az batch task

Gerenciar tarefas do Lote.

Comandos

Nome	Description	Tipo	Status
az batch task create	Criar tarefas do Lote.	Núcleo	GA
az batch task delete	Exclui uma tarefa do trabalho especificado.	Núcleo	GA
az batch task file	Gerenciar arquivos de tarefa do Lote.	Núcleo	GA
az batch task file delete	Exclui o arquivo de tarefa especificado do Nó de Computação em que a Tarefa foi executada.	Núcleo	GA
az batch task file download	Baixe o conteúdo de um arquivo de tarefa do Lote.	Núcleo	GA
az batch task file list	Lista os arquivos no diretório de uma tarefa em seu Nó de Computação.	Núcleo	GA
az batch task file show	Obtém as propriedades do arquivo de tarefa especificado.	Núcleo	GA
az batch task list	Lista todas as Tarefas associadas ao Trabalho especificado.	Núcleo	GA
az batch task reactivate	Reativa uma tarefa, permitindo que ela seja executada novamente mesmo que sua contagem de repetições tenha sido esgotada.	Núcleo	GA
az batch task reset	Redefina as propriedades de uma tarefa do Lote.	Núcleo	GA
az batch task show	Obtém informações sobre a Tarefa especificada.	Núcleo	GA
az batch task stop	Encerra a Tarefa especificada.	Núcleo	GA
az batch task subtask	Gerenciar informações de subtarefa de uma tarefa do Lote.	Núcleo	GA
az batch task subtask list	Lista todas as subtarefas associadas à Tarefa de várias instâncias especificada.	Núcleo	GA

az batch task create

Criar tarefas do Lote.

az batch task create --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--affinity-id]
                     [--application-package-references]
                     [--command-line]
                     [--environment-settings]
                     [--json-file]
                     [--max-task-retry-count]
                     [--max-wall-clock-time]
                     [--resource-files]
                     [--retention-time]
                     [--task-id]

Exemplos

Crie uma tarefa que dure por 1 minuto.

az batch task create --task-id task1 --job-id job1 --command-line "sleep 60"

Parâmetros Exigidos

--job-id

A ID do trabalho que contém a tarefa.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

A chave da conta do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do Lote. Somente necessário Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.

--affinity-id

Necessário. Você pode passar a affinityId de um nó para indicar que essa Tarefa precisa ser executada nesse nó de computação. Observe que isso é apenas uma afinidade suave. Se o Nó de Computação de destino estiver ocupado ou indisponível no momento em que a Tarefa for agendada, a Tarefa será agendada em outro lugar.

--application-package-references

A lista separada por espaço de IDs que especifica os pacotes de aplicativos a serem instalados. IDs de aplicativo separadas por espaço com versão opcional no formato 'id[#version]'.

--command-line

A linha de comando da tarefa. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se quiser aproveitar esses recursos, invoque o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux.

--environment-settings

Uma lista de configurações de variável de ambiente para a tarefa. Valores separados por espaço no formato 'key=value'.

--json-file

O arquivo que contém as tarefas a serem criadas em JSON(formatado para corresponder ao corpo da solicitação da API REST). Ao enviar várias tarefas, aceita uma matriz de tarefas ou um TaskAddCollectionParamater. Se esse parâmetro for especificado, todos os outros parâmetros serão ignorados.

--max-task-retry-count

O número máximo de vezes que a Tarefa pode ser repetida. O serviço do Lote tentará novamente uma Tarefa se o código de saída não for zero. Observe que esse valor controla especificamente o número de repetições para o executável da Tarefa devido a um código de saída diferente de zero. O serviço lote tentará a Tarefa uma vez e poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de repetição for 3, o Lote tentará a Tarefa até 4 vezes (uma tentativa inicial e três tentativas). Se a contagem máxima de repetição for 0, o serviço do Lote não tentará novamente a Tarefa após a primeira tentativa. Se a contagem máxima de repetição for -1, o serviço do Lote repetirá a Tarefa sem limite, no entanto, isso não é recomendado para uma tarefa inicial ou qualquer tarefa. O valor padrão é 0 (sem novas tentativas).

--max-wall-clock-time

Se isso não for especificado, não haverá limite de tempo para a execução da Tarefa.

--resource-files

Uma lista de arquivos que o serviço do Lote baixará no nó de computação antes de executar a linha de comando. Referências de recurso separadas por espaço no formato filename=httpurl, com httpurl sendo qualquer URL HTTP com acesso público ou uma URL SAS com acesso de leitura.

--retention-time

O padrão é 7 dias, ou seja, o diretório tarefa será mantido por 7 dias, a menos que o Nó de Computação seja removido ou o Trabalho seja excluído.

--task-id

A ID da tarefa.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

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

az batch task delete

Exclui uma tarefa do trabalho especificado.

Quando uma Tarefa é excluída, todos os arquivos em seu diretório no Nó de Computação em que ele foi executado também são excluídos (independentemente do tempo de retenção). Para tarefas de várias instâncias, a operação excluir Tarefa aplica-se de forma síncrona à tarefa primária; as subtarefas e seus arquivos são excluídos de forma assíncrona em segundo plano.

az batch task delete --job-id
                     --task-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--yes]

Parâmetros Exigidos

--job-id

A ID do trabalho do qual excluir a Tarefa. Necessário.

--task-id

A ID da Tarefa a ser excluída. Necessário.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.

--if-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente.

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

--if-none-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço não corresponder ao valor especificado pelo cliente.

--if-unmodified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

--yes -y

Não solicite confirmação.

Valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

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

az batch task list

Lista todas as Tarefas associadas ao Trabalho especificado.

