Compartilhar via


JobAddParameter interface

Uma interface que representa JobAddParameter.

Propriedades

commonEnvironmentSettings

A lista de configurações comuns de variável de ambiente. Essas variáveis de ambiente são definidas para todas as Tarefas no Trabalho (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 o Trabalho.

displayName

O nome de exibição do Trabalho. O nome de exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024.

id

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

jobManagerTask

Detalhes de uma Tarefa do Gerenciador de Trabalhos a ser iniciada quando o Trabalho for iniciado. Se o Trabalho não especificar uma Tarefa do Gerenciador de Trabalhos, o usuário deverá adicionar explicitamente Tarefas ao Trabalho. 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. A finalidade típica da Tarefa do Gerenciador de Trabalho é controlar e/ou monitorar a execução do trabalho, por exemplo, decidindo quais tarefas adicionais serão executadas, determinando quando o trabalho está concluído etc. (No entanto, uma Tarefa do Gerenciador de Trabalho não está restrita a essas atividades – é uma Tarefa completa no sistema e executar todas as ações necessárias para o Trabalho.) Por exemplo, uma Tarefa do Gerenciador de Trabalhos pode baixar um arquivo especificado como um parâmetro, analisar o conteúdo desse arquivo e enviar tarefas adicionais com base nesse conteúdo.

jobPreparationTask

A tarefa de preparação do trabalho. 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.

jobReleaseTask

A tarefa de liberaçã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 que executaram a Tarefa de Preparação de Trabalho. A principal finalidade da Tarefa de Liberação de Trabalho é desfazer alterações nos Nós de Computação 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.

metadata

Uma lista de pares nome-valor associados ao Trabalho como metadados. O serviço do Lote não atribui nenhum significado aos metadados; é apenas para o uso do código do usuário.

networkConfiguration

A configuração de rede do Trabalho.

onAllTasksComplete

A ação que o serviço lote deve executar quando todas as Tarefas no Trabalho estão no estado concluído. Observe que, se um trabalho não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Essa opção é, portanto, mais comumente usada com uma tarefa do Gerenciador de Trabalhos; se você quiser usar a terminação automática de trabalho sem um Gerenciador de Trabalhos, inicialmente deverá definir emAllTasksComplete para noaction e atualizar as propriedades de trabalho a serem definidas emAllTasksComplete para encerrar o trabalho depois de terminar de adicionar Tarefas. O padrão é noaction. Os valores possíveis incluem: 'noAction', 'terminateJob'

onTaskFailure

A ação que o serviço lote deve executar quando qualquer Tarefa no Trabalho falhar. Uma tarefa será considerada com falha se houver uma falhaInfo. 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. Os valores possíveis incluem: 'noAction', 'performExitOptionsJobAction'

poolInfo

O pool no qual o serviço lote executa as Tarefas do Trabalho.

priority

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

usesTaskDependencies

Se as tarefas no trabalho podem definir dependências entre si. O padrão é false.

Detalhes da propriedade

commonEnvironmentSettings

A lista de configurações comuns de variável de ambiente. Essas variáveis de ambiente são definidas para todas as Tarefas no Trabalho (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?: EnvironmentSetting[]

Valor da propriedade

constraints

As restrições de execução para o Trabalho.

constraints?: JobConstraints

Valor da propriedade

displayName

O nome de exibição do Trabalho. O nome de exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024.

displayName?: string

Valor da propriedade

string

id

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

id: string

Valor da propriedade

string

jobManagerTask

Detalhes de uma Tarefa do Gerenciador de Trabalhos a ser iniciada quando o Trabalho for iniciado. Se o Trabalho não especificar uma Tarefa do Gerenciador de Trabalhos, o usuário deverá adicionar explicitamente Tarefas ao Trabalho. 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. A finalidade típica da Tarefa do Gerenciador de Trabalho é controlar e/ou monitorar a execução do trabalho, por exemplo, decidindo quais tarefas adicionais serão executadas, determinando quando o trabalho está concluído etc. (No entanto, uma Tarefa do Gerenciador de Trabalho não está restrita a essas atividades – é uma Tarefa completa no sistema e executar todas as ações necessárias para o Trabalho.) Por exemplo, uma Tarefa do Gerenciador de Trabalhos pode baixar um arquivo especificado como um parâmetro, analisar o conteúdo desse arquivo e enviar tarefas adicionais com base nesse conteúdo.

jobManagerTask?: JobManagerTask

Valor da propriedade

jobPreparationTask

A tarefa de preparação do trabalho. 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?: JobPreparationTask

Valor da propriedade

jobReleaseTask

A tarefa de liberaçã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 que executaram a Tarefa de Preparação de Trabalho. A principal finalidade da Tarefa de Liberação de Trabalho é desfazer alterações nos Nós de Computação 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.

jobReleaseTask?: JobReleaseTask

Valor da propriedade

metadata

Uma lista de pares nome-valor associados ao Trabalho como metadados. O serviço do Lote não atribui nenhum significado aos metadados; é apenas para o uso do código do usuário.

metadata?: MetadataItem[]

Valor da propriedade

networkConfiguration

A configuração de rede do Trabalho.

networkConfiguration?: JobNetworkConfiguration

Valor da propriedade

onAllTasksComplete

A ação que o serviço lote deve executar quando todas as Tarefas no Trabalho estão no estado concluído. Observe que, se um trabalho não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Essa opção é, portanto, mais comumente usada com uma tarefa do Gerenciador de Trabalhos; se você quiser usar a terminação automática de trabalho sem um Gerenciador de Trabalhos, inicialmente deverá definir emAllTasksComplete para noaction e atualizar as propriedades de trabalho a serem definidas emAllTasksComplete para encerrar o trabalho depois de terminar de adicionar Tarefas. O padrão é noaction. Os valores possíveis incluem: 'noAction', 'terminateJob'

onAllTasksComplete?: OnAllTasksComplete

Valor da propriedade

onTaskFailure

A ação que o serviço lote deve executar quando qualquer Tarefa no Trabalho falhar. Uma tarefa será considerada com falha se houver uma falhaInfo. 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. Os valores possíveis incluem: 'noAction', 'performExitOptionsJobAction'

onTaskFailure?: OnTaskFailure

Valor da propriedade

poolInfo

O pool no qual o serviço lote executa as Tarefas do Trabalho.

poolInfo: PoolInformation

Valor da propriedade

priority

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

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