# detail

The cldkctl vm detail command retrieves detailed information about a specific virtual machine (VM) by its name. This command provides information such as CPU, memory, storage, image, and current status. You can also use the --yaml flag to output the details in YAML format.

## Usage

```
cldkctl vm detail [name] [flags]
```

## Steps

Follow the steps below to run and view the result of this command:

1. Run the following command in your terminal and replace \<vm\_name> with your virtual machine name.

```
cldkctl vm detail <vm_name>
```

2. Optionally, include the --namespace flag to scope the operation to a specific namespace, or --project to specify a project ID.
3. Wait for the system to retrieve the details. The command will display information such as the namespace, status, readiness, CPU, RAM, storage, image, and creation date.
4. If you prefer to view the data in YAML format, add the --yaml flag at the end of the command

<figure><img src="/files/AMsnbPtUByOTFCEHLP8m" alt=""><figcaption></figcaption></figure>

| Column     | Description                                                             |
| ---------- | ----------------------------------------------------------------------- |
| Namespace  | The namespace where the virtual machine is located.                     |
| Status     | The current operational state of the VM.                                |
| Ready      | Indicates whether the VM is ready or not.                               |
| CPU        | The number of virtual CPUs allocated to the VM.                         |
| RAM        | The memory size assigned to the VM.                                     |
| Storage    | The total storage capacity allocated to the VM.                         |
| Image      | The container image or operating system image used to provision the VM. |
| Created At | The date and time when the VM was created.                              |

## Flags

{% hint style="info" %}
This command supports [global flags](/cloudeka-api-list/global-flags.md). Refer to the Global Flags section for details
{% endhint %}

| Flag                   | Description                                             |
| ---------------------- | ------------------------------------------------------- |
| -h, --help             | Help for the vm detail command.                         |
| -n, --namespace string | Specifies the cluster namespace to scope the operation. |
| -p, --project string   | Specifies the project ID.                               |
| --yaml                 | Outputs the VM details in YAML format.                  |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-vm/detail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.