Temporal CLI operator command reference
Operator commands enable actions on Namespaces 🔗
To run an Operator command, run temporal operator [command] [subcommand] [command options]
.
cluster
Operator commands enable actions on Namespaces 🔗
To run an Operator command, run temporal operator [command] [subcommand] [command options]
.
describe
The temporal operator cluster describe
command shows information about the Cluster 🔗
Use the options listed below to change the output of this command.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
health
The temporal operator cluster health
command checks the health of the Frontend Service 🔗
Use the options listed below to change the behavior and output of this command.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
list
The temporal operator cluster list
command prints a list of all remote Clusters 🔗
temporal operator cluster list
Use the options listed below to change the command's behavior.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
remove
The temporal operator cluster remove
command removes a remote Cluster 🔗
temporal operator cluster remove --name=SomeCluster
Use the options listed below to change the command's behavior.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.--name 🔗
xLink previewtemporal nameFrontend address of the remote Cluster.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
system
The temporal operator cluster system
command provides information about the system the Cluster 🔗
temporal operator cluster system
Use the options listed below to change this command's output.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
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 options listed below to change the behavior of this command.
- xLink previewtemporal enable-connectionEnable cross-cluster connection
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.- xLink previewtemporal frontend-addressFrontend address of the remote Cluster.
--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
namespace
Namespace commands allow Namespace 🔗
create
The temporal operator namespace create
command creates a new Namespace 🔗
temporal operator namespace --cluster=MyCluster
Global Namespaces can also be created.
temporal operator namespace create --global
Other settings, such as retention 🔗
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.
- xLink previewtemporal active-clusterActive cluster name
- xLink previewtemporal clusterCluster name
--data 🔗
xLink previewtemporal dataNamespace data in a key=value format- xLink previewtemporal descriptionNamespace description
--email 🔗
xLink previewtemporal emailOwner email--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--global 🔗
xLink previewtemporal globalFlag to indicate whether namespace is a global namespace- xLink previewtemporal history-archival-stateFlag to set history archival state, valid values are "disabled" and "enabled"
- xLink previewtemporal history-uriOptionally specify history archival URI
--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal retentionWorkflow Execution retention
- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
- xLink previewtemporal visibility-archival-stateFlag to set visibility archival state.
- xLink previewtemporal visibility-uriOptionally specify visibility archival URI (cannot be changed after first time archival is enabled).
delete
The temporal operator namespace delete
command deletes a given Namespace 🔗
Use the options listed below to change the command's behavior.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
--yes 🔗
xLink previewtemporal yesConfirm all prompts.
describe
The temporal operator namespace describe
command provides a description of a Namespace 🔗
temporal operator namespace describe --namespace-id=meaningful-business-id
Use the options listed below to change the command's output.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal namespace-idNamespace Id
- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
list
The temporal operator namespace list
command lists all Namespaces on the Server 🔗
temporal operator namespace list
Use the options listed below to change the command's output.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
update
The temporal operator namespace update
command updates a given 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 🔗
temporal operator namespace update --history-archival-state="enabled" --visibility-archival-state="disabled"
Use the options listed below to change the command's behavior.
- xLink previewtemporal active-clusterActive cluster name
- xLink previewtemporal clusterCluster name
--data 🔗
xLink previewtemporal dataNamespace data in a key=value format- xLink previewtemporal descriptionNamespace description
--email 🔗
xLink previewtemporal emailOwner email--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.- xLink previewtemporal history-archival-stateFlag to set history archival state, valid values are "disabled" and "enabled"
- xLink previewtemporal history-uriOptionally specify history archival URI
--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal promote-globalPromote local namespace to global namespace
--reason 🔗
xLink previewtemporal reasonReason for the operation- xLink previewtemporal retentionWorkflow Execution retention
- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
- xLink previewtemporal visibility-archival-stateFlag to set visibility archival state.
- xLink previewtemporal visibility-uriOptionally specify visibility archival URI (cannot be changed after first time archival is enabled).
search-attribute
Search Attribute commands enable operations for the creation, listing, and removal of Search Attributes 🔗
create
The temporal operator search-attribute create
command adds one or more custom Search Attributes 🔗
Use the options listed below to change the command's behavior.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.--name 🔗
xLink previewtemporal nameFrontend address of the remote Cluster.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
--type 🔗
xLink previewtemporal typeSearch attribute type.
list
The temporal operator search-attribute list
command displays a list of all Search Attributes 🔗
temporal workflow list --query
.Use the options listed below to change the command's behavior.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
remove
The temporal operator search-attribute remove
command removes custom Search Attribute 🔗
Use the options listed below to change the command's behavior.
--fields 🔗
xLink previewtemporal fieldsCustomize fields to print.--limit 🔗
xLink previewtemporal limitNumber of items to print.--name 🔗
xLink previewtemporal nameFrontend address of the remote Cluster.- xLink previewtemporal no-pagerDisables the interactive pager.
--output 🔗
xLink previewtemporal outputOutput format.--pager 🔗
xLink previewtemporal pagerSets the pager for Temporal CLI to use.- xLink previewtemporal time-formatFormat time as either relative, iso, raw.
--yes 🔗
xLink previewtemporal yesConfirm all prompts.