Partilhar via


az batch job

Gerencie trabalhos em lote.

Comandos

Name Description Tipo Status
az batch job create

Adicione um trabalho a uma conta de lote.

Núcleo GA
az batch job delete

Exclui um trabalho de uma conta de lote.

Núcleo GA
az batch job disable

Desative um trabalho em lote.

Núcleo GA
az batch job enable

Habilite um trabalho em lote.

Núcleo GA
az batch job list

Liste todos os trabalhos ou agendamento de tarefas em uma conta Batch.

Núcleo GA
az batch job prep-release-status

Exiba o status das tarefas de preparação e liberação de trabalhos em lote.

Núcleo GA
az batch job prep-release-status list

Lista o status de execução da Tarefa de Preparação e Liberação de Trabalho para o Trabalho especificado nos Nós de Computação onde o Trabalho foi executado.

Núcleo GA
az batch job reset

Atualize as propriedades de um trabalho em lote. As propriedades não especificadas que podem ser atualizadas são redefinidas para seus padrões.

Núcleo GA
az batch job set

Atualize as propriedades de um trabalho em lote. A atualização de uma propriedade em um subgrupo redefinirá as propriedades não especificadas desse grupo.

Núcleo GA
az batch job show

Obtém informações sobre o trabalho em lote especificado.

Núcleo GA
az batch job stop

Pare um trabalho em lote em execução.

Núcleo GA
az batch job task-counts

Exiba o número de tarefas e slots em um trabalho em lote e seus estados.

Núcleo GA
az batch job task-counts show

Obtém as contagens de Tarefas para o Trabalho especificado.

Núcleo GA

az batch job create

Adicione um trabalho a uma conta de lote.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-application-package-references]
                    [--job-manager-task-command-line]
                    [--job-manager-task-environment-settings]
                    [--job-manager-task-id]
                    [--job-manager-task-resource-files]
                    [--job-max-task-retry-count]
                    [--job-max-wall-clock-time]
                    [--json-file]
                    [--max-parallel-tasks]
                    [--metadata]
                    [--on-all-tasks-complete]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

Exemplos

Crie um novo trabalho associado a um pool existente.

az batch job create --id job1 --pool-id pool1

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, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Se as tarefas neste trabalho podem ser antecipadas por outros trabalhos de alta prioridade. Se o valor for definido como True, outros trabalhos de alta prioridade enviados ao sistema terão precedência e poderão enfileirar novamente as tarefas desse trabalho. Você pode atualizar allowTaskPreemption de um trabalho depois que ele tiver sido criado usando a API do trabalho de atualização. True se a bandeira estiver presente.

--id

Uma cadeia de caracteres que identifica exclusivamente o Trabalho dentro da Conta. O ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hífenes e sublinhados, e não pode conter mais de 64 caracteres. O ID preserva maiúsculas e minúsculas (ou seja, você não pode ter dois IDs em uma Conta que diferem apenas por maiúsculas e minúsculas). Necessário.

--job-manager-task-application-package-references

Uma lista de pacotes de aplicativos que o serviço em lote implantará no nó de computação antes de executar a linha de comando. Os Pacotes de Aplicativos são baixados e implantados em um diretório compartilhado, não no diretório de trabalho da Tarefa. Portanto, se um pacote de aplicativo referenciado já estiver no nó de computação e estiver atualizado, ele não será baixado novamente; a cópia existente no nó de computação é usada. Se um pacote de aplicativo referenciado não puder ser instalado, por exemplo, porque o pacote foi excluído ou porque o download falhou, a tarefa falhará. IDs de aplicativo separados por espaço com versão opcional no formato 'id[#version]'.

--job-manager-task-command-line

