astro deployment service-account | Astronomer Documentation

This command is available only if you’re authenticated to an Astro Private Cloud installation.

Manage Deployment-level service accounts, which you can use to configure a CI/CD pipeline or otherwise interact with the Astronomer Houston API.

Usage

This command includes three subcommands: create, delete, and list

1 # Creates a Deployment-level service account
2 astro deployment service-account create --deployment-id=<your-deployment-id> --label=<your-service-account-label>
3 
4 # Deletes a Deployment-level service account
5 astro deployment service-account delete <your-service-account-label>
6 
7 # Shows the name, ID, and API token for each service account in a specific Deployment.
8 astro deployment service-account list

Options

Option	Description	Possible Values
`--category`	The category for the new service account as displayed in the UI	Any string. The default value is `default`.
`--deployment-id` (Required for `create` and `delete`)	The Deployment you’re creating a service account for	Any Deployment ID
`--label` (Required for `create`)	The name or label for the new service account	Any string
`--role`	The User Role for the new service account	Can be either `viewer`, `editor`, or `admin`. The default is `viewer`.

1	# Creates a Deployment-level service account
2	astro deployment service-account create --deployment-id=<your-deployment-id> --label=<your-service-account-label>
3
4	# Deletes a Deployment-level service account
5	astro deployment service-account delete <your-service-account-label>
6
7	# Shows the name, ID, and API token for each service account in a specific Deployment.
8	astro deployment service-account list