Compartilhar via

az batch job-schedule

  • Referência

Gerenciar agendas de trabalho em lote.

Comandos

Nome Description Tipo Status
az batch job-schedule create

Adicione uma agenda de trabalho em lote a uma conta.

 Núcleo GA
az batch job-schedule delete

Exclui uma Agenda de Trabalho da Conta especificada.

 Núcleo GA
az batch job-schedule disable

Desabilita uma agenda de trabalho.

 Núcleo GA
az batch job-schedule enable

Habilita uma agenda de trabalho.

 Núcleo GA
az batch job-schedule list

Lista todas as agendas de trabalho na conta especificada.

 Núcleo GA
az batch job-schedule reset

Redefinir as propriedades de uma agenda de trabalho. Uma especificação de trabalho atualizada só se aplica a novos trabalhos.

 Núcleo GA
az batch job-schedule set

Atualize as propriedades de uma agenda de trabalho.

 Núcleo GA
az batch job-schedule show

Obtém informações sobre a Agenda de Trabalho especificada.

 Núcleo GA
az batch job-schedule stop

Encerra uma agenda de trabalho.

 Núcleo GA

az batch job-schedule create

Editar

Adicione uma agenda de trabalho em lote a uma conta.

az batch job-schedule create [--account-endpoint]
                             [--account-key]
                             [--account-name]
                             [--allow-task-preemption]
                             [--do-not-run-after]
                             [--do-not-run-until]
                             [--id]
                             [--job-manager-task-command-line]
                             [--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 {noaction, terminatejob}]
                             [--pool-id]
                             [--priority]
                             [--recurrence-interval]
                             [--required-slots]
                             [--start-window]
                             [--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.

--do-not-run-after

Se você não especificar um horário doNotRunAfter e estiver criando uma Agenda de Trabalho recorrente, a Agenda de Trabalho permanecerá ativa até que você a encerre explicitamente. O formato esperado é um carimbo de data/hora ISO-8601.

--do-not-run-until

Se você não especificar um horário doNotRunUntil , a agenda ficará pronta para criar Jobs imediatamente. O formato esperado é um carimbo de data/hora ISO-8601.

--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-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 de agendamento de trabalho na nuvem em JSON (formatado para corresponder ao respectivo corpo da API REST). Se esse parâmetro for especificado, todos os 'Argumentos de agendamento de trabalho na nuvem' 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'.

--on-all-tasks-complete

A ação que o serviço em lote deve executar quando todas as tarefas em um trabalho criado sob essa agenda 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 Tarefas; se você quiser usar o encerramento automático do trabalho sem um Gerenciador de trabalhos, você deve inicialmente definir onAllTasksComplete como noaction e atualizar as propriedades do trabalho para definir onAllTasksComplete para encerrar o trabalho assim que terminar de adicionar tarefas. O padrão é noaction.

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 dos empregos criados no âmbito deste calendário. 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. Essa prioridade é usada como padrão para todos os Trabalhos na Agenda de Trabalhos. Você pode atualizar a prioridade de um Trabalho depois que ele tiver sido criado usando a API de Trabalho de atualização.

--recurrence-interval

Como uma Agenda de Trabalho pode ter no máximo um Trabalho ativo sob ela a qualquer momento, se for hora de criar um novo Trabalho em uma Agenda de Trabalho, mas o Trabalho anterior ainda estiver em execução, o serviço em Lote não criará o novo Trabalho até que o Trabalho anterior seja concluído. Se o Trabalho anterior não for concluído dentro do período startWindow do novo recurrenceInterval, nenhum novo Trabalho será agendado para esse intervalo. Para trabalhos recorrentes, você normalmente deve especificar um jobManagerTask no jobSpecification. Se você não usar jobManagerTask, precisará de um processo externo para monitorar quando os Trabalhos são criados, adicionar Tarefas aos Trabalhos e encerrar os Trabalhos prontos para a próxima recorrência. O padrão é que a agenda não se repita: um Job é criado, dentro do startWindow após o tempo doNotRunUntil e o agendamento é concluído assim que esse Job termina. O valor mínimo é de 1 minuto. Se você especificar um valor menor, o serviço em lote rejeitará o agendamento com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). O formato esperado é uma duração ISO-8601.

--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.

--start-window

Se um Job não for criado dentro do intervalo startWindow, a 'oportunidade' será perdida; nenhum trabalho será criado até a próxima recorrência do agendamento. Se o agendamento for recorrente e startWindow for maior que o intervalo de recorrência, isso será equivalente a um startWindow infinito, porque o Job que é 'devido' em um recurrenceInterval não é transferido para o próximo intervalo de recorrência. O padrão é infinito. O valor mínimo é de 1 minuto. Se você especificar um valor menor, o serviço em lote rejeitará o agendamento com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). O formato esperado é uma duração ISO-8601.

--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-schedule delete

Editar

Exclui uma Agenda de Trabalho da Conta especificada.

