Create a namespace to isolate resources and services - Microservices Engine

When multiple teams or environments share a single Microservices Engine (MSE) instance, service names and configurations can collide. Namespaces isolate resources and services within an MSE instance to enhance security, so you can separate environments such as development, staging, and production, or partition resources across teams, without naming conflicts. Creating namespaces also simplifies management and maintenance, and improves work efficiency.

Each namespace is scoped to a single MSE instance within a specific region.

Prerequisites

Before you begin, make sure that you have:

An MSE instance in the target region
Permissions to manage namespaces in the MSE console

Considerations

When you create an instance, MSE automatically generates a default namespace named public. This namespace cannot be modified or deleted. If you do not need custom isolation, use the default namespace.
Create namespaces based on distinct isolation requirements, such as different environments or usage scenarios. Keep the total to 10 or fewer per instance. Too many namespaces increase the blast radius and can overload the instance database, which affects the runtime Service-Level Agreement (SLA).

Create a namespace

Log on to the MSE console and select a region in the top navigation bar.
In the left-side navigation pane, choose Microservices Registry > Instances.
On the Instances page, click the name of the target instance.
In the left-side navigation pane, click Namespace.
On the Namespace page, click Create namespace.

In the Create namespace dialog box, configure the following parameters, and then click OK.

Parameter	Required	Description	Example
Namespace Name	Yes	A display name for the namespace. Use a name that reflects the purpose, such as the environment or team.	`dev-env`
Namespace ID	Yes	A unique identifier for the namespace within the instance.	`dev-environment`

Verify that the new namespace appears in the namespace list.

View, edit, or delete a namespace

After you create a namespace, manage it from the Actions column in the namespace list:

Action	Steps
View details	Click View to check the namespace configuration, including the namespace name and ID.
Edit	Click Edit to modify the namespace name or other editable fields.
Delete	Click Delete and follow the on-screen prompts to confirm the deletion.

Note: The default namespace public cannot be edited or deleted.