> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro deployment inspect

> Inspect a Deployment.

<Info>
  This command is only available on Astro.
</Info>

Inspect an Astro Deployment. This command returns a YAML or JSON representation of a Deployment's current configuration and state as shown in the Astro UI. When the `--key` flag is used, it returns only the values specified with the flag.

For more information about how to use Deployment files, see [Manage Deployments as Code](/docs/astro/manage-deployments-as-code).

## Usage

```sh wrap theme={null}
astro deployment inspect
```

When using the `--key` flag, specify the complete path of the key you want to return the value for, excluding `deployment`. For example, to return the `cluster_id` for a specific Deployment, you would run:

```sh wrap theme={null}
astro deployment inspect -n <deployment-name> --key metadata.cluster_id
```

See [Template file contents](/docs/astro/deployment-file-reference) for all possible values to return.

## Options

| Option | Description | Possible Values |
| - | - | - |
| `<deployment-id>` | The ID of the Deployment to inspect. | Any valid Deployment ID |
| `-n`, `--deployment-name` | Name of the Deployment to inspect. Use as an alternative to `<deployment-id>`. | Any valid Deployment name |
| `-k`, `--key` | Return only a specific configuration key for a Deployment. For example `--key configuration.cluster_id` to get a Deployment's cluster ID. | Any valid Deployment configuration key |
| `-o`, `--output` | Output format can be one of: YAML or JSON. By default, inspecting a Deployment returns a file in YAML format. | `yaml` or `json` |
| `--show-workload-identity` | Return the workload identity values that are set for the Deployment. | None |
| `-t`, `--template` | Generate a Deployment template file for the inspected Deployment. A template file is a configuration file that includes all information about a Deployment at the time of inspection, except for its name, description field, and unique metadata. See [Manage with Deployment files](/docs/astro/manage-deployments-as-code) to learn more about templates. | None |
| `--workspace-id` | Specify a Workspace to run this command for a Deployment that is outside of your current Workspace. | Any valid Workspace ID |

## Examples

```sh wrap theme={null}
# Shows a list of Deployments to inspect and prompts you to choose one
$ astro deployment inspect

# Shows a specific Deployment's configuration
$ astro deployment inspect <deployment-id>

# Shows a specific Deployment's health status
$ astro deployment inspect <deployment-id> --key metadata.status

# Save the current state of a Deployment to a YAML Deployment file
$ astro deployment inspect <deployment-id> > deployment.yaml

# Save a Deployment as a JSON template file
$ astro deployment inspect <deployment-id> --template -o json > deployment.json
```

## Related commands

* [`astro deployment list`](/docs/cli/v1.46/astro-deployment-list)
* [`astro deployment create`](/docs/cli/v1.46/astro-deployment-create)