> ## Documentation Index
> Fetch the complete documentation index at: https://datum-4926dda5-mintlify-style-consistency-1774830500.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# datumctl describe

Show details of a specific resource or group of resources

### Synopsis

Show details of a specific resource or group of resources.

Print a detailed description of the selected resources, including related resources such as events or controllers. You may select a single object by name, all objects of that type, provide a name prefix, or label selector. For example:

\$ kubectl describe TYPE NAME\_PREFIX

will first check for an exact match on TYPE and NAME\_PREFIX. If no such resource exists, it will output details for every resource that has a name prefixed with NAME\_PREFIX.

Use "datumctl api-resources" for a complete list of supported resources.

```
datumctl describe (-f FILENAME | TYPE [NAME_PREFIX | -l label] | TYPE/NAME)
```

### Examples

```
  # Describe a node
  kubectl describe nodes kubernetes-node-emt8.c.myproject.internal

  # Describe a pod
  kubectl describe pods/nginx

  # Describe a pod identified by type and name in "pod.json"
  kubectl describe -f pod.json

  # Describe all pods
  kubectl describe pods

  # Describe pods by label name=myLabel
  kubectl describe pods -l name=myLabel

  # Describe all pods managed by the 'frontend' replication controller
  # (rc-created pods get the name of the rc as a prefix in the pod name)
  kubectl describe pods frontend
```

### Options

| Flag                     | Type    | Description                                                                                                                                   |
| ------------------------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `-A`, `--all-namespaces` | —       | If present, list the requested object(s) across all namespaces. Namespace in current context is ignored even if specified with `--namespace`. |
| `--chunk-size`           | int     | Return large lists in chunks rather than all at once. Pass 0 to disable. (default `500`)                                                      |
| `-f`, `--filename`       | strings | Filename, directory, or URL to files containing the resource to describe.                                                                     |
| `-h`, `--help`           | —       | Help for describe.                                                                                                                            |
| `-k`, `--kustomize`      | string  | Process the kustomization directory. This flag can't be used together with `-f` or `-R`.                                                      |
| `-R`, `--recursive`      | —       | Process the directory used in `-f`, `--filename` recursively.                                                                                 |
| `-l`, `--selector`       | string  | Selector (label query) to filter on, supports `=`, `==`, `!=`, `in`, `notin`.                                                                 |
| `--show-events`          | —       | If true, display events related to the described object. (default `true`)                                                                     |

### Options inherited from parent commands

| Flag                         | Type        | Description                                                                                                                                                                                                             |
| ---------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--as`                       | string      | Username to impersonate for the operation. User could be a regular user or a service account in a namespace.                                                                                                            |
| `--as-group`                 | stringArray | Group to impersonate for the operation. Can be repeated to specify multiple groups.                                                                                                                                     |
| `--as-uid`                   | string      | UID to impersonate for the operation.                                                                                                                                                                                   |
| `--as-user-extra`            | stringArray | User extras to impersonate for the operation. Can be repeated to specify multiple values for the same key.                                                                                                              |
| `--certificate-authority`    | string      | Path to a cert file for the certificate authority.                                                                                                                                                                      |
| `--disable-compression`      | —           | If true, opt-out of response compression for all requests to the server.                                                                                                                                                |
| `--insecure-skip-tls-verify` | —           | If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure.                                                                                                     |
| `--log-flush-frequency`      | duration    | Maximum number of seconds between log flushes. (default `5s`)                                                                                                                                                           |
| `-n`, `--namespace`          | string      | If present, the namespace scope for this CLI request.                                                                                                                                                                   |
| `--organization`             | string      | Organization name.                                                                                                                                                                                                      |
| `--platform-wide`            | —           | Access the platform root instead of a project or organization control plane.                                                                                                                                            |
| `--project`                  | string      | Project name.                                                                                                                                                                                                           |
| `--request-timeout`          | string      | The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. `1s`, `2m`, `3h`). A value of zero means don't timeout requests. (default `"0"`) |
| `-s`, `--server`             | string      | The address and port of the Kubernetes API server.                                                                                                                                                                      |
| `--tls-server-name`          | string      | Server name to use for server certificate validation. If not provided, the hostname used to contact the server is used.                                                                                                 |
| `--token`                    | string      | Bearer token for authentication to the API server.                                                                                                                                                                      |
| `--user`                     | string      | The name of the kubeconfig user to use.                                                                                                                                                                                 |
| `-v`, `--v`                  | Level       | Number for the log level verbosity.                                                                                                                                                                                     |
| `--vmodule`                  | moduleSpec  | Comma-separated list of `pattern=N` settings for file-filtered logging (only works for the default text log format).                                                                                                    |

### See also

* [datumctl](/docs/datumctl/cli-reference/)	 - A CLI for interacting with the Datum platform

###### Auto generated by spf13/cobra on 24-Feb-2026