A linha de comando da Tarefa do Gerenciador de Tarefas. 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. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho Tarefa) ou usar a variável de ambiente Batch provided (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Necessário.

--job-manager-task-environment-settings

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

--job-manager-task-id

Uma cadeia de caracteres que identifica exclusivamente a Tarefa do Gerenciador de Tarefas dentro do Trabalho. O ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hífenes e sublinhados, e não pode conter mais de 64 caracteres. Necessário.

--job-manager-task-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. Os arquivos listados sob este elemento estão localizados no diretório de trabalho da tarefa. Há um tamanho máximo para a lista de arquivos de recursos. Quando o tamanho máximo for excedido, a solicitação falhará e o código de erro de resposta será RequestEntityTooLarge. Se isso ocorrer, a coleção de ResourceFiles deve ser reduzida em tamanho. Isso pode ser feito usando arquivos .zip, pacotes de aplicativos ou contêineres do Docker. Referências de recursos separados por espaço no formato filename=httpurl.

--job-max-task-retry-count

O número máximo de vezes que cada 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 tentativas. O serviço de lote tentará cada 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á uma 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á Tarefas. Se a contagem máxima de tentativas for -1, o serviço em lote repetirá Tarefas sem limite. O valor padrão é 0 (sem tentativas).

--job-max-wall-clock-time

O tempo máximo decorrido que o Trabalho pode ser executado, medido a partir do momento em que o Trabalho é criado. Se o Trabalho não for concluído dentro do limite de tempo, o serviço em lote o encerrará e todas as Tarefas que ainda estiverem em execução. Neste caso, o motivo da rescisão será MaxWallClockTimeExpiry. Se essa propriedade não for especificada, não há limite de tempo para a execução do trabalho. O formato esperado é uma duração ISO-8601.

--json-file

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

--max-parallel-tasks

O número máximo de tarefas que podem ser executadas em paralelo para o trabalho. O valor de maxParallelTasks deve ser -1 ou maior que 0, se especificado. Se não for especificado, o valor padrão será -1, o que significa que não há limite para o número de tarefas que podem ser executadas de uma só vez. Você pode atualizar maxParallelTasks de um trabalho depois que ele tiver sido criado usando a API do trabalho de atualização.

--metadata

Uma lista de pares nome-valor associados ao Job como metadados. O serviço Batch não atribui qualquer significado aos metadados; é exclusivamente para o uso do código de usuário. Valores separados por espaço no formato 'key=value'.

--on-all-tasks-complete

A ação que o serviço em lote deve executar quando todas as tarefas no trabalho estiverem no estado concluído. Observe que, se um Trabalho não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Esta opção é, portanto, mais comumente usada com uma tarefa do Job Manager; se você quiser usar o encerramento automático de trabalho sem um Gerenciador de tarefas, você deve inicialmente definir onAllTasksComplete como noaction e atualizar as propriedades de trabalho para definir onAllTasksComplete para encerrar o trabalho assim que terminar de adicionar tarefas. O padrão é noaction. Os valores conhecidos são: "noaction" e "terminatejob".

--pool-id

A ID de um Pool existente. Todas as Tarefas do Trabalho serão executadas no Pool especificado. Você deve garantir que o Pool referenciado por essa propriedade exista. Se o Pool não existir no momento em que o serviço de Lote tentar agendar um Trabalho, nenhuma Tarefa para o Trabalho será executada até que você crie um Pool com essa id. Observe que o serviço Batch não rejeitará a solicitação de trabalho; ele simplesmente não executará Tarefas até que o Pool exista. Você deve especificar a ID do Pool ou a especificação automática do Pool, mas não ambas.

--priority

A prioridade do Trabalho. Os valores de prioridade podem variar de -1000 a 1000, sendo -1000 a prioridade mais baixa e 1000 a prioridade mais alta. O valor padrão é 0.

--required-slots

O número de slots de agendamento que a Tarefa requer para ser executada. O padrão é 1. Uma Tarefa só pode ser agendada para ser executada em um nó de computação se o nó tiver slots de agendamento livres suficientes disponíveis. Para tarefas de várias instâncias, essa propriedade não é suportada e não deve ser especificada.

--uses-task-dependencies

Se as Tarefas no Trabalho podem definir dependências entre si. O padrão é false. True se a bandeira estiver presente.

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
Default value: json
--query

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

--subscription

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

--verbose

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

az batch job delete

Exclui um trabalho de uma conta de lote.

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

Exemplos

Exclua um trabalho usando a ID do trabalho sem solicitar confirmação.

az batch job delete --job-id job1 --yes

Parâmetros Obrigatórios

--job-id

A ID do trabalho a ser excluído. Necessário.

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, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--yes -y

Não solicite confirmação.

Default value: 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
Default value: json
--query

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

--subscription

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

--verbose

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

az batch job disable

Desative um trabalho em lote.

az batch job disable --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--disable-tasks]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--json-file]

Exemplos

Desative um trabalho e coloque novamente na fila todas as tarefas em execução.

az batch job disable --job-id job1 --disable-tasks requeue

Parâmetros Obrigatórios

--job-id

A ID do trabalho a ser desabilitado. Necessário.

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, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--disable-tasks

O que fazer com as Tarefas ativas associadas ao Trabalho. Necessário. Os valores conhecidos são: "requeue", "terminate" e "wait".

--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 tiver sido modificado desde o tempo especificado.

--json-file

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

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
Default value: json
--query

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

--subscription

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

--verbose

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

az batch job enable

Habilite um trabalho em lote.

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

Exemplos

Habilite um trabalho.

az batch job enable --job-id job1

Parâmetros Obrigatórios

--job-id

A ID do trabalho a ser habilitado. Necessário.

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, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, 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 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 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
Default value: json
--query

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

--subscription

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

--verbose

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

az batch job list

Liste todos os trabalhos ou agendamento de tarefas em uma conta Batch.

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

Exemplos

Listar todos os trabalhos em uma conta de lote

az batch job list

Listar toda a agenda de trabalho em uma conta de lote

az batch job list --job-schedule-id jobschedule1

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, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do lote. Apenas necessário 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://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

--job-schedule-id

A ID da agenda de trabalho a partir da qual você deseja obter uma lista de trabalhos. Se omitido, lista todos os trabalhos na conta.

--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
Default value: json
--query

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

--subscription

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

--verbose

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

az batch job reset

Atualize as propriedades de um trabalho em lote. As propriedades não especificadas que podem ser atualizadas são redefinidas para seus padrões.

az batch job reset --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--allow-task-preemption]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--job-max-task-retry-count]
                   [--job-max-wall-clock-time]
                   [--json-file]
                   [--max-parallel-tasks]
                   [--metadata]
                   [--on-all-tasks-complete]
                   [--pool-id]
                   [--priority]

Exemplos

Redefina todas as propriedades do trabalho, exceto a prioridade.

az batch job reset --job-id job1 --priority 100

Parâmetros Obrigatórios

--job-id

A ID do Trabalho cujas propriedades você deseja atualizar. Necessário.

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, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Se as tarefas neste trabalho podem ser antecipadas por outros trabalhos de alta prioridade. Se o valor for definido como True, outros trabalhos de alta prioridade enviados ao sistema terão precedência e poderão enfileirar novamente as tarefas desse trabalho. Você pode atualizar allowTaskPreemption de um trabalho depois que ele tiver sido criado usando a API do trabalho de atualização. True se a bandeira estiver presente.

--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 tiver sido modificado desde o tempo especificado.

--job-max-task-retry-count

O número máximo de vezes que cada 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 tentativas. O serviço de lote tentará cada 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á uma 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á Tarefas. Se a contagem máxima de tentativas for -1, o serviço em lote repetirá Tarefas sem limite. O valor padrão é 0 (sem tentativas).

--job-max-wall-clock-time

O tempo máximo decorrido que o Trabalho pode ser executado, medido a partir do momento em que o Trabalho é criado. Se o Trabalho não for concluído dentro do limite de tempo, o serviço em lote o encerrará e todas as Tarefas que ainda estiverem em execução. Neste caso, o motivo da rescisão será MaxWallClockTimeExpiry. Se essa propriedade não for especificada, não há limite de tempo para a execução do trabalho. O formato esperado é uma duração ISO-8601.

--json-file

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

--max-parallel-tasks

O número máximo de tarefas que podem ser executadas em paralelo para o trabalho. O valor de maxParallelTasks deve ser -1 ou maior que 0, se especificado. Se não for especificado, o valor padrão será -1, o que significa que não há limite para o número de tarefas que podem ser executadas de uma só vez. Você pode atualizar maxParallelTasks de um trabalho depois que ele tiver sido criado usando a API do trabalho de atualização.

--metadata

Uma lista de pares nome-valor associados ao Job como metadados. O serviço Batch não atribui qualquer significado aos metadados; é exclusivamente para o uso do código de usuário. Valores separados por espaço no formato 'key=value'.

--on-all-tasks-complete

A ação que o serviço em lote deve executar quando todas as tarefas no trabalho estiverem no estado concluído. O padrão é noaction. Os valores conhecidos são: "noaction" e "terminatejob".

--pool-id

A ID de um Pool existente. Todas as Tarefas do Trabalho serão executadas no Pool especificado. Você deve garantir que o Pool referenciado por essa propriedade exista. Se o Pool não existir no momento em que o serviço de Lote tentar agendar um Trabalho, nenhuma Tarefa para o Trabalho será executada até que você crie um Pool com essa id. Observe que o serviço Batch não rejeitará a solicitação de trabalho; ele simplesmente não executará Tarefas até que o Pool exista. Você deve especificar a ID do Pool ou a especificação automática do Pool, mas não ambas.

--priority

A prioridade do Trabalho. Os valores de prioridade podem variar de -1000 a 1000, sendo -1000 a prioridade mais baixa e 1000 a prioridade mais alta. O valor padrão é 0.

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
Default value: json
--query

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

--subscription

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

--verbose

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

az batch job set

Atualize as propriedades de um trabalho em lote. A atualização de uma propriedade em um subgrupo redefinirá as propriedades não especificadas desse grupo.

az batch job set --job-id
                 [--account-endpoint]
                 [--account-key]
                 [--account-name]
                 [--allow-task-preemption]
                 [--if-match]
                 [--if-modified-since]
                 [--if-none-match]
                 [--if-unmodified-since]
                 [--job-max-task-retry-count]
                 [--job-max-wall-clock-time]
                 [--json-file]
                 [--max-parallel-tasks]
                 [--metadata]
                 [--on-all-tasks-complete]
                 [--pool-id]
                 [--priority]

Exemplos

Atualizar a prioridade do trabalho.

az batch job set --job-id job1 --priority 100

Parâmetros Obrigatórios

--job-id

A ID do Trabalho cujas propriedades você deseja atualizar. Necessário.

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, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Se as tarefas neste trabalho podem ser antecipadas por outros trabalhos de alta prioridade. Se o valor for definido como True, outros trabalhos de alta prioridade enviados ao sistema terão precedência e poderão enfileirar novamente as tarefas desse trabalho. Você pode atualizar allowTaskPreemption de um trabalho depois que ele tiver sido criado usando a API do trabalho de atualização. True se a bandeira estiver presente.

--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 tiver sido modificado desde o tempo especificado.

--job-max-task-retry-count

O número máximo de vezes que cada 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 tentativas. O serviço de lote tentará cada 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á uma 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á Tarefas. Se a contagem máxima de tentativas for -1, o serviço em lote repetirá Tarefas sem limite. O valor padrão é 0 (sem tentativas).

--job-max-wall-clock-time

O tempo máximo decorrido que o Trabalho pode ser executado, medido a partir do momento em que o Trabalho é criado. Se o Trabalho não for concluído dentro do limite de tempo, o serviço em lote o encerrará e todas as Tarefas que ainda estiverem em execução. Neste caso, o motivo da rescisão será MaxWallClockTimeExpiry. Se essa propriedade não for especificada, não há limite de tempo para a execução do trabalho. O formato esperado é uma duração ISO-8601.

--json-file

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

--max-parallel-tasks

O número máximo de tarefas que podem ser executadas em paralelo para o trabalho. O valor de maxParallelTasks deve ser -1 ou maior que 0, se especificado. Se não for especificado, o valor padrão será -1, o que significa que não há limite para o número de tarefas que podem ser executadas de uma só vez. Você pode atualizar maxParallelTasks de um trabalho depois que ele tiver sido criado usando a API do trabalho de atualização.

--metadata

Uma lista de pares nome-valor associados ao Job como metadados. Se omitidos, os metadados de trabalho existentes são deixados inalterados. Valores separados por espaço no formato 'key=value'.

--on-all-tasks-complete

A ação que o serviço em lote deve executar quando todas as tarefas no trabalho estiverem no estado concluído. Se omitido, o comportamento de conclusão será mantido inalterado. Você não pode alterar o valor de terminatejob para noaction - ou seja, uma vez que você tenha contratado a rescisão automática do trabalho, você não pode desativá-lo novamente. Se você tentar fazer isso, a solicitação falhará com uma resposta de erro 'valor de propriedade inválido'; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). Os valores conhecidos são: "noaction" e "terminatejob".

--pool-id

A ID de um Pool existente. Todas as Tarefas do Trabalho serão executadas no Pool especificado. Você deve garantir que o Pool referenciado por essa propriedade exista. Se o Pool não existir no momento em que o serviço de Lote tentar agendar um Trabalho, nenhuma Tarefa para o Trabalho será executada até que você crie um Pool com essa id. Observe que o serviço Batch não rejeitará a solicitação de trabalho; ele simplesmente não executará Tarefas até que o Pool exista. Você deve especificar a ID do Pool ou a especificação automática do Pool, mas não ambas.

--priority

A prioridade do Trabalho. Os valores de prioridade podem variar de -1000 a 1000, sendo -1000 a prioridade mais baixa e 1000 a prioridade mais alta. Se omitida, a prioridade do trabalho é mantida inalterada.

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
Default value: json
--query

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

--subscription

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

--verbose

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

az batch job show

Obtém informações sobre o trabalho em lote especificado.

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

Exemplos

Mostra detalhes de informações sobre um trabalho.

az batch job show --job-id job1

Parâmetros Obrigatórios

--job-id

A ID do trabalho. Necessário.

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, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina 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 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
Default value: json
--query

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

--subscription

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

--verbose

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

az batch job stop

Pare um trabalho em lote em execução.

Encerre o trabalho especificado, marcando-o como concluído. Quando uma solicitação de trabalho de encerramento é recebida, o serviço de lote define o trabalho para o estado de encerramento. Em seguida, o serviço em lote encerra todas as tarefas em execução associadas ao trabalho e executa todas as tarefas de liberação de trabalho necessárias. Em seguida, o trabalho passa para o estado concluído. Se houver alguma tarefa no trabalho no estado ativo, ela permanecerá no estado ativo. Quando um trabalho é encerrado, novas tarefas não podem ser adicionadas e quaisquer tarefas ativas restantes não serão agendadas.

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

Exemplos

Parar um trabalho e dar um motivo de rescisão

az batch job stop --job-id job1 --terminate-reason "Completed workflow"

Parâmetros Obrigatórios

--job-id

A ID do trabalho a ser encerrado. Necessário.

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, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--terminate-reason

Motivo da rescisão.

O texto que você deseja que apareça como TerminateReason do trabalho. O padrão é 'UserTerminate'.

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
Default value: json
--query

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

--subscription

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

--verbose

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