> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/guidance-for-enterprise/cloudeka-api-list/command-reference/cldkctl-describe/persistentvolumeclaim.md).

# persistentvolumeclaim

The describe persistentvolumeclaim command retrieves detailed information about a specific Persistent Volume Claim (PVC) in the Kubernetes cluster. This includes metadata, requested storage, access modes, binding status, and the associated Persistent Volume (PV), if any.

## Usage

```
cldkctl describe persistentvolumeclaim [name] [flags]
```

## Steps

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

1. Run the following command in your terminal:

```
cldkctl describe persistentvolumeclaim [name]
```

2. Replace `[name]` with the PVC name you want to inspect.
3. To view the resource name, refer to the corresponding get persistentvolumeclaim section.
4. If the resource is located in a non-default namespace, include the `-n` or `--namespace` flag followed by the namespace name.

```
cldkctl describe [resource] [name] -n [namespace]
```

5. Once completed successfully, the detailed information about the specified PVC will appear in your terminal. The output includes metadata, requested storage, and current binding status.

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

The following table describes the additional fields specific to the PersistentVolumeClaim resource.

| Column                          | Description                                                                        |
| ------------------------------- | ---------------------------------------------------------------------------------- |
| spec.accessModes                | The desired access mode for the PVC.                                               |
| spec.resources.requests.storage | The requested storage size for the volume.                                         |
| spec.storageClassName           | The name of the StorageClass that provisions the Persistent Volume for this claim. |
| spec.volumeName                 | The name of the Persistent Volume bound to this claim, if any.                     |
| spec.volumeMode                 | The mode in which the volume is exposed to the Pod.                                |
| status.phase                    | Indicates the current state of the claim.                                          |

## Flags

{% hint style="info" %}

1. This command supports [global flags](/guidance-for-enterprise/cloudeka-api-list/global-flags.md). Refer to the Global Flags section for details.
2. For common metadata fields, refer to the Common Output Fields table at the beginning of this section.
   {% endhint %}

| Flag       | Description                                      |
| ---------- | ------------------------------------------------ |
| -h, --help | Help for describe persistentvolumeclaim command. |