az cognitiveservices account adapter-deployment

Preview

This command group is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Manage LoRA adapter deployments for Azure Cognitive Services accounts.

An adapter deployment is a lightweight LoRA weight patch that attaches to an existing managed compute (parent) deployment. It owns no SKU, capacity, base model, or runtime

all inference resources come from the parent managed compute deployment referenced by --target-deployment-name.

Commands

Name	Description	Type	Status
az cognitiveservices account adapter-deployment create	Create (or replace / re-target) a LoRA adapter deployment attached to a managed compute deployment.	Core	Preview
az cognitiveservices account adapter-deployment delete	Delete an adapter deployment from Azure Cognitive Services account.	Core	Preview
az cognitiveservices account adapter-deployment list	List all adapter deployments for Azure Cognitive Services account.	Core	Preview
az cognitiveservices account adapter-deployment show	Show an adapter deployment for Azure Cognitive Services account.	Core	Preview

az cognitiveservices account adapter-deployment create

Edit

Preview

Command group 'cognitiveservices account adapter-deployment' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Create (or replace / re-target) a LoRA adapter deployment attached to a managed compute deployment.

The adapter must reference a protected Foundry fine-tuning LoRA output as its source model. The target deployment is the name of an existing managed compute deployment in the same account. Re-issuing create with the same adapter name and a different --target-deployment-name re-targets the adapter; --source-model-id is immutable.

az cognitiveservices account adapter-deployment create --adapter-deployment-name --adapter-name
                                                       --name
                                                       --resource-group
                                                       --source-model-id
                                                       --target-deployment-name
                                                       [--acquire-policy-token]
                                                       [--change-reference]

Examples

Create an adapter deployment attached to an existing managed compute deployment.

az cognitiveservices account adapter-deployment create -g myResourceGroup -n myAccount --adapter-deployment-name my-lora-adapter --source-model-id "azureai://accounts/myAccount/projects/myProject/models/my-fine-tuned-lora/versions/1" --target-deployment-name gpt-oss-120b-gpu

Required Parameters

--adapter-deployment-name --adapter-name

Adapter deployment name.

--name -n

Cognitive service account name.

--resource-group -g

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

--source-model-id

Immutable Foundry fine-tuning LoRA output model URI (e.g., azureai://accounts/{account}/projects/{project}/models/{model}/versions/{version}).

--target-deployment-name

Name of the existing managed compute parent deployment (resolved within the same account) that will serve this adapter. Re-specify to re-target an existing adapter deployment.

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

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 cognitiveservices account adapter-deployment delete

Edit

Preview

Command group 'cognitiveservices account adapter-deployment' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Delete an adapter deployment from Azure Cognitive Services account.

az cognitiveservices account adapter-deployment delete --adapter-deployment-name --adapter-name
                                                       --name
                                                       --resource-group
                                                       [--acquire-policy-token]
                                                       [--change-reference]

Examples

Delete an adapter deployment.

az cognitiveservices account adapter-deployment delete -g myResourceGroup -n myAccount --adapter-deployment-name my-lora-adapter

Required Parameters

--adapter-deployment-name --adapter-name

Adapter deployment name.

--name -n

Cognitive service account name.

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

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 cognitiveservices account adapter-deployment list

Edit

Preview

Command group 'cognitiveservices account adapter-deployment' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List all adapter deployments for Azure Cognitive Services account.

az cognitiveservices account adapter-deployment list --name
                                                     --resource-group

Examples

List all adapter deployments.

az cognitiveservices account adapter-deployment list -g myResourceGroup -n myAccount

Required Parameters

--name -n

Cognitive service account name.

--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 cognitiveservices account adapter-deployment show

Edit

Preview

Command group 'cognitiveservices account adapter-deployment' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Show an adapter deployment for Azure Cognitive Services account.

az cognitiveservices account adapter-deployment show --adapter-deployment-name --adapter-name
                                                     --name
                                                     --resource-group

Examples

Show an adapter deployment.

az cognitiveservices account adapter-deployment show -g myResourceGroup -n myAccount --adapter-deployment-name my-lora-adapter

Required Parameters

--adapter-deployment-name --adapter-name

Adapter deployment name.

--name -n

Cognitive service account name.

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

Feedback

Was this page helpful?