Para tarefas de várias instâncias, informações como affinityId, executionInfo e nodeInfo referem-se à Tarefa primária. Use a API de subtarefas de lista para recuperar informações sobre subtarefas.

az batch task list --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--filter]
                   [--select]

Parâmetros Exigidos

--job-id

A ID do trabalho. Necessário.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.

--expand

Uma cláusula $expand OData.

--filter

Uma cláusula $filter OData. Para obter mais informações sobre como construir esse filtro, consulte https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

--select

Uma cláusula $select OData.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

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

az batch task reactivate

Reativa uma tarefa, permitindo que ela seja executada novamente mesmo que sua contagem de repetições tenha sido esgotada.

A reativação torna uma tarefa elegível para ser repetidamente até sua contagem máxima de repetição. O estado da Tarefa é alterado para ativo. Como a Tarefa não está mais no estado concluído, qualquer código de saída anterior ou informações de falha não estão mais disponíveis após a reativação. Cada vez que uma tarefa é reativada, sua contagem de repetição é redefinida para 0. A reativação falhará para tarefas que não foram concluídas ou que foram concluídas com êxito (com um código de saída de 0). Além disso, ele falhará se o Trabalho tiver sido concluído (ou estiver encerrando ou excluindo).

az batch task reactivate --job-id
                         --task-id
                         [--account-endpoint]
                         [--account-key]
                         [--account-name]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]

Parâmetros Exigidos

--job-id

A ID do trabalho que contém a Tarefa. Necessário.

--task-id

A ID da Tarefa a ser reativada. Necessário.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.

--if-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente.

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

--if-none-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço não corresponder ao valor especificado pelo cliente.

--if-unmodified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

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

az batch task reset

Redefina as propriedades de uma tarefa do Lote.

az batch task reset --job-id
                    --task-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--json-file]
                    [--max-task-retry-count]
                    [--max-wall-clock-time]
                    [--retention-time]

Exemplos

Definir a contagem máxima de repetição como 3 e redefinir outras propriedades para seus padrões

az batch task reset --task-id task1 --job-id job1 --max-task-retry-count 3

Parâmetros Exigidos

--job-id

A ID do trabalho que contém a Tarefa.

--task-id

A ID da Tarefa a ser atualizada.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

A chave da conta do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do Lote. Somente necessário Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.

--if-match

A operação será executada somente se a ETag atual do recurso corresponder exatamente ao valor especificado.

--if-modified-since

A operação será executada somente se o recurso tiver sido modificado desde o carimbo de data/hora especificado.

--if-none-match

A operação não será executada somente se a ETag atual do recurso corresponder exatamente ao valor especificado.

--if-unmodified-since

A operação não será executada somente se o recurso tiver sido modificado desde o carimbo de data/hora especificado.

--json-file

O arquivo que contém a especificação do parâmetro de propriedades de atualização do pool em JSON(formatado para corresponder ao corpo da solicitação da API REST). Se esse parâmetro for especificado, todos os "argumentos de parâmetro de propriedades de atualização do pool" serão ignorados.

--max-task-retry-count

O número máximo de vezes que a Tarefa pode ser repetida. O serviço do Lote tentará novamente uma Tarefa se o código de saída não for zero. Observe que esse valor controla especificamente o número de repetições para o executável da Tarefa devido a um código de saída diferente de zero. O serviço lote tentará a Tarefa uma vez e poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de repetição for 3, o Lote tentará a Tarefa até 4 vezes (uma tentativa inicial e três tentativas). Se a contagem máxima de repetição for 0, o serviço do Lote não tentará novamente a Tarefa após a primeira tentativa. Se a contagem máxima de repetição for -1, o serviço do Lote repetirá a Tarefa sem limite, no entanto, isso não é recomendado para uma tarefa inicial ou qualquer tarefa. O valor padrão é 0 (sem novas tentativas).

--max-wall-clock-time

Se isso não for especificado, não haverá limite de tempo para a execução da Tarefa. O formato esperado é uma duração ISO-8601.

--retention-time

O padrão é 7 dias, ou seja, o diretório tarefa será mantido por 7 dias, a menos que o Nó de Computação seja removido ou o Trabalho seja excluído. O formato esperado é uma duração ISO-8601.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

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

az batch task show

Obtém informações sobre a Tarefa especificada.

Para tarefas de várias instâncias, informações como affinityId, executionInfo e nodeInfo referem-se à Tarefa primária. Use a API de subtarefas de lista para recuperar informações sobre subtarefas.

az batch task show --job-id
                   --task-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--select]

Parâmetros Exigidos

--job-id

A ID do trabalho que contém a Tarefa. Necessário.

--task-id

A ID da Tarefa sobre a qual obter informações. Necessário.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.

--expand

Uma cláusula $expand OData.

--if-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente.

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

--if-none-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço não corresponder ao valor especificado pelo cliente.

--if-unmodified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

--select

Uma cláusula $select OData.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

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

az batch task stop

Encerra a Tarefa especificada.

Quando a Tarefa foi encerrada, ela passa para o estado concluído. Para tarefas de várias instâncias, a operação encerrar Tarefa se aplica de forma síncrona à tarefa primária; As subtarefas são então encerradas de forma assíncrona em segundo plano.

az batch task stop --job-id
                   --task-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]

Parâmetros Exigidos

--job-id

A ID do trabalho que contém a Tarefa. Necessário.

--task-id

A ID da Tarefa a ser encerrada. Necessário.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.

--if-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente.

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

--if-none-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço não corresponder ao valor especificado pelo cliente.

--if-unmodified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

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