Task - Get
Obtém informações sobre a Tarefa especificada.
Para tarefas de várias instâncias, informações como affinityId, executionInfo e nodeInfo referem-se à Tarefa primária. Use a API de subtarefas de lista para recuperar informações sobre subtarefas.
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?api-version=2024-07-01.20.0
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?$select={$select}&$expand={$expand}&timeout={timeout}&api-version=2024-07-01.20.0
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
batch
|
path | True |
string |
A URL base para todas as solicitações de serviço do Lote do Azure. |
job
|
path | True |
string |
A ID do trabalho que contém a Tarefa. |
task
|
path | True |
string |
A ID da Tarefa sobre a qual obter informações. |
api-version
|
query | True |
string |
Versão da API do cliente. |
$expand
|
query |
string |
Uma cláusula $expand OData. |
|
$select
|
query |
string |
Uma cláusula $select OData. |
|
timeout
|
query |
integer int32 |
O tempo máximo que o servidor pode gastar processando a solicitação, em segundos. O padrão é 30 segundos. Se o valor for maior que 30, o padrão será usado. |
Cabeçalho da solicitação
Media Types: "application/json; odata=minimalmetadata"
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
client-request-id |
string uuid |
A identidade da solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Se o servidor deve retornar a ID de solicitação do cliente na resposta. |
|
ocp-date |
string date-time-rfc1123 |
A hora em que a solicitação foi emitida. As bibliotecas de cliente normalmente definem isso como a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente. |
|
If-Match |
string |
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 corresponder exatamente ao valor especificado pelo cliente. |
|
If-None-Match |
string |
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-Modified-Since |
string date-time-rfc1123 |
Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado. |
|
If-Unmodified-Since |
string date-time-rfc1123 |
Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço não tiver sido modificado desde o horário especificado. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Uma resposta que contém a Tarefa. Cabeçalhos
|
|
Other Status Codes |
O erro do serviço do Lote. |
Segurança
azure_auth
Fluxo de código de autenticação do Microsoft Entra OAuth 2.0
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | Representar sua conta de usuário |
Authorization
Tipo:
apiKey
Em:
header
Exemplos
Task get
Solicitação de exemplo
GET account.region.batch.azure.com/jobs/jobId/tasks/taskId?api-version=2024-07-01.20.0
Resposta de exemplo
{
"id": "testTask",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId",
"eTag": "0x8D3D62350711C55",
"creationTime": "2016-09-06T06:59:15.1161429Z",
"lastModified": "2016-09-06T06:59:15.1161429Z",
"state": "active",
"stateTransitionTime": "2016-09-06T06:59:15.1161429Z",
"commandLine": "cmd /c hostname",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"multiInstanceSettings": {
"numberOfInstances": 3,
"coordinationCommandLine": "cmd /c echo coordinating"
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 0
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
}
Definições
Nome | Description |
---|---|
Access |
Os recursos do Lote aos quais o token concede acesso. |
Affinity |
Uma dica de localidade que pode ser usada pelo serviço do Lote para selecionar um Nó de Computação no qual iniciar uma Tarefa. |
Application |
Uma referência a um pacote a ser implantado em Nós de Computação. |
Authentication |
As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço do Lote. |
Auto |
O escopo do usuário automático |
Auto |
Especifica os parâmetros para o usuário automático que executa uma Tarefa no serviço do Lote. |
Batch |
Uma resposta de erro recebida do serviço do Lote do Azure. |
Batch |
Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure. |
Cloud |
Uma Tarefa do Lote do Azure. |
Compute |
A referência a uma identidade atribuída pelo usuário associada ao pool do Lote que um nó de computação usará. |
Compute |
Informações sobre o Nó de Computação no qual uma Tarefa foi executada. |
Container |
A entrada do caminho e do modo de montagem que você deseja montar no contêiner de tarefas. |
Container |
Os caminhos que serão montados no contêiner da tarefa de contêiner. |
Container |
Um registro de contêiner privado. |
Container |
O local do diretório de trabalho da Tarefa de contêiner. |
Dependency |
Uma ação que o serviço lote executa em Tarefas que dependem dessa Tarefa. |
Elevation |
O nível de elevação do usuário. |
Environment |
Uma variável de ambiente a ser definida em um processo de tarefa. |
Error |
A categoria do erro. |
Error |
Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure. |
Exit |
Como o serviço lote deve responder se uma Tarefa for encerrada com um código de saída específico. |
Exit |
Um intervalo de códigos de saída e como o serviço do Lote deve responder aos códigos de saída dentro desse intervalo. |
Exit |
Especifica como o serviço do Lote deve responder quando a Tarefa for concluída. |
Exit |
Especifica como o serviço do Lote responde a uma condição de saída específica. |
Http |
Um par nome-valor de cabeçalho HTTP |
Job |
Uma ação a ser executada no trabalho que contém a Tarefa, se a Tarefa for concluída com a condição de saída fornecida e a propriedade onTaskFailed do Trabalho for 'performExitOptionsJobAction'. |
Multi |
Configurações que especificam como executar uma Tarefa de várias instâncias. |
Name |
Representa um par nome-valor. |
Output |
Uma especificação para carregar arquivos de um Nó de Computação em Lote do Azure para outro local depois que o serviço do Lote terminar de executar o processo tarefa. |
Output |
Especifica um destino de upload de arquivo em um contêiner de armazenamento de blobs do Azure. |
Output |
O destino para o qual um arquivo deve ser carregado. |
Output |
As condições sob as quais um arquivo de saída da tarefa ou um conjunto de arquivos deve ser carregado. |
Output |
Detalhes sobre uma operação de upload de arquivo de saída, inclusive sob quais condições executar o upload. |
Resource |
Um único arquivo ou vários arquivos a serem baixados em um Nó de Computação. |
Task |
Restrições de execução a serem aplicadas a uma Tarefa. |
Task |
Contém informações sobre o contêiner que uma Tarefa está executando. |
Task |
As configurações de contêiner de uma Tarefa. |
Task |
Especifica as dependências de uma Tarefa. Qualquer tarefa especificada explicitamente ou dentro de um intervalo de dependência deve ser concluída antes que a Tarefa dependente seja agendada. |
Task |
Informações sobre a execução de uma Tarefa. |
Task |
O resultado da execução da tarefa. |
Task |
Informações sobre uma falha de tarefa. |
Task |
Um intervalo de IDs de tarefa das quais uma tarefa pode depender. Todas as tarefas com IDs no intervalo devem ser concluídas com êxito antes que a Tarefa dependente possa ser agendada. |
Task |
O estado da Tarefa. |
Task |
Estatísticas de uso de recursos para uma Tarefa. |
User |
A definição da identidade do usuário na qual a Tarefa é executada. |
AccessScope
Os recursos do Lote aos quais o token concede acesso.
Nome | Tipo | Description |
---|---|---|
job |
string |
Concede acesso para executar todas as operações no trabalho que contém a Tarefa. |
AffinityInformation
Uma dica de localidade que pode ser usada pelo serviço do Lote para selecionar um Nó de Computação no qual iniciar uma Tarefa.
Nome | Tipo | Description |
---|---|---|
affinityId |
string |
Uma cadeia de caracteres opaca que representa o local de um Nó de Computação ou de uma Tarefa executada anteriormente. |
ApplicationPackageReference
Uma referência a um pacote a ser implantado em Nós de Computação.
Nome | Tipo | Description |
---|---|---|
applicationId |
string |
A ID do aplicativo a ser implantado. |
version |
string |
A versão do aplicativo a ser implantado. Se omitida, a versão padrão será implantada. |
AuthenticationTokenSettings
As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço do Lote.
Nome | Tipo | Description |
---|---|---|
access |
Os recursos do Lote aos quais o token concede acesso. |
AutoUserScope
O escopo do usuário automático
Nome | Tipo | Description |
---|---|---|
pool |
string |
Especifica que a Tarefa é executada como a conta de usuário automático comum que é criada em cada nó de computação em um pool. |
task |
string |
Especifica que o serviço deve criar um novo usuário para a Tarefa. |
AutoUserSpecification
Especifica os parâmetros para o usuário automático que executa uma Tarefa no serviço do Lote.
Nome | Tipo | Description |
---|---|---|
elevationLevel |
O nível de elevação do usuário automático. |
|
scope |
O escopo do usuário automático |
BatchError
Uma resposta de erro recebida do serviço do Lote do Azure.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente. |
message |
Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário. |
|
values |
Uma coleção de pares chave-valor contendo detalhes adicionais sobre o erro. |
BatchErrorDetail
Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.
Nome | Tipo | Description |
---|---|---|
key |
string |
Um identificador que especifica o significado da propriedade Value. |
value |
string |
As informações adicionais incluídas na resposta de erro. |
CloudTask
Uma Tarefa do Lote do Azure.
Nome | Tipo | Description |
---|---|---|
affinityInfo |
Uma dica de localidade que pode ser usada pelo serviço lote para selecionar um Nó de Computação no qual iniciar a nova Tarefa. |
|
applicationPackageReferences |
Uma lista de pacotes que o serviço do Lote implantará no Nó de Computação antes de executar a linha de comando. |
|
authenticationTokenSettings |
As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço do Lote. |
|
commandLine |
string |
A linha de comando da Tarefa. |
constraints |
As restrições de execução que se aplicam a esta Tarefa. |
|
containerSettings |
As configurações do contêiner no qual a Tarefa é executada. |
|
creationTime |
string |
A hora de criação da Tarefa. |
dependsOn |
As tarefas das quais essa Tarefa depende. |
|
displayName |
string |
Um nome de exibição para a Tarefa. |
eTag |
string |
A ETag da Tarefa. |
environmentSettings |
Uma lista de configurações de variável de ambiente para a Tarefa. |
|
executionInfo |
Informações sobre a execução da Tarefa. |
|
exitConditions |
Especifica como o serviço do Lote deve responder quando a Tarefa for concluída. |
|
id |
string |
Uma cadeia de caracteres que identifica exclusivamente a Tarefa no Trabalho. |
lastModified |
string |
A hora da última modificação da 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. |
|
nodeInfo |
Informações sobre o Nó de Computação no qual a Tarefa foi executada. |
|
outputFiles |
Uma lista de arquivos que o serviço do Lote carregará do Nó de Computação depois de executar a linha de comando. |
|
previousState |
O estado anterior da Tarefa. |
|
previousStateTransitionTime |
string |
A hora em que a Tarefa inseriu seu estado anterior. |
requiredSlots |
integer |
O número de slots de agendamento necessários para execução da Tarefa. |
resourceFiles |
Uma lista de arquivos que o serviço do Lote baixará no Nó de Computação antes de executar a linha de comando. |
|
state |
O estado atual da Tarefa. |
|
stateTransitionTime |
string |
A hora em que a Tarefa inseriu seu estado atual. |
stats |
Estatísticas de uso de recursos para a Tarefa. |
|
url |
string |
A URL da Tarefa. |
userIdentity |
A identidade do usuário sob a qual a Tarefa é executada. |
ComputeNodeIdentityReference
A referência a uma identidade atribuída pelo usuário associada ao pool do Lote que um nó de computação usará.
Nome | Tipo | Description |
---|---|---|
resourceId |
string |
A ID de recurso do ARM da identidade atribuída pelo usuário. |
ComputeNodeInformation
Informações sobre o Nó de Computação no qual uma Tarefa foi executada.
Nome | Tipo | Description |
---|---|---|
affinityId |
string |
Um identificador para o nó no qual a Tarefa foi executada, que pode ser passada ao adicionar uma Tarefa para solicitar que a Tarefa seja agendada neste Nó de Computação. |
nodeId |
string |
A ID do Nó de Computação no qual a Tarefa foi executada. |
nodeUrl |
string |
A URL do Nó de Computação no qual a Tarefa foi executada. |
poolId |
string |
A ID do pool no qual a Tarefa foi executada. |
taskRootDirectory |
string |
O diretório raiz da Tarefa no Nó de Computação. |
taskRootDirectoryUrl |
string |
A URL para o diretório raiz da Tarefa no Nó de Computação. |
ContainerHostBatchBindMountEntry
A entrada do caminho e do modo de montagem que você deseja montar no contêiner de tarefas.
Nome | Tipo | Description |
---|---|---|
isReadOnly |
boolean |
Monte esse caminho de origem como modo somente leitura ou não. O valor padrão é falso (modo de leitura/gravação). |
source |
O caminho que será montado no cliente do contêiner pode ser selecionado. |
ContainerHostDataPath
Os caminhos que serão montados no contêiner da tarefa de contêiner.
Nome | Tipo | Description |
---|---|---|
Applications |
string |
O caminho dos aplicativos. |
JobPrep |
string |
O caminho da tarefa de preparação do trabalho. |
Shared |
string |
O caminho para a tarefa de várias instâncias compartilhar seus arquivos. |
Startup |
string |
O caminho para iniciar a tarefa. |
Task |
string |
O caminho da tarefa. |
VfsMounts |
string |
O caminho contém todos os sistemas de arquivos virtuais montados neste nó. |
ContainerRegistry
Um registro de contêiner privado.
Nome | Tipo | Description |
---|---|---|
identityReference |
A referência à identidade atribuída pelo usuário a ser usada para acessar um Registro de Contêiner do Azure em vez de nome de usuário e senha. |
|
password |
string |
A senha para fazer logon no servidor do Registro. |
registryServer |
string |
A URL do Registro. |
username |
string |
O nome de usuário a ser conectado ao servidor do Registro. |
ContainerWorkingDirectory
O local do diretório de trabalho da Tarefa de contêiner.
Nome | Tipo | Description |
---|---|---|
containerImageDefault |
string |
Use o diretório de trabalho definido na imagem do contêiner. Cuidado para que esse diretório não contenha os Arquivos de Recursos baixados pelo Lote. |
taskWorkingDirectory |
string |
Use o diretório de trabalho da Tarefa de Serviço do Lote padrão, que conterá os Arquivos de Recurso de Tarefa preenchidos pelo Lote. |
DependencyAction
Uma ação que o serviço lote executa em Tarefas que dependem dessa Tarefa.
Nome | Tipo | Description |
---|---|---|
block |
string |
Bloqueia as tarefas que aguardam essa tarefa, impedindo que elas sejam agendadas. |
satisfy |
string |
Satisfazer tarefas aguardando essa tarefa; depois que todas as dependências forem atendidas, a tarefa será agendada para ser executada. |
ElevationLevel
O nível de elevação do usuário.
Nome | Tipo | Description |
---|---|---|
admin |
string |
O usuário é um usuário com acesso elevado e opera com permissões de Administrador completas. |
nonadmin |
string |
O usuário é um usuário padrão sem acesso elevado. |
EnvironmentSetting
Uma variável de ambiente a ser definida em um processo de tarefa.
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome da variável de ambiente. |
value |
string |
O valor da variável de ambiente. |
ErrorCategory
A categoria do erro.
Nome | Tipo | Description |
---|---|---|
servererror |
string |
O erro ocorre devido a um problema interno do servidor. |
usererror |
string |
O erro ocorre devido a um problema de usuário, como configuração incorreta. |
ErrorMessage
Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.
Nome | Tipo | Description |
---|---|---|
lang |
string |
O código de idioma da mensagem de erro |
value |
string |
O texto da mensagem. |
ExitCodeMapping
Como o serviço lote deve responder se uma Tarefa for encerrada com um código de saída específico.
Nome | Tipo | Description |
---|---|---|
code |
integer |
Um código de saída do processo. |
exitOptions |
Como o serviço lote deve responder se a Tarefa sair com esse código de saída. |
ExitCodeRangeMapping
Um intervalo de códigos de saída e como o serviço do Lote deve responder aos códigos de saída dentro desse intervalo.
Nome | Tipo | Description |
---|---|---|
end |
integer |
O último código de saída no intervalo. |
exitOptions |
Como o serviço do Lote deve responder se a Tarefa for encerrada com um código de saída no intervalo do início ao fim (inclusive). |
|
start |
integer |
O primeiro código de saída no intervalo. |
ExitConditions
Especifica como o serviço do Lote deve responder quando a Tarefa for concluída.
Nome | Tipo | Description |
---|---|---|
default |
Como o serviço lote deve responder se a Tarefa falhar com uma condição de saída não coberta por nenhuma das outras propriedades. |
|
exitCodeRanges |
Uma lista de intervalos de código de saída da tarefa e como o serviço do Lote deve responder a eles. |
|
exitCodes |
Uma lista de códigos de saída de tarefas individuais e como o serviço do Lote deve responder a eles. |
|
fileUploadError |
Como o serviço do Lote deve responder se ocorrer um erro de upload de arquivo. |
|
preProcessingError |
Como o serviço lote deve responder se a Tarefa não for iniciada devido a um erro. |
ExitOptions
Especifica como o serviço do Lote responde a uma condição de saída específica.
Nome | Tipo | Description |
---|---|---|
dependencyAction |
Uma ação que o serviço lote executa em Tarefas que dependem dessa Tarefa. |
|
jobAction |
Uma ação a ser executada no trabalho que contém a Tarefa, se a Tarefa for concluída com a condição de saída fornecida e a propriedade onTaskFailed do Trabalho for 'performExitOptionsJobAction'. |
HttpHeader
Um par nome-valor de cabeçalho HTTP
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome que não diferencia maiúsculas de minúsculas do cabeçalho a ser usado durante o carregamento de arquivos de saída |
value |
string |
O valor do cabeçalho a ser usado durante o carregamento de arquivos de saída |
JobAction
Uma ação a ser executada no trabalho que contém a Tarefa, se a Tarefa for concluída com a condição de saída fornecida e a propriedade onTaskFailed do Trabalho for 'performExitOptionsJobAction'.
Nome | Tipo | Description |
---|---|---|
disable |
string |
Desabilite o trabalho. Isso é equivalente a chamar a API de desabilitação do Trabalho, com um valor de desabilitação de tarefas de requeue. |
none |
string |
Não faça nenhuma ação. |
terminate |
string |
Encerre o trabalho. O terminateReason no executionInfo do trabalho é definido como "TaskFailed". |
MultiInstanceSettings
Configurações que especificam como executar uma Tarefa de várias instâncias.
Nome | Tipo | Description |
---|---|---|
commonResourceFiles |
Uma lista de arquivos que o serviço do Lote baixará antes de executar a linha de comando de coordenação. |
|
coordinationCommandLine |
string |
A linha de comando a ser executada em todos os Nós de Computação para permitir que eles coordenem quando o principal executa o comando Tarefa principal. |
numberOfInstances |
integer |
O número de nós de computação exigidos pela Tarefa. |
NameValuePair
Representa um par nome-valor.
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome no par nome-valor. |
value |
string |
O valor no par nome-valor. |
OutputFile
Uma especificação para carregar arquivos de um Nó de Computação em Lote do Azure para outro local depois que o serviço do Lote terminar de executar o processo tarefa.
Nome | Tipo | Description |
---|---|---|
destination |
O destino dos arquivos de saída. |
|
filePattern |
string |
Um padrão que indica quais arquivos serão carregados. |
uploadOptions |
Opções adicionais para a operação de upload, incluindo sob quais condições executar o upload. |
OutputFileBlobContainerDestination
Especifica um destino de upload de arquivo em um contêiner de armazenamento de blobs do Azure.
Nome | Tipo | Description |
---|---|---|
containerUrl |
string |
A URL do contêiner no Armazenamento de Blobs do Azure para o qual carregar os arquivos. |
identityReference |
A referência à identidade atribuída pelo usuário a ser usada para acessar o Armazenamento de Blobs do Azure especificado pelo containerUrl |
|
path |
string |
O blob de destino ou o diretório virtual dentro do contêiner do Armazenamento do Azure. |
uploadHeaders |
Uma lista de pares nome-valor para cabeçalhos a serem usados no carregamento de arquivos de saída |
OutputFileDestination
O destino para o qual um arquivo deve ser carregado.
Nome | Tipo | Description |
---|---|---|
container |
Um local no armazenamento de blobs do Azure para o qual os arquivos são carregados. |
OutputFileUploadCondition
As condições sob as quais um arquivo de saída da tarefa ou um conjunto de arquivos deve ser carregado.
Nome | Tipo | Description |
---|---|---|
taskcompletion |
string |
Carregue os arquivos após a saída do processo de tarefa, independentemente do código de saída. |
taskfailure |
string |
Carregue os arquivos somente depois que o processo de Tarefa for encerrado com um código de saída diferente de zero. |
tasksuccess |
string |
Carregue os arquivos somente depois que o processo de Tarefa for encerrado com um código de saída 0. |
OutputFileUploadOptions
Detalhes sobre uma operação de upload de arquivo de saída, inclusive sob quais condições executar o upload.
Nome | Tipo | Description |
---|---|---|
uploadCondition |
As condições sob as quais o arquivo de saída da tarefa ou o conjunto de arquivos devem ser carregados. |
ResourceFile
Um único arquivo ou vários arquivos a serem baixados em um Nó de Computação.
Nome | Tipo | Description |
---|---|---|
autoStorageContainerName |
string |
O nome do contêiner de armazenamento na Conta de armazenamento automático. |
blobPrefix |
string |
O prefixo de blob a ser usado ao baixar blobs de um contêiner do Armazenamento do Azure. Somente os blobs cujos nomes começam com o prefixo especificado serão baixados. |
fileMode |
string |
O atributo de modo de permissão de arquivo no formato octal. |
filePath |
string |
O local no Nó de Computação para o qual baixar os arquivos em relação ao diretório de trabalho da Tarefa. |
httpUrl |
string |
A URL do arquivo a ser baixado. |
identityReference |
A referência à identidade atribuída pelo usuário a ser usada para acessar o Armazenamento de Blobs do Azure especificado por storageContainerUrl ou httpUrl |
|
storageContainerUrl |
string |
A URL do contêiner de blob no Armazenamento de Blobs do Azure. |
TaskConstraints
Restrições de execução a serem aplicadas a uma Tarefa.
Nome | Tipo | Description |
---|---|---|
maxTaskRetryCount |
integer |
O número máximo de vezes que a Tarefa pode ser repetida. O serviço do Lote tentará novamente 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 a partir do momento em que a Tarefa é iniciada. Se a Tarefa não for concluída dentro do limite de tempo, o serviço do Lote a encerrará. |
retentionTime |
string |
O tempo mínimo para manter o diretório Tarefa no Nó de Computação em que ele foi executado, a partir do momento em que ele conclui a execução. Após esse tempo, o serviço do Lote poderá excluir o diretório tarefa e todo o seu conteúdo. |
TaskContainerExecutionInformation
Contém informações sobre o contêiner que uma Tarefa está executando.
Nome | Tipo | Description |
---|---|---|
containerId |
string |
A ID do contêiner. |
error |
string |
Informações detalhadas de erro sobre o contêiner. |
state |
string |
O estado do contêiner. |
TaskContainerSettings
As configurações de contêiner de uma Tarefa.
Nome | Tipo | Description |
---|---|---|
containerHostBatchBindMounts |
Os caminhos que você deseja montar na tarefa de contêiner. |
|
containerRunOptions |
string |
Opções adicionais para o comando de criação de contêiner. |
imageName |
string |
A imagem a ser usada para criar o contêiner no qual a Tarefa será executada. |
registry |
O registro privado que contém a imagem do contêiner. |
|
workingDirectory |
O local do diretório de trabalho da Tarefa de contêiner. |
TaskDependencies
Especifica as dependências de uma Tarefa. Qualquer tarefa especificada explicitamente ou dentro de um intervalo de dependência deve ser concluída antes que a Tarefa dependente seja agendada.
Nome | Tipo | Description |
---|---|---|
taskIdRanges |
A lista de intervalos de ID de tarefa dos quais essa Tarefa depende. Todas as tarefas em todos os intervalos devem ser concluídas com êxito antes que a Tarefa dependente possa ser agendada. |
|
taskIds |
string[] |
A lista de IDs de tarefa das quais essa Tarefa depende. Todas as tarefas nesta lista devem ser concluídas com êxito antes que a Tarefa dependente possa ser agendada. |
TaskExecutionInformation
Informações sobre a execução de uma Tarefa.
Nome | Tipo | Description |
---|---|---|
containerInfo |
Informações sobre o contêiner no qual a Tarefa está sendo executada. |
|
endTime |
string |
A hora em que a Tarefa foi concluída. |
exitCode |
integer |
O código de saída do programa especificado na linha de comando Tarefa. |
failureInfo |
Informações que descrevem a falha da tarefa, se houver. |
|
lastRequeueTime |
string |
O momento mais recente em que a Tarefa foi requeutada pelo serviço lote como resultado de uma solicitação de usuário. |
lastRetryTime |
string |
O momento mais recente em que uma repetição da Tarefa começou a ser executada. |
requeueCount |
integer |
O número de vezes que a Tarefa foi requeutada pelo serviço lote como resultado de uma solicitação de usuário. |
result |
O resultado da execução da tarefa. |
|
retryCount |
integer |
O número de vezes que a Tarefa foi repetida pelo serviço do Lote. |
startTime |
string |
A hora em que a Tarefa começou a ser executada. |
TaskExecutionResult
O resultado da execução da tarefa.
Nome | Tipo | Description |
---|---|---|
failure |
string |
Houve um erro durante o processamento da Tarefa. A falha pode ter ocorrido antes do processo de tarefa ser iniciado, enquanto o processo de tarefa estava em execução ou após a saída do processo de tarefa. |
success |
string |
A Tarefa foi executada com êxito. |
TaskFailureInformation
Informações sobre uma falha de tarefa.
Nome | Tipo | Description |
---|---|---|
category |
A categoria do erro Tarefa. |
|
code |
string |
Um identificador para o erro tarefa. Os códigos são invariáveis e devem ser consumidos programaticamente. |
details |
Uma lista de detalhes adicionais relacionados ao erro. |
|
message |
string |
Uma mensagem que descreve o erro Tarefa, destinada a ser adequada para exibição em uma interface do usuário. |
TaskIdRange
Um intervalo de IDs de tarefa das quais uma tarefa pode depender. Todas as tarefas com IDs no intervalo devem ser concluídas com êxito antes que a Tarefa dependente possa ser agendada.
Nome | Tipo | Description |
---|---|---|
end |
integer |
A última ID da Tarefa no intervalo. |
start |
integer |
A primeira ID da Tarefa no intervalo. |
TaskState
O estado da Tarefa.
Nome | Tipo | Description |
---|---|---|
active |
string |
A Tarefa está na fila e pode ser executada, mas não está atribuída atualmente a um Nó de Computação. Uma tarefa entra nesse estado quando é criada, quando está habilitada após ser desabilitada ou quando aguarda uma repetição após uma execução com falha. |
completed |
string |
A Tarefa não está mais qualificada para ser executada, geralmente porque a Tarefa foi concluída com êxito ou a Tarefa foi concluída sem êxito e esgotou seu limite de repetição. Uma tarefa também será marcada como concluída se ocorreu um erro ao iniciar a Tarefa ou quando a Tarefa foi encerrada. |
preparing |
string |
A Tarefa foi atribuída a um Nó de Computação, mas está aguardando a conclusão de uma Tarefa de Preparação de Trabalho necessária no Nó de Computação. Se a Tarefa de Preparação do Trabalho for bem-sucedida, a Tarefa passará para a execução. Se a Tarefa de Preparação do Trabalho falhar, a Tarefa retornará à ativa e será qualificada para ser atribuída a um nó de computação diferente. |
running |
string |
A Tarefa está em execução em um Nó de Computação. Isso inclui a preparação no nível da tarefa, como baixar arquivos de recursos ou implantar pacotes especificados na Tarefa , isso não significa necessariamente que a linha de comando Task começou a ser executada. |
TaskStatistics
Estatísticas de uso de recursos para uma Tarefa.
Nome | Tipo | Description |
---|---|---|
kernelCPUTime |
string |
O tempo total da CPU do modo kernel (resumido em todos os núcleos e todos os Nós de Computação) consumidos pela Tarefa. |
lastUpdateTime |
string |
A hora em que as estatísticas foram atualizadas pela última vez. Todas as estatísticas são limitadas ao intervalo entre startTime e lastUpdateTime. |
readIOGiB |
number |
O total de gibibytes lidos do disco pela Tarefa. |
readIOps |
integer |
O número total de operações de leitura de disco feitas pela Tarefa. |
startTime |
string |
A hora de início do intervalo de tempo coberto pelas estatísticas. |
url |
string |
A URL das estatísticas. |
userCPUTime |
string |
O tempo total de CPU do modo de usuário (resumido em todos os núcleos e todos os Nós de Computação) consumidos pela Tarefa. |
waitTime |
string |
O tempo total de espera da Tarefa. O tempo de espera de uma tarefa é definido como o tempo decorrido entre a criação da Tarefa e o início da execução da Tarefa. (Se a Tarefa for repetida devido a falhas, o tempo de espera será o tempo para a execução mais recente da Tarefa.) |
wallClockTime |
string |
O tempo total do relógio de parede da Tarefa. |
writeIOGiB |
number |
O total de gibibytes gravados em disco pela Tarefa. |
writeIOps |
integer |
O número total de operações de gravação de disco feitas pela Tarefa. |
UserIdentity
A definição da identidade do usuário na qual a Tarefa é executada.
Nome | Tipo | Description |
---|---|---|
autoUser |
O usuário automático no qual a Tarefa é executada. |
|
username |
string |
O nome da identidade do usuário na qual a Tarefa é executada. |