Compartilhar via


az batch job

Gerenciar trabalhos do Lote.

Comandos

Nome Description Tipo Status
az batch job create

Adicione um trabalho a uma conta do Lote.

Núcleo GA
az batch job delete

Exclui um trabalho de uma conta do Lote.

Núcleo GA
az batch job disable

Desabilite um trabalho do Lote.

Núcleo GA
az batch job enable

Habilitar um trabalho do Lote.

Núcleo GA
az batch job list

Liste todos os trabalhos ou agendamento de trabalhos em uma conta do Lote.

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

Exiba o status das tarefas de preparação e liberação do trabalho do Lote.

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

Lista o status de execução da Tarefa preparação do trabalho e da versão do trabalho para o trabalho especificado nos nós de computação em que o trabalho foi executado.

Núcleo GA
az batch job reset

Atualize as propriedades de um trabalho do 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 do Lote. Atualizar 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 do Lote especificado.

Núcleo GA
az batch job stop

Pare um trabalho em execução no Lote.

Núcleo GA
az batch job task-counts

Exiba o número de tarefas e slots em um trabalho do 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 do 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 do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--allow-task-preemption

Se as tarefas neste trabalho podem ser preempidas 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 redirecionar tarefas desse trabalho. Você pode atualizar o allowTaskPreemption de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização. True se o sinalizador estiver presente.

--id

Uma cadeia de caracteres que identifica exclusivamente o Trabalho na Conta. A ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hifens e sublinhados, e não pode conter mais de 64 caracteres. A ID não diferencia maiúsculas de minúsculas e diferencia maiúsculas de minúsculas (ou seja, você pode não ter duas IDs em uma conta que diferem apenas por caso). Necessário.

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

Uma lista de Pacotes de Aplicativos que o serviço 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 separadas por espaço com versão opcional no formato 'id[#version]'.

--job-manager-task-command-line

