az batch task

  • Referência

Gerenciar tarefas em lote.

Comandos

Nome Description Tipo Status
az batch task create

Criar tarefas em lote.

 Núcleo GA
az batch task delete

Exclui uma Tarefa do Trabalho especificado.

 Núcleo GA
az batch task file

Gerenciar arquivos de tarefas em lote.

 Núcleo GA
az batch task file delete

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

 Núcleo GA
az batch task file download

Baixe o conteúdo de um arquivo de tarefa em 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 tentativas tenha sido esgotada.

 Núcleo GA
az batch task reset

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

Editar

Criar 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 Exigidos

--job-id

A ID do trabalho que contém a tarefa.

Parâmetros Opcionais

--account-endpoint

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

--account-key

A chave de conta Batch. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do Batch. Como alternativa, defina 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 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 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 comando da tarefa. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser tirar proveito de tais 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(s) 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 em lote tentará novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas para o executável Task devido a um código de saída diferente de zero. O serviço em 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 Lote 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 novas 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 em lote 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, 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 Task será mantido por 7 dias, a menos que o Compute Node seja removido ou o Job seja excluído.

--task-id

A ID da tarefa.

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. 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 Exigidos

--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. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

Nome da conta de lote. Como alternativa, defina 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 horário especificado.

--if-none-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 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 horário especificado.

--yes -y

Não solicite confirmação.

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

Aumente o detalhamento 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 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 o detalhamento do log. 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 Exigidos

--job-id

A ID do trabalho.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--expand

Uma cláusula de $expand OData.

--filter

Uma cláusula de $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 de $select OData.

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. 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 qualificada 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 estarã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 Exigidos

--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. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

Nome da conta de lote. Como alternativa, defina 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 horário especificado.

--if-none-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 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 horário especificado.

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. 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 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 em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

Nome da conta de lote. Como alternativa, defina 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 horário especificado.

--if-none-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 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 horário especificado.

--json-file

Um arquivo que contém a especificação de restrições em JSON (formatado para corresponder ao respectivo 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 em lote tentará novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas para o executável Task devido a um código de saída diferente de zero. O serviço em 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 Lote 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 novas 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 Task será mantido por 7 dias, a menos que o Compute Node seja removido ou o Job seja excluído. O formato esperado é uma duração ISO-8601.

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. 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 Exigidos

--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. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--expand

Uma cláusula de $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 horário especificado.

--if-none-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 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 horário especificado.

--select

Uma cláusula de $select OData.

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az batch task stop

Editar

Encerra a Tarefa especificada.

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

--task-id

A ID da tarefa a ser encerrada.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

Nome da conta de lote. Como alternativa, defina 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 horário especificado.

--if-none-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 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 horário especificado.

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.