idyl namespace - IDYL Docs

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

Command	Description
`idyl namespace create`	Create a new namespace
`idyl namespace delete`	Delete a namespace
`idyl namespace edit`	Edit a namespace
`idyl namespace get`	Get namespace details or list all namespaces
`idyl namespace show`	Show current namespace details

Inherited flags

Flag	Description
`-a <string>, --account-id <string>`	Account ID to use, overriding the current context.
`-c <string>, --context <string>`	Use the named context for this command.
`--homedir <string>`	Override the configuration directory. Defaults to ~/.config/idyl.
`-n <string>, --namespace <string>`	Namespace to use for this command.
`-o <string>, --output <string>`	Output format (json\|yaml).
`-p <string>, --profile <string>`	Override the access profile for this command.
`--realm <string>`	Override the realm for this command.
`--subnet <string>`	Override the 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

Flag	Description
`--description <string>`	Description of the namespace.
`-o <string>, --output <string>`	Output format: table, json, or 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

Flag	Description
`-y, --yes`	Skip 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

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, or 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

Flag	Description
`--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, or 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

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, or 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

​Usage

​Aliases

​Commands

​Inherited flags

​Examples

​Subcommand reference

​idyl namespace create

​Usage

​Flags

​Examples

​idyl namespace delete

​Usage

​Flags

​Examples

​idyl namespace edit

​Usage

​Flags

​Examples

​idyl namespace get

​Usage

​Aliases

​Flags

​Examples

​idyl namespace show

​Usage

​Flags

​Examples

Usage

Aliases

Commands

Inherited flags

Examples

Subcommand reference

`idyl namespace create`

Usage

Flags

Examples

`idyl namespace delete`

Usage

Flags

Examples

`idyl namespace edit`

Usage

Flags

Examples

`idyl namespace get`

Usage

Aliases

Flags

Examples

`idyl namespace show`

Usage

Flags

Examples