Compartilhar via


az containerapp revision

Note

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

Comandos para gerenciar revisões.

Comandos

Nome Description Tipo Status
az containerapp revision activate

Ative uma revisão.

Core GA
az containerapp revision copy

Crie uma revisão com base em uma revisão anterior.

Core GA
az containerapp revision deactivate

Desative uma revisão.

Core GA
az containerapp revision label

Gerencie rótulos de revisão atribuídos a pesos de tráfego.

Núcleo e extensão GA
az containerapp revision label add

Defina um rótulo de revisão para uma revisão com um peso de tráfego associado.

Core GA
az containerapp revision label add (containerapp extensão)

Defina um rótulo de revisão para uma revisão com um peso de tráfego associado.

Extension GA
az containerapp revision label remove

Remova um rótulo de revisão de uma revisão com um peso de tráfego associado.

Core GA
az containerapp revision label remove (containerapp extensão)

Remova um rótulo de revisão de uma revisão com um peso de tráfego associado.

Extension GA
az containerapp revision label swap

Troque um rótulo de revisão entre duas revisões com pesos de tráfego associados.

Core GA
az containerapp revision list

Listar as revisões de um aplicativo de contêiner.

Core GA
az containerapp revision restart

Reinicie uma revisão.

Core GA
az containerapp revision set-mode

Defina o modo de revisão de um aplicativo de contêiner.

Core GA
az containerapp revision set-mode (containerapp extensão)

Defina o modo de revisão de um aplicativo de contêiner.

Extension GA
az containerapp revision show

Mostrar detalhes de uma revisão.

Core GA

az containerapp revision activate

Ative uma revisão.

az containerapp revision activate --revision
                                  [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

Exemplos

Ative uma revisão.

az containerapp revision activate -g MyResourceGroup --revision MyContainerappRevision

Parâmetros Exigidos

--revision

Nome da revisão.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

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

O nome do Containerapp. Um nome deve consistir em caracteres alfanuméricos minúsculos ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az containerapp revision copy

Crie uma revisão com base em uma revisão anterior.

az containerapp revision copy [--args]
                              [--command]
                              [--container-name]
                              [--cpu]
                              [--from-revision]
                              [--ids]
                              [--image]
                              [--max-replicas]
                              [--memory]
                              [--min-replicas]
                              [--name]
                              [--remove-all-env-vars]
                              [--remove-env-vars]
                              [--replace-env-vars]
                              [--resource-group]
                              [--revision-suffix]
                              [--scale-rule-auth --sra]
                              [--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc]
                              [--scale-rule-metadata --srm]
                              [--scale-rule-name --srn]
                              [--scale-rule-type --srt]
                              [--set-env-vars]
                              [--subscription]
                              [--tags]
                              [--workload-profile-name]
                              [--yaml]

Exemplos

Crie uma revisão com base em uma revisão anterior.

az containerapp revision copy -n my-containerapp -g MyResourceGroup --cpu 0.75 --memory 1.5Gi

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--args

Uma lista de argumentos de comando de inicialização do contêiner. Valores separados por espaço, por exemplo, "-c", "mycommand". Cadeia de caracteres vazia para limpar os valores existentes.

Propriedade Valor
Grupo de parâmetros: Container Arguments
--command

Uma lista de comandos com suporte no contêiner que serão executados durante a inicialização. Valores separados por espaço, por exemplo, "/bin/queue", "mycommand". Cadeia de caracteres vazia para limpar os valores existentes.

Propriedade Valor
Grupo de parâmetros: Container Arguments
--container-name

Nome do contêiner.

Propriedade Valor
Grupo de parâmetros: Container Arguments
--cpu

CPU necessária em núcleos de 0,25 a 2,0, por exemplo, 0,5.

Propriedade Valor
Grupo de parâmetros: Container Arguments
--from-revision

Revisão a ser copiada. Padrão: revisão mais recente.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--image -i

Imagem do contêiner, por exemplo, publisher/image-name:tag.

--max-replicas

O número máximo de réplicas.

Propriedade Valor
Grupo de parâmetros: Scale Arguments
--memory

Memória necessária de 0,5 a 4,0 terminando com "Gi", por exemplo, 1,0Gi.

Propriedade Valor
Grupo de parâmetros: Container Arguments
--min-replicas

O número mínimo de réplicas.

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

O nome do Containerapp. Um nome deve consistir em caracteres alfanuméricos minúsculos ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--remove-all-env-vars

Remova todas as variáveis de ambiente do contêiner.

Propriedade Valor
Grupo de parâmetros: Environment variables Arguments
Valor padrão: False
--remove-env-vars

Remova a(s) variável(is) de ambiente do contêiner. Nomes de variáveis de ambiente separados por espaço.

Propriedade Valor
Grupo de parâmetros: Environment variables Arguments
--replace-env-vars

Substitua a(s) variável(is) de ambiente no contêiner. Outras variáveis de ambiente existentes são removidas. Valores separados por espaço no formato 'key=value'. Se armazenado como um segredo, o valor deve começar com 'secretref:' seguido pelo nome do segredo.

Propriedade Valor
Grupo de parâmetros: Environment variables Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--revision-suffix

Sufixo amigável que é anexado ao nome da revisão.

Propriedade Valor
Grupo de parâmetros: Container Arguments
--scale-rule-auth --sra

Parâmetros de autenticação de regra de escala. Os parâmetros de autenticação devem estar no formato "{triggerParameter}={secretRef} {triggerParameter}={secretRef} ...".

Propriedade Valor
Grupo de parâmetros: Scale Arguments
--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

O número máximo de solicitações simultâneas antes da expansão. Com suporte apenas para regras de escala http e tcp.

Propriedade Valor
Grupo de parâmetros: Scale Arguments
--scale-rule-metadata --srm

Dimensionar metadados de regra. Os metadados devem estar no formato "{key}={value} {key}={value} ...".

Propriedade Valor
Grupo de parâmetros: Scale Arguments
--scale-rule-name --srn

O nome da regra de escala.

Propriedade Valor
Grupo de parâmetros: Scale Arguments
--scale-rule-type --srt

O tipo da regra de escala. Padrão: http. Para obter mais informações, visite https://learn.microsoft.com/azure/container-apps/scale-app#scale-triggers.

Propriedade Valor
Grupo de parâmetros: Scale Arguments
--set-env-vars

Adicione ou atualize variáveis de ambiente no contêiner. As variáveis de ambiente existentes não são modificadas. Valores separados por espaço no formato 'key=value'. Se armazenado como um segredo, o valor deve começar com 'secretref:' seguido pelo nome do segredo.

Propriedade Valor
Grupo de parâmetros: Environment variables Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--workload-profile-name -w

O nome amigável para o perfil de carga de trabalho.

--yaml

Caminho para um arquivo .yaml com a configuração de um aplicativo de contêiner. Todos os outros parâmetros serão ignorados. Para obter um exemplo, consulte https://learn.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az containerapp revision deactivate

Desative uma revisão.

az containerapp revision deactivate --revision
                                    [--ids]
                                    [--name]
                                    [--resource-group]
                                    [--subscription]

Exemplos

Desative uma revisão.

az containerapp revision deactivate -g MyResourceGroup --revision MyContainerappRevision

Parâmetros Exigidos

--revision

Nome da revisão.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

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

O nome do Containerapp. Um nome deve consistir em caracteres alfanuméricos minúsculos ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az containerapp revision list

Listar as revisões de um aplicativo de contêiner.

az containerapp revision list --name
                              --resource-group
                              [--all]

Exemplos

Listar as revisões de um aplicativo de contêiner.

az containerapp revision list -n my-containerapp -g MyResourceGroup

Parâmetros Exigidos

--name -n

O nome do Containerapp. Um nome deve consistir em caracteres alfanuméricos minúsculos ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

--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 se tornar obrigatórios para que o comando seja executado com sucesso.

--all

Mostrar revisões inativas.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az containerapp revision restart

Reinicie uma revisão.

az containerapp revision restart --revision
                                 [--ids]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]

