Tasks - Get Task
Obtém informações sobre a Tarefa especificada.
Para Tarefas multi-instância, informações como affinityId, executionInfo e nodeInfo referem-se à Tarefa principal. Use a API de subtarefas da lista para obter informações sobre subtarefas.
GET {endpoint}/jobs/{jobId}/tasks/{taskId}?api-version=2025-06-01
GET {endpoint}/jobs/{jobId}/tasks/{taskId}?api-version=2025-06-01&timeOut={timeOut}&$select={$select}&$expand={$expand}
Parâmetros do URI
| Name | Em | Necessário | Tipo | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Ponto de extremidade da conta em lote (por exemplo: https://batchaccount.eastus2.batch.azure.com). |
|
job
|
path | True |
string |
O ID do Trabalho que contém a Tarefa. |
|
task
|
path | True |
string |
O ID da Tarefa sobre o qual obter informações. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a utilizar para esta operação. |
|
$expand
|
query |
string[] |
Uma cláusula $expand OData. |
|
|
$select
|
query |
string[] |
Uma cláusula OData $select. |
|
|
time
|
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 superior a 30, será usado o padrão em vez disso.". |
Cabeçalho do Pedido
| Name | Necessário | Tipo | Description |
|---|---|---|---|
| client-request-id |
string |
A identidade de solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves encaracoladas, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
| return-client-request-id |
boolean |
Se o servidor deve retornar o client-request-id na resposta. |
|
| ocp-date |
string (date-time-rfc7231) |
A hora em que o pedido foi emitido. As bibliotecas de cliente normalmente definem isso para a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente. |
|
| If-Modified-Since |
string (date-time-rfc7231) |
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-Unmodified-Since |
string (date-time-rfc7231) |
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. |
|
| If-Match |
string |
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-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. |
Respostas
| Name | Tipo | Description |
|---|---|---|
| 200 OK |
O pedido foi bem-sucedido. Cabeçalhos
|
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
OAuth2Auth
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Âmbitos
| Name | Description |
|---|---|
| https://batch.core.windows.net//.default |
Exemplos
Task get
Pedido de amostra
GET {endpoint}/jobs/jobId/tasks/taskId?api-version=2025-06-01
Resposta da amostra
{
"id": "testTask",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId",
"eTag": "0x8D3D62350711C55",
"creationTime": "2025-09-06T06:59:15.1161429Z",
"lastModified": "2025-09-06T06:59:15.1161429Z",
"state": "active",
"stateTransitionTime": "2025-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
| Name | Description |
|---|---|
|
Authentication |
As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço em lote. |
|
Auto |
Enums AutoUserScope |
|
Auto |
Especifica as opções para o usuário automático que executa uma Tarefa em Lote do Azure. |
|
Batch |
Enums BatchAccessScope |
|
Batch |
Uma dica de localidade que pode ser usada pelo serviço Batch para selecionar um Nó de Computação no qual iniciar uma Tarefa. |
|
Batch |
Uma referência a um pacote a ser implantado em nós de computação. |
|
Batch |
Uma resposta de erro recebida do serviço Batch do Azure. |
|
Batch |
Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure. |
|
Batch |
Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure. |
|
Batch |
BatchErrorSourceCategory enums |
|
Batch |
Enums do BatchJobAction |
|
Batch |
A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará. |
|
Batch |
Informações sobre o nó de computação no qual uma tarefa foi executada. |
|
Batch |
O lote tentará novamente Tarefas quando uma operação de recuperação for acionada em um nó. Exemplos de operações de recuperação incluem (mas não estão limitados a) quando um nó não íntegro é reinicializado ou um nó de computação desaparece devido a falha do host. As novas tentativas devido a operações de recuperação são independentes e não são contabilizadas em relação ao maxTaskRetryCount. Mesmo se maxTaskRetryCount for 0, pode ocorrer uma nova tentativa interna devido a uma operação de recuperação. Por isso, todas as tarefas devem ser idempotentes. Isso significa que as tarefas precisam tolerar ser interrompidas e reiniciadas sem causar corrupção ou dados duplicados. A prática recomendada para tarefas de longa duração é usar alguma forma de ponto de verificação. |
|
Batch |
Restrições de execução a serem aplicadas a uma Tarefa. |
|
Batch |
Contém informações sobre o contêiner que uma tarefa está executando. |
|
Batch |
As configurações de contêiner para uma Tarefa. |
|
Batch |
Especifica quaisquer 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. |
|
Batch |
Informações sobre a execução de uma Tarefa. |
|
Batch |
Enums BatchTaskExecutionResult |
|
Batch |
Informações sobre uma falha de tarefa. |
|
Batch |
O início e o fim do intervalo são inclusivos. Por exemplo, se um intervalo tiver início 9 e fim 12, ele representa Tarefas '9', '10', '11' e '12'. |
|
Batch |
Enums BatchTaskState |
|
Batch |
Estatísticas de utilização de recursos para uma Tarefa. |
|
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 do contêiner. |
|
Container |
Um registro de contêiner privado. |
|
Container |
ContainerWorkingDirectory enums |
|
Dependency |
Enums DependencyAction |
|
Elevation |
Enums ElevationLevel |
|
Environment |
Uma variável de ambiente a ser definida em um processo Task. |
|
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 em lote 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. |
|
Multi |
Tarefas de várias instâncias são comumente usadas para dar suporte a tarefas MPI. No caso do MPI, se qualquer uma das subtarefas falhar (por exemplo, devido à saída com um código de saída diferente de zero), toda a Tarefa de várias instâncias falhará. A tarefa de várias instâncias é então encerrada e repetida, até seu limite de repetição. |
|
Name |
Representa um par nome-valor. |
|
Output |
Em cada upload de arquivo, o serviço Batch grava dois arquivos de log no nó de computação, 'fileuploadout.txt' e 'fileuploaderr.txt'. Esses arquivos de log são usados para saber mais sobre uma falha específica. |
|
Output |
Especifica um destino de carregamento de arquivo em um contêiner de armazenamento de blob do Azure. |
|
Output |
O destino para o qual um arquivo deve ser carregado. |
|
Output |
OutputFileUploadCondition enums |
|
Output |
Opções para uma operação de upload de arquivo de saída, incluindo em que condições executar o upload. |
|
Output |
Um par nome-valor de cabeçalho HTTP |
|
Resource |
Um único arquivo ou vários arquivos a serem baixados para um nó de computação. |
|
User |
A definição da identidade do usuário sob a qual a Tarefa é executada. Especifique a propriedade userName ou autoUser, mas não ambas. |
AuthenticationTokenSettings
As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço em lote.
| Name | Tipo | Description |
|---|---|---|
| access |
Os recursos do Batch a que o token concede acesso. O token de autenticação concede acesso a um conjunto limitado de operações de serviço em lote. Atualmente, o único valor suportado para a propriedade de acesso é 'job', que concede acesso a todas as operações relacionadas com o Job que contém a Tarefa. |
AutoUserScope
Enums AutoUserScope
| Valor | Description |
|---|---|
| task |
Especifica que o serviço deve criar um novo utilizador para a Tarefa. |
| pool |
Especifica que a Tarefa corre como a Conta de utilizador automática comum, criada em cada Nó de Computação de um Pool. |
AutoUserSpecification
Especifica as opções para o usuário automático que executa uma Tarefa em Lote do Azure.
| Name | Tipo | Description |
|---|---|---|
| elevationLevel |
O nível de elevação do usuário automático. O valor padrão é nonAdmin. |
|
| scope |
O escopo para o usuário automático. O valor padrão é pool. Se o pool estiver executando o Windows, um valor de Task deverá ser especificado se for necessário um isolamento mais rigoroso entre as tarefas. Por exemplo, se a tarefa muta o registro de uma forma que pode afetar outras tarefas. |
BatchAccessScope
Enums BatchAccessScope
| Valor | Description |
|---|---|
| job |
Concede acesso para realizar todas as operações no Trabalho que contém a Tarefa. |
BatchAffinityInfo
Uma dica de localidade que pode ser usada 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 já foi executada anteriormente. Podes passar o affinityId de um Nó para indicar que esta Tarefa precisa de ser executada nesse Nó de Computação. Note que esta é apenas uma afinidade suave. Se o Nó de Computação de destino estiver ocupado ou indisponível no momento em que a Tarefa for agendada, a Tarefa será agendada em outro lugar. |
BatchApplicationPackageReference
Uma referência a um pacote a ser implantado em nós de computação.
| Name | Tipo | Description |
|---|---|---|
| applicationId |
string |
O ID da aplicação a implementar. Ao criar um pool, a ID do aplicativo do pacote deve ser totalmente qualificada (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). |
| version |
string |
A versão do aplicativo a ser implantado. Se omitida, a versão padrão será implantada. Se isto for omitido num Pool e não for especificada uma versão padrão para esta aplicação, o pedido falha com o código de erro InvalidApplicationPackageReferences e o código de estado HTTP 409. Se isto for omitido numa Tarefa, e não for especificada uma versão padrão para esta aplicação, a Tarefa falha com um erro de pré-processamento. |
BatchError
Uma resposta de erro recebida do serviço Batch do Azure.
| 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 descrevendo 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.
| Name | Tipo | Description |
|---|---|---|
| key |
string |
Um identificador que especifica o significado da propriedade Value. |
| value |
string |
As informações adicionais incluídas com a resposta de erro. |
BatchErrorMessage
Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.
| Name | Tipo | Description |
|---|---|---|
| lang |
string |
O código da linguagem da mensagem de erro. |
| value |
string |
O texto da mensagem. |
BatchErrorSourceCategory
BatchErrorSourceCategory enums
| Valor | Description |
|---|---|
| usererror |
O erro deve-se a um problema do utilizador, como uma má configuração. |
| servererror |
O erro deve-se a um problema interno no servidor. |
BatchJobActionKind
Enums do BatchJobAction
| Valor | Description |
|---|---|
| none |
Não tomes nenhuma atitude. |
| disable |
Desativa o trabalho. Isto é equivalente a chamar a disable Job API, com um valor disableTasks como requeue. |
| terminate |
Termina o trabalho. A terminationReason na executionInfo do Job está definida como "TaskFailed". |
BatchNodeIdentityReference
A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará.
| Name | Tipo | Description |
|---|---|---|
| resourceId |
string (arm-id) |
O ID de recurso ARM da identidade atribuída ao usuário. |
BatchNodeInfo
Informações sobre o nó de computação no qual uma tarefa foi executada.
| Name | Tipo | Description |
|---|---|---|
| affinityId |
string |
Um identificador para o Nó onde a Tarefa foi executada, que pode ser passado ao adicionar uma Tarefa para solicitar que a Tarefa seja agendada nesse Nó de Computação. |
| nodeId |
string |
O ID do nó de computação onde a tarefa foi executada. |
| nodeUrl |
string (uri) |
A URL do Nó de Computação onde a Tarefa foi executada. |
| poolId |
string |
O ID do Pool onde a Tarefa decorria. |
| taskRootDirectory |
string |
O diretório raiz da tarefa no nó de computação. |
| taskRootDirectoryUrl |
string (uri) |
O URL para o diretório raiz da Tarefa no Nó de Computação. |
BatchTask
O lote tentará novamente Tarefas quando uma operação de recuperação for acionada em um nó. Exemplos de operações de recuperação incluem (mas não estão limitados a) quando um nó não íntegro é reinicializado ou um nó de computação desaparece devido a falha do host. As novas tentativas devido a operações de recuperação são independentes e não são contabilizadas em relação ao maxTaskRetryCount. Mesmo se maxTaskRetryCount for 0, pode ocorrer uma nova tentativa interna devido a uma operação de recuperação. Por isso, todas as tarefas devem ser idempotentes. Isso significa que as tarefas precisam tolerar ser interrompidas e reiniciadas sem causar corrupção ou dados duplicados. A prática recomendada para tarefas de longa duração é usar alguma forma de ponto de verificação.
| Name | Tipo | Description |
|---|---|---|
| affinityInfo |
Uma dica de localidade que pode ser usada pelo serviço Batch para selecionar um Nó de Computação onde 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. Os pacotes de aplicações são descarregados e implementados num diretório partilhado, não no diretório de trabalho Tarefa. Portanto, se um pacote referenciado já estiver no Nó e estiver atualizado, então não é descarregado novamente; a cópia existente no Nó de Computação é utilizada. Se um Pacote referenciado não puder ser instalado, por exemplo porque o pacote foi eliminado ou porque o download falhou, a Tarefa falha. |
|
| authenticationTokenSettings |
As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço em lote. Se esta propriedade estiver definida, o serviço Batch fornece à Tarefa um token de autenticação que pode ser usado para autenticar operações do serviço Batch sem exigir uma chave de acesso à Conta. O token é fornecido através da variável de ambiente AZ_BATCH_AUTHENTICATION_TOKEN. As operações que a Tarefa pode realizar usando o token dependem das definições. Por exemplo, uma Tarefa pode solicitar permissões de Trabalho para adicionar outras Tarefas ao Trabalho, ou verificar o estado do Trabalho ou de outras Tarefas sob o Trabalho. |
|
| commandLine |
string |
A linha de comandos da Tarefa. Para Tarefas multi-instância, a linha de comando é executada como a Tarefa principal, depois de a Tarefa principal e todas as subtarefas terem terminado a execução da linha de comandos de coordenação. 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 Batch provided (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| constraints |
As restrições de execução que se aplicam a esta Tarefa. |
|
| containerSettings |
As definições do contentor sob o qual a Tarefa é executada. Se o Pool que irá executar esta tarefa tiver containerConfiguration definido, isto também deve ser definido. Se o Pool que irá executar esta Tarefa não tiver containerConfiguration ativado, isto não deve estar definido. Quando isto é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz dos diretórios Batch do Azure no nó) são mapeados para o contentor, todas as variáveis do ambiente Task são mapeadas para o contentor e a linha de comando Task é executada no contentor. Ficheiros produzidos no contentor fora de AZ_BATCH_NODE_ROOT_DIR podem não ser refletidos para o disco anfitrião, o que significa que as APIs de ficheiros Batch não poderão aceder a esses ficheiros. |
|
| creationTime |
string (date-time) |
O tempo de criação da Tarefa. |
| dependsOn |
As Tarefas das quais esta Tarefa depende. Esta Tarefa não será agendada até que todas as Tarefas de que depende tenham sido concluídas com sucesso. Se alguma dessas Tarefas falhar e esgotar o número de retentativas, essa Tarefa nunca será agendada. |
|
| displayName |
string |
Um nome de exibição para a Tarefa. O nome para exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024. |
| eTag |
string |
O ETag da Tarefa. Esta é uma cadeia de caracteres opaca. Podes usá-lo para detetar se a tarefa mudou entre pedidos. Em particular, podes passar o ETag ao atualizar uma Tarefa para especificar que as tuas alterações só devem ter efeito se ninguém mais tiver modificado a Tarefa entretanto. |
| environmentSettings |
Uma lista de definições de variáveis de ambiente para a Tarefa. |
|
| executionInfo |
Informação sobre a execução da Tarefa. |
|
| exitConditions |
Como o serviço Batch deve responder quando a Tarefa for concluída. |
|
| id |
string |
Uma cadeia que identifica de forma única a Tarefa dentro do Trabalho. 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. |
| lastModified |
string (date-time) |
O último tempo modificado da Tarefa. |
| multiInstanceSettings |
Um objeto que indica que a Tarefa é uma Tarefa multiinstância e contém informações sobre como executar a Tarefa multi-instância. |
|
| nodeInfo |
Informação sobre o Nó de Computação onde a Tarefa corria. |
|
| outputFiles |
Uma lista de ficheiros que o serviço Batch irá carregar do Nó de Computação após executar a linha de comandos. Para Tarefas de múltiplas instâncias, os ficheiros só serão carregados a partir do Nó de Computação onde a Tarefa principal é executada. |
|
| previousState |
O estado anterior da Tarefa. Esta propriedade não está definida se a Tarefa estiver no seu estado inicial Ativo. |
|
| previousStateTransitionTime |
string (date-time) |
O momento em que a Tarefa entrou no seu estado anterior. Esta propriedade não está definida se a Tarefa estiver no seu estado inicial Ativo. |
| requiredSlots |
integer (int32) |
O número de espaços de agendamento que a Tarefa requer para executar. O padrão é 1. Uma Tarefa só pode ser agendada para correr num nó de computação se este tiver espaços de agendamento livres suficientes. Para Tarefas de múltiplas instâncias, isto deve ser 1. |
| resourceFiles |
Uma lista de arquivos que o serviço em lote baixará para o nó de computação antes de executar a linha de comando. Para Tarefas multiinstância, os ficheiros de recurso serão descarregados apenas para o Nó de Computação onde a Tarefa principal é executada. 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. |
|
| state |
O estado atual da Tarefa. |
|
| stateTransitionTime |
string (date-time) |
O momento em que a Tarefa entrou no seu estado atual. |
| stats |
Estatísticas de utilização de recursos para a Tarefa. |
|
| url |
string (uri) |
O URL da tarefa. |
| userIdentity |
A identidade do utilizador sob a qual a Tarefa é executada. Se omitida, a Tarefa é executada como um utilizador não administrativo único da Tarefa. |
BatchTaskConstraints
Restrições de execução a serem aplicadas a uma Tarefa.
| Name | Tipo | Description |
|---|---|---|
| maxTaskRetryCount |
integer (int32) |
O número máximo de vezes que a Tarefa pode ser repetida. O serviço de lote tenta novamente uma tarefa se seu código de saída for diferente de zero. Note que este valor controla especificamente o número de tentativas para o executável Task devido a um código de saída não nulo. O serviço de lote tentará a 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á a Tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se o número máximo de tentativas for 0, o serviço Batch não tenta novamente a Tarefa após a primeira tentativa. Se a contagem máxima de tentativas for -1, o serviço em lote repetirá a tarefa sem limite, no entanto, isso não é recomendado para uma tarefa inicial ou qualquer tarefa. O valor padrão é 0 (sem tentativas). |
| maxWallClockTime |
string (duration) |
O tempo máximo decorrido que a Tarefa pode executar, medido a partir do momento em que a Tarefa começa. Se a Tarefa não for concluída dentro do limite de tempo, o serviço Batch termina-a. Se isto não for especificado, não existe limite de tempo para a duração da Tarefa. |
| retentionTime |
string (duration) |
O tempo mínimo para reter o diretório Tarefa no Nó de Computação onde foi executado, a partir da conclusão da execução. Após este período, o serviço Batch pode eliminar o diretório Task e todo o seu conteúdo. O padrão é 7 dias, ou seja, o diretório Tarefa será mantido durante 7 dias, a menos que o Nó de Computação seja removido ou o Trabalho seja eliminado. |
BatchTaskContainerExecutionInfo
Contém informações sobre o contêiner que uma tarefa está executando.
| Name | Tipo | Description |
|---|---|---|
| containerId |
string |
A identificação do contentor. |
| error |
string |
Informação detalhada sobre o erro do contentor. Esta é a cadeia de erros detalhada do serviço Docker, se disponível. É equivalente ao campo de erro devolvido por "docker inspect". |
| state |
string |
O estado do contentor. Este é o estado do contentor segundo o serviço Docker. É equivalente ao campo de estado devolvido por "docker inspect". |
BatchTaskContainerSettings
As configurações de contêiner para uma Tarefa.
| Name | Tipo | Description |
|---|---|---|
| containerHostBatchBindMounts |
Os caminhos que você deseja montar para a tarefa de contêiner. Se essa matriz for nula ou não estiver presente, a tarefa de contêiner montará toda a unidade de disco temporária no Windows (ou AZ_BATCH_NODE_ROOT_DIR no Linux). Ele não montará nenhum caminho de dados no contêiner se essa matriz estiver definida como vazia. |
|
| containerRunOptions |
string |
Opções adicionais para o comando container create. Essas opções adicionais são fornecidas como argumentos para o comando "docker create", além daquelas controladas pelo Batch Service. |
| imageName |
string |
A imagem a usar para criar o contentor onde a tarefa será executada. Esta é a referência completa da Imagem, conforme especificado para "docker pull". Se não for fornecida uma etiqueta como parte do nome da Imagem, a etiqueta ":latest" é usada como padrão. |
| registry |
O registo privado que contém a imagem do contentor. Esta definição pode ser omitida se já foi fornecida na criação do Pool. |
|
| workingDirectory |
A localização do diretório de trabalho da Tarefa do contentor. O padrão é 'taskWorkingDirectory'. |
BatchTaskDependencies
Especifica quaisquer 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.
| Name | Tipo | Description |
|---|---|---|
| taskIdRanges |
A lista de intervalos de IDs de Tarefa de que esta Tarefa depende. Todas as Tarefas em todos os intervalos devem ser concluídas com sucesso antes que a Tarefa dependente possa ser agendada. |
|
| taskIds |
string[] |
A lista de IDs de Tarefa de que esta Tarefa depende. Todas as Tarefas desta lista devem ser concluídas com sucesso antes que a Tarefa dependente possa ser agendada. A coleção de taskIds está limitada a 64000 caracteres no total (ou seja, o comprimento combinado de todos os IDs de tarefa). Se a coleção taskIds exceder o comprimento máximo, o pedido de Adicionar Tarefa falha com o código de erro TaskDependencyListTooLong. Neste caso, considere usar intervalos de ID de tarefa em vez disso. |
BatchTaskExecutionInfo
Informações sobre a execução de uma Tarefa.
| Name | Tipo | Description |
|---|---|---|
| containerInfo |
Informação sobre o contentor sob o qual a Tarefa está a ser executada. Esta propriedade é definida apenas se a Tarefa for executada num contexto de contentor. |
|
| endTime |
string (date-time) |
A hora em que a Tarefa foi concluída. Esta propriedade é definida apenas se a Tarefa estiver no estado Concluído. |
| exitCode |
integer (int32) |
O código de saída do programa especificado na linha de comandos Task. Esta propriedade é definida apenas se a Tarefa estiver no estado concluído. Em geral, o código de saída de um processo reflete a convenção específica implementada pelo programador da aplicação para esse processo. Se usar o valor do código de saída para tomar decisões no seu código, certifique-se de que conhece a convenção do código de saída usada pelo processo de candidatura. No entanto, se o serviço Batch terminar a Tarefa (devido ao timeout ou à terminação do utilizador via API), pode aparecer um código de saída definido pelo sistema operativo. |
| failureInfo |
Informação que descreve a falha da Tarefa, se houver. Esta propriedade é definida apenas se a Tarefa estiver no estado concluído e tiver sofrido uma falha. |
|
| lastRequeueTime |
string (date-time) |
A última vez em que a Tarefa foi reenfileirada pelo serviço Batch como resultado de um pedido de utilizador. Esta propriedade é definida apenas se o requeueCount for diferente de zero. |
| lastRetryTime |
string (date-time) |
A última vez em que uma nova tentativa da Tarefa começou a ser executada. Este elemento está presente apenas se a Tarefa foi retentada (ou seja, o retryCount for diferente de zero). Se presente, isto é tipicamente igual ao tempo de início, mas pode ser diferente se a tarefa tiver sido reiniciada por razões que não sejam retentar; por exemplo, se o Nó de Computação foi reiniciado durante uma retentativa, então o startTime é atualizado mas o lastRetryTime não. |
| requeueCount |
integer (int32) |
O número de vezes que a Tarefa foi reenfileirada pelo serviço Batch como resultado de um pedido de utilizador. Quando o utilizador remove os Nós de Computação de um Pool (redimensionando/reduzindo o pool) ou quando o Job está a ser desativado, o utilizador pode especificar que as Tarefas em execução nos Compute Nodes sejam reenfileiradas para execução. Esta contagem regista quantas vezes a Tarefa foi recolocada na fila por estas razões. |
| result |
O resultado da execução da Tarefa. Se o valor for 'failed', então os detalhes da falha podem ser encontrados na propriedade failureInfo. |
|
| retryCount |
integer (int32) |
O número de vezes que a Tarefa foi retentada pelo serviço Batch. Falhas de aplicação de tarefas (código de saída não nulo) são retentadas, erros de pré-processamento (a tarefa não pôde ser executada) e erros de carregamento de ficheiros não são retentados. O serviço Batch tenta novamente a Tarefa até ao limite especificado pelas restrições. |
| startTime |
string (date-time) |
A hora em que a Tarefa começou a decorrer. 'Running' corresponde ao estado em execução, por isso, se a Tarefa especificar ficheiros de recursos ou Pacotes, então a hora de início reflete o momento em que a Tarefa começou a descarregar ou implementar estes. Se a Tarefa foi reiniciada ou retentada, esta é a última vez em que a Tarefa começou a ser executada. Esta propriedade está presente apenas para Tarefas que estejam no estado em execução ou concluídas. |
BatchTaskExecutionResult
Enums BatchTaskExecutionResult
| Valor | Description |
|---|---|
| success |
A Tarefa correu com sucesso. |
| failure |
Houve um erro durante o processamento da Tarefa. A falha pode ter ocorrido antes do processo Tarefa ser lançado, enquanto o processo Tarefa estava em execução, ou depois de o processo Tarefa ter terminado. |
BatchTaskFailureInfo
Informações sobre uma falha de tarefa.
| Name | Tipo | Description |
|---|---|---|
| category |
A categoria do erro de tarefa. |
|
| code |
string |
Um identificador para o erro Tarefa. Os códigos são invariantes e destinam-se a ser consumidos programaticamente. |
| details |
Uma lista de detalhes adicionais relacionados com o erro. |
|
| message |
string |
Uma mensagem que descreve o erro Tarefa, destinada a ser adequada para exibição numa interface de utilizador. |
BatchTaskIdRange
O início e o fim do intervalo são inclusivos. Por exemplo, se um intervalo tiver início 9 e fim 12, ele representa Tarefas '9', '10', '11' e '12'.
| Name | Tipo | Description |
|---|---|---|
| end |
integer (int32) |
O último ID de Tarefa na gama. |
| start |
integer (int32) |
O primeiro ID de Tarefa na gama. |
BatchTaskState
Enums BatchTaskState
| Valor | Description |
|---|---|
| active |
A Tarefa está em fila e pode ser executada, mas não está atualmente atribuída a um Nó de Computação. Uma Tarefa entra neste estado quando é criada, quando é ativada após ser desativada, ou quando aguarda uma nova tentativa após uma execução falhada. |
| preparing |
A Tarefa foi atribuída a um Nó de Computação, mas está à espera que uma Tarefa de Preparação de Trabalho obrigatória seja concluída no Nó de Computação. Se a Tarefa de Preparação de Tarefas for bem-sucedida, a Tarefa passará para a corrida. Se a Tarefa de Preparação de Tarefas falhar, a Tarefa voltará a estar ativa e será elegível para ser atribuída a um Nó de Computação diferente. |
| running |
A tarefa está a correr num nó de computação. Isto inclui preparação ao nível da tarefa, como o download de ficheiros de recursos ou a implementação de Pacotes especificados na Tarefa – não significa necessariamente que a linha de comandos da Tarefa tenha começado a executar. |
| completed |
A Tarefa já não é elegível para ser executada, normalmente porque a Tarefa foi concluída com sucesso, ou porque a Tarefa foi concluída sem sucesso e esgotou o seu limite de retentativas. Uma tarefa também é marcada como concluída se ocorrer um erro ao iniciar a tarefa, ou quando a tarefa foi terminada. |
BatchTaskStatistics
Estatísticas de utilização de recursos para uma Tarefa.
| Name | Tipo | Description |
|---|---|---|
| kernelCPUTime |
string (duration) |
O tempo total de CPU em modo kernel (somado em todos os núcleos e todos os Nós de Computação) consumido pela Tarefa. |
| lastUpdateTime |
string (date-time) |
A data em que as estatísticas foram atualizadas pela última vez. Todas as estatísticas estão limitadas ao intervalo entre startTime e lastUpdateTime. |
| readIOGiB |
number (float) |
O total de gibibytes lidos do disco pela Tarefa. |
| readIOps |
string (int64) |
O número total de operações de leitura de disco realizadas pela Tarefa. |
| startTime |
string (date-time) |
A hora de início do intervalo temporal coberto pelas estatísticas. |
| url |
string (uri) |
O URL das estatísticas. |
| userCPUTime |
string (duration) |
O tempo total de CPU em modo utilizador (somado por todos os núcleos e todos os Nós de Computação) consumido pela Tarefa. |
| waitTime |
string (duration) |
O tempo total de espera da Tarefa. O tempo de espera para 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 retentada devido a falhas, o tempo de espera é o tempo até à execução da Tarefa mais recente.) |
| wallClockTime |
string (duration) |
O tempo total do relógio de parede da Tarefa. O tempo do relógio de parede é o tempo decorrido desde que a Tarefa começou a ser executada num Nó de Computação até ao seu término (ou até à última vez que as estatísticas foram atualizadas, se a Tarefa não tivesse terminado nessa altura). Se a Tarefa foi repetida, isto inclui o tempo de parede de todas as tentativas da Tarefa. |
| writeIOGiB |
number (float) |
O total de gibibytes gravados no disco pela Tarefa. |
| writeIOps |
string (int64) |
O número total de operações de escrita em disco realizadas pela Tarefa. |
ContainerHostBatchBindMountEntry
A entrada do caminho e do modo de montagem que você deseja montar no contêiner de tarefas.
| Name | Tipo | Description |
|---|---|---|
| isReadOnly |
boolean |
Monte esse caminho de origem como modo somente leitura ou não. O valor padrão é false (modo de leitura/gravação). Para Linux, se você montar esse caminho como um modo de leitura/gravação, isso não significa que todos os usuários no contêiner tenham o acesso de leitura/gravação para o caminho, depende do acesso na VM do host. Se esse caminho for montado somente leitura, todos os usuários dentro do contêiner não poderão modificá-lo. |
| source |
O caminho que ser montado para o cliente de contêiner pode selecionar. |
ContainerHostDataPath
Os caminhos que serão montados no contêiner da tarefa do contêiner.
| Valor | Description |
|---|---|
| Shared |
O caminho para a tarefa de várias instâncias compartilhar seus arquivos. |
| Startup |
O caminho para iniciar a tarefa. |
| VfsMounts |
O caminho contém todos os sistemas de arquivos virtuais montados neste nó. |
| Task |
O caminho da tarefa. |
| JobPrep |
O caminho da tarefa de preparação para o trabalho. |
| Applications |
O caminho dos aplicativos. |
ContainerRegistryReference
Um registro de contêiner privado.
| Name | Tipo | Description |
|---|---|---|
| identityReference |
A referência à identidade atribuída ao 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 (password) |
A palavra-passe para iniciar sessão no servidor de registo. |
| registryServer |
string (uri) |
O URL do registo. Se omitido, o padrão é "docker.io". |
| username |
string |
O nome de utilizador para iniciar sessão no servidor de registo. |
ContainerWorkingDirectory
ContainerWorkingDirectory enums
| Valor | Description |
|---|---|
| taskWorkingDirectory |
Use o diretório de trabalho padrão de Tarefas do serviço Batch, que conterá os Ficheiros de Recursos da Tarefa preenchidos por Batch. |
| containerImageDefault |
Use o diretório de trabalho definido na imagem do contentor. Atenção que este diretório não conterá os Ficheiros de Recursos descarregados pelo Batch. |
DependencyAction
Enums DependencyAction
| Valor | Description |
|---|---|
| satisfy |
Satisfazer tarefas que aguardam essa tarefa; Uma vez satisfeitas todas as dependências, a tarefa será agendada para execução. |
| block |
Bloqueia tarefas à espera dessa tarefa, impedindo-as de serem agendadas. |
ElevationLevel
Enums ElevationLevel
| Valor | Description |
|---|---|
| nonadmin |
O usuário é um usuário padrão sem acesso elevado. |
| admin |
O usuário é um usuário com acesso elevado e opera com permissões completas de administrador. |
EnvironmentSetting
Uma variável de ambiente a ser definida em um processo Task.
| Name | Tipo | Description |
|---|---|---|
| name |
string |
O nome da variável de ambiente. |
| value |
string |
O valor da variável de ambiente. |
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 (int32) |
Um código de saída de 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 (int32) |
O último código de saída na gama. |
| exitOptions |
Como o serviço Batch deve responder se a Tarefa sair com um código de saída no intervalo do início ao fim (inclusive). |
|
| start |
integer (int32) |
O primeiro código de saída na gama. |
ExitConditions
Especifica como o serviço em lote deve responder quando a tarefa for concluída.
| Name | Tipo | Description |
|---|---|---|
| default |
Como o serviço Batch deve responder caso a Tarefa falhe com uma condição de saída não coberta por nenhuma das outras propriedades. Este valor é usado se a Tarefa sair com qualquer código de saída não nulo que não esteja listado na coleção exitCodes ou exitCodeRanges, com um erro de pré-processamento se a propriedade preProcessingError não estiver presente, ou com um erro de carregamento de ficheiro se a propriedade fileUploadError não estiver presente. Se quiser um comportamento não padrão no código de saída 0, deve listá-lo explicitamente usando a coleção exitCodes ou exitCodeRanges. |
|
| exitCodeRanges |
Uma lista de intervalos de códigos de saída de tarefa e como o serviço Batch deve responder a eles. |
|
| exitCodes |
Uma lista de códigos individuais de saída de tarefa e como o serviço Batch deve responder a eles. |
|
| fileUploadError |
Como o serviço Batch deve responder caso ocorra um erro de carregamento de ficheiros. Se a tarefa saiu com um código de saída especificado através de exitCodes ou exitCodeRanges, e depois encontrou um erro de carregamento de ficheiro, então a ação especificada pelo código de saída tem prioridade. |
|
| preProcessingError |
Como o serviço Batch deve responder se a Tarefa falhar no início 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 realiza em Tarefas que dependem dessa Tarefa. Os valores possíveis são 'satisfizer' (permitindo que tarefas dependentes progridam) e 'bloqueio' (tarefas dependentes continuam à espera). O batch ainda não suporta o cancelamento de tarefas dependentes. |
|
| jobAction |
Uma ação a realizar no Trabalho que contém a Tarefa, se a Tarefa for concluída com a condição de saída dada e a propriedade onTaskFailed do Trabalho for 'performExitOptionsJobAction'. O padrão é nenhum para o código de saída 0 e terminar para todas as outras condições de saída. Se a propriedade onTaskFailed do Job for noaction, então especificar essa propriedade retorna um erro e o pedido de adicionar Task falha com um erro de valor de propriedade inválido; se estiver a chamar diretamente a API REST, o código de estado HTTP é 400 (Pedido Mau). |
MultiInstanceSettings
Tarefas de várias instâncias são comumente usadas para dar suporte a tarefas MPI. No caso do MPI, se qualquer uma das subtarefas falhar (por exemplo, devido à saída com um código de saída diferente de zero), toda a Tarefa de várias instâncias falhará. A tarefa de várias instâncias é então encerrada e repetida, até seu limite de repetição.
| Name | Tipo | Description |
|---|---|---|
| commonResourceFiles |
Uma lista de ficheiros que o serviço Batch irá descarregar antes de executar a linha de comandos de coordenação. A diferença entre os ficheiros de recursos comuns e os ficheiros de recursos da Tarefa é que os ficheiros de recursos comuns são descarregados para todas as subtarefas, incluindo a primária, enquanto os ficheiros de recursos da Tarefa são descarregados apenas para a primária. Note também que estes ficheiros de recursos não são descarregados para o diretório de trabalho Tarefa, mas sim para o diretório raiz de Tarefa (um diretório acima do diretório de trabalho). 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. |
|
| coordinationCommandLine |
string |
A linha de comandos para correr em todos os Nós de Computação para lhes permitir coordenar quando o principal executa o comando principal de Tarefa. Uma linha de comandos típica de coordenação lança um serviço em segundo plano e verifica se o serviço está pronto para processar mensagens entre nós. |
| numberOfInstances |
integer (int32) |
O número de Nós de Computação exigidos pela Tarefa. Se for omitido, o padrão é 1. |
NameValuePair
Representa um par nome-valor.
| Name | Tipo | Description |
|---|---|---|
| name |
string |
O nome no par nome-valor. |
| value |
string |
O valor no par nome-valor. |
OutputFile
Em cada upload de arquivo, o serviço Batch grava dois arquivos de log no nó de computação, 'fileuploadout.txt' e 'fileuploaderr.txt'. Esses arquivos de log são usados para saber mais sobre uma falha específica.
| Name | Tipo | Description |
|---|---|---|
| destination |
O destino do(s) ficheiro(s) de saída. |
|
| filePattern |
string |
Um padrão que indica que ficheiro(s) carregar. Tanto os caminhos relativos como os absolutos são suportados. Os caminhos relativos são relativos ao diretório de trabalho Tarefa. São suportados os seguintes coringas: * corresponde a 0 ou mais caracteres (por exemplo, o padrão abc* corresponderia a abc ou abcdef), ** corresponde a qualquer diretório, ? corresponde a qualquer personagem individual, [ABC] corresponde a um personagem entre parênteses, e [A-C] corresponde a um carácter no intervalo. Os parênteses podem incluir uma negação para corresponder a qualquer carácter não especificado (por exemplo, [!abc] corresponde a qualquer carácter exceto a, b ou c). Se o nome de um ficheiro começar por "." é ignorado por defeito, mas pode ser correspondido especificando-o explicitamente (por exemplo ,.gif não corresponderá .a.gif, mas.gif sim). Um exemplo simples: ***.txt corresponde a qualquer ficheiro que não comece em '.' e termine com .txt no diretório de trabalho Task ou em qualquer subdiretório. Se o nome do ficheiro contiver um carácter curinga, pode ser escapado usando parênteses (por exemplo, abc[] corresponderia a um ficheiro chamado abc). Note que tanto \ como / são tratados como separadores de diretórios no Windows, mas apenas / é no Linux. As variáveis de ambiente (%var% no Windows ou $var no Linux) são expandidas antes da aplicação do padrão. |
| uploadOptions |
Opções adicionais para a operação de upload, incluindo em que condições realizar o upload. |
OutputFileBlobContainerDestination
Especifica um destino de carregamento de arquivo em um contêiner de armazenamento de blob do Azure.
| Name | Tipo | Description |
|---|---|---|
| containerUrl |
string (uri) |
A URL do contentor dentro do Azure Blob Storage para onde carregar o(s) ficheiro(s). Se não estiver a usar uma identidade gerida, a URL deve incluir uma Assinatura de Acesso Partilhado (SAS) que conceda permissões de escrita ao contentor. |
| identityReference |
A referência à identidade atribuída pelo utilizador para aceder ao Azure Blob Storage especificada pelo containerUrl. A identidade deve ter acesso de escrita ao contentor Azure Blob Storage. |
|
| path |
string |
O blob de destino ou diretório virtual dentro do contentor Azure Storage. Se filePattern se referir a um ficheiro específico (ou seja, não contiver curingas), então path é o nome do blob para onde se deve carregar esse ficheiro. Se o filePattern contiver um ou mais wildcards (e, portanto, pode corresponder a vários ficheiros), então path é o nome do diretório virtual do blob (que é antecedido a cada nome do blob) para o qual carregar o(s) ficheiro(s). Se omitido(s), o(s) ficheiro(s) são carregados para a raiz do contentor com um nome de blob correspondente ao nome do ficheiro. |
| uploadHeaders |
Uma lista de pares nome-valor para cabeçalhos a serem usados no carregamento de ficheiros de saída. Estes cabeçalhos serão especificados ao carregar ficheiros para o Azure Storage. Documento oficial sobre cabeçalhos permitidos ao carregar blobs: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types. |
OutputFileDestination
O destino para o qual um arquivo deve ser carregado.
| Name | Tipo | Description |
|---|---|---|
| container |
Um local no armazenamento de blobs do Azure para onde os ficheiros são carregados. |
OutputFileUploadCondition
OutputFileUploadCondition enums
| Valor | Description |
|---|---|
| tasksuccess |
Carregue o(s) ficheiro(s) apenas depois de o processo de Tarefa sair com um código de saída 0. |
| taskfailure |
Carrega o(s) ficheiro(s) apenas depois de o processo de Tarefa sair com um código de saída diferente de zero. |
| taskcompletion |
Carrega o(s) ficheiro(s) depois de o processo de Tarefa sair, independentemente do código de saída. |
OutputFileUploadConfig
Opções para uma operação de upload de arquivo de saída, incluindo em que condições executar o upload.
| Name | Tipo | Description |
|---|---|---|
| uploadCondition |
As condições sob as quais o ficheiro de saída da Tarefa ou conjunto de ficheiros deve ser carregado. O padrão é a conclusão de tarefas. |
OutputFileUploadHeader
Um par nome-valor de cabeçalho HTTP
| Name | Tipo | Description |
|---|---|---|
| name |
string |
O nome insensível a maiúsculas minúsculas do cabeçalho a ser usado durante o carregamento dos ficheiros de saída. |
| value |
string |
O valor do cabeçalho a ser usado ao carregar ficheiros de saída. |
ResourceFile
Um único arquivo ou vários arquivos a serem baixados para um nó de computação.
| Name | Tipo | Description |
|---|---|---|
| autoStorageContainerName |
string |
O nome do contentor de armazenamento na conta de armazenamento automático. As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. |
| blobPrefix |
string |
O prefixo de blob a ser usado ao baixar blobs de um contêiner de Armazenamento do Azure. Somente os blobs cujos nomes começam com o prefixo especificado serão baixados. A propriedade é válida somente quando autoStorageContainerName ou storageContainerUrl é usado. Esse prefixo pode ser um nome de arquivo parcial ou um subdiretório. Se um prefixo não for especificado, todos os arquivos no contêiner serão baixados. |
| fileMode |
string |
O atributo file permission mode em formato octal. Esta propriedade aplica-se apenas a ficheiros descarregados para os Nós de Computação Linux. Será ignorado se for especificado para um resourceFile que será descarregado para um Nó de Computação do Windows. Se esta propriedade não for especificada para um Nó de Computação Linux, então é aplicado um valor padrão de 0770 ao ficheiro. |
| filePath |
string |
A localização no Nó de Computação para onde descarregar o(s) ficheiro(s), relativa ao diretório de trabalho da Tarefa. Se a propriedade httpUrl for especificada, o filePath será necessário e descreverá o caminho para o qual o arquivo será baixado, incluindo o nome do arquivo. Caso contrário, se a propriedade autoStorageContainerName ou storageContainerUrl for especificada, filePath será opcional e será o diretório para o qual os arquivos serão baixados. No caso em que filePath é usado como um diretório, qualquer estrutura de diretório já associada aos dados de entrada será mantida na íntegra e anexada ao diretório filePath especificado. O caminho relativo especificado não pode sair do diretório de trabalho da Tarefa (por exemplo, usando '..'). |
| httpUrl |
string (uri) |
O URL do ficheiro a transferir. As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Se a URL apontar para o Armazenamento de Blobs do Azure, ela deverá ser legível a partir dos nós de computação. Há três maneiras de obter essa URL para um blob no armazenamento do Azure: incluir uma Assinatura de Acesso Compartilhado (SAS) concedendo permissões de leitura no blob, usar uma identidade gerenciada com permissão de leitura ou definir a ACL para o blob ou seu contêiner para permitir acesso público. |
| identityReference |
A referência à identidade atribuída pelo utilizador para aceder ao Azure Blob Storage especificada por storageContainerUrl ou httpUrl. |
|
| storageContainerUrl |
string (uri) |
A URL do contêiner de blob no Armazenamento de Blob do Azure. As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Este URL deve ser legível e listável a partir de nós de computação. Há três maneiras de obter essa URL para um contêiner no armazenamento do Azure: incluir uma SAS (Assinatura de Acesso Compartilhado) concedendo permissões de leitura e lista no contêiner, usar uma identidade gerenciada com permissões de leitura e lista ou definir a ACL do contêiner para permitir acesso público. |
UserIdentity
A definição da identidade do usuário sob a qual a Tarefa é executada. Especifique a propriedade userName ou autoUser, mas não ambas.
| Name | Tipo | Description |
|---|---|---|
| autoUser |
O utilizador automático sob o qual a Tarefa é executada. As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos. |
|
| username |
string |
O nome da identidade do utilizador sob a qual a Tarefa é executada. As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos. |