Skip to main content
View and manage namespaces within your account. Namespaces provide logical isolation for resources within an account. Each account has a ‘default’ namespace that cannot be deleted.

​
Usage

idyl namespace

​
Aliases

  • namespaces
  • ns

​
Commands

CommandDescription
idyl namespace createCreate a new namespace
idyl namespace deleteDelete a namespace
idyl namespace editEdit a namespace
idyl namespace getGet namespace details or list all namespaces
idyl namespace showShow current namespace details

​
Inherited flags

FlagDescription
-a <string>, --account-id <string>Account ID to use (overrides context)
-c <string>, --context <string>Use specific context
--homedir <string>Override config directory (default: ~/.idyl)
-n <string>, --namespace <string>Namespace to use
-o <string>, --output <string>Output format (json|yaml)
-p <string>, --profile <string>Override profile
--realm <string>Override realm
--subnet <string>Override context subnet for this command

​
Examples

# List namespaces
idyl namespace list

# Create a new namespace
idyl namespace create my-namespace

# Get namespace details
idyl ns get my-namespace

# Edit a namespace
idyl ns edit my-namespace --set-description "Updated description"

# Delete a namespace
idyl namespace delete my-namespace

​
Subcommand reference

​
idyl namespace create

Create a new namespace in your account. Namespace names must be lowercase alphanumeric with hyphens, between 1-63 characters.

​
Usage

idyl namespace create <name> [flags]

​
Flags

FlagDescription
--description <string>Description of the namespace
-o <string>, --output <string>Output format: table, json, yaml Default: table.

​
Examples

# Create a namespace
idyl namespace create my-namespace

# Create with description
idyl ns create my-namespace --description "Production environment"

​
idyl namespace delete

Delete a namespace from your account. The ‘default’ namespace cannot be deleted. You will be prompted for confirmation unless the —yes flag is provided.

​
Usage

idyl namespace delete <name> [flags]

​
Flags

FlagDescription
-y, --yesSkip confirmation prompts

​
Examples

# Delete a namespace (with confirmation)
idyl namespace delete my-namespace

# Delete without confirmation
idyl ns delete my-namespace --yes

​
idyl namespace edit

Edit a namespace’s settings.

​
Usage

idyl namespace edit <name> [flags]

​
Flags

FlagDescription
-o <string>, --output <string>Output format: table, json, yaml Default: table.
--set-description <string>Set the namespace description

​
Examples

# Update description
idyl namespace edit my-namespace --set-description "New description"

​
idyl namespace get

Get details of a specific namespace, or list all namespaces in your account. With no arguments, lists all namespaces. With a name argument, gets details of that specific namespace.

​
Usage

idyl namespace get [name] [flags]

​
Aliases

  • list
  • ls

​
Flags

FlagDescription
--limit <int>Maximum number of namespaces to list Default: 20.
--offset <int>Number of namespaces to skip Default: 0.
-o <string>, --output <string>Output format: table, json, yaml Default: table.

​
Examples

# List namespaces
idyl namespace get

# Get namespace details
idyl namespace get my-namespace

# Get in JSON format
idyl ns get my-namespace -o json

​
idyl namespace show

Show details of the current namespace from the active context. Respects —namespace, —account-id, and —context flags.

​
Usage

idyl namespace show [flags]

​
Flags

FlagDescription
-o <string>, --output <string>Output format: table, json, yaml Default: table.

​
Examples

# Show current namespace details
idyl namespace show

# Show a specific namespace
idyl namespace show -n my-namespace

# Show current namespace in JSON format
idyl ns show -o json