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
The name of the AI Manager resource.
The name of the AI Manager namespace.
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Comma-separated key=value pairs to specify custom headers.
Space-separated annotations (key=value) applied to the Kubernetes namespace.
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Space-separated labels (key=value) applied to the Kubernetes namespace.
Do not wait for the long-running operation to finish.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
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
The name of the AI Manager resource.
The name of the AI Manager namespace.
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Do not wait for the long-running operation to finish.
| Property | Value |
|---|---|
| Default value: | False |
Do not prompt for confirmation.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
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
The name of the AI Manager resource.
The name of the AI Manager namespace.
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Comma-separated key=value pairs to specify custom headers.
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
If specified, overwrite the default context name.
Kubernetes configuration file to update. Use "-" to print YAML to stdout instead.
| Property | Value |
|---|---|
| Default value: | ~\.kube\config |
Overwrite any existing cluster entry with the same name.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
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
The name of the AI Manager resource.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
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
The name of the AI Manager resource.
The name of the AI Manager namespace.
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Comma-separated key=value pairs to specify custom headers.
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
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
The name of the AI Manager resource.
The name of the AI Manager namespace.
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Comma-separated key=value pairs to specify custom headers.
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Do not prompt for confirmation.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
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
The name of the AI Manager resource.
The name of the AI Manager namespace.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
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
The name of the AI Manager resource.
The name of the AI Manager namespace.
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Comma-separated key=value pairs to specify custom headers.
Space-separated annotations (key=value) applied to the Kubernetes namespace.
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Space-separated labels (key=value) applied to the Kubernetes namespace.
Do not wait for the long-running operation to finish.
| Property | Value |
|---|---|
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
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
The name of the AI Manager resource.
The name of the AI Manager namespace.
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Wait until created with 'provisioningState' at 'Succeeded'.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
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 |
Wait until deleted.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
Wait until the resource exists.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
Polling interval in seconds.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | 30 |
Maximum wait in seconds.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | 3600 |
Wait until updated with provisioningState at 'Succeeded'.
| Property | Value |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |