Compartilhar via


az batch job

Observação

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerenciar trabalhos em lote.

Comandos

Nome Description Tipo Status
az batch job create

Adicione um trabalho a uma conta em lote.

Núcleo GA
az batch job create (azure-batch-cli-extensions extensão)

Adicione um trabalho e a(s) tarefa(s) associada(s) a uma conta em lote.

Extensão GA
az batch job delete

Exclui um trabalho.

Núcleo GA
az batch job disable

Desabilita o Trabalho especificado, impedindo a execução de novas Tarefas.

Núcleo GA
az batch job enable

Habilita o Trabalho especificado, permitindo a execução de novas Tarefas.

Núcleo GA
az batch job list

Liste todos os trabalhos ou agendamento de trabalho em uma conta em lote.

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

Exiba o status das tarefas de preparação e liberação do trabalho 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 em que 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 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 em lote.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--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]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--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 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 o sinalizador estiver presente.

--id

Obrigatório. O ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hífens e sublinhados, e não pode conter mais de 64 caracteres. O ID preserva maiúsculas de minúsculas e não diferencia maiúsculas de minúsculas (ou seja, você pode não ter dois IDs em uma Conta que diferem apenas por maiúsculas e minúsculas).

--job-manager-task-command-line

Obrigatório. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser tirar proveito de tais recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. 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 fornecida em lote (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--job-manager-task-environment-settings

Valores separados por espaço no formato 'key=value'.

--job-manager-task-id

Obrigatório. O ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hífens e sublinhados, e não pode conter mais de 64 caracteres.

--job-manager-task-resource-files

Os arquivos listados nesse 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 em lote tentará novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas. O serviço em 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 Lote tentará uma Tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se a contagem máxima de tentativas for 0, o serviço Batch 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 novas tentativas).

--job-max-wall-clock-time

Se o Trabalho não for concluído dentro do limite de tempo, o serviço em Lote o encerrará e quaisquer Tarefas que ainda estejam 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 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 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. Valor padrão: -1 .

--metadata

O serviço Batch não atribui nenhum significado aos metadados; é exclusivamente para o uso de código de usuário. Valores separados por espaço no formato 'key=value'.

--pool-id

O id de um pool existente. Todas as tarefas do trabalho serão executadas no pool especificado.

--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 tem suporte e não deve ser especificada.

--uses-task-dependencies

Se as Tarefas no Trabalho podem definir dependências umas das outras. O padrão é false. True se o sinalizador estiver presente.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch job create (azure-batch-cli-extensions extensão)

Adicione um trabalho e a(s) tarefa(s) associada(s) a uma conta em lote.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--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]
                    [--parameters]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--resource-group]
                    [--template]
                    [--uses-task-dependencies]

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

O nome da conta do Batch. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--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 tarefas desse trabalho. Você pode atualizar allowTaskPreemption de um trabalho depois que ele tiver sido criado usando a API do trabalho de atualização.

--id

Obrigatório. O ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hífens e sublinhados, e não pode conter mais de 64 caracteres. O ID preserva maiúsculas de minúsculas e não diferencia maiúsculas de minúsculas (ou seja, você pode não ter dois IDs em uma Conta que diferem apenas por maiúsculas e minúsculas).

--job-manager-task-command-line

A linha de comando da tarefa Gerenciador de Tarefas. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser tirar proveito de tais recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux.

--job-manager-task-environment-settings

Uma lista de configurações de variáveis de ambiente para a tarefa Gerenciador de Tarefas. Espalhe valores separados 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ífens e sublinhados, e não pode conter mais de 64 caracteres.

--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 nesse elemento estão localizados no diretório de trabalho da tarefa. 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 em lotes repetirá 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 em lote tentará cada tarefa uma vez e, em seguida, 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 3 repetições). Se a contagem máxima de repetição for 0, o serviço em lote não tentará repetir a tarefas. Se a contagem máxima de repetição for -1, o serviço em lotes repetirá as tarefas ilimitadamente. 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 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 haverá limite de tempo para a execução do trabalho. 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 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. Valor padrão: -1 .

--metadata

O serviço Batch não atribui nenhum significado aos metadados; é exclusivamente para o uso de código de usuário.

--parameters

Valores de parâmetro para um arquivo de modelo JSON de trabalho em lote. Só pode ser usado com --template.

--pool-id

O id de um pool existente. Todas as tarefas do trabalho serão executadas no pool especificado.

--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 tem suporte e não deve ser especificada.

--resource-group

O grupo de recursos da conta em lote.

--template

Um arquivo de modelo JSON de trabalho em lote. Se esse parâmetro for especificado, todos os outros parâmetros serão ignorados.

--uses-task-dependencies

O sinalizador que determina se esse trabalho usará tarefas com dependências. True se o sinalizador estiver presente.

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch job delete

Exclui um trabalho.

A exclusão de um Trabalho também exclui todas as Tarefas que fazem parte desse Trabalho e todas as estatísticas do Trabalho. Isso também substitui o período de retenção dos dados da Tarefa; ou seja, se o Trabalho contiver Tarefas que ainda são retidas nos Nós de Computação, os serviços em lote excluirão os diretórios de trabalho dessas Tarefas e todo o seu conteúdo. Quando uma solicitação de Excluir Trabalho é recebida, o serviço Lote define o Trabalho para o estado de exclusão. Todas as operações de atualização em um Trabalho que está no estado de exclusão falharão com o código de status 409 (Conflito), com informações adicionais indicando que o Trabalho está sendo excluído.

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