Quando você exclui uma Agenda de Trabalho, isso também exclui todos os Trabalhos e Tarefas sob essa agenda. Quando as Tarefas são excluídas, todos os arquivos em seus diretórios de trabalho nos Nós de Computação também são excluídos (o período de retenção é ignorado). As estatísticas da Agenda de Trabalho não estarão mais acessíveis depois que a Agenda de Trabalho for excluída, embora ainda sejam contadas para as estatísticas do tempo de vida da Conta.

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

Parâmetros Exigidos

--job-schedule-id

A ID da Agenda de Trabalho a ser excluída.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--yes -y

Não solicite confirmação.

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az batch job-schedule disable

Editar

Desabilita uma agenda de trabalho.

Nenhum novo Job será criado até que o Job Schedule seja habilitado novamente.

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

Parâmetros Exigidos

--job-schedule-id

A ID da Agenda de 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.

--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-schedule enable

Editar

Habilita uma agenda de trabalho.

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

Parâmetros Exigidos

--job-schedule-id

A ID da Agenda de Trabalho a ser habilitada.

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-schedule list

Editar

Lista todas as agendas de trabalho na conta especificada.

az batch job-schedule list [--account-endpoint]
                           [--account-key]
                           [--account-name]
                           [--expand]
                           [--filter]
                           [--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

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

--account-name

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

--expand

Uma cláusula de $expand OData.

--filter

Uma cláusula de $filter OData. Para obter mais informações sobre como construir esse filtro, consulte https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-job-schedules.

--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-schedule reset

Editar

Redefinir as propriedades de uma agenda de trabalho. Uma especificação de trabalho atualizada só se aplica a novos trabalhos.

az batch job-schedule reset --job-schedule-id
                            [--account-endpoint]
                            [--account-key]
                            [--account-name]
                            [--allow-task-preemption]
                            [--do-not-run-after]
                            [--do-not-run-until]
                            [--if-match]
                            [--if-modified-since]
                            [--if-none-match]
                            [--if-unmodified-since]
                            [--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-metadata]
                            [--json-file]
                            [--max-parallel-tasks]
                            [--metadata]
                            [--on-all-tasks-complete {noaction, terminatejob}]
                            [--pool-id]
                            [--priority]
                            [--recurrence-interval]
                            [--required-slots]
                            [--start-window]
                            [--uses-task-dependencies]

Parâmetros Exigidos

--job-schedule-id

A ID da Agenda de Trabalho a ser atualizada.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--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.

--do-not-run-after

Se você não especificar um horário doNotRunAfter e estiver criando uma Agenda de Trabalho recorrente, a Agenda de Trabalho permanecerá ativa até que você a encerre explicitamente. O formato esperado é um carimbo de data/hora ISO-8601.

--do-not-run-until

Se você não especificar um horário doNotRunUntil , a agenda ficará pronta para criar Jobs imediatamente. O formato esperado é um carimbo de data/hora ISO-8601.

--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-manager-task-application-package-references

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

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-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'.

--json-file

Um arquivo que contém a especificação do parâmetro de atualização da agenda de trabalho em JSON (formatado para corresponder ao respectivo corpo da API REST). Se esse parâmetro for especificado, todos os 'Argumentos de agendamento 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 você não especificar esse elemento, ele terá 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 em um trabalho criado sob essa agenda 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 Tarefas; se você quiser usar o encerramento automático do trabalho sem um Gerenciador de trabalhos, você deve inicialmente definir onAllTasksComplete como noaction e atualizar as propriedades do trabalho para definir onAllTasksComplete para encerrar o trabalho assim que terminar de adicionar tarefas. O padrão é noaction.

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 dos empregos criados no âmbito deste calendário. 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. Essa prioridade é usada como padrão para todos os Trabalhos na Agenda de Trabalhos. Você pode atualizar a prioridade de um Trabalho depois que ele tiver sido criado usando a API de Trabalho de atualização.

--recurrence-interval

Como uma Agenda de Trabalho pode ter no máximo um Trabalho ativo sob ela a qualquer momento, se for hora de criar um novo Trabalho em uma Agenda de Trabalho, mas o Trabalho anterior ainda estiver em execução, o serviço em Lote não criará o novo Trabalho até que o Trabalho anterior seja concluído. Se o Trabalho anterior não for concluído dentro do período startWindow do novo recurrenceInterval, nenhum novo Trabalho será agendado para esse intervalo. Para trabalhos recorrentes, você normalmente deve especificar um jobManagerTask no jobSpecification. Se você não usar jobManagerTask, precisará de um processo externo para monitorar quando os Trabalhos são criados, adicionar Tarefas aos Trabalhos e encerrar os Trabalhos prontos para a próxima recorrência. O padrão é que a agenda não se repita: um Job é criado, dentro do startWindow após o tempo doNotRunUntil e o agendamento é concluído assim que esse Job termina. O valor mínimo é de 1 minuto. Se você especificar um valor menor, o serviço em lote rejeitará o agendamento com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). O formato esperado é uma duração ISO-8601.

--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.

--start-window

