az batch job-schedule

  • Referência

Gerencie agendas de trabalho em lote.

Comandos

Name Description Tipo Estado
az batch job-schedule create

Adicione uma agenda de trabalho em lote a uma conta.

 Principal GA
az batch job-schedule delete

Exclui uma Agenda de Trabalho da Conta especificada.

 Principal GA
az batch job-schedule disable

Desabilita uma agenda de trabalho.

 Principal GA
az batch job-schedule enable

Habilita uma agenda de trabalho.

 Principal GA
az batch job-schedule list

Lista todas as Agendas de Trabalho na Conta especificada.

 Principal GA
az batch job-schedule reset

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

 Principal GA
az batch job-schedule set

Atualize as propriedades de uma agenda de trabalho.

 Principal GA
az batch job-schedule show

Obtém informações sobre o Cronograma de Trabalho especificado.

 Principal GA
az batch job-schedule stop

Encerra uma agenda de trabalho.

 Principal 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. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--allow-task-preemption

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

--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 tempo doNotRunUntil , o agendamento estará pronto para criar trabalhos 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ífenes e sublinhados, e não pode conter mais de 64 caracteres. O ID preserva maiúsculas e minúsculas (ou seja, você não pode ter dois IDs em uma Conta que diferem apenas por maiúsculas e minúsculas).

--job-manager-task-command-line

Obrigatório. A linha de comando não é executada sob um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser aproveitar esses recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho Tarefa) ou usar a variável de ambiente 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ífenes e sublinhados, e não pode conter mais de 64 caracteres.

--job-manager-task-resource-files

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

--job-max-task-retry-count

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

--job-max-wall-clock-time

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

--json-file

Um arquivo que contém a especificação de agendamento de trabalho na nuvem em JSON (formatado para corresponder ao respetivo 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 qualquer significado aos metadados; é exclusivamente para o uso do código de usuário. Valores separados por espaço no formato 'key=value'.

--on-all-tasks-complete

A ação que o serviço em lote deve executar quando todas as tarefas em um trabalho criado sob essa agenda estiverem no estado concluído. Observe que, se um Trabalho não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Esta opção é, portanto, mais comumente usada com uma tarefa do Job Manager; se você quiser usar o encerramento automático do trabalho sem um Gerenciador de tarefas, 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 aceites: noaction, terminatejob
--pool-id

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

--priority

A prioridade dos postos de trabalho criados ao abrigo 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 predefinido é 0. Essa prioridade é usada como padrão para todos os Trabalhos sob a 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 Job anterior não terminar dentro do período startWindow do novo recurrenceInterval, nenhum novo Job 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 forem criados, adicionar Tarefas aos Trabalhos e encerrar os Trabalhos prontos para a próxima recorrência. O padrão é que o agendamento não se repita: um Job é criado, dentro de 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 Batch 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. A predefinição é 1. Uma Tarefa só pode ser agendada para ser executada em um nó de computação se o nó tiver slots de agendamento livres suficientes disponíveis. Para tarefas de várias instâncias, essa propriedade não é suportada e não deve ser especificada.

--start-window

Se um trabalho não for criado dentro do intervalo startWindow, a 'oportunidade' será perdida; nenhum trabalho será criado até a próxima recorrência do cronograma. Se o agendamento for recorrente e o startWindow for maior do que o intervalo de recorrência, isso será equivalente a um startWindow infinito, porque o Job que é 'devido' em um recurrenceInterval não é transportado 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 Batch 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 entre si. O padrão é false. True se a bandeira estiver presente.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 Trabalhos, 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 estão mais acessíveis quando a Agenda de Trabalho é excluída, embora ainda sejam contadas para as estatísticas de 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 Obrigatórios

--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. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az batch job-schedule disable

Editar

Desabilita uma agenda de trabalho.

Nenhum novo trabalho será criado até que o cronograma de trabalho seja ativado 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 Obrigatórios

--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. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--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. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--expand

Uma cláusula $expand OData.

--filter

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

--select

Uma cláusula OData $select.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az batch job-schedule reset

Editar

Redefina 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 Obrigatórios

--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. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--allow-task-preemption

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

--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 tempo doNotRunUntil , o agendamento estará pronto para criar trabalhos 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 tempo especificado.

--if-none-match

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

--if-unmodified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço não tiver sido modificado desde o tempo 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 sob um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser aproveitar esses recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho Tarefa) ou usar a variável de ambiente 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ífenes e sublinhados, e não pode conter mais de 64 caracteres.

--job-manager-task-resource-files

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

--job-metadata

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

