az cognitiveservices account deployment

Note

Este grupo de comandos tem comandos definidos tanto no CLI do Azure como em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerir implementações para contas Azure Cognitive Services.

Comandos

Nome Descrição Tipo Estado
az cognitiveservices account deployment create

Crie uma implementação para a conta Azure Cognitive Services.

 Core disponibilidade geral
az cognitiveservices account deployment create (foundry-cost-control extensão)

Crie uma implementação de conta de Serviços Cognitivos.

 Extension Preview
az cognitiveservices account deployment delete

Apagar uma implementação da conta Azure Cognitive Services.

 Core disponibilidade geral
az cognitiveservices account deployment list

Mostrar todas as implementações para a conta Azure Cognitive Services.

 Core disponibilidade geral
az cognitiveservices account deployment show

Mostrar uma implementação para a conta Azure Cognitive Services.

 Core disponibilidade geral
az cognitiveservices account deployment update

Atualize a implementação de uma conta de Serviços Cognitivos.

 Extension Preview

az cognitiveservices account deployment create

Editar

Crie uma implementação para a conta Azure Cognitive Services.

Este artigo lista apenas os comandos CLI do Azure para gestão de contas e subscrições do Azure Cognitive Services. Consulte a documentação em https://learn.microsoft.com/azure/cognitive-services/ para serviços individuais para saber como usar as APIs e SDKs suportados.

az cognitiveservices account deployment create --model-format
                                               --model-name
                                               --model-version
                                               --name
                                               --resource-group
                                               [--acquire-policy-token]
                                               [--capacity --sku-capacity]
                                               [--change-reference]
                                               [--deployment-name]
                                               [--model-source]
                                               [--scale-capacity --scale-settings-capacity]
                                               [--scale-settings-scale-type --scale-type {Manual, Standard}]
                                               [--sku --sku-name]
                                               [--spillover-deployment-name --spillover-name]

Exemplos

Crie uma implementação para a conta Azure Cognitive Services.

az cognitiveservices account deployment create -g yuanyang-test-sdk -n yytest-oai --deployment-name dpy --model-name ada --model-version "1" --model-format OpenAI --sku-capacity 1 --sku-name "Standard"

Parâmetros Obrigatórios

--model-format

Formato do modelo de implantação de conta dos Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentModel Arguments
--model-name

Nome do modelo de implantação da conta dos Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentModel Arguments
--model-version

Versão do modelo de implantação de conta dos Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentModel Arguments
--name -n

Nome da conta do serviço cognitivo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--capacity --sku-capacity

Valor de capacidade da conta/implantação de Sku de Serviços Cognitivos.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--deployment-name

Nome de implantação da conta dos Serviços Cognitivos.

--model-source

Origem do modelo de implantação de conta dos Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentModel Arguments
--scale-capacity --scale-settings-capacity

Capacidade de configurações de escala de implantação de conta de Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentScaleSettings Arguments
--scale-settings-scale-type --scale-type

Tipo de escala de configurações de escala de implantação de conta de Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentScaleSettings Arguments
Valores aceites: Manual, Standard
--sku --sku-name

Nome da conta/implantação do Sku dos Serviços Cognitivos.

--spillover-deployment-name --spillover-name

O nome da implementação padrão para usar como efeito de spillover quando estiver cheio.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az cognitiveservices account deployment create (foundry-cost-control extensão)

Pré-visualizar

O grupo de comando 'az cognitiveservices' está em fase de pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie uma implementação de conta de Serviços Cognitivos.

az cognitiveservices account deployment create --deployment-name
                                               --model-format
                                               --model-name
                                               --model-version
                                               --name
                                               --resource-group
                                               [--acquire-policy-token]
                                               [--capacity --sku-capacity]
                                               [--change-reference]
                                               [--cost-control-ids]
                                               [--model-source]
                                               [--scale-capacity --scale-settings-capacity]
                                               [--scale-settings-scale-type --scale-type {Manual, Standard}]
                                               [--sku --sku-name]
                                               [--spillover-deployment-name --spillover-name]

Exemplos

Crie uma implementação com um anexo de controlo de custos

az cognitiveservices account deployment create --name my-account --resource-group my-resource-group --deployment-name my-deployment --model-name gpt-4.1 --model-version 2025-04-14 --model-format OpenAI --sku-name GlobalStandard --sku-capacity 10 --cost-control-ids /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.CognitiveServices/accounts/my-account/costControls/my-control

Parâmetros Obrigatórios

--deployment-name

Nome de implantação da conta dos Serviços Cognitivos.

--model-format

