az batch task
Gerenciar tarefas em lote.
Comandos
| Name | Description | Tipo | Status |
|---|---|---|---|
| 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
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
A ID do trabalho que contém a tarefa.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
A chave da conta Batch. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
O nome da conta do lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.
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.
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]'.
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.
Uma lista de configurações de variáveis de ambiente para a tarefa. Valores separados por espaço no formato 'key=value'.
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.
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).
Se isso não for especificado, não há limite de tempo para a execução da Tarefa.
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.
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.
A ID da tarefa.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. 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 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
A ID do Trabalho do qual excluir a Tarefa.
A ID da Tarefa a ser excluída.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Não solicite confirmação.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. 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 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
A ID do trabalho.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.
Uma cláusula $expand OData.
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.
Uma cláusula OData $select.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. 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 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
A ID do Trabalho que contém a Tarefa.
A ID da Tarefa a ser reativada.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az batch task reset
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
A ID do Trabalho que contém a Tarefa.
A ID da Tarefa a ser atualizada.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
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.
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).
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.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. 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 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
A ID do Trabalho que contém a Tarefa.
A ID da Tarefa sobre a qual obter informações.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.
Uma cláusula $expand OData.
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.
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.
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.
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.
Uma cláusula OData $select.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az batch task stop
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
A ID do Trabalho que contém a Tarefa.
A ID da Tarefa a ser encerrada.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
