az aimanager namespace

Note

This reference is part of the aimanager extension for the Azure CLI (version 2.61.0 or higher). The extension will automatically install the first time you run an az aimanager namespace command. Learn more about extensions.

Command group 'aimanager' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Manage namespaces within an AI Manager.

Commands

Name	Description	Type	Status
az aimanager namespace create	Create a namespace in an AI Manager.	Extension	Preview
az aimanager namespace delete	Delete a namespace within an AI Manager.	Extension	Preview
az aimanager namespace get-credentials	Get access credentials for an AI Manager namespace.	Extension	Preview
az aimanager namespace list	List the namespaces within an AI Manager.	Extension	Preview
az aimanager namespace list-accesskeys	List the LLM gateway endpoint and API keys of an AI Manager namespace.	Extension	Preview
az aimanager namespace modeldeployment	Manage model deployments within an AI Manager namespace.	Extension	Preview
az aimanager namespace modeldeployment create	Create a model deployment in an AI Manager namespace.	Extension	Preview
az aimanager namespace modeldeployment delete	Delete a model deployment from an AI Manager namespace.	Extension	Preview
az aimanager namespace modeldeployment list	List model deployments within an AI Manager namespace.	Extension	Preview
az aimanager namespace modeldeployment show	Show a model deployment within an AI Manager namespace.	Extension	Preview
az aimanager namespace modeldeployment update	Update a model deployment within an AI Manager namespace.	Extension	Preview
az aimanager namespace modeldeployment wait	Wait for an AI Manager model deployment to reach a desired state.	Extension	Preview
az aimanager namespace rotate-accesskeys	Rotate the LLM gateway API keys of an AI Manager namespace.	Extension	Preview
az aimanager namespace show	Show the details of a namespace within an AI Manager.	Extension	Preview
az aimanager namespace update	Update a namespace within an AI Manager.	Extension	Preview
az aimanager namespace wait	Wait for an AI Manager namespace to reach a desired state.	Extension	Preview

az aimanager namespace create

Preview

Command group 'aimanager namespace' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Create a namespace in an AI Manager.

This command is idempotent: running it again with the same name updates the namespace and returns it, rather than failing because it already exists. Once creation succeeds the caller is granted the built-in 'Azure AIManager Contributor' and 'Azure AIManager RBAC Reader' roles on the new namespace (best-effort; requires Owner or User Access Administrator). Skipped with --no-wait.

az aimanager namespace create --aimanager --manager
                              --name
                              --resource-group
                              [--acquire-policy-token]
                              [--annotations]
                              [--change-reference]
                              [--custom-headers]
                              [--labels]
                              [--no-wait]

Examples

Create a namespace

az aimanager namespace create -m my-ai-manager -g myrg --name team-alpha

Create a namespace with labels and annotations

az aimanager namespace create -m my-ai-manager -g myrg --name team-alpha --labels team=alpha --annotations owner=alice

Required Parameters

--aimanager --manager -m

The name of the AI Manager resource.

--name -n

The name of the AI Manager namespace.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--annotations

Space-separated annotations (key=value) applied to the Kubernetes namespace.

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--custom-headers

Comma-separated key=value pairs to specify custom headers, this is mainly for internal testing.

--labels

Space-separated labels (key=value) applied to the Kubernetes namespace.

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az aimanager namespace delete

Preview

Command group 'aimanager namespace' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Delete a namespace within an AI Manager.

az aimanager namespace delete --aimanager --manager
                              --name
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]
                              [--no-wait]
                              [--yes]

Examples

Delete a namespace

az aimanager namespace delete -m my-ai-manager -g myrg --name team-alpha

Required Parameters

--aimanager --manager -m

The name of the AI Manager resource.

--name -n

The name of the AI Manager namespace.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--yes -y

Do not prompt for confirmation.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az aimanager namespace get-credentials

Preview

Command group 'aimanager namespace' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get access credentials for an AI Manager namespace.

Retrieves the Kubernetes configuration for an AI Manager namespace and merges it into the local kubeconfig file (default ~/.kube/config), similar to 'az aks namespace get-credentials'.

az aimanager namespace get-credentials --aimanager --manager
                                       --name
                                       --resource-group
                                       [--acquire-policy-token]
                                       [--change-reference]
                                       [--context-name]
                                       [--custom-headers]
                                       [--file]
                                       [--overwrite-existing]

Examples

Get the credentials for a namespace and merge into the default kubeconfig

az aimanager namespace get-credentials -m my-ai-manager -g myrg --name team-alpha

Print the credentials to stdout

az aimanager namespace get-credentials -m my-ai-manager -g myrg --name team-alpha -f -

Required Parameters

--aimanager --manager -m

The name of the AI Manager resource.

--name -n

The name of the AI Manager namespace.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--context-name

