Command reference
deployments service-account
Machine identities
| Command | Summary |
|---|---|
deployments service-account create | Create a service account |
deployments service-account list | List service accounts |
deployments service-account show | Show a service account |
deployments service-account revoke | Revoke a service account |
deployments service-account create
Create a service account.
deployments service-account create --name <name> --scopes <a-b-c>- Calls
POST /v1/service-accounts(SDKcreateServiceAccount). - Needs an environment:
--envor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--name | string | yes | Resource name | |
--description | string | Resource description | ||
--scopes | string (a,b,c) | yes | Capability scopes |
Also accepts the global flags.
deployments service-account list
List service accounts.
deployments service-account list- Calls
GET /v1/service-accounts(SDKlistServiceAccounts). - Needs an environment:
--envor the saved context. - Paginated.
--page-sizesets the page size; pass the returned cursor as--cursorfor the next page.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--cursor | string (cursor) | Pagination cursor | ||
--page-size | string (number) | Page size |
Also accepts the global flags.
deployments service-account show
Show a service account.
deployments service-account show <id>- Calls
GET /v1/service-accounts/{id}(SDKgetServiceAccount). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments service-account revoke
Revoke a service account.
deployments service-account revoke <id>- Calls
DELETE /v1/service-accounts/{id}(SDKrevokeServiceAccount). - Needs an environment:
--envor the saved context. - Destructive. Live runs ask for confirmation; pass
--yesin scripts or with--json. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--reason | string | Reason for this operation |
Also accepts the global flags.