Exemplos

Reinicie uma revisão.

az containerapp revision restart -n my-containerapp -g MyResourceGroup --revision MyContainerappRevision

Parâmetros Exigidos

--revision

Nome da revisão.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

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

O nome do Containerapp. Um nome deve consistir em caracteres alfanuméricos minúsculos ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az containerapp revision set-mode

Defina o modo de revisão de um aplicativo de contêiner.

az containerapp revision set-mode --mode {multiple, single}
                                  [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

Exemplos

Defina um aplicativo de contêiner para o modo de revisão única.

az containerapp revision set-mode -n my-containerapp -g MyResourceGroup --mode Single

Parâmetros Exigidos

--mode

O modo de revisões ativas para o aplicativo de contêiner.

Propriedade Valor
Valores aceitos: multiple, single

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

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

O nome do Containerapp. Um nome deve consistir em caracteres alfanuméricos minúsculos ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az containerapp revision set-mode (containerapp extensão)

Defina o modo de revisão de um aplicativo de contêiner.

az containerapp revision set-mode --mode {labels, multiple, single}
                                  [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]
                                  [--target-label]

Exemplos

Defina um aplicativo de contêiner para o modo de revisão única.

az containerapp revision set-mode -n my-containerapp -g MyResourceGroup --mode Single

Parâmetros Exigidos

--mode

O modo de revisões ativas para o aplicativo de contêiner.

Propriedade Valor
Valores aceitos: labels, multiple, single

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

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

O nome do Containerapp. Um nome deve consistir em caracteres alfanuméricos minúsculos ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--target-label
Versão Prévia

O rótulo a ser aplicado a novas revisões. Necessário para o modo de revisão 'rótulos'.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False

az containerapp revision show

Mostrar detalhes de uma revisão.

az containerapp revision show --revision
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Exemplos

Mostrar detalhes de uma revisão.

az containerapp revision show -n my-containerapp -g MyResourceGroup \
    --revision MyContainerappRevision

Parâmetros Exigidos

--revision

Nome da revisão.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

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

O nome do Containerapp. Um nome deve consistir em caracteres alfanuméricos minúsculos ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--verbose

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

Propriedade Valor
Valor padrão: False