Compartilhar via


az devcenter dev environment

Note

Essa referência faz parte da extensão de devcenter para a CLI do Azure (versão 2.67.0 ou superior). A extensão instalará automaticamente a primeira vez que você executar um comando ambiente de desenvolvimento do az devcenter comando. Saiba mais sobre extensões.

Gerenciar ambientes.

Comandos

Nome Description Tipo Status
az devcenter dev environment create

Criar um ambiente.

Extension GA
az devcenter dev environment delay-action

Atrase uma ação de ambiente.

Extension GA
az devcenter dev environment delete

Exclua um ambiente e todos os seus recursos associados.

Extension GA
az devcenter dev environment deploy

Atualize um ambiente.

Extension GA
az devcenter dev environment list

Liste os ambientes de um projeto ou liste os ambientes de um usuário em um projeto.

Extension GA
az devcenter dev environment list-action

Listar ações de ambiente específicas.

Extension GA
az devcenter dev environment list-operation

Lista as operações no ambiente que ocorreram nos últimos 90 dias.

Extension GA
az devcenter dev environment show

Obtenha um ambiente.

Extension GA
az devcenter dev environment show-action

Recupere uma ação de ambiente específica.

Extension GA
az devcenter dev environment show-logs-by-operation

Obtém os logs de uma operação em um ambiente.

Extension GA
az devcenter dev environment show-operation

Obtém um resultado de ação de ambiente.

Extension GA
az devcenter dev environment show-outputs

Obtém saídas do ambiente.

Extension GA
az devcenter dev environment skip-action

Ignorar uma ação de ambiente específica.

Extension GA
az devcenter dev environment update

Atualize um ambiente.

Extension GA
az devcenter dev environment update-expiration-date

Atualize a expiração do ambiente.

Extension GA

az devcenter dev environment create

Criar um ambiente.

az devcenter dev environment create --catalog-name
                                    --environment-definition-name
                                    --environment-name --name
                                    --environment-type
                                    --project --project-name
                                    [--dev-center --dev-center-name]
                                    [--endpoint]
                                    [--expiration --expiration-date]
                                    [--no-wait]
                                    [--parameters]
                                    [--user-id]

Exemplos

Criar usando o centro de desenvolvimento

az devcenter dev environment create --dev-center-name "ContosoDevCenter" --project-name "DevProject" --catalog-name "main" --environment-definition-name "helloworld" --environment-type "DevTest" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000"

Criar usando o ponto de extremidade

az devcenter dev environment create --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --catalog-name "main" --environment-definition-name "helloworld" --environment-type "DevTest" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--catalog-name

Nome do catálogo.

--environment-definition-name -e

Nome da definição de ambiente.

--environment-name --name -n

O nome do ambiente.

--environment-type

Tipo de ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--expiration --expiration-date

A hora em que a data de validade será disparada (UTC), após a qual o ambiente e os recursos associados serão excluídos. O formato de cadeia de caracteres é o formato ISO.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--parameters

Objeto Parameters para o ambiente. Valor esperado: json-string/json-file/@json-file.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment delay-action

Atrase uma ação de ambiente.

az devcenter dev environment delay-action --action-name
                                          --delay-time
                                          --environment-name --name
                                          --project --project-name
                                          [--dev-center --dev-center-name]
                                          [--endpoint]
                                          [--user-id]

Exemplos

Atraso ao usar o centro de desenvolvimento

az devcenter dev environment delay-action --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --action-name "myEnv-Delete" --delay-time "04:30"

Atraso no uso do ponto de extremidade

az devcenter dev environment delay-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --action-name "myEnv-Delete" --delay-time "04:30"

Parâmetros Exigidos

--action-name

O nome de uma ação que ocorrerá em um ambiente.

--delay-time

O tempo limite atrasado da hora de ação agendada. Formatar HH:MM.

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment delete

Exclua um ambiente e todos os seus recursos associados.