If specified, overwrite the default context name.

--custom-headers

Comma-separated key=value pairs to specify custom headers, this is mainly for internal testing.

--file -f

Kubernetes configuration file to update. Use "-" to print YAML to stdout instead.

Property	Value
Default value:	~\.kube\config

--overwrite-existing

Overwrite any existing cluster entry with the same name.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az aimanager namespace list

Preview

Command group 'aimanager namespace' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List the namespaces within an AI Manager.

az aimanager namespace list --aimanager --manager
                            --resource-group

Examples

List namespaces in an AI Manager

az aimanager namespace list -m my-ai-manager -g myrg

Required Parameters

--aimanager --manager -m

The name of the AI Manager resource.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az aimanager namespace list-accesskeys

Preview

Command group 'aimanager namespace' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List the LLM gateway endpoint and API keys of an AI Manager namespace.

Returns the namespace-scoped, OpenAI-compatible inference gateway endpoint together with the current primary and secondary API keys. Treat the keys as secrets: do not log them or persist them in plaintext.

az aimanager namespace list-accesskeys --aimanager --manager
                                       --name
                                       --resource-group
                                       [--acquire-policy-token]
                                       [--change-reference]
                                       [--custom-headers]

Examples

List the access keys of a namespace

az aimanager namespace list-accesskeys -g myrg --aimanager my-ai-manager --name team-alpha

Show only the gateway endpoint

az aimanager namespace list-accesskeys -g myrg --aimanager my-ai-manager --name team-alpha --query endpoint -o tsv

Required Parameters

--aimanager --manager -m

The name of the AI Manager resource.

--name -n

The name of the AI Manager namespace.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--custom-headers

Comma-separated key=value pairs to specify custom headers, this is mainly for internal testing.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az aimanager namespace rotate-accesskeys

Preview

Command group 'aimanager namespace' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Rotate the LLM gateway API keys of an AI Manager namespace.

A new key is generated and installed as the primary key, and the previous primary key overwrites the secondary key so clients can roll over without downtime. Returns the updated access info. Any client still using the previous secondary key will stop being able to authenticate.

az aimanager namespace rotate-accesskeys --aimanager --manager
                                         --name
                                         --resource-group
                                         [--acquire-policy-token]
                                         [--change-reference]
                                         [--custom-headers]
                                         [--yes]

Examples

Rotate the access keys of a namespace

az aimanager namespace rotate-accesskeys -g myrg --aimanager my-ai-manager --name team-alpha

Required Parameters

--aimanager --manager -m

The name of the AI Manager resource.

--name -n

The name of the AI Manager namespace.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--custom-headers

Comma-separated key=value pairs to specify custom headers, this is mainly for internal testing.

--yes -y

Do not prompt for confirmation.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az aimanager namespace show

Preview

Command group 'aimanager namespace' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Show the details of a namespace within an AI Manager.

az aimanager namespace show --aimanager --manager
                            --name
                            --resource-group

Examples

Show a namespace

az aimanager namespace show -m my-ai-manager -g myrg --name team-alpha

Required Parameters

--aimanager --manager -m

The name of the AI Manager resource.

--name -n

The name of the AI Manager namespace.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az aimanager namespace update

Preview

Command group 'aimanager namespace' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Update a namespace within an AI Manager.

az aimanager namespace update --aimanager --manager
                              --name
                              --resource-group
                              [--acquire-policy-token]
                              [--annotations]
                              [--change-reference]
                              [--custom-headers]
                              [--labels]
                              [--no-wait]

Examples

Update the labels of a namespace

az aimanager namespace update -m my-ai-manager -g myrg --name team-alpha --labels team=beta

Required Parameters

--aimanager --manager -m

The name of the AI Manager resource.

--name -n

The name of the AI Manager namespace.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--annotations

Space-separated annotations (key=value) applied to the Kubernetes namespace.

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--custom-headers

Comma-separated key=value pairs to specify custom headers, this is mainly for internal testing.

--labels

Space-separated labels (key=value) applied to the Kubernetes namespace.

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az aimanager namespace wait

Preview

Command group 'aimanager namespace' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Wait for an AI Manager namespace to reach a desired state.

az aimanager namespace wait --aimanager --manager
                            --name
                            --resource-group
                            [--acquire-policy-token]
                            [--change-reference]
                            [--created]
                            [--custom]
                            [--deleted]
                            [--exists]
                            [--interval]
                            [--timeout]
                            [--updated]

Required Parameters

--aimanager --manager -m

The name of the AI Manager resource.

--name -n

The name of the AI Manager namespace.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--created

Wait until created with 'provisioningState' at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Property	Value
Parameter group:	Wait Condition Arguments

--deleted

Wait until deleted.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--exists

Wait until the resource exists.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--interval

Polling interval in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	30

--timeout

Maximum wait in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False