Parâmetros Exigidos

--job-id

A ID do trabalho a ser excluído.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--yes -y

Não solicite confirmação.

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch job disable

Desabilita o Trabalho especificado, impedindo a execução de novas Tarefas.

O Serviço em Lote move imediatamente o Trabalho para o estado de desabilitação. Em seguida, o lote usa o parâmetro disableTasks para determinar o que fazer com as Tarefas do Trabalho em execução no momento. O Trabalho permanece no estado de desabilitação até que a operação de desabilitação seja concluída e todas as Tarefas tenham sido tratadas de acordo com a opção disableTasks; em seguida, o trabalho é movido para o estado desabilitado. Nenhuma nova Tarefa é iniciada no Trabalho até que ele volte ao estado ativo. Se você tentar desabilitar um trabalho que esteja em qualquer estado diferente de ativo, desabilitando ou desabilitado, a solicitação falhará com o código de status 409.

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]

Parâmetros Exigidos

--job-id

A ID do Trabalho a ser desabilitada.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--disable-tasks

Os valores possíveis incluem: 'requeue', 'terminate', '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 horário especificado.

--if-none-match

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

--if-unmodified-since

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch job enable

Habilita o Trabalho especificado, permitindo a execução de novas Tarefas.

Quando você chama essa API, o serviço em lote define um trabalho desabilitado para o estado de habilitação. Depois que essa operação for concluída, o Trabalho será movido para o estado ativo e o agendamento de novas Tarefas será retomado. O serviço em lote não permite que uma tarefa permaneça no estado ativo por mais de 180 dias. Portanto, se você habilitar um Trabalho contendo Tarefas ativas que foram adicionadas há mais de 180 dias, essas Tarefas não serão executadas.

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

Parâmetros Exigidos

--job-id

A ID do trabalho a ser habilitado.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch job list

Liste todos os trabalhos ou agendamento de trabalho em uma conta em lote.

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

O nome da conta do Batch. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--expand

Uma cláusula de $expand OData.

--filter

Uma cláusula de $filter OData.

--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 de $select OData.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch 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 {noaction, terminatejob}]
                   [--pool-id]
                   [--priority]

Parâmetros Exigidos

--job-id

A ID do Trabalho cujas propriedades você deseja atualizar.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--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 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 o sinalizador 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 horário especificado.

--if-none-match

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

--if-unmodified-since

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

--job-max-task-retry-count

O número máximo de vezes que cada Tarefa pode ser repetida. O serviço em lote tentará novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas. O serviço em 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 Lote tentará uma Tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se a contagem máxima de tentativas for 0, o serviço Batch 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 novas tentativas).

--job-max-wall-clock-time

Se o Trabalho não for concluído dentro do limite de tempo, o serviço em Lote o encerrará e quaisquer Tarefas que ainda estejam 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 que contém a especificação do parâmetro de atualização de 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 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. Valor padrão: -1 .

--metadata

Se omitido, ele assume o valor padrão de uma lista vazia; Na verdade, todos os metadados existentes são excluídos. 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 é definido como noaction. Se o valor atual for terminatejob, isso será um erro porque o comportamento de conclusão de um trabalho não pode ser alterado de terminatejob para noaction. 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á e o Batch retornará o código de status 400 (Solicitação incorreta) e uma resposta de erro 'valor de propriedade inválido'. Se você não especificar esse elemento em uma solicitação PUT, será equivalente a passar noaction. Este é um erro se o valor atual for terminatejob.

Valores aceitos: noaction, terminatejob
--pool-id

O id de um pool existente. Todas as tarefas do trabalho serão executadas no pool especificado.

--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 omitido, ele será definido como o valor padrão 0.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch 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 {noaction, terminatejob}]
                 [--pool-id]
                 [--priority]

Parâmetros Exigidos

--job-id

A ID do Trabalho cujas propriedades você deseja atualizar.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--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 tarefas desse trabalho. Você pode atualizar allowTaskPreemption de um trabalho depois que ele tiver sido criado usando a API do trabalho de atualização. Especifique 'true' ou 'false' para atualizar a propriedade.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--job-max-task-retry-count

O número máximo de vezes que cada Tarefa pode ser repetida. O serviço em lote tentará novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas. O serviço em 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 Lote tentará uma Tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se a contagem máxima de tentativas for 0, o serviço Batch 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 novas tentativas).

--job-max-wall-clock-time

Se o Trabalho não for concluído dentro do limite de tempo, o serviço em Lote o encerrará e quaisquer Tarefas que ainda estejam 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 que contém a especificação do parâmetro do patch de 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 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

Se omitidos, os metadados do trabalho existentes serão mantidos 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).

Valores aceitos: noaction, terminatejob
--pool-id

O id de um pool existente. Todas as tarefas do trabalho serão executadas no pool especificado.

--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 será mantida inalterada.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch job show

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

Parâmetros Exigidos

--job-id

A ID do trabalho.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--expand

Uma cláusula de $expand OData.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--select

Uma cláusula de $select OData.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch job stop

Pare um trabalho em lote em execução.

Encerre o trabalho especificado, marcando-o como concluído. Quando uma solicitação de Encerrar Trabalho é recebida, o serviço Lote define o trabalho para o estado de encerramento. Em seguida, o serviço 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, elas permanecerão no estado ativo. Depois que um trabalho é encerrado, novas tarefas não podem 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]

Parâmetros Exigidos

--job-id

A ID do trabalho a ser encerrado.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--terminate-reason

Motivo da rescisão.

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.