az devcenter dev environment delete --environment-name --name
                                    --project --project-name
                                    [--dev-center --dev-center-name]
                                    [--endpoint]
                                    [--force {false, true}]
                                    [--no-wait]
                                    [--user-id]
                                    [--yes]

Exemplos

Excluir usando o centro de desenvolvimento

az devcenter dev environment delete --dev-center-name "ContosoDevCenter"  --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Excluir usando o ponto de extremidade

az devcenter dev environment delete --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--force

Opcional para forçar a exclusão de ambiente mesmo que a definição de ambiente não exista. Essa é uma exclusão de melhor esforço e qualquer coisa personalizada que force a criação de recursos além do grupo de recursos associado pode não ser excluída.

Propriedade Valor
Valores aceitos: false, true
--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
--yes -y

Não solicite confirmação.

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 devcenter dev environment deploy

Atualize um ambiente.

az devcenter dev environment deploy --environment-name --name
                                    --project --project-name
                                    [--dev-center --dev-center-name]
                                    [--endpoint]
                                    [--expiration --expiration-date]
                                    [--no-wait]
                                    [--parameters]
                                    [--user-id]

Exemplos

Atualizar usando o centro de desenvolvimento

az devcenter dev environment deploy --dev-center-name "ContosoDevCenter" --project-name "DevProject" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}"

Atualizar usando o ponto de extremidade

az devcenter dev environment deploy --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--expiration --expiration-date

A data de expiração do ambiente. Deve ser uma cadeia de caracteres ISO.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--parameters

Objeto Parameters para o ambiente. Valor esperado: json-string/json-file/@json-file.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment list

Liste os ambientes de um projeto ou liste os ambientes de um usuário em um projeto.

az devcenter dev environment list --project --project-name
                                  [--dev-center --dev-center-name]
                                  [--endpoint]
                                  [--user-id]

Exemplos

Listar por projeto usando o centro de desenvolvimento

az devcenter dev environment list --dev-center-name "ContosoDevCenter" --project-name "DevProject"

Listar por projeto usando o ponto de extremidade

az devcenter dev environment list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject"

Listar por usuário e projeto usando o centro de desenvolvimento

az devcenter dev environment list --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Listar por usuário e projeto usando o ponto de extremidade

az devcenter dev environment list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

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 devcenter dev environment list-action

Listar ações de ambiente específicas.

az devcenter dev environment list-action --environment-name --name
                                         --project --project-name
                                         [--dev-center --dev-center-name]
                                         [--endpoint]
                                         [--user-id]

Exemplos

Listar usando o centro de desenvolvimento

az devcenter dev environment list-action --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Listar usando o ponto de extremidade

az devcenter dev environment list-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment list-operation

Lista as operações no ambiente que ocorreram nos últimos 90 dias.

az devcenter dev environment list-operation --environment-name --name
                                            --project --project-name
                                            [--dev-center --dev-center-name]
                                            [--endpoint]
                                            [--user-id]

Exemplos

Listar usando o centro de desenvolvimento

az devcenter dev environment list-operation --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Listar usando o ponto de extremidade

az devcenter dev environment list-operation --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment show

Obtenha um ambiente.

az devcenter dev environment show --environment-name --name
                                  --project --project-name
                                  [--dev-center --dev-center-name]
                                  [--endpoint]
                                  [--user-id]

Exemplos

Obter usando o centro de desenvolvimento

az devcenter dev environment show --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Usar o ponto de extremidade

az devcenter dev environment show --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment show-action

Recupere uma ação de ambiente específica.

az devcenter dev environment show-action --action-name
                                         --environment-name --name
                                         --project --project-name
                                         [--dev-center --dev-center-name]
                                         [--endpoint]
                                         [--user-id]

Exemplos

Obter usando o centro de desenvolvimento

az devcenter dev environment show-action --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --action-name "myEnv-Delete"

Usar o ponto de extremidade

az devcenter dev environment show-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --action-name "myEnv-Delete"

Parâmetros Exigidos

--action-name

O nome de uma ação que ocorrerá em um ambiente.

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment show-logs-by-operation

