How to manage Namespaces in Temporal Cloud

A Namespace is a unit of isolation within the Temporal Platform.

• Create a Namespace
• Access a Namespace
• Manage Namespaces

Create a Namespace

info

The user who creates a Namespace is automatically granted Namespace Admin permission for that Namespace.

To create a Namespace, a user must have the Developer or Global Admin account-level Role.

tip

By default, each account has a quota of 10 Namespaces. If you want to increase this limit, open a support ticket.

Information needed to create a Namespace

To create a Namespace in Temporal Cloud, gather the following information:

• Namespace Name and region
• Retention Period for the Event History of closed Workflow Executions
• CA certificate for the Namespace
• Permissions for each user

Create a Namespace using Temporal Cloud UI

1. Gather the information listed earlier in Information needed to create a Namespace.
2. Go to the Temporal Cloud UI and log in.
3. On the left side of the window, click Namespaces.
4. On the Namespaces page, click Create Namespace in the upper-right portion of the window.
5. On the Create Namespace page in Name, enter the Namespace Name.
6. In Region, select the region in which to host this Namespace.
7. In Retention Period, specify a value from 1 to 90 days. When choosing this value, consider your needs for Event History versus the cost of maintaining that Event History. Typically, a development Namespace has a short retention period and a production Namespace has a longer retention period. (If you need to change this value later, contact Temporal Support.)
8. In Certificate, paste the CA certificate for this Namespace.
9. Click Create Namespace.

Create a Namespace using tcld

This functionality is in development.

Access Namespaces

Each Namespace in Temporal Cloud has two unique endpoints, both of which include the Namespace Id.

• For programmatic access, a gRPC endpoint in the form <NamespaceId>.tmprl.cloud; for example, accounting-production.f45a2.tmprl.cloud:7233.
• For accessing Temporal Web UI, an HTTPS endpoint in the form web.<namespaceId>.tmprl.cloud; for example, https://web.accounting-production.f45a2.tmprl.cloud.

Manage Namespaces

Manage Namespaces in Temporal Cloud using Temporal Cloud UI

To list Namespaces:

• On the left side of the window, select Namespaces.

To edit a Namespace (including custom Search Attributes, certificates, certificate filters, permissions, and users), find the Namespace and do either of the following:

• On the right end of the Namespace row, select the three vertical dots (⋮). Click Edit.
• Select the Namespace name. In the top-right portion of the page, select Edit.

On the Edit page, you can do the following:

• Add a custom Search Attribute.
• Manage CA certificates.
• Manage certificate filters.
• Manage Namespace-level permissions.
• Add users.

To add a user to a Namespace, scroll to the bottom of the page and select Add User.

After you make changes, select Save in the top-right or bottom-left portion of the page.

Manage Namespaces in Temporal Cloud using tcld

To list Namespaces and get information about them, use the following tcld commands:

• tcld namespace listtcld namespace list
  
  How to list all Namespaces in Temporal Cloud using tcld.
  
  Learn more
• tcld namespace gettcld namespace get
  
  How to get information about a Namespace in Temporal Cloud using tcld.
  
  Learn more

To manage certificates, use the tcld namespace accepted-client-catcld namespace accepted-client-ca

How to manage the client CA certificates for a Namespace in Temporal Cloud using tcld.

Learn more commands. For more information, see How to manage certificates in Temporal Cloud.

To manage certificate filters, use the tcld namespace certificate-filterstcld namespace certificate-filters

How to manage certificate filters for a Namespace in Temporal Cloud using tcld.

Learn more commands. For more information, see How to manage certificate filters in Temporal Cloud.