--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 respetivo corpo da API REST). Se esse parâmetro for especificado, todos os 'Argumentos da Agenda 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; Com efeito, todos os metadados existentes são eliminados. 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 estiverem no estado concluído. Observe que, se um Trabalho não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Esta opção é, portanto, mais comumente usada com uma tarefa do Job Manager; se você quiser usar o encerramento automático do trabalho sem um Gerenciador de tarefas, 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 aceites: noaction, terminatejob
--pool-id

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

--priority

A prioridade dos postos de trabalho criados ao abrigo 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 predefinido é 0. Essa prioridade é usada como padrão para todos os Trabalhos sob a 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 Job anterior não terminar dentro do período startWindow do novo recurrenceInterval, nenhum novo Job 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 forem criados, adicionar Tarefas aos Trabalhos e encerrar os Trabalhos prontos para a próxima recorrência. O padrão é que o agendamento não se repita: um Job é criado, dentro de 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 Batch 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. A predefinição é 1. Uma Tarefa só pode ser agendada para ser executada em um nó de computação se o nó tiver slots de agendamento livres suficientes disponíveis. Para tarefas de várias instâncias, essa propriedade não é suportada e não deve ser especificada.

--start-window

Se um trabalho não for criado dentro do intervalo startWindow, a 'oportunidade' será perdida; nenhum trabalho será criado até a próxima recorrência do cronograma. Se o agendamento for recorrente e o startWindow for maior do que o intervalo de recorrência, isso será equivalente a um startWindow infinito, porque o Job que é 'devido' em um recurrenceInterval não é transportado 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 Batch 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 entre si. O padrão é false. True se a bandeira estiver presente.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 o agendamento 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 Obrigatórios

--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. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--allow-task-preemption

Se as tarefas neste trabalho podem ser antecipadas por outros trabalhos de alta prioridade. Se o valor for definido como True, outros trabalhos de alta prioridade enviados ao sistema terão precedência e poderão enfileirar novamente as tarefas desse trabalho. Você pode atualizar allowTaskPreemption de um trabalho depois que ele tiver sido criado usando a API do trabalho de atualização. 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 tempo doNotRunUntil , o agendamento estará pronto para criar trabalhos 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 tempo especificado.

--if-none-match

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

--if-unmodified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço não tiver sido modificado desde o tempo 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 sob um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser aproveitar esses recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho Tarefa) ou usar a variável de ambiente 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ífenes e sublinhados, e não pode conter mais de 64 caracteres.

--job-manager-task-resource-files

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

--job-metadata

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

--json-file

Um arquivo que contém a especificação do parâmetro de patch de agendamento de trabalho em JSON (formatado para corresponder ao respetivo corpo da API REST). Se esse parâmetro for especificado, todos os 'Argumentos da Agenda 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 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 em um trabalho criado sob essa agenda estiverem no estado concluído. Observe que, se um Trabalho não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Esta opção é, portanto, mais comumente usada com uma tarefa do Job Manager; se você quiser usar o encerramento automático do trabalho sem um Gerenciador de tarefas, 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 aceites: noaction, terminatejob
--pool-id

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

--priority

A prioridade dos postos de trabalho criados ao abrigo 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 predefinido é 0. Essa prioridade é usada como padrão para todos os Trabalhos sob a 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 Job anterior não terminar dentro do período startWindow do novo recurrenceInterval, nenhum novo Job 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 forem criados, adicionar Tarefas aos Trabalhos e encerrar os Trabalhos prontos para a próxima recorrência. O padrão é que o agendamento não se repita: um Job é criado, dentro de 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 Batch 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. A predefinição é 1. Uma Tarefa só pode ser agendada para ser executada em um nó de computação se o nó tiver slots de agendamento livres suficientes disponíveis. Para tarefas de várias instâncias, essa propriedade não é suportada e não deve ser especificada.

--start-window

Se um trabalho não for criado dentro do intervalo startWindow, a 'oportunidade' será perdida; nenhum trabalho será criado até a próxima recorrência do cronograma. Se o agendamento for recorrente e o startWindow for maior do que o intervalo de recorrência, isso será equivalente a um startWindow infinito, porque o Job que é 'devido' em um recurrenceInterval não é transportado 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 Batch 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 entre si. O padrão é false. Especifique 'true' ou 'false' para atualizar a propriedade.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az batch job-schedule show

Editar

Obtém informações sobre o Cronograma de Trabalho especificado.

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 Obrigatórios

--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. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--expand

Uma cláusula $expand OData.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--select

Uma cláusula OData $select.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--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. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

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

--account-name

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

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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