Obtém os logs de uma operação em um ambiente.

az devcenter dev environment show-logs-by-operation --environment-name --name
                                                    --operation-id
                                                    --project --project-name
                                                    [--dev-center --dev-center-name]
                                                    [--endpoint]
                                                    [--user-id]

Exemplos

Obter usando o centro de desenvolvimento

az devcenter dev environment show-logs-by-operation --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Usar o ponto de extremidade

az devcenter dev environment show-logs-by-operation --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--operation-id

A ID da operação.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment show-operation

Obtém um resultado de ação de ambiente.

az devcenter dev environment show-operation --environment-name --name
                                            --operation-id
                                            --project --project-name
                                            [--dev-center --dev-center-name]
                                            [--endpoint]
                                            [--user-id]

Exemplos

Obter usando o centro de desenvolvimento

az devcenter dev environment show-operation --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Usar o ponto de extremidade

az devcenter dev environment show-operation --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--operation-id

A ID da operação.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment show-outputs

Obtém saídas do ambiente.

az devcenter dev environment show-outputs --environment-name --name
                                          --project --project-name
                                          [--dev-center --dev-center-name]
                                          [--endpoint]
                                          [--user-id]

Exemplos

Obter usando o centro de desenvolvimento

az devcenter dev environment show-outputs --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Usar o ponto de extremidade

az devcenter dev environment show-outputs --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment skip-action

Ignorar uma ação de ambiente específica.

az devcenter dev environment skip-action --action-name
                                         --environment-name --name
                                         --project --project-name
                                         [--dev-center --dev-center-name]
                                         [--endpoint]
                                         [--user-id]

Exemplos

Ignorar o uso do centro de desenvolvimento

az devcenter dev environment skip-action --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --action-name "myEnv-Delete"

Ignorar o uso do ponto de extremidade

az devcenter dev environment skip-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --action-name "myEnv-Delete"

Parâmetros Exigidos

--action-name

O nome de uma ação que ocorrerá em um ambiente.

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment update

Atualize um ambiente.

az devcenter dev environment update --environment-name --name
                                    --project --project-name
                                    [--dev-center --dev-center-name]
                                    [--endpoint]
                                    [--expiration --expiration-date]
                                    [--no-wait]
                                    [--parameters]
                                    [--user-id]

Exemplos

Atualizar usando o centro de desenvolvimento

az devcenter dev environment update --dev-center-name "ContosoDevCenter" --project-name "DevProject" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}"

Atualizar usando o ponto de extremidade

az devcenter dev environment update --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --name "mydevenv" --user-id "00000000-0000-0000-0000-000000000000" --parameters "{\"functionAppRuntime\":\"node\",\"storageAccountType\":\"Standard_LRS\"}"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--expiration --expiration-date

A data de expiração do ambiente. Deve ser uma cadeia de caracteres ISO.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--parameters

Objeto Parameters para o ambiente. Valor esperado: json-string/json-file/@json-file.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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 devcenter dev environment update-expiration-date

Atualize a expiração do ambiente.

az devcenter dev environment update-expiration-date --environment-name --name
                                                    --project --project-name
                                                    [--dev-center --dev-center-name]
                                                    [--endpoint]
                                                    [--expiration --expiration-date]
                                                    [--user-id]

Exemplos

Obter usando o centro de desenvolvimento

az devcenter dev environment update-expiration-date --dev-center-name "ContosoDevCenter" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --expiration "2026-11-30T22:35:00+00:00"

Usar o ponto de extremidade

az devcenter dev environment update-expiration-date --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --expiration "2026-11-30T22:35:00+00:00"

Parâmetros Exigidos

--environment-name --name -n

O nome do ambiente.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrã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.

--dev-center --dev-center-name -d

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--expiration --expiration-date

A hora em que a data de validade será disparada (UTC), após a qual o ambiente e os recursos associados serão excluídos. O formato de cadeia de caracteres é o formato ISO.

--user-id

A ID de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
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