BatchJobSpecificationOutput interface
Especifica os detalhes dos Trabalhos a serem criados em um agendamento.
Propriedades
| allow |
Se as tarefas neste trabalho podem ser preempidas por outros trabalhos de alta prioridade. (Essa propriedade não está disponível por padrão. Entre em contato com o suporte para obter mais informações) Se o valor for definido como True, outros trabalhos de alta prioridade enviados ao sistema terão precedência e poderão recolocar tarefas na fila desse trabalho. Você pode atualizar o allowTaskPreemption de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização. |
| common |
Uma lista de configurações comuns de variável de ambiente. Essas variáveis de ambiente são definidas para todas as Tarefas em Trabalhos criadas nessa agenda (incluindo as Tarefas de Preparação de Trabalho, Preparação de Trabalho e Liberação de Trabalho). Tarefas Individuais podem substituir uma configuração de ambiente especificada aqui especificando o mesmo nome de configuração com um valor diferente. |
| constraints | As restrições de execução para trabalhos criados nessa agenda. |
| display |
O nome de exibição para trabalhos criados nessa agenda. O nome não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024. |
| job |
Os detalhes de uma Tarefa do Gerenciador de Trabalhos a ser iniciada quando um trabalho é iniciado nessa agenda. Se o Trabalho não especificar uma Tarefa do Gerenciador de Trabalhos, o usuário deverá adicionar explicitamente Tarefas ao Trabalho usando a API de Tarefa. Se o Trabalho especificar uma Tarefa do Gerenciador de Trabalhos, o serviço Do Lote criará a Tarefa do Gerenciador de Trabalhos quando o Trabalho for criado e tentará agendar a Tarefa do Gerenciador de Trabalhos antes de agendar outras tarefas no Trabalho. |
| job |
A Tarefa de Preparação do Trabalho para Trabalhos criada neste agendamento. Se um trabalho tiver uma tarefa de preparação de trabalho, o serviço do Lote executará a Tarefa de Preparação de Trabalho em um nó antes de iniciar qualquer tarefa desse trabalho nesse nó de computação. |
| job |
A Tarefa de Liberação de Trabalho para Trabalhos criada nessa agenda. A principal finalidade da Tarefa de Liberação de Trabalho é desfazer alterações em nós feitas pela Tarefa de Preparação do Trabalho. As atividades de exemplo incluem a exclusão de arquivos locais ou o desligamento de serviços que foram iniciados como parte da preparação do trabalho. Uma tarefa de liberação de trabalho não pode ser especificada sem especificar também uma tarefa de preparação de trabalho para o trabalho. O serviço Lote executa a Tarefa de Liberação de Trabalho nos Nós de Computação que executaram a Tarefa de Preparação do Trabalho. |
| max |
O número máximo de tarefas que podem ser executadas em paralelo para o trabalho. (Essa propriedade não está disponível por padrão. Entre em contato com o suporte para obter mais informações) O valor de maxParallelTasks deve ser -1 ou maior que 0, se especificado. Se não for especificado, o valor padrão será -1, o que significa que não há limite para o número de tarefas que podem ser executadas ao mesmo tempo. Você pode atualizar maxParallelTasks de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização. |
| metadata | Uma lista de pares nome-valor associados a cada trabalho criado nesse agendamento como metadados. O serviço do Lote não atribui nenhum significado aos metadados; é apenas para o uso do código do usuário. |
| network |
(Essa propriedade não está disponível por padrão. Entre em contato com o suporte para obter mais informações) A configuração de rede do trabalho. |
| on |
A ação que o serviço lote deve executar quando todas as Tarefas em um Trabalho criadas nesse agendamento estão no estado concluído. Observe que, se um trabalho não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Essa opção é, portanto, mais comumente usada com uma tarefa do Gerenciador de Trabalhos; se você quiser usar a terminação automática de trabalho sem um Gerenciador de Trabalhos, inicialmente deverá definir emAllTasksComplete para noaction e atualizar as propriedades de trabalho a serem definidas emAllTasksComplete para encerrar o trabalho depois de terminar de adicionar Tarefas. O padrão é noaction. Valores possíveis: "noaction", "terminatejob" |
| on |
A ação que o serviço do Lote deve executar quando qualquer Tarefa falha em um trabalho criado neste agendamento. Uma tarefa será considerada com falha se tiver falhado se tiver um failureInfo. Um failureInfo será definido se a Tarefa for concluída com um código de saída diferente de zero depois de esgotar sua contagem de repetições ou se houver um erro ao iniciar a Tarefa, por exemplo, devido a um erro de download de arquivo de recurso. O padrão é noaction. Valores possíveis: "noaction", "performexitoptionsjobaction" |
| pool |
O pool no qual o serviço do Lote executa as Tarefas de Trabalhos criadas nesse agendamento. |
| priority | A prioridade dos trabalhos criados nessa agenda. Os valores de prioridade podem variar de -1000 a 1000, com -1000 sendo a prioridade mais baixa e 1000 sendo a prioridade mais alta. O valor padrão é 0. Essa prioridade é usada como o padrão para todos os trabalhos na Agenda de Trabalho. Você pode atualizar a prioridade de um trabalho depois que ele tiver sido criado usando a API de trabalho de atualização. |
| uses |
Se as tarefas no trabalho podem definir dependências entre si. O padrão é false. |
Detalhes da propriedade
allowTaskPreemption
Se as tarefas neste trabalho podem ser preempidas por outros trabalhos de alta prioridade. (Essa propriedade não está disponível por padrão. Entre em contato com o suporte para obter mais informações) Se o valor for definido como True, outros trabalhos de alta prioridade enviados ao sistema terão precedência e poderão recolocar tarefas na fila desse trabalho. Você pode atualizar o allowTaskPreemption de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização.
allowTaskPreemption?: boolean
Valor da propriedade
boolean
commonEnvironmentSettings
Uma lista de configurações comuns de variável de ambiente. Essas variáveis de ambiente são definidas para todas as Tarefas em Trabalhos criadas nessa agenda (incluindo as Tarefas de Preparação de Trabalho, Preparação de Trabalho e Liberação de Trabalho). Tarefas Individuais podem substituir uma configuração de ambiente especificada aqui especificando o mesmo nome de configuração com um valor diferente.
commonEnvironmentSettings?: EnvironmentSettingOutput[]
Valor da propriedade
constraints
As restrições de execução para trabalhos criados nessa agenda.
constraints?: BatchJobConstraintsOutput
Valor da propriedade
displayName
O nome de exibição para trabalhos criados nessa agenda. O nome não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024.
displayName?: string
Valor da propriedade
string
jobManagerTask
Os detalhes de uma Tarefa do Gerenciador de Trabalhos a ser iniciada quando um trabalho é iniciado nessa agenda. Se o Trabalho não especificar uma Tarefa do Gerenciador de Trabalhos, o usuário deverá adicionar explicitamente Tarefas ao Trabalho usando a API de Tarefa. Se o Trabalho especificar uma Tarefa do Gerenciador de Trabalhos, o serviço Do Lote criará a Tarefa do Gerenciador de Trabalhos quando o Trabalho for criado e tentará agendar a Tarefa do Gerenciador de Trabalhos antes de agendar outras tarefas no Trabalho.
jobManagerTask?: BatchJobManagerTaskOutput
Valor da propriedade
jobPreparationTask
A Tarefa de Preparação do Trabalho para Trabalhos criada neste agendamento. Se um trabalho tiver uma tarefa de preparação de trabalho, o serviço do Lote executará a Tarefa de Preparação de Trabalho em um nó antes de iniciar qualquer tarefa desse trabalho nesse nó de computação.
jobPreparationTask?: BatchJobPreparationTaskOutput
Valor da propriedade
jobReleaseTask
A Tarefa de Liberação de Trabalho para Trabalhos criada nessa agenda. A principal finalidade da Tarefa de Liberação de Trabalho é desfazer alterações em nós feitas pela Tarefa de Preparação do Trabalho. As atividades de exemplo incluem a exclusão de arquivos locais ou o desligamento de serviços que foram iniciados como parte da preparação do trabalho. Uma tarefa de liberação de trabalho não pode ser especificada sem especificar também uma tarefa de preparação de trabalho para o trabalho. O serviço Lote executa a Tarefa de Liberação de Trabalho nos Nós de Computação que executaram a Tarefa de Preparação do Trabalho.
jobReleaseTask?: BatchJobReleaseTaskOutput
Valor da propriedade
maxParallelTasks
O número máximo de tarefas que podem ser executadas em paralelo para o trabalho. (Essa propriedade não está disponível por padrão. Entre em contato com o suporte para obter mais informações) O valor de maxParallelTasks deve ser -1 ou maior que 0, se especificado. Se não for especificado, o valor padrão será -1, o que significa que não há limite para o número de tarefas que podem ser executadas ao mesmo tempo. Você pode atualizar maxParallelTasks de um trabalho depois de ele ter sido criado usando a API de trabalho de atualização.
maxParallelTasks?: number
Valor da propriedade
number
metadata
Uma lista de pares nome-valor associados a cada trabalho criado nesse agendamento como metadados. O serviço do Lote não atribui nenhum significado aos metadados; é apenas para o uso do código do usuário.
metadata?: BatchMetadataItemOutput[]
Valor da propriedade
networkConfiguration
(Essa propriedade não está disponível por padrão. Entre em contato com o suporte para obter mais informações) A configuração de rede do trabalho.
networkConfiguration?: BatchJobNetworkConfigurationOutput
Valor da propriedade
onAllTasksComplete
A ação que o serviço lote deve executar quando todas as Tarefas em um Trabalho criadas nesse agendamento estão no estado concluído. Observe que, se um trabalho não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Essa opção é, portanto, mais comumente usada com uma tarefa do Gerenciador de Trabalhos; se você quiser usar a terminação automática de trabalho sem um Gerenciador de Trabalhos, inicialmente deverá definir emAllTasksComplete para noaction e atualizar as propriedades de trabalho a serem definidas emAllTasksComplete para encerrar o trabalho depois de terminar de adicionar Tarefas. O padrão é noaction.
Valores possíveis: "noaction", "terminatejob"
onAllTasksComplete?: string
Valor da propriedade
string
onTaskFailure
A ação que o serviço do Lote deve executar quando qualquer Tarefa falha em um trabalho criado neste agendamento. Uma tarefa será considerada com falha se tiver falhado se tiver um failureInfo. Um failureInfo será definido se a Tarefa for concluída com um código de saída diferente de zero depois de esgotar sua contagem de repetições ou se houver um erro ao iniciar a Tarefa, por exemplo, devido a um erro de download de arquivo de recurso. O padrão é noaction.
Valores possíveis: "noaction", "performexitoptionsjobaction"
onTaskFailure?: string
Valor da propriedade
string
poolInfo
O pool no qual o serviço do Lote executa as Tarefas de Trabalhos criadas nesse agendamento.
poolInfo: BatchPoolInfoOutput
Valor da propriedade
priority
A prioridade dos trabalhos criados nessa agenda. Os valores de prioridade podem variar de -1000 a 1000, com -1000 sendo a prioridade mais baixa e 1000 sendo a prioridade mais alta. O valor padrão é 0. Essa prioridade é usada como o padrão para todos os trabalhos na Agenda de Trabalho. Você pode atualizar a prioridade de um trabalho depois que ele tiver sido criado usando a API de trabalho de atualização.
priority?: number
Valor da propriedade
number
usesTaskDependencies
Se as tarefas no trabalho podem definir dependências entre si. O padrão é false.
usesTaskDependencies?: boolean
Valor da propriedade
boolean