Skip to main content

Temporal CLI operator command reference

Operator commands enable actions on Namespaces, Search Attributes, and Temporal Clusters. These actions are performed through subcommands.

To run an Operator command, run temporal operator [command] [subcommand] [command options].

cluster

Cluster commands enable actions on Temporal Clusters.

Cluster commands follow this syntax: temporal operator [command] [subcommand] [command options].

describe

The temporal operator cluster describe command shows information about the Cluster. This information can include information about other connected services, such as a remote Codec Server.

Use the following options to change the output of this command.

health

The temporal operator cluster health command checks the health of the Frontend Service. A successful execution returns a list of Cluster metrics.

Use the following options to change the behavior and output of this command.

list

The temporal operator cluster list command prints a list of all remote Clusters on the system.

temporal operator cluster list

Use the following options to change the command's behavior.

remove

The temporal operator cluster remove command removes a remote Cluster from the system.

temporal operator cluster remove --name=SomeCluster

Use the following options to change the command's behavior.

system

The temporal operator cluster system command provides information about the system the Cluster is running on. This information can be used to diagnose problems occurring in the Temporal Server.

temporal operator cluster system

Use the following options to change this command's behavior.

upsert

The temporal operator cluster upsert command allows the user to add or update a remote Cluster. temporal operator cluster upsert --frontend-address="127.0.2.1"

Upserting can also be used to enable or disabled cross-cluster connection. temporal operator cluster upsert --enable-connection=true

Use the following options to change the behavior of this command.

namespace

Namespace commands perform operations on Namespaces contained in the Temporal Cluster.

Namespace commands follow this syntax: temporal operator namespace COMMAND [ARGS].

create

The temporal operator namespace create command creates a new Namespace. The Namespace can be created on the active Cluster, or any named Cluster within the system. temporal operator namespace --cluster=MyCluster

Global Namespaces can also be created. temporal operator namespace create --global

Other settings, such as retention and Visibility Archival State, can be configured according to the application's needs. The Visibility Archive can be set on a separate URI. temporal operator namespace create --retention=RetentionMyWorkflow --visibility-archival-state="enabled" --visibility-uri="some-uri"

Use the options listed below to change the command's behavior.

delete

The temporal operator namespace delete command deletes a given Namespace from the system. The command follow the syntax temporal operator namespace delete <namespace>

Use the following options to change the behavior of this command.

describe

The temporal operator namespace describe command provides a description of a Namespace. Namespaces are identified by Namespace ID.

temporal operator namespace describe --namespace-id=meaningful-business-id

Use the following options to change the behavior of this command.

list

The temporal operator namespace list command lists all Namespaces on the Server.

temporal operator namespace list

Use the following options to change this command's behavior.

update

The temporal operator namespace update command updates a Namespace.

Namespaces can be assigned a different active Cluster. temporal operator namespace update --active-cluster=NewActiveCluster

Namespaces can also be promoted to global Namespaces. temporal operator namespace --promote-global=true

Any Archives that were previously enabled or disabled can be changed through this command. However, URI values for archival states cannot be changed after the states are enabled. temporal operator namespace update --history-archival-state="enabled" --visibility-archival-state="disabled"

note

The Namespace needs to be the last argument passed in your command. For example, temporal operator namespace update retention 180 your_namespace.

Use the options listed below to change the command's behavior.

search-attribute

Search Attribute commands enable operations for the creation, listing, and removal of Search Attributes.

Search Attribute commands follow this syntax: temporal operator search-attribute COMMAND [ARGS].

create

The temporal operator search-attribute create command adds one or more custom Search Attributes. These Search Attributes can be used to filter a list of Workflow Executions that contain the given Search Attributes in their metadata.

Use the following options to change this command's behavior.

list

The temporal operator search-attribute list command displays a list of all Search Attributes that can be used in Queries.

temporal workflow list --query.

Use the following options to change this command's behavior.

remove

The temporal operator search-attribute remove command removes custom Search Attribute metadata. This command does not remove custom Search Attributes from Elasticsearch or change the index schema.

Use the following options to change this command's behavior.