Skip to main content

tcld account command reference

View Markdown

The tcld account commands manage accounts in Temporal Cloud.

Alias: a

audit-log​

The tcld account audit-log command manage Audit Logs in Temporal Cloud.

Alias: al

kinesis​

The tcld account audit-log kinesis command manages Kinesis audit log sinks.

Alias: k

create​

The tcld account audit-log kinesis command creates a Kinesis audit log sink.

Alias: c

--destination-uri​

The destination URI of the audit log sink.

Alias: du

--region​

The region to use for the request.

Alias: re

--role-name​

The role name to use to write to the sink.

Alias: rn

--sink-name​

Provide a name for the sink.

delete​

The tcld account audit-log kinesis delete command deletes an audit log sink.

Alias: d

--resource-version​

The resource-version (etag) to update from, if not set the cli will use the latest (optional).

Alias: v

--sink-name​

Provide a name for the sink.

get​

The tcld account audit-log kinesis get command gets an audit log sink.

Alias: g

--sink-name​

Provide a name for the sink.

list​

The tcld account audit-log kinesis list command lists audit log sinks on the account.

Alias: l

--page-size​

The page size for list operations.

--page-token​

The page token for list operations.

update​

The tcld account audit-log kinesis update command updates an audit log sink.

Alias: u

--destination-uri​

The destination URI of the audit log sink.

Alias: du

--enabled​

Whether the sink is enabled.

--region​

The region to use for the request.

Alias: re

--resource-version​

The resource-version (etag) to update from, if not set the cli will use the latest (optional).

Alias: v

--role-name​

The role name to use to write to the sink.

Alias: rn

--sink-name​

Provide a name for the sink.

validate​

The tcld account audit-log kinesis validate command verifies Temporal Cloud can write to a Kinesis sink.

Alias: v

--destination-uri​

The destination URI of the audit log sink.

Alias: du

--region​

The region to use for the request.

Alias: re

--role-name​

The role name to use to write to the sink.

Alias: rn

--sink-name​

Provide a name for the sink.

pubsub​

The tcld account audit-log pubsub command manages Pub/Sub audit log sinks.

Alias: ps

create​

The tcld account audit-log pubsub command creates a Pub/Sub audit log sink.

Alias: c

--service-account-email​

The service account email to impersonate to write to the sink.

Alias: sae

--sink-name​

Provide a name for the sink.

--topic-name​

The topic name to write to the sink.

Alias: tn

delete​

The tcld account audit-log pubsub delete command deletes an audit log sink.

Alias: d

--resource-version​

The resource-version (etag) to update from, if not set the cli will use the latest (optional).

Alias: v

--sink-name​

Provide a name for the sink.

get​

The tcld account audit-log pubsub get command gets an audit log sink.

Alias: g

--sink-name​

Provide a name for the sink.

list​

The tcld account audit-log pubsub list command lists audit log sinks on the account.

Alias: l

--page-size​

The page size for list operations.

--page-token​

The page token for list operations.

update​

The tcld account audit-log pubsub update command updates an audit log sink.

Alias: u

--enabled​

Whether the sink is enabled.

--resource-version​

The resource-version (etag) to update from, if not set the cli will use the latest (optional).

Alias: v

--service-account-email​

The service account email to impersonate to write to the sink.

Alias: sae

--sink-name​

Provide a name for the sink.

--topic-name​

The topic name to write to the sink.

Alias: tn

validate​

The tcld account audit-log pubsub validate command verifies Temporal Cloud can write to a Pub/Sub sink.

Alias: v

--service-account-email​

The service account email to impersonate to write to the sink.

Alias: sae

--sink-name​

Provide a name for the sink.

--topic-name​

The topic name to write to the sink.

Alias: tn

get​

The tcld account get command gets information about the Temporal Cloud account you are logged into.

Alias: g

tcld account get

The command has no modifiers.

list-regions​

The tcld account list-regions lists all regions where the account can provision namespaces.

Alias: l

metrics​

The tcld account metrics commands configure the metrics endpoint for the Temporal Cloud account that is currently logged in.

Alias: m

accepted-client-ca​

The tcld account metrics accepted-client-ca commands manage the end-entity certificates for the metrics endpoint of the Temporal Cloud account that is currently logged in.

info

The end-entity certificates for the metrics endpoint must chain up to the CA certificate used for the account. For more information, see Certificate requirements.

Alias: ca

add​

The tcld account metrics accepted-client-ca add command adds end-entity certificates to the metrics endpoint of a Temporal Cloud account.

info

The end-entity certificates for the metrics endpoint must chain up to the CA certificate used for the account. For more information, see Certificate requirements.

tcld account metrics accepted-client-ca add --ca-certificate <value>

Alias: a

The following modifiers control the behavior of the command.

--request-id​

Specify a request identifier to use for the asynchronous operation. If not specified, the server assigns a request identifier.

Alias: -r

Example

tcld account metrics accepted-client-ca add --request-id <request_id> --ca-certificate <encoded_certificate>
--resource-version​

