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.

Manage namespaces within an AI Manager.

Commands

Name Description Type Status
az aimanager namespace add

Add a namespace to an AI Manager.

Extension GA
az aimanager namespace delete

Delete a namespace within an AI Manager.

Extension GA
az aimanager namespace get-credentials

Get access credentials for an AI Manager namespace.

Extension GA
az aimanager namespace list

List the namespaces within an AI Manager.

Extension GA
az aimanager namespace list-accesskeys

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

Extension GA
az aimanager namespace modeldeployment

Manage model deployments within an AI Manager namespace.

Extension GA
az aimanager namespace modeldeployment add

Add a model deployment to an AI Manager namespace.

Extension GA
az aimanager namespace modeldeployment delete

Delete a model deployment from an AI Manager namespace.

Extension GA
az aimanager namespace modeldeployment list

List model deployments within an AI Manager namespace.

Extension GA
az aimanager namespace modeldeployment show

Show a model deployment within an AI Manager namespace.

Extension GA
az aimanager namespace modeldeployment update

Update a model deployment within an AI Manager namespace.

Extension GA
az aimanager namespace modeldeployment wait

Wait for an AI Manager model deployment to reach a desired state.

Extension GA
az aimanager namespace rotate-accesskeys

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

Extension GA
az aimanager namespace show

Show the details of a namespace within an AI Manager.

Extension GA
az aimanager namespace update

Update a namespace within an AI Manager.

Extension GA
az aimanager namespace wait

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

Extension GA

az aimanager namespace add

Add a namespace to an AI Manager.

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

Examples

Add a namespace

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

Add a namespace with labels and annotations

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

Required Parameters

--aimanager-name --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
--aks-custom-headers

Comma-separated key=value pairs to specify custom headers.

--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
--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

Delete a namespace within an AI Manager.

az aimanager namespace delete --aimanager-name --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-name --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

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-name --manager
                                       --name
                                       --resource-group
                                       [--acquire-policy-token]
                                       [--aks-custom-headers]
                                       [--change-reference]
                                       [--context-name]
                                       [--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-name --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
--aks-custom-headers

Comma-separated key=value pairs to specify custom headers.

--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.

--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

List the namespaces within an AI Manager.

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

Examples

List namespaces in an AI Manager

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

Required Parameters

--aimanager-name --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

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-name --manager
                                       --name
                                       --resource-group
                                       [--acquire-policy-token]
                                       [--aks-custom-headers]
                                       [--change-reference]

Examples

List the access keys of a namespace

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

Show only the gateway endpoint

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

Required Parameters

--aimanager-name --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
--aks-custom-headers

Comma-separated key=value pairs to specify custom headers.

--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
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

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-name --manager
                                         --name
                                         --resource-group
                                         [--acquire-policy-token]
                                         [--aks-custom-headers]
                                         [--change-reference]
                                         [--yes]

Examples

Rotate the access keys of a namespace

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

Required Parameters

--aimanager-name --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
--aks-custom-headers

Comma-separated key=value pairs to specify custom headers.

--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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

Show the details of a namespace within an AI Manager.

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

Examples

Show a namespace

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

Required Parameters

--aimanager-name --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

Update a namespace within an AI Manager.

az aimanager namespace update --aimanager-name --manager
                              --name
                              --resource-group
                              [--acquire-policy-token]
                              [--aks-custom-headers]
                              [--annotations]
                              [--change-reference]
                              [--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-name --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
--aks-custom-headers

Comma-separated key=value pairs to specify custom headers.

--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
--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

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

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

Required Parameters

--aimanager-name --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