az batch task

  • Referência

Gerenciar tarefas em lote.

Comandos

Name Description Tipo Estado
az batch task create

Crie tarefas em lote.

 Principal GA
az batch task delete

Exclui uma Tarefa do Trabalho especificado.

 Principal GA
az batch task file

Gerencie arquivos de tarefas em lote.

 Principal GA
az batch task file delete

Exclui o arquivo de tarefa especificado do nó de computação onde a tarefa foi executada.

 Principal GA
az batch task file download

Baixe o conteúdo de um arquivo de tarefa em lote.

 Principal GA
az batch task file list

Lista os arquivos no diretório de uma tarefa em seu nó de computação.

 Principal GA
az batch task file show

Obtém as propriedades do arquivo de tarefa especificado.

 Principal GA
az batch task list

Lista todas as Tarefas associadas ao Trabalho especificado.

 Principal GA
az batch task reactivate

Reativa uma Tarefa, permitindo que ela seja executada novamente mesmo que sua contagem de tentativas tenha sido esgotada.

 Principal GA
az batch task reset

Redefina as propriedades de uma tarefa em lote.

 Principal GA
az batch task show

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

 Principal GA
az batch task stop

Encerra a tarefa especificada.

 Principal GA
az batch task subtask

Gerenciar informações de subtarefas de uma tarefa em lote.

 Principal GA
az batch task subtask list

Lista todas as subtarefas associadas à Tarefa de várias instâncias especificada.

 Principal GA

az batch task create

Editar

Crie tarefas em 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]

Parâmetros Obrigatórios

--job-id

A ID do trabalho que contém a tarefa.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

A chave da conta Batch. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.

--affinity-id

Obrigatório. Você pode passar o affinityId de um nó para indicar que essa tarefa precisa ser executada nesse nó de computação. Note que esta é 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 especificando os pacotes de aplicativos a serem instalados. IDs de aplicativo separados por espaço com versão opcional no formato 'id[#version]'.

--command-line

A linha de comandos da tarefa. A linha de comando não é executada sob um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser aproveitar esses recursos, você deve invocar 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áveis de ambiente para a tarefa. Valores separados por espaço no formato 'key=value'.

--json-file

O arquivo que contém a(s) tarefa(s) a ser criada 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 de lote tenta novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de novas tentativas para o executável Task devido a um código de saída diferente de zero. O serviço de lote tentará a tarefa uma vez e, em seguida, poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de tentativas for 3, o Batch tentará a Tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se a contagem máxima de tentativas for 0, o serviço em lote não repetirá a tarefa após a primeira tentativa. Se a contagem máxima de tentativas for -1, o serviço em 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 tentativas).

--max-wall-clock-time

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

--resource-files

Uma lista de arquivos que o serviço Batch baixará para o nó de computação antes de executar a linha de comando. Referências de recursos separados por espaço no formato filename=httpurl, sendo httpurl qualquer url HTTP com acesso público ou um URL SAS com acesso de leitura.

--retention-time

O padrão é 7 dias, ou seja, o diretório de tarefas 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 de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az batch task delete

Editar

Exclui uma Tarefa do Trabalho especificado.

Quando uma Tarefa é excluída, todos os arquivos em seu diretório no Nó de Computação onde ela foi executada 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 principal; 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 Obrigatórios

--job-id

A ID do Trabalho do qual excluir a Tarefa.

--task-id

A ID da Tarefa a ser excluída.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, 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 o 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 tempo 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 não tiver sido modificado desde o tempo especificado.

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az batch task list

Editar

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 principal. 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 Obrigatórios

--job-id

A ID do trabalho.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, 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://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-tasks.

--select

Uma cláusula OData $select.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az batch task reactivate

Editar

Reativa uma Tarefa, permitindo que ela seja executada novamente mesmo que sua contagem de tentativas tenha sido esgotada.

A reativação torna uma Tarefa elegível para ser repetida novamente até sua contagem máxima de tentativas. 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 tentativas é redefinida para 0. A reativação falhará para Tarefas que não foram concluídas ou que foram concluídas anteriormente 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 terminando 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 Obrigatórios

--job-id

A ID do Trabalho que contém a Tarefa.

--task-id

A ID da Tarefa a ser reativada.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, 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 o 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 tempo 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 não tiver sido modificado desde o tempo especificado.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az batch task reset

Editar

Redefina as propriedades de uma tarefa em 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]

Parâmetros Obrigatórios

--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 em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, 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 o 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 tempo 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 não tiver sido modificado desde o tempo especificado.

--json-file

Um arquivo contendo a especificação de restrições em JSON (formatado para corresponder ao respetivo corpo da API REST). Se esse parâmetro for especificado, todos os 'Argumentos de restrições' serão ignorados.

--max-task-retry-count

O número máximo de vezes que a Tarefa pode ser repetida. O serviço de lote tenta novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de novas tentativas para o executável Task devido a um código de saída diferente de zero. O serviço de lote tentará a tarefa uma vez e, em seguida, poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de tentativas for 3, o Batch tentará a Tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se a contagem máxima de tentativas for 0, o serviço em lote não repetirá a tarefa após a primeira tentativa. Se a contagem máxima de tentativas for -1, o serviço em 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 tentativas).

--max-wall-clock-time

Se isso não for especificado, não há 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 de tarefas 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 de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az batch task show

Editar

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 principal. 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 Obrigatórios

--job-id

A ID do Trabalho que contém a Tarefa.

--task-id

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

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, 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 o 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 tempo 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 não tiver sido modificado desde o tempo especificado.

--select

Uma cláusula OData $select.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az batch task stop

Editar

Encerra a tarefa especificada.

Quando a Tarefa for encerrada, ela será movida para o estado concluído. Para Tarefas de várias instâncias, a operação Encerrar Tarefa aplica-se de forma síncrona à tarefa principal; 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 Obrigatórios

--job-id

A ID do Trabalho que contém a Tarefa.

--task-id

A ID da Tarefa a ser encerrada.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, 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 o 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 tempo 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 não tiver sido modificado desde o tempo especificado.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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