Task - Add Collection
Adiciona uma coleção de Tarefas à Tarefa especificada.
Tenha em atenção que cada Tarefa tem de ter um ID exclusivo. O serviço Batch pode não devolver os resultados de cada Tarefa pela mesma ordem em que as Tarefas foram submetidas neste pedido. Se o servidor exceder o limite de tempo ou a ligação for fechada durante o pedido, o pedido poderá ter sido parcial ou totalmente processado ou não ter sido de todo. Nesses casos, o utilizador deve emitir novamente o pedido. Tenha em atenção que cabe ao utilizador processar corretamente as falhas ao emitir novamente um pedido. Por exemplo, deve utilizar os mesmos IDs de Tarefa durante uma repetição para que, se a operação anterior tiver êxito, a repetição não crie Tarefas adicionais inesperadamente. Se a resposta contiver quaisquer Tarefas que não foram adicionadas, um cliente pode repetir o pedido. Numa repetição, é mais eficiente submeter novamente apenas Tarefas que não foram adicionadas e omitir Tarefas que foram adicionadas com êxito na primeira tentativa. A duração máxima de uma Tarefa de adição à conclusão é de 180 dias. Se uma Tarefa não tiver sido concluída no prazo de 180 dias após ser adicionada, será terminada pelo serviço Batch e deixada em qualquer estado em que estava nessa altura.
POST {batchUrl}/jobs/{jobId}/addtaskcollection?api-version=2023-11-01.18.0
POST {batchUrl}/jobs/{jobId}/addtaskcollection?timeout={timeout}&api-version=2023-11-01.18.0
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
batch
|
path | True |
string |
O URL base para todos os pedidos de serviço Azure Batch. |
job
|
path | True |
string |
O ID da Tarefa à qual a Coleção de tarefas deve ser adicionada. |
api-version
|
query | True |
string |
Versão da API de Cliente. |
timeout
|
query |
integer int32 |
O tempo máximo que o servidor pode gastar a processar o pedido, em segundos. A predefinição é 30 segundos. |
Cabeçalho do Pedido
Media Types: "application/json; odata=minimalmetadata"
Name | Necessário | Tipo | Description |
---|---|---|---|
client-request-id |
string uuid |
A identidade do pedido gerado pelo autor da chamada, sob a forma de um GUID sem decoração, como chavetas, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Se o servidor deve devolver o client-request-id na resposta. |
|
ocp-date |
string date-time-rfc1123 |
A hora em que o pedido foi emitido. Normalmente, as bibliotecas de cliente definem isto como a hora atual do relógio do sistema; defina-a explicitamente se estiver a chamar a API REST diretamente. |
Corpo do Pedido
Media Types: "application/json; odata=minimalmetadata"
Name | Necessário | Tipo | Description |
---|---|---|---|
value | True |
A coleção de Tarefas a adicionar. A contagem máxima de Tarefas é 100. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Uma resposta que contém os resultados da operação adicionar Coleção de tarefas. Headers
|
|
Other Status Codes |
Erro inesperado |
Segurança
azure_auth
Microsoft Entra fluxo de código de autenticação OAuth 2.0
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Representar a sua conta de utilizador |
Authorization
Type:
apiKey
In:
header
Exemplos
Add a basic collection of tasks |
Add a complex collection of tasks |
Add a basic collection of tasks
Sample Request
POST account.region.batch.azure.com/jobs/jobId/addtaskcollection?api-version=2023-11-01.18.0
{
"value": [
{
"id": "simple1",
"commandLine": "cmd /c dir /s"
},
{
"id": "simple2",
"commandLine": "cmd /c dir /s"
}
]
}
Sample Response
{
"value": [
{
"status": "success",
"taskId": "simple1",
"eTag": "0x8D3D623CD661246",
"lastModified": "2016-09-06T07:02:44.7589958Z",
"location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple1"
},
{
"status": "success",
"taskId": "simple2",
"eTag": "0x8D3D623CD7072CC",
"lastModified": "2016-09-06T07:02:44.8270028Z",
"location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple2"
}
]
}
Add a complex collection of tasks
Sample Request
POST account.region.batch.azure.com/jobs/jobId/addtaskcollection?api-version=2023-11-01.18.0
{
"value": [
{
"id": "complex1",
"commandLine": "cmd /c dir /s",
"resourceFiles": [
{
"autoStorageContainerName": "containerName",
"filePath": "data"
}
],
"environmentSettings": [
{
"name": "env1",
"value": "value1"
},
{
"name": "env2",
"value": "value2"
}
],
"affinityInfo": {
"affinityId": "affinityId"
},
"constraints": {
"maxWallClockTime": "P1D",
"retentionTime": "P2D",
"maxTaskRetryCount": 5
},
"requiredSlots": 2,
"multiInstanceSettings": {
"numberOfInstances": 3,
"coordinationCommandLine": "cmd /c echo coordinating",
"commonResourceFiles": [
{
"httpUrl": "https://common.blob.core.windows.net/",
"filePath": "common.exe"
}
]
}
},
{
"id": "simple3",
"commandLine": "cmd /c dir /s"
}
]
}
Sample Response
{
"value": [
{
"taskId": "simple3",
"status": "success",
"eTag": "0x8D3D623CE295629",
"lastModified": "2016-09-06T07:02:46.0386857Z",
"location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple3"
},
{
"taskId": "complex1",
"status": "success",
"eTag": "0x8D3D623CE29A412",
"lastModified": "2016-09-06T07:02:46.0406802Z",
"location": "https://account.region.batch.azure.com/jobs/jobId/tasks/complex1"
}
]
}
Definições
Name | Description |
---|---|
Access |
Os recursos do Batch aos quais o token concede acesso. |
Affinity |
Uma sugestão de localidade que pode ser utilizada pelo serviço Batch para selecionar um Nó de Computação no qual iniciar uma Tarefa. |
Application |
Uma referência a um Pacote a ser implementado nos Nós de Computação. |
Authentication |
As definições de um token de autenticação que a Tarefa pode utilizar para realizar operações de serviço do Batch. |
Auto |
O âmbito do utilizador automático |
Auto |
Especifica os parâmetros para o utilizador automático que executa uma Tarefa no serviço Batch. |
Batch |
Uma resposta de erro recebida do serviço Azure Batch. |
Batch |
Um item de informações adicionais incluídas numa resposta de erro Azure Batch. |
Compute |
A referência a uma identidade atribuída pelo utilizador associada ao conjunto do Batch que um nó de computação irá utilizar. |
Container |
Um registo de contentor privado. |
Container |
A localização do diretório de trabalho tarefa do contentor. |
Dependency |
Uma ação que o serviço Batch executa em Tarefas que dependem desta Tarefa. |
Elevation |
O nível de elevação do utilizador. |
Environment |
Uma variável de ambiente a definir num processo de Tarefa. |
Error |
Uma mensagem de erro recebida numa resposta de erro Azure Batch. |
Exit |
Como o serviço Batch deve responder se uma Tarefa sair com um código de saída específico. |
Exit |
Um intervalo de códigos de saída e como o serviço Batch deve responder aos códigos de saída dentro desse intervalo. |
Exit |
Especifica como o serviço Batch deve responder quando a Tarefa for concluída. |
Exit |
Especifica como o serviço Batch responde a uma condição de saída específica. |
Http |
Um par de nome-valor de cabeçalho HTTP |
Job |
Uma ação a executar no Trabalho que contém a Tarefa, se a Tarefa for concluída com a condição de saída especificada e a propriedade onTaskFailed da Tarefa for "performExitOptionsJobAction". |
Multi |
Definições que especificam como executar uma Tarefa de várias instâncias. |
Output |
Uma especificação para carregar ficheiros a partir de um Nó de Computação Azure Batch para outra localização depois de o serviço Batch ter terminado de executar o processo de Tarefa. |
Output |
Especifica um destino de carregamento de ficheiros num contentor de armazenamento de blobs do Azure. |
Output |
O destino para o qual um ficheiro deve ser carregado. |
Output |
As condições nas quais um ficheiro de saída de tarefa ou conjunto de ficheiros deve ser carregado. |
Output |
Detalhes sobre uma operação de carregamento de ficheiros de saída, incluindo em que condições efetuar o carregamento. |
Resource |
Um único ficheiro ou vários ficheiros a transferir para um Nó de Computação. |
Task |
Uma coleção de tarefas Azure Batch a adicionar. |
Task |
O resultado da adição de uma coleção de Tarefas a uma Tarefa. |
Task |
Uma Tarefa Azure Batch a adicionar. |
Task |
Resultado de uma única Tarefa adicionada como parte de uma operação adicionar Coleção de tarefas. |
Task |
O estado do pedido adicionar Tarefa. |
Task |
Restrições de execução a aplicar a uma Tarefa. |
Task |
As definições de contentor para uma Tarefa. |
Task |
Especifica quaisquer dependências de uma Tarefa. Qualquer Tarefa especificada explicitamente ou dentro de um intervalo de dependências tem de ser concluída antes de a Tarefa dependente ser agendada. |
Task |
Um intervalo de IDs de Tarefa de que uma Tarefa pode depender. Todas as Tarefas com IDs no intervalo têm de ser concluídas com êxito antes de a Tarefa dependente poder ser agendada. |
User |
A definição da identidade de utilizador na qual a Tarefa é executada. |
AccessScope
Os recursos do Batch aos quais o token concede acesso.
Name | Tipo | Description |
---|---|---|
job |
string |
Concede acesso para efetuar todas as operações na Tarefa que contém a Tarefa. |
AffinityInformation
Uma sugestão de localidade que pode ser utilizada pelo serviço Batch para selecionar um Nó de Computação no qual iniciar uma Tarefa.
Name | Tipo | Description |
---|---|---|
affinityId |
string |
Uma cadeia opaca que representa a localização de um Nó de Computação ou de uma Tarefa que foi executada anteriormente. |
ApplicationPackageReference
Uma referência a um Pacote a ser implementado nos Nós de Computação.
Name | Tipo | Description |
---|---|---|
applicationId |
string |
O ID da aplicação a implementar. |
version |
string |
A versão da aplicação a implementar. Se for omitida, a versão predefinida é implementada. |
AuthenticationTokenSettings
As definições de um token de autenticação que a Tarefa pode utilizar para realizar operações de serviço do Batch.
Name | Tipo | Description |
---|---|---|
access |
Os recursos do Batch aos quais o token concede acesso. |
AutoUserScope
O âmbito do utilizador automático
Name | Tipo | Description |
---|---|---|
pool |
string |
Especifica que a Tarefa é executada como a Conta de utilizador automático comum que é criada em todos os Nós de Computação num Conjunto. |
task |
string |
Especifica que o serviço deve criar um novo utilizador para a Tarefa. |
AutoUserSpecification
Especifica os parâmetros para o utilizador automático que executa uma Tarefa no serviço Batch.
Name | Tipo | Description |
---|---|---|
elevationLevel |
O nível de elevação do utilizador automático. |
|
scope |
O âmbito do utilizador automático |
BatchError
Uma resposta de erro recebida do serviço Azure Batch.
Name | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente. |
message |
Uma mensagem que descreve o erro, destinada a ser adequada para ser apresentada numa interface de utilizador. |
|
values |
Uma coleção de pares chave-valor que contém detalhes adicionais sobre o erro. |
BatchErrorDetail
Um item de informações adicionais incluídas numa resposta de erro Azure Batch.
Name | Tipo | Description |
---|---|---|
key |
string |
Um identificador que especifica o significado da propriedade Valor. |
value |
string |
As informações adicionais incluídas na resposta do erro. |
ComputeNodeIdentityReference
A referência a uma identidade atribuída pelo utilizador associada ao conjunto do Batch que um nó de computação irá utilizar.
Name | Tipo | Description |
---|---|---|
resourceId |
string |
O ID de recurso do ARM da identidade atribuída pelo utilizador. |
ContainerRegistry
Um registo de contentor privado.
Name | Tipo | Description |
---|---|---|
identityReference |
A referência à identidade atribuída pelo utilizador a utilizar para aceder a um Azure Container Registry em vez de nome de utilizador e palavra-passe. |
|
password |
string |
A palavra-passe para iniciar sessão no servidor de registo. |
registryServer |
string |
O URL do registo. |
username |
string |
O nome de utilizador a iniciar sessão no servidor de registo. |
ContainerWorkingDirectory
A localização do diretório de trabalho tarefa do contentor.
Name | Tipo | Description |
---|---|---|
containerImageDefault |
string |
Utilize o diretório de trabalho definido no contentor Imagem. Tenha em atenção que este diretório não conterá os Ficheiros de Recursos transferidos pelo Batch. |
taskWorkingDirectory |
string |
Utilize o diretório de trabalho tarefas do serviço Batch padrão, que irá conter os Ficheiros de Recurso de Tarefa preenchidos pelo Batch. |
DependencyAction
Uma ação que o serviço Batch executa em Tarefas que dependem desta Tarefa.
Name | Tipo | Description |
---|---|---|
block |
string |
Bloqueia tarefas à espera desta tarefa, impedindo-as de serem agendadas. |
satisfy |
string |
Satisfazer tarefas à espera desta tarefa; Assim que todas as dependências forem satisfeitas, a tarefa será agendada para ser executada. |
ElevationLevel
O nível de elevação do utilizador.
Name | Tipo | Description |
---|---|---|
admin |
string |
O utilizador é um utilizador com acesso elevado e funciona com permissões de Administrador completas. |
nonadmin |
string |
O utilizador é um utilizador padrão sem acesso elevado. |
EnvironmentSetting
Uma variável de ambiente a definir num processo de Tarefa.
Name | Tipo | Description |
---|---|---|
name |
string |
O nome da variável de ambiente. |
value |
string |
O valor da variável de ambiente. |
ErrorMessage
Uma mensagem de erro recebida numa resposta de erro Azure Batch.
Name | Tipo | Description |
---|---|---|
lang |
string |
O código de idioma da mensagem de erro |
value |
string |
O texto da mensagem. |
ExitCodeMapping
Como o serviço Batch deve responder se uma Tarefa sair com um código de saída específico.
Name | Tipo | Description |
---|---|---|
code |
integer |
Um código de saída do processo. |
exitOptions |
Como o serviço Batch deve responder se a Tarefa sair com este código de saída. |
ExitCodeRangeMapping
Um intervalo de códigos de saída e como o serviço Batch deve responder aos códigos de saída dentro desse intervalo.
Name | Tipo | Description |
---|---|---|
end |
integer |
O último código de saída no intervalo. |
exitOptions |
Como o serviço Batch deve responder se a Tarefa sair com um código de saída no intervalo começar a terminar (inclusive). |
|
start |
integer |
O primeiro código de saída no intervalo. |
ExitConditions
Especifica como o serviço Batch deve responder quando a Tarefa for concluída.
Name | Tipo | Description |
---|---|---|
default |
Como o serviço Batch deve responder se a Tarefa falhar com uma condição de saída não abrangida por nenhuma das outras propriedades. |
|
exitCodeRanges |
Uma lista de intervalos de código de saída de tarefas e como o serviço Batch deve responder aos mesmos. |
|
exitCodes |
Uma lista de códigos de saída de tarefas individuais e como o serviço Batch deve responder aos mesmos. |
|
fileUploadError |
Como o serviço Batch deve responder se ocorrer um erro de carregamento de ficheiros. |
|
preProcessingError |
Como o serviço Batch deve responder se a Tarefa não iniciar devido a um erro. |
ExitOptions
Especifica como o serviço Batch responde a uma condição de saída específica.
Name | Tipo | Description |
---|---|---|
dependencyAction |
Uma ação que o serviço Batch executa em Tarefas que dependem desta Tarefa. |
|
jobAction |
Uma ação a executar no Trabalho que contém a Tarefa, se a Tarefa for concluída com a condição de saída especificada e a propriedade onTaskFailed da Tarefa for "performExitOptionsJobAction". |
HttpHeader
Um par de nome-valor de cabeçalho HTTP
Name | Tipo | Description |
---|---|---|
name |
string |
O nome não sensível a maiúsculas e minúsculas do cabeçalho a utilizar ao carregar ficheiros de saída |
value |
string |
O valor do cabeçalho a ser utilizado ao carregar ficheiros de saída |
JobAction
Uma ação a executar no Trabalho que contém a Tarefa, se a Tarefa for concluída com a condição de saída especificada e a propriedade onTaskFailed da Tarefa for "performExitOptionsJobAction".
Name | Tipo | Description |
---|---|---|
disable |
string |
Desative a Tarefa. Isto é equivalente a chamar a API de Tarefa desativada, com um valor disableTasks de requeue. |
none |
string |
Não tome nenhuma ação. |
terminate |
string |
Termine a Tarefa. O terminateReason na executionInfo da Tarefa está definido como "TaskFailed". |
MultiInstanceSettings
Definições que especificam como executar uma Tarefa de várias instâncias.
Name | Tipo | Description |
---|---|---|
commonResourceFiles |
Uma lista de ficheiros que o serviço Batch irá transferir antes de executar a linha de comandos de coordenação. |
|
coordinationCommandLine |
string |
A linha de comandos a executar em todos os Nós de Computação para permitir que se coordenem quando o principal executa o comando tarefa principal. |
numberOfInstances |
integer |
O número de Nós de Computação necessários para a Tarefa. |
OutputFile
Uma especificação para carregar ficheiros a partir de um Nó de Computação Azure Batch para outra localização depois de o serviço Batch ter terminado de executar o processo de Tarefa.
Name | Tipo | Description |
---|---|---|
destination |
O destino dos ficheiros de saída. |
|
filePattern |
string |
Um padrão que indica quais os ficheiros a carregar. |
uploadOptions |
Opções adicionais para a operação de carregamento, incluindo em que condições efetuar o carregamento. |
OutputFileBlobContainerDestination
Especifica um destino de carregamento de ficheiros num contentor de armazenamento de blobs do Azure.
Name | Tipo | Description |
---|---|---|
containerUrl |
string |
O URL do contentor no Armazenamento de Blobs do Azure para o qual carregar o(s) ficheiro(s). |
identityReference |
A referência à identidade atribuída pelo utilizador a utilizar para aceder a Armazenamento de Blobs do Azure especificado pelo containerUrl |
|
path |
string |
O blob de destino ou o diretório virtual no contentor do Armazenamento do Azure. |
uploadHeaders |
Uma lista de pares nome-valor para cabeçalhos a serem utilizados no carregamento de ficheiros de saída |
OutputFileDestination
O destino para o qual um ficheiro deve ser carregado.
Name | Tipo | Description |
---|---|---|
container |
Uma localização no armazenamento de blobs do Azure para a qual os ficheiros são carregados. |
OutputFileUploadCondition
As condições nas quais um ficheiro de saída de tarefa ou conjunto de ficheiros deve ser carregado.
Name | Tipo | Description |
---|---|---|
taskcompletion |
string |
Carregue o(s) ficheiro(s) após o processo de tarefa sair, independentemente do código de saída. |
taskfailure |
string |
Carregue o(s) ficheiro(s) apenas após o processo de tarefa sair com um código de saída diferente de zero. |
tasksuccess |
string |
Carregue o(s) ficheiro(s) apenas após o processo de tarefa sair com um código de saída de 0. |
OutputFileUploadOptions
Detalhes sobre uma operação de carregamento de ficheiros de saída, incluindo em que condições efetuar o carregamento.
Name | Tipo | Description |
---|---|---|
uploadCondition |
As condições nas quais o ficheiro de saída da Tarefa ou o conjunto de ficheiros devem ser carregados. |
ResourceFile
Um único ficheiro ou vários ficheiros a transferir para um Nó de Computação.
Name | Tipo | Description |
---|---|---|
autoStorageContainerName |
string |
O nome do contentor de armazenamento na Conta de armazenamento automático. |
blobPrefix |
string |
O prefixo de blobs a utilizar ao transferir blobs a partir de um contentor do Armazenamento do Azure. Apenas os blobs cujos nomes começam com o prefixo especificado serão transferidos. |
fileMode |
string |
O atributo do modo de permissão de ficheiro no formato octal. |
filePath |
string |
A localização no Nó de Computação para o qual transferir os ficheiros, relativamente ao diretório de trabalho da Tarefa. |
httpUrl |
string |
O URL do ficheiro a transferir. |
identityReference |
A referência à identidade atribuída pelo utilizador a utilizar para aceder a Armazenamento de Blobs do Azure especificado por storageContainerUrl ou httpUrl |
|
storageContainerUrl |
string |
O URL do contentor de blobs no Armazenamento de Blobs do Azure. |
TaskAddCollectionParameter
Uma coleção de tarefas Azure Batch a adicionar.
Name | Tipo | Description |
---|---|---|
value |
A coleção de Tarefas a adicionar. A contagem máxima de Tarefas é de 100. |
TaskAddCollectionResult
O resultado da adição de uma coleção de Tarefas a uma Tarefa.
Name | Tipo | Description |
---|---|---|
value |
Os resultados da operação adicionar Coleção de tarefas. |
TaskAddParameter
Uma Tarefa Azure Batch a adicionar.
Name | Tipo | Description |
---|---|---|
affinityInfo |
Uma sugestão de localidade que pode ser utilizada pelo serviço Batch para selecionar um Nó de Computação no qual iniciar a nova Tarefa. |
|
applicationPackageReferences |
Uma lista de Pacotes que o serviço Batch irá implementar no Nó de Computação antes de executar a linha de comandos. |
|
authenticationTokenSettings |
As definições de um token de autenticação que a Tarefa pode utilizar para efetuar operações de serviço do Batch. |
|
commandLine |
string |
A linha de comandos da Tarefa. |
constraints |
As restrições de execução que se aplicam a esta Tarefa. |
|
containerSettings |
As definições do contentor no qual a Tarefa é executada. |
|
dependsOn |
As Tarefas de que esta Tarefa depende. |
|
displayName |
string |
Um nome a apresentar para a Tarefa. |
environmentSettings |
Uma lista de definições de variáveis de ambiente para a Tarefa. |
|
exitConditions |
Especifica como o serviço Batch deve responder quando a Tarefa for concluída. |
|
id |
string |
Uma cadeia que identifica exclusivamente a Tarefa na Tarefa. |
multiInstanceSettings |
Um objeto que indica que a Tarefa é uma Tarefa de várias instâncias e contém informações sobre como executar a Tarefa de várias instâncias. |
|
outputFiles |
Uma lista de ficheiros que o serviço Batch irá carregar a partir do Nó de Computação depois de executar a linha de comandos. |
|
requiredSlots |
integer |
O número de blocos de agendamento que a Tarefa precisava de executar. |
resourceFiles |
Uma lista de ficheiros que o serviço Batch irá transferir para o Nó de Computação antes de executar a linha de comandos. |
|
userIdentity |
A identidade de utilizador na qual a Tarefa é executada. |
TaskAddResult
Resultado de uma única Tarefa adicionada como parte de uma operação adicionar Coleção de tarefas.
Name | Tipo | Description |
---|---|---|
eTag |
string |
A ETag da Tarefa, se a Tarefa tiver sido adicionada com êxito. |
error |
O erro encontrado ao tentar adicionar a Tarefa. |
|
lastModified |
string |
A hora da última modificação da Tarefa. |
location |
string |
O URL da Tarefa, se a Tarefa tiver sido adicionada com êxito. |
status |
O estado do pedido adicionar Tarefa. |
|
taskId |
string |
O ID da Tarefa para a qual este é o resultado. |
TaskAddStatus
O estado do pedido adicionar Tarefa.
Name | Tipo | Description |
---|---|---|
clienterror |
string |
A Tarefa não foi adicionada devido a um erro de cliente e não deve ser repetida sem modificar o pedido conforme adequado. |
servererror |
string |
A tarefa não foi adicionada devido a um erro do servidor e pode ser repetida sem modificação. |
success |
string |
A Tarefa foi adicionada com êxito. |
TaskConstraints
Restrições de execução a aplicar a uma Tarefa.
Name | Tipo | Description |
---|---|---|
maxTaskRetryCount |
integer |
O número máximo de vezes que a Tarefa pode ser repetida. O serviço Batch repetirá uma Tarefa se o código de saída não for zero. |
maxWallClockTime |
string |
O tempo máximo decorrido que a Tarefa pode executar, medido desde o início da Tarefa. Se a Tarefa não for concluída dentro do limite de tempo, o serviço Batch termina-a. |
retentionTime |
string |
O tempo mínimo para manter o diretório Tarefa no Nó de Computação onde foi executado, desde o momento em que conclui a execução. Após este período de tempo, o serviço Batch poderá eliminar o diretório Tarefas e todos os respetivos conteúdos. |
TaskContainerSettings
As definições de contentor para uma Tarefa.
Name | Tipo | Description |
---|---|---|
containerRunOptions |
string |
Opções adicionais para o comando de criação de contentor. |
imageName |
string |
A Imagem a utilizar para criar o contentor no qual a Tarefa será executada. |
registry |
O registo privado que contém o contentor Imagem. |
|
workingDirectory |
A localização do diretório de trabalho da Tarefa de contentor. |
TaskDependencies
Especifica quaisquer dependências de uma Tarefa. Qualquer Tarefa especificada explicitamente ou dentro de um intervalo de dependências tem de ser concluída antes de a Tarefa dependente ser agendada.
Name | Tipo | Description |
---|---|---|
taskIdRanges |
A lista de intervalos de ID de Tarefa de que esta Tarefa depende. Todas as Tarefas em todos os intervalos têm de ser concluídas com êxito antes de a Tarefa dependente poder ser agendada. |
|
taskIds |
string[] |
A lista de IDs de Tarefa de que esta Tarefa depende. Todas as Tarefas nesta lista têm de ser concluídas com êxito antes de a Tarefa dependente poder ser agendada. |
TaskIdRange
Um intervalo de IDs de Tarefa de que uma Tarefa pode depender. Todas as Tarefas com IDs no intervalo têm de ser concluídas com êxito antes de a Tarefa dependente poder ser agendada.
Name | Tipo | Description |
---|---|---|
end |
integer |
O último ID da Tarefa no intervalo. |
start |
integer |
O primeiro ID da Tarefa no intervalo. |
UserIdentity
A definição da identidade de utilizador na qual a Tarefa é executada.
Name | Tipo | Description |
---|---|---|
autoUser |
O utilizador automático no qual a Tarefa é executada. |
|
username |
string |
O nome da identidade de utilizador na qual a Tarefa é executada. |