Se um Job não for criado dentro do intervalo startWindow, a 'oportunidade' será perdida; nenhum trabalho será criado até a próxima recorrência do agendamento. Se o agendamento for recorrente e startWindow for maior que o intervalo de recorrência, isso será equivalente a um startWindow infinito, porque o Job que é 'devido' em um recurrenceInterval não é transferido para o próximo intervalo de recorrência. O padrão é infinito. O valor mínimo é de 1 minuto. Se você especificar um valor menor, o serviço em lote rejeitará o agendamento com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). O formato esperado é uma duração ISO-8601.

--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-schedule set

Editar

Atualize as propriedades de uma agenda de trabalho.

Você pode atualizar independentemente a agenda e a especificação do trabalho, mas qualquer alteração em qualquer uma dessas entidades redefinirá todas as propriedades nessa entidade.

az batch job-schedule set --job-schedule-id
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--allow-task-preemption]
                          [--do-not-run-after]
                          [--do-not-run-until]
                          [--if-match]
                          [--if-modified-since]
                          [--if-none-match]
                          [--if-unmodified-since]
                          [--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-metadata]
                          [--json-file]
                          [--max-parallel-tasks]
                          [--metadata]
                          [--on-all-tasks-complete {noaction, terminatejob}]
                          [--pool-id]
                          [--priority]
                          [--recurrence-interval]
                          [--required-slots]
                          [--start-window]
                          [--uses-task-dependencies]

Parâmetros Exigidos

--job-schedule-id

A ID da Agenda de Trabalho a ser atualizada.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--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.

--do-not-run-after

Se você não especificar um horário doNotRunAfter e estiver criando uma Agenda de Trabalho recorrente, a Agenda de Trabalho permanecerá ativa até que você a encerre explicitamente. O formato esperado é um carimbo de data/hora ISO-8601.

--do-not-run-until

Se você não especificar um horário doNotRunUntil , a agenda ficará pronta para criar Jobs imediatamente. O formato esperado é um carimbo de data/hora ISO-8601.

--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-manager-task-application-package-references

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

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-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'.

--json-file

Um arquivo que contém a especificação do parâmetro de patch de agenda de trabalho em JSON (formatado para corresponder ao respectivo corpo da API REST). Se esse parâmetro for especificado, todos os 'Argumentos de agendamento 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 você não especificar esse elemento, os metadados existentes permanecerão 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 em um trabalho criado sob essa agenda 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 Tarefas; se você quiser usar o encerramento automático do trabalho sem um Gerenciador de trabalhos, você deve inicialmente definir onAllTasksComplete como noaction e atualizar as propriedades do trabalho para definir onAllTasksComplete para encerrar o trabalho assim que terminar de adicionar tarefas. O padrão é noaction.

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 dos empregos criados no âmbito deste calendário. 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. Essa prioridade é usada como padrão para todos os Trabalhos na Agenda de Trabalhos. Você pode atualizar a prioridade de um Trabalho depois que ele tiver sido criado usando a API de Trabalho de atualização.

--recurrence-interval

Como uma Agenda de Trabalho pode ter no máximo um Trabalho ativo sob ela a qualquer momento, se for hora de criar um novo Trabalho em uma Agenda de Trabalho, mas o Trabalho anterior ainda estiver em execução, o serviço em Lote não criará o novo Trabalho até que o Trabalho anterior seja concluído. Se o Trabalho anterior não for concluído dentro do período startWindow do novo recurrenceInterval, nenhum novo Trabalho será agendado para esse intervalo. Para trabalhos recorrentes, você normalmente deve especificar um jobManagerTask no jobSpecification. Se você não usar jobManagerTask, precisará de um processo externo para monitorar quando os Trabalhos são criados, adicionar Tarefas aos Trabalhos e encerrar os Trabalhos prontos para a próxima recorrência. O padrão é que a agenda não se repita: um Job é criado, dentro do startWindow após o tempo doNotRunUntil e o agendamento é concluído assim que esse Job termina. O valor mínimo é de 1 minuto. Se você especificar um valor menor, o serviço em lote rejeitará o agendamento com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). O formato esperado é uma duração ISO-8601.

--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.

--start-window

Se um Job não for criado dentro do intervalo startWindow, a 'oportunidade' será perdida; nenhum trabalho será criado até a próxima recorrência do agendamento. Se o agendamento for recorrente e startWindow for maior que o intervalo de recorrência, isso será equivalente a um startWindow infinito, porque o Job que é 'devido' em um recurrenceInterval não é transferido para o próximo intervalo de recorrência. O padrão é infinito. O valor mínimo é de 1 minuto. Se você especificar um valor menor, o serviço em lote rejeitará o agendamento com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). O formato esperado é uma duração ISO-8601.

--uses-task-dependencies

Se as Tarefas no Trabalho podem definir dependências umas das outras. O padrão é false. Especifique 'true' ou 'false' para atualizar a propriedade.

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-schedule show

Editar

Obtém informações sobre a Agenda de Trabalho especificada.

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

Parâmetros Exigidos

--job-schedule-id

A ID da Agenda de Trabalho a ser obtida.

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-schedule stop

Editar

Encerra uma agenda de trabalho.

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

Parâmetros Exigidos

--job-schedule-id

A ID da Agenda de Trabalho a ser encerrada.

Parâmetros Opcionais

--account-endpoint

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

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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