Formato do modelo de implantação de conta dos Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentModel Arguments
--model-name

Nome do modelo de implantação da conta dos Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentModel Arguments
--model-version

Versão do modelo de implantação de conta dos Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentModel Arguments
--name -n

Nome da conta do serviço cognitivo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--capacity --sku-capacity

Valor de capacidade da conta/implantação de Sku de Serviços Cognitivos.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--cost-control-ids

ID de recurso do controlo de custos associado à implementação. Especifique a opção sem valor para remover o anexo.

Propriedade Valor
Grupo de parâmetros: Cost Control Arguments
--model-source

Origem do modelo de implantação de conta dos Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentModel Arguments
--scale-capacity --scale-settings-capacity

Capacidade de configurações de escala de implantação de conta de Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentScaleSettings Arguments
--scale-settings-scale-type --scale-type

Tipo de escala de configurações de escala de implantação de conta de Serviços Cognitivos.

Propriedade Valor
Grupo de parâmetros: DeploymentScaleSettings Arguments
Valores aceites: Manual, Standard
--sku --sku-name

Nome da conta/implantação do Sku dos Serviços Cognitivos.

--spillover-deployment-name --spillover-name

A implementação padrão para usar como efeito de spillover quando estiver cheio.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az cognitiveservices account deployment delete

Editar

Apagar uma implementação da conta Azure Cognitive Services.

Este artigo lista apenas os comandos CLI do Azure para gestão de contas e subscrições do Azure Cognitive Services. Consulte a documentação em https://learn.microsoft.com/azure/cognitive-services/ para serviços individuais para saber como usar as APIs e SDKs suportados.

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

Exemplos

Apagar uma implementação da conta Azure Cognitive Services.

az cognitiveservices account deployment delete -g yuanyang-test-sdk -n yytest-oai --deployment-name dpy

Parâmetros Obrigatórios

--name -n

Nome da conta do serviço cognitivo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--deployment-name

Nome de implantação da conta dos Serviços Cognitivos.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az cognitiveservices account deployment list

Editar

Mostrar todas as implementações para a conta Azure Cognitive Services.

Este artigo lista apenas os comandos CLI do Azure para gestão de contas e subscrições do Azure Cognitive Services. Consulte a documentação em https://learn.microsoft.com/azure/cognitive-services/ para serviços individuais para saber como usar as APIs e SDKs suportados.

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

Exemplos

Mostrar todas as implementações para a conta Azure Cognitive Services.

az cognitiveservices account deployment list -g yuanyang-test-sdk -n yytest-oai

Parâmetros Obrigatórios

--name -n

Nome da conta do serviço cognitivo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az cognitiveservices account deployment show

Editar

Mostrar uma implementação para a conta Azure Cognitive Services.

Este artigo lista apenas os comandos CLI do Azure para gestão de contas e subscrições do Azure Cognitive Services. Consulte a documentação em https://learn.microsoft.com/azure/cognitive-services/ para serviços individuais para saber como usar as APIs e SDKs suportados.

az cognitiveservices account deployment show --name
                                             --resource-group
                                             [--deployment-name]

Exemplos

Mostrar uma implementação para a conta Azure Cognitive Services.

az cognitiveservices account deployment show -g yuanyang-test-sdk -n yytest-oai --deployment-name dpy

Parâmetros Obrigatórios

--name -n

Nome da conta do serviço cognitivo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--deployment-name

Nome de implantação da conta dos Serviços Cognitivos.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az cognitiveservices account deployment update

Pré-visualizar

O grupo de comando 'az cognitiveservices' está em fase de pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Atualize a implementação de uma conta de Serviços Cognitivos.

az cognitiveservices account deployment update --deployment-name
                                               --name
                                               --resource-group
                                               [--acquire-policy-token]
                                               [--change-reference]
                                               [--cost-control-ids]

Exemplos

Anexar um controlo de custos a uma implementação existente

az cognitiveservices account deployment update --name my-account --resource-group my-resource-group --deployment-name my-deployment --cost-control-ids /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.CognitiveServices/accounts/my-account/costControls/my-control

Remover o anexo de controlo de custos

az cognitiveservices account deployment update --name my-account --resource-group my-resource-group --deployment-name my-deployment --cost-control-ids

Parâmetros Obrigatórios

--deployment-name

Nome de implantação da conta dos Serviços Cognitivos.

--name -n

Nome da conta do serviço cognitivo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--cost-control-ids

ID de recurso do controlo de custos associado à implementação. Especifique a opção sem valor para remover o anexo.

Propriedade Valor
Grupo de parâmetros: Cost Control Arguments
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False