Specify a resource version (ETag) to update from. If not specified, the latest version is used.

Alias: -v

Example

tcld account metrics accepted-client-ca add --resource-version <etag> --ca-certificate <encoded_certificate>
--ca-certificate​

Required modifier unless --ca-certificate-file is specified

Specify a base64-encoded string of a CA certificate PEM file.

If both --ca-certificate and --ca-certificate-file are specified, only --ca-certificate is used.

Alias: -c

Example

tcld account metrics accepted-client-ca add --ca-certificate <encoded_certificate>
--ca-certificate-file​

Required modifier unless --ca-certificate is specified

Specify a path to a CA certificate PEM file.

If both --ca-certificate and --ca-certificate-file are specified, only --ca-certificate is used.

Alias: -f

Example

tcld account metrics accepted-client-ca add --ca-certificate-file <path>

list​

The tcld account metrics accepted-client-ca list command lists the end-entity certificates that are currently configured for the metrics endpoint of a Temporal Cloud account.

tcld account metrics accepted-client-ca list

Alias: l

The command has no modifiers.

remove​

The tcld account metrics accepted-client-ca remove command removes end-entity certificates from the metrics endpoint of a Temporal Cloud account.

tcld account metrics accepted-client-ca remove --ca-certificate <value>

Alias: r

The following modifiers control the behavior of the command.

--request-id​

Specify a request identifier to use for the asynchronous operation. If not specified, the server assigns a request identifier.

Alias: -r

Example

tcld account metrics accepted-client-ca remove --request-id <request_id> --ca-certificate <encoded_certificate>
--resource-version​

Specify a resource version (ETag) to update from. If not specified, the latest version is used.

Alias: -v

Example

tcld account metrics accepted-client-ca remove --resource-version <etag> --ca-certificate <encoded_certificate>
--ca-certificate​

Required modifier unless --ca-certificate-fingerprint or --ca-certificate-file is specified

Specify a base64-encoded string of a CA certificate PEM file.

If --ca-certificate-fingerprint is also specified, both --ca-certificate and --ca-certificate-file are ignored.

If --ca-certificate-file is also specified but --ca-certificate-fingerprint is not, only --ca-certificate is used.

Alias: -c

Example

tcld account metrics accepted-client-ca remove --ca-certificate <encoded_certificate>
--ca-certificate-file​

Required modifier unless --ca-certificate-fingerprint or --ca-certificate is specified

Specify a path to a CA certificate PEM file.

If --ca-certificate-fingerprint is also specified, both --ca-certificate-file and --ca-certificate are ignored.

If --ca-certificate is also specified but --ca-certificate-fingerprint is not, only --ca-certificate is used.

Alias: -f

Example

tcld account metrics accepted-client-ca remove --ca-certificate-file <path>
--ca-certificate-fingerprint​

Required modifier unless --ca-certificate or --ca-certificate-file is specified

Specify the fingerprint of a CA certificate.

If --ca-certificate, --ca-certificate-file, or both are also specified, they are ignored.

Alias: --fp

Example

tcld account metrics accepted-client-ca remove --ca-certificate-fingerprint <fingerprint>

set​

The tcld account metrics accepted-client-ca set command sets the end-entity certificates for the metrics endpoint of a Temporal Cloud account.

info

The end-entity certificates for the metrics endpoint must chain up to the CA certificate used for the account. For more information, see Certificate requirements.

tcld account metrics accepted-client-ca set --ca-certificate <value>

Alias: s

The following modifiers control the behavior of the command.

--request-id​

Specify a request identifier to use for the asynchronous operation. If not specified, the server assigns a request identifier.

Alias: -r

Example

tcld account metrics accepted-client-ca set --request-id <request_id> --ca-certificate <encoded_certificate>
--resource-version​

Specify a resource version (ETag) to update from. If not specified, the latest version is used.

Alias: -v

Example

tcld account metrics accepted-client-ca set --resource-version <etag> --ca-certificate <encoded_certificate>
--ca-certificate​

Required modifier unless --ca-certificate-file is specified

Specify a base64-encoded string of a CA certificate PEM file.

If both --ca-certificate and --ca-certificate-file are specified, only --ca-certificate is used.

Alias: -c

Example

tcld account metrics accepted-client-ca set --ca-certificate <encoded_certificate>
--ca-certificate-file​

Required modifier unless --ca-certificate is specified

Specify a path to a CA certificate PEM file.

If both --ca-certificate and --ca-certificate-file are specified, only --ca-certificate is used.

Alias: -f

Example

tcld account metrics accepted-client-ca set --ca-certificate-file <path>

enable​

The tcld account metrics enable command enables the metrics endpoint for the Temporal Cloud account that is currently logged in.

info

The end-entity for the metrics endpoint must be configured before the endpoint can be enabled. See the tcld account metrics accepted-client-ca commands.

tcld account metrics enable

The command has no modifiers.

disable​

The tcld account metrics disable command disables the metrics endpoint for the Temporal Cloud account that is currently logged in.

tcld account metrics disable

The command has no modifiers.