A linha de comando da Tarefa Gerenciador de Trabalhos. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se quiser aproveitar esses recursos, invoque o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho da Tarefa) ou usar a variável de ambiente fornecida pelo Lote (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ável de ambiente para a Tarefa gerenciador de trabalhos. Valores separados por espaço no formato 'key=value'.

--job-manager-task-id

Uma cadeia de caracteres que identifica exclusivamente a Tarefa gerenciador de trabalhos dentro do trabalho. A ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hifens 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 do Lote baixará no Nó de Computação antes de executar a linha de comando. Os arquivos listados sob esse elemento estão localizados no diretório de trabalho da Tarefa. Há um tamanho máximo para a lista de arquivos de recurso. 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 deverá ser reduzida em tamanho. Isso pode ser feito usando arquivos .zip, pacotes de aplicativos ou contêineres do Docker. Referências de recurso separadas 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 do Lote tentará novamente uma Tarefa se o código de saída não for zero. Observe que esse valor controla especificamente o número de repetições. O serviço lote tentará cada Tarefa uma vez e poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de repetição for 3, o Lote tentará uma Tarefa até 4 vezes (uma tentativa inicial e três tentativas). Se a contagem máxima de repetição for 0, o serviço do Lote não repetirá Tarefas. Se a contagem máxima de repetição for -1, o serviço do Lote repetirá Tarefas sem limite. O valor padrão é 0 (sem novas tentativas).

--job-max-wall-clock-time

O tempo máximo decorrido que o Trabalho pode executar, 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 do Lote o encerrará e todas as Tarefas que ainda estiverem em execução. Nesse caso, o motivo da terminação será MaxWallClockTimeExpiry. Se essa propriedade não for especificada, não haverá limite de tempo em quanto tempo o Trabalho pode ser executado. O formato esperado é uma duração ISO-8601.

--json-file

Um arquivo que contém a especificação do trabalho em JSON (formatado para corresponder ao respectivo 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 ao mesmo tempo. Você pode atualizar maxParallelTasks de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização.

--metadata

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

--on-all-tasks-complete

A ação que o serviço lote deve executar quando todas as Tarefas no Trabalho estão no estado concluído. Observe que, se um trabalho não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Essa opção é, portanto, mais comumente usada com uma tarefa do Gerenciador de Trabalhos; se você quiser usar a terminação automática de trabalho sem um Gerenciador de Trabalhos, inicialmente deverá definir emAllTasksComplete para noaction e atualizar as propriedades de trabalho a serem definidas emAllTasksComplete para encerrar o trabalho depois de 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 do Lote tentar agendar um trabalho, nenhuma tarefa do trabalho será executada até que você crie um Pool com essa ID. Observe que o serviço do Lote 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 do Pool automático, mas não ambos.

--priority

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

--required-slots

O número de slots de agendamento necessários para execução da Tarefa. O padrão é 1. Uma tarefa só poderá ser agendada para ser executada em um nó de computação se o nó tiver slots de agendamento gratuitos suficientes disponíveis. Para tarefas de várias instâncias, essa propriedade não tem suporte 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 o sinalizador estiver presente.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

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

az batch job delete

Exclui um trabalho de uma conta do 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 Exigidos

--job-id

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--yes -y

Não solicite confirmação.

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

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

az batch job disable

Desabilite um trabalho do 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

Desabilite um trabalho e requeue as tarefas em execução.

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

Parâmetros Exigidos

--job-id

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--disable-tasks

O que fazer com 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 a ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente.

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--json-file

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

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

az batch job enable

Habilitar um trabalho do 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

Habilitar um trabalho.

az batch job enable --job-id job1

Parâmetros Exigidos

--job-id

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

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

az batch job list

Liste todos os trabalhos ou agendamento de trabalhos em uma conta do Lote.

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

Exemplos

Listar todos os trabalhos em uma conta do Lote

az batch job list

Listar toda a agenda de trabalhos em uma conta do Lote

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--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 da qual você deseja obter uma lista de trabalhos. Se omitido, lista todos os trabalhos na conta.

--select

Uma cláusula $select OData.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

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

az batch job reset

Atualize as propriedades de um trabalho do 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 Exigidos

--job-id

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--allow-task-preemption

Se as tarefas neste trabalho podem ser preempidas 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 redirecionar tarefas desse trabalho. Você pode atualizar o allowTaskPreemption de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização. True se o sinalizador estiver presente.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--job-max-task-retry-count

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

--job-max-wall-clock-time

O tempo máximo decorrido que o Trabalho pode executar, 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 do Lote o encerrará e todas as Tarefas que ainda estiverem em execução. Nesse caso, o motivo da terminação será MaxWallClockTimeExpiry. Se essa propriedade não for especificada, não haverá limite de tempo em quanto tempo o Trabalho pode ser executado. O formato esperado é uma duração ISO-8601.

--json-file

Um arquivo que contém a especificação do trabalho em JSON (formatado para corresponder ao respectivo 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 ao mesmo tempo. Você pode atualizar maxParallelTasks de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização.

--metadata

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

--on-all-tasks-complete

A ação que o serviço lote deve executar quando todas as Tarefas no Trabalho estão 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 do Lote tentar agendar um trabalho, nenhuma tarefa do trabalho será executada até que você crie um Pool com essa ID. Observe que o serviço do Lote 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 do Pool automático, mas não ambos.

--priority

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

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

az batch job set

Atualize as propriedades de um trabalho do Lote. Atualizar 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

Atualize a prioridade do trabalho.

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

Parâmetros Exigidos

--job-id

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--allow-task-preemption

Se as tarefas neste trabalho podem ser preempidas 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 redirecionar tarefas desse trabalho. Você pode atualizar o allowTaskPreemption de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização. True se o sinalizador estiver presente.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--job-max-task-retry-count

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

--job-max-wall-clock-time

O tempo máximo decorrido que o Trabalho pode executar, 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 do Lote o encerrará e todas as Tarefas que ainda estiverem em execução. Nesse caso, o motivo da terminação será MaxWallClockTimeExpiry. Se essa propriedade não for especificada, não haverá limite de tempo em quanto tempo o Trabalho pode ser executado. O formato esperado é uma duração ISO-8601.

--json-file

Um arquivo que contém a especificação do trabalho em JSON (formatado para corresponder ao respectivo 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 ao mesmo tempo. Você pode atualizar maxParallelTasks de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização.

--metadata

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

--on-all-tasks-complete

A ação que o serviço lote deve executar quando todas as Tarefas no Trabalho estão no estado concluído. Se omitido, o comportamento de conclusão ficará inalterado. Talvez você não altere o valor de terminatejob para noaction. Ou seja, depois de ter contratado a rescisão automática do trabalho, você não poderá 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 do Lote tentar agendar um trabalho, nenhuma tarefa do trabalho será executada até que você crie um Pool com essa ID. Observe que o serviço do Lote 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 do Pool automático, mas não ambos.

--priority

A prioridade do Trabalho. Os valores de prioridade podem variar de -1000 a 1000, com -1000 sendo a prioridade mais baixa e 1000 sendo a prioridade mais alta. Se omitida, a prioridade do Trabalho será deixada inalterada.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

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

az batch job show

Obtém informações sobre o trabalho do 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 Exigidos

--job-id

A ID do trabalho. Necessário.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--expand

Uma cláusula $expand OData.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--select

Uma cláusula $select OData.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

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

az batch job stop

Pare um trabalho em execução no Lote.

Encerre o trabalho especificado, marcando-o como concluído. Quando uma solicitação Encerrar Trabalho é recebida, o serviço do Lote define o trabalho como o estado de encerramento. Em seguida, o serviço do Lote encerra todas as tarefas em execução associadas ao trabalho e executa as tarefas de liberação de trabalho necessárias. Em seguida, o trabalho passa para o estado concluído. Se houver tarefas no trabalho no estado ativo, elas permanecerão no estado ativo. Depois que um trabalho for encerrado, novas tarefas não poderão ser adicionadas e as 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 encerramento

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

Parâmetros Exigidos

--job-id

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--terminate-reason

Motivo da terminação.

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

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