Compartilhar via


Tasks - Get Task

Recebe 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 de lista para recuperar 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 de URI

Nome Em Obrigatório Tipo Description
endpoint
path True

string (uri)

Ponto de extremidade da conta do Lote (por exemplo: https://batchaccount.eastus2.batch.azure.com).

jobId
path True

string

O ID do Trabalho que contém a Tarefa.

taskId
path True

string

O ID da Tarefa para obter informações sobre.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

$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 em seu lugar.".

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
client-request-id

string

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-rfc7231)

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-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 horário 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 horário especificado.

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.

Respostas

Nome Tipo Description
200 OK

BatchTask

A solicitação foi bem-sucedida.

Cabeçalhos

  • DataServiceId: string
  • ETag: string
  • Last-Modified: string
  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

Uma resposta de erro inesperada.

Segurança

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Escopos

Nome Description
https://batch.core.windows.net//.default

Exemplos

Task get

Solicitação de exemplo

GET {endpoint}/jobs/jobId/tasks/taskId?api-version=2025-06-01


Resposta de exemplo

{
  "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

Nome Description
AuthenticationTokenSettings

As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço do Lote.

AutoUserScope

Enums AutoUserScope

AutoUserSpecification

Especifica as opções para o usuário automático que executa uma Tarefa do Lote do Azure.

BatchAccessScope

Enums BatchAccessScope

BatchAffinityInfo

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.

BatchApplicationPackageReference

Uma referência a um pacote a ser implantado em Nós de Computação.

BatchError

Uma resposta de erro recebida do serviço do Lote do Azure.

BatchErrorDetail

Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.

BatchErrorMessage

Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.

BatchErrorSourceCategory

BatchErrorSourceCategory enums

BatchJobActionKind

Enums do BatchJobAction

BatchNodeIdentityReference

A referência a uma identidade atribuída pelo usuário associada ao pool do Lote que um nó de computação usará.

BatchNodeInfo

Informações sobre o Nó de Computação no qual uma Tarefa foi executada.

BatchTask

O Lote tentará novamente tarefas quando uma operação de recuperação for disparada em um nó. Exemplos de operações de recuperação incluem (mas não se limitam a) quando um nó não íntegro é reinicializado ou um Nó de Computação desapareceu devido a uma falha de host. As novas tentativas devido às operações de recuperação são independentes e não são contadas em relação ao maxTaskRetryCount. Mesmo que o maxTaskRetryCount seja 0, uma repetição interna devido a uma operação de recuperação poderá ocorrer. Por isso, todas as tarefas devem ser idempotentes. Isso significa que as tarefas precisam tolerar ser interrompidas e reiniciadas sem causar dados corrompidos ou duplicados. A melhor prática para tarefas de execução longa é usar alguma forma de ponto de verificação.

BatchTaskConstraints

Restrições de execução a serem aplicadas a uma Tarefa.

BatchTaskContainerExecutionInfo

Contém informações sobre o contêiner que uma Tarefa está executando.

BatchTaskContainerSettings

As configurações de contêiner de uma Tarefa.

BatchTaskDependencies

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.

BatchTaskExecutionInfo

Informações sobre a execução de uma Tarefa.

BatchTaskExecutionResult

Enums BatchTaskExecutionResult

BatchTaskFailureInfo

Informações sobre uma falha de tarefa.

BatchTaskIdRange

O início e o final do intervalo são inclusivos. Por exemplo, se um intervalo tiver início 9 e término 12, ele representará Tarefas '9', '10', '11' e '12'.

BatchTaskState

Enums BatchTaskState

BatchTaskStatistics

Estatísticas de uso de recursos para uma Tarefa.

ContainerHostBatchBindMountEntry

A entrada do caminho e do modo de montagem que você deseja montar no contêiner de tarefas.

ContainerHostDataPath

Os caminhos que serão montados no contêiner da tarefa de contêiner.

ContainerRegistryReference

Um registro de contêiner privado.

ContainerWorkingDirectory

ContainerWorkingDirectory enums

DependencyAction

Enums DependencyAction

ElevationLevel

Enums de Elevação

EnvironmentSetting

Uma variável de ambiente a ser definida em um processo de tarefa.

ExitCodeMapping

Como o serviço lote deve responder se uma Tarefa for encerrada com um código de saída específico.

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.

ExitConditions

Especifica como o serviço do Lote deve responder quando a Tarefa for concluída.

ExitOptions

Especifica como o serviço do Lote responde a uma condição de saída específica.

MultiInstanceSettings

Tarefas de várias instâncias geralmente são usadas para dar suporte a Tarefas de MPI. No caso do MPI, se alguma 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á. Em seguida, a Tarefa de várias instâncias é encerrada e repetida, até o limite de repetição.

NameValuePair

Representa um par nome-valor.

OutputFile

Em cada upload de arquivo, o serviço lote 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.

OutputFileBlobContainerDestination

Especifica um destino de upload de arquivo em um contêiner de armazenamento de blobs do Azure.

OutputFileDestination

O destino para o qual um arquivo deve ser carregado.

OutputFileUploadCondition

Enums OutputFileUploadCondition

OutputFileUploadConfig

Opções para uma operação de upload de arquivo de saída, incluindo sob quais condições executar o upload.

OutputFileUploadHeader

Um par nome-valor de cabeçalho HTTP

ResourceFile

Um único arquivo ou vários arquivos a serem baixados em um Nó de Computação.

UserIdentity

A definição da identidade do usuário na 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 do Lote.

Nome Tipo Description
access

BatchAccessScope[]

Os recursos do lote aos quais 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 ao Job que contém a Tarefa.

AutoUserScope

Enums AutoUserScope

Valor Description
task

Especifica que o serviço deve criar um novo usuário para a Tarefa.

pool

Especifica que a Tarefa roda como a conta de usuário automático comum, criada em cada Nó de Computação em um Pool.

AutoUserSpecification

Especifica as opções para o usuário automático que executa uma Tarefa do Lote do Azure.

Nome Tipo Description
elevationLevel

ElevationLevel

O nível de elevação do usuário automático. O valor padrão é nonAdmin.

scope

AutoUserScope

O escopo do usuário automático. O valor padrão é pool. Se o pool estiver executando o Windows, um valor de Tarefa deverá ser especificado se for necessário um isolamento mais rigoroso entre as tarefas. Por exemplo, se a tarefa alterar o registro de uma forma que possa afetar outras tarefas.

BatchAccessScope

Enums BatchAccessScope

Valor Description
job

Concede acesso para realizar todas as operações no Trabalho contendo a Tarefa.

BatchAffinityInfo

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 string opaca que representa a localização de um Nó de Computação ou de uma Tarefa que já foi executada anteriormente. Você pode passar o affinityId de um nó para indicar que essa tarefa precisa rodar nesse nó de computação. Observe que isso é 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.

Nome Tipo Description
applicationId

string

O ID do aplicativo a ser implantado. 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 isso for omitido em um Pool, e nenhuma versão padrão for especificada para esta aplicação, a solicitação falha com o código de erro InvalidApplicationPackageReferences, e o código de status HTTP 409. Se isso for omitido em uma tarefa, e nenhuma versão padrão for especificada para essa aplicação, a tarefa falha com um erro de pré-processamento.

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

BatchErrorMessage

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

values

BatchErrorDetail[]

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.

BatchErrorMessage

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.

BatchErrorSourceCategory

BatchErrorSourceCategory enums

Valor Description
usererror

O erro se deve a um problema do usuário, como uma configuração incorreta.

servererror

O erro se deve a um problema interno no servidor.

BatchJobActionKind

Enums do BatchJobAction

Valor Description
none

Não tome nenhuma ação.

disable

Desative o trabalho. Isso é equivalente a chamar a API de Job de desativação, com um valor de requeue para disableTasks.

terminate

Encerre o trabalho. A terminationReason na executionInfo do Job está definida como "TaskFailed".

BatchNodeIdentityReference

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 (arm-id)

A ID de recurso do ARM da identidade atribuída pelo usuário.

BatchNodeInfo

Informações sobre o Nó de Computação no qual uma Tarefa foi executada.

Nome Tipo Description
affinityId

string

Um identificador para o Nó em que a Tarefa rodava, 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 no qual a Tarefa rodava.

nodeUrl

string (uri)

A URL do Nó de Computação onde a Tarefa rodava.

poolId

string

O ID do Pool em que a Tarefa rodava.

taskRootDirectory

string

O diretório raiz da Tarefa no Nó de Computação.

taskRootDirectoryUrl

string (uri)

A URL do diretório raiz da Tarefa no Nó de Computação.

BatchTask

O Lote tentará novamente tarefas quando uma operação de recuperação for disparada em um nó. Exemplos de operações de recuperação incluem (mas não se limitam a) quando um nó não íntegro é reinicializado ou um Nó de Computação desapareceu devido a uma falha de host. As novas tentativas devido às operações de recuperação são independentes e não são contadas em relação ao maxTaskRetryCount. Mesmo que o maxTaskRetryCount seja 0, uma repetição interna devido a uma operação de recuperação poderá ocorrer. Por isso, todas as tarefas devem ser idempotentes. Isso significa que as tarefas precisam tolerar ser interrompidas e reiniciadas sem causar dados corrompidos ou duplicados. A melhor prática para tarefas de execução longa é usar alguma forma de ponto de verificação.

Nome Tipo Description
affinityInfo

BatchAffinityInfo

Uma dica de localidade que pode ser usada pelo serviço Batch para selecionar um Nó de Computação no qual iniciar a nova Tarefa.

applicationPackageReferences

BatchApplicationPackageReference[]

Uma lista de Pacotes que o serviço Batch irá implantar no Nó de Computação antes de executar a linha de comando. Os pacotes de aplicação são baixados e implantados em um diretório compartilhado, não no diretório de trabalho Tarefa. Portanto, se um pacote referenciado já estiver no Nó e atualizado, ele não é baixado 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 deletado ou porque o download falhou, a Tarefa falha.

authenticationTokenSettings

AuthenticationTokenSettings

As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço do Lote. Se essa propriedade for 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 por meio da variável de ambiente AZ_BATCH_AUTHENTICATION_TOKEN. As operações que a Tarefa pode realizar usando o token dependem das configurações. Por exemplo, uma Tarefa pode solicitar permissões de Trabalho para adicionar outras Tarefas ao Trabalho, ou verificar o status do Trabalho ou de outras Tarefas sob o Trabalho.

commandLine

string

A linha de comando da Tarefa. Para Tarefas multiinstância, a linha de comando é executada como a Tarefa principal, após a Tarefa principal e todas as subtarefas terem terminado de executar a linha de comando de coordenação. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se quiser aproveitar esses recursos, invoque 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 da Tarefa) ou usar a variável de ambiente fornecida pelo Lote (https://v4.hkg1.meaqua.org/azure/batch/batch-compute-node-environment-variables).

constraints

BatchTaskConstraints

As restrições de execução que se aplicam a esta Tarefa.

containerSettings

BatchTaskContainerSettings

As configurações do contêiner sob o qual a Tarefa é executada. Se o pool que executará essa tarefa tiver containerConfiguration ativado, isso também deve ser definido. Se o pool que executará essa tarefa não tiver containerConfiguration ativado, isso não deve ser definido. Quando isso é 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 no contêiner, todas as variáveis do ambiente Tarefa são mapeadas no contêiner, e a linha de comando Tarefa é executada no contêiner. Arquivos produzidos no contêiner fora do AZ_BATCH_NODE_ROOT_DIR podem não ser refletidos no disco hospedeiro, o que significa que APIs de arquivos Batch não conseguirão acessar esses arquivos.

creationTime

string (date-time)

O tempo de criação da Tarefa.

dependsOn

BatchTaskDependencies

As tarefas das quais essa tarefa depende. Essa Tarefa não será agendada até que todas as Tarefas das quais ela depende tenham sido concluídas com sucesso. Se alguma dessas Tarefas falhar e esgotar a contagem de tentativas de novo, essa Tarefa nunca será agendada.

displayName

string

Um nome de exibição para a Tarefa. O nome de 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. Essa é uma cadeia de caracteres opaca. Você pode usá-lo para detectar se a tarefa mudou entre as requisições. Em particular, você pode passar o ETag ao atualizar uma Tarefa para especificar que suas mudanças só devem entrar em vigor se ninguém mais tiver modificado a Tarefa nesse meio tempo.

environmentSettings

EnvironmentSetting[]

Uma lista de configurações de variáveis de ambiente para a Tarefa.

executionInfo

BatchTaskExecutionInfo

Informações sobre a execução da Tarefa.

exitConditions

ExitConditions

Como o serviço em lote deve responder quando a tarefa for concluída.

id

string

Uma cadeia que identifica de forma única a Tarefa dentro do Trabalho. A ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hifens e sublinhados, e não pode conter mais de 64 caracteres.

lastModified

string (date-time)

O último tempo modificado da Tarefa.

multiInstanceSettings

MultiInstanceSettings

Um objeto que indica que a tarefa é uma tarefa multiinstância e contém informações sobre como executar a tarefa multiinstância.

nodeInfo

BatchNodeInfo

Informações sobre o Nó de Computação onde a Tarefa rodava.

outputFiles

OutputFile[]

Uma lista de arquivos que o serviço Batch enviará do Nó de Computação após executar a linha de comando. Para Tarefas de múltiplas instâncias, os arquivos só serão carregados do Nó de Computação onde a Tarefa principal é executada.

previousState

BatchTaskState

O estado anterior da Tarefa. Essa propriedade não é definida se a Tarefa estiver em seu estado inicial Ativo.

previousStateTransitionTime

string (date-time)

O momento em que a Tarefa entrou em seu estado anterior. Essa propriedade não é definida se a Tarefa estiver em seu estado inicial Ativo.

requiredSlots

integer (int32)

O número de espaços de agendamento que a Tarefa precisa para executar. O padrão é 1. Uma Tarefa só pode ser agendada para rodar em um nó de computação se o nó tiver vagas de agendamento livres suficientes disponíveis. Para Tarefas de múltiplas instâncias, isso deve ser 1.

resourceFiles

ResourceFile[]

Uma lista de arquivos que o serviço do Lote baixará no Nó de Computação antes de executar a linha de comando. Para Tarefas multiinstância, os arquivos de recurso serão baixados apenas para o Nó de Computação onde a Tarefa principal é executada. Há um tamanho máximo para a lista de arquivos de recurso. 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 deverá ser reduzida em tamanho. Isso pode ser feito usando arquivos .zip, pacotes de aplicativos ou contêineres do Docker.

state

BatchTaskState

O estado atual da Tarefa.

stateTransitionTime

string (date-time)

O momento em que a Tarefa entrou em seu estado atual.

stats

BatchTaskStatistics

Estatísticas de uso de recursos para a Tarefa.

url

string (uri)

A URL da tarefa.

userIdentity

UserIdentity

A identidade do usuário sob a qual a Tarefa é executada. Se omitida, a Tarefa roda como um usuário não administrativo exclusivo da Tarefa.

BatchTaskConstraints

Restrições de execução a serem aplicadas a uma Tarefa.

Nome Tipo Description
maxTaskRetryCount

integer (int32)

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. Note que esse valor controla especificamente o número de tentativas para o executável da Tarefa devido a um código de saída diferente de zero. O serviço lote tentará a Tarefa uma vez e poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de repetição for 3, o Lote tentará a Tarefa até 4 vezes (uma tentativa inicial e três tentativas). Se a contagem máxima 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 repetição for -1, o serviço do 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 novas 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 tempo limite, o serviço Batch a encerra. Se isso não for especificado, não há limite de tempo para quanto tempo a Tarefa pode durar.

retentionTime

string (duration)

O tempo mínimo para manter o diretório Tarefa no Nó de Computação onde ela foi executada, a partir do momento em que ela é concluída. Após esse tempo, o serviço Batch pode deletar o diretório Task e todo o seu conteúdo. O padrão é 7 dias, ou seja, o diretório Tarefa será mantido por 7 dias, a menos que o Nó de Computação seja removido ou o Trabalho seja excluído.

BatchTaskContainerExecutionInfo

Contém informações sobre o contêiner que uma Tarefa está executando.

Nome Tipo Description
containerId

string

O ID do contêiner.

error

string

Informações detalhadas sobre o contêiner. Esta é a string de erro detalhada do serviço Docker, se disponível. É equivalente ao campo de erro retornado por "docker inspect".

state

string

O estado do recipiente. Esse é o estado do contêiner de acordo com o serviço Docker. É equivalente ao campo de status retornado por "docker inspect".

BatchTaskContainerSettings

As configurações de contêiner de uma Tarefa.

Nome Tipo Description
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

Os caminhos que você deseja montar na 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 de criação de contêiner. Essas opções adicionais são fornecidas como argumentos para o comando "docker create", além das controladas pelo Serviço de Lote.

imageName

string

A imagem a ser usada para criar o contêiner onde a tarefa será executada. Esta é a referência completa da Imagem, conforme especificado para "docker pull". Se nenhuma tag for fornecida como parte do nome da Imagem, a tag ":latest" é usada como padrão.

registry

ContainerRegistryReference

O registro privado que contém a imagem do contêiner. Essa configuração pode ser omitida se já foi fornecida na criação do Pool.

workingDirectory

ContainerWorkingDirectory

A localização do diretório de trabalho Container Task. O padrão é 'taskWorkingDirectory'.

BatchTaskDependencies

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

BatchTaskIdRange[]

A lista de intervalos de IDs de Tarefa dos quais essa 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 da qual essa 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 é limitada a 64.000 caracteres no total (ou seja, o comprimento combinado de todos os IDs de tarefa). Se a coleção taskIds exceder o comprimento máximo, a solicitação de Adicionar Tarefa falha com o código de erro TaskDependencyListTooLong. Nesse caso, considere usar intervalos de IDs de tarefa.

BatchTaskExecutionInfo

Informações sobre a execução de uma Tarefa.

Nome Tipo Description
containerInfo

BatchTaskContainerExecutionInfo

Informações sobre o contêiner sob o qual a Tarefa está sendo executada. Essa propriedade é definida apenas se a Tarefa rodar em um contexto de container.

endTime

string (date-time)

O momento em que a Tarefa foi concluída. Essa 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 comando Task. Essa 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 desenvolvedor da aplicação para aquele processo. Se você usar o valor do código de saída para tomar decisões no seu código, certifique-se de conhecer a convenção do código de saída usada pelo processo de aplicação. No entanto, se o serviço Batch encerrar a Tarefa (devido ao timeout ou ao término do usuário via API), você pode ver um código de saída definido pelo sistema operacional.

failureInfo

BatchTaskFailureInfo

Informações que descrevem a falha da Tarefa, se houver. Essa propriedade é definida apenas se a Tarefa estiver no estado concluído e tiver encontrado uma falha.

lastRequeueTime

string (date-time)

A última vez em que a Tarefa foi reenfileirada pelo serviço Batch como resultado de uma solicitação de usuário. Essa propriedade é definida apenas se o requeueCount for diferente de zero.

lastRetryTime

string (date-time)

A última vez em que uma retentativa da Tarefa começou a ser executada. Esse elemento está presente apenas se a Tarefa foi retentada (ou seja, o número de tentativas for diferente de zero). Se presente, isso normalmente é igual ao tempo de início, mas pode ser diferente se a tarefa tiver sido reiniciada por motivos diferentes de tentar novamente; por exemplo, se o Compute Node 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 uma solicitação de usuário. Quando o usuário remove Nós de Computação de um Pool (redimensionando/reduzindo o pool) ou quando o Job está sendo desativado, o usuário pode especificar que as Tarefas em execução nos Nós de Computação sejam reenfileiradas para execução. Essa contagem acompanha quantas vezes a Tarefa foi reenfileirada por esses motivos.

result

BatchTaskExecutionResult

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 em lote. Falhas de aplicação de tarefa (código de saída diferente de zero) são tentadas novamente, erros de pré-processamento (a tarefa não pôde ser executada) e erros de upload de arquivos não são tentados novamente. O serviço Batch tentará novamente a Tarefa até o limite especificado pelas restrições.

startTime

string (date-time)

O horário em que a Tarefa começou a ser executada. 'Executando' corresponde ao estado em execução, então se a Tarefa especifica arquivos de recursos ou Pacotes, o horário de início reflete o momento em que a Tarefa começou a baixar ou implantar esses arquivos. Se a Tarefa foi reiniciada ou retentada, este é o momento mais recente em que a Tarefa começou a ser executada. Essa propriedade está presente apenas para Tarefas que estão no estado em execução ou concluídas.

BatchTaskExecutionResult

Enums BatchTaskExecutionResult

Valor Description
success

A Tarefa foi executada 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 após o encerramento do processo Tarefa.

BatchTaskFailureInfo

Informações sobre uma falha de tarefa.

Nome Tipo Description
category

BatchErrorSourceCategory

A categoria do erro de tarefa.

code

string

Um identificador para o erro Tarefa. Os códigos são invariáveis e devem ser consumidos programaticamente.

details

NameValuePair[]

Uma lista de detalhes adicionais relacionados ao erro.

message

string

Uma mensagem descrevendo o erro de tarefa, destinada a ser adequada para exibição em uma interface de usuário.

BatchTaskIdRange

O início e o final do intervalo são inclusivos. Por exemplo, se um intervalo tiver início 9 e término 12, ele representará Tarefas '9', '10', '11' e '12'.

Nome Tipo Description
end

integer (int32)

O último ID de Tarefa da faixa.

start

integer (int32)

O primeiro ID de Tarefa da alcance.

BatchTaskState

Enums BatchTaskState

Valor Description
active

A Tarefa está em fila e pode ser executada, mas atualmente não está atribuída a um Nó de Computação. Uma Tarefa entra nesse estado quando é criada, quando é habilitada após ser desativada, ou quando está aguardando uma nova tentativa após uma execução falhada.

preparing

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 obrigatória no Nó de Computação. Se a Tarefa de Preparação de Tarefas for bem-sucedida, a Tarefa passará para a execução. Se a Tarefa de Preparação de Trabalho falhar, a Tarefa voltará à ativa e será elegível para ser designada a um Nó de Computação diferente.

running

A tarefa está rodando em um Nó de Computação. Isso inclui preparação em nível de tarefa, como baixar arquivos de recursos ou implantar Pacotes especificados na Tarefa – não significa necessariamente que a linha de comando da Tarefa tenha começado a ser executada.

completed

A Tarefa não é mais elegível para ser executada, geralmente porque a Tarefa foi concluída com sucesso, ou porque a Tarefa foi concluída sem sucesso e esgotou seu limite de tentativas de reabilitação. Uma Tarefa também é marcada como concluída se ocorreu um erro ao iniciar a Tarefa, ou quando a Tarefa foi encerrada.

BatchTaskStatistics

Estatísticas de uso de recursos para uma Tarefa.

Nome 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)

O momento em que as estatísticas foram atualizadas pela última vez. Todas as estatísticas são limitadas à faixa 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 feitas pela Tarefa.

startTime

string (date-time)

O horário de início do intervalo de tempo coberto pelas estatísticas.

url

string (uri)

A URL das estatísticas.

userCPUTime

string (duration)

O tempo total de CPU em modo usuário (somado em 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é a 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 rodar em um nó de computação até o término (ou até a última vez que as estatísticas foram atualizadas, caso a tarefa não tivesse terminado até então). Se a Tarefa foi tentada novamente, isso inclui o tempo de parede de todas as tentativas de Tarefa.

writeIOGiB

number (float)

O total de gibibytes gravados no disco pela Tarefa.

writeIOps

string (int64)

O número total de operações de gravação em disco feitas pela Tarefa.

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). Para o 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, isso 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 modificar o caminho.

source

ContainerHostDataPath

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.

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 do trabalho.

Applications

O caminho dos aplicativos.

ContainerRegistryReference

Um registro de contêiner privado.

Nome Tipo Description
identityReference

BatchNodeIdentityReference

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 (password)

A senha para fazer logon no servidor do Registro.

registryServer

string (uri)

A URL do registro. Se omitido, o padrão será "docker.io".

username

string

O nome de usuário a ser conectado ao servidor do Registro.

ContainerWorkingDirectory

ContainerWorkingDirectory enums

Valor Description
taskWorkingDirectory

Use o diretório padrão de trabalho de Tarefas do serviço Batch, que conterá os Arquivos de Recursos de Tarefas preenchidos por Batch.

containerImageDefault

Use o diretório de trabalho definido na imagem do contêiner. Atenção, este diretório não conterá os Arquivos de Recursos baixados pelo Batch.

DependencyAction

Enums DependencyAction

Valor Description
satisfy

Satisfazer tarefas que aguardam essa tarefa; Uma vez que todas as dependências sejam satisfeitas, a tarefa será programada para ser executada.

block

Bloqueia tarefas que aguardam essa tarefa, impedindo que sejam agendadas.

ElevationLevel

Enums de Elevação

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 de Administrador completas.

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.

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 (int32)

Um código de saída de processo.

exitOptions

ExitOptions

Como o serviço Batch 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 (int32)

O último código de saída na faixa.

exitOptions

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 (inclusivo).

start

integer (int32)

O primeiro código de saída na faixa.

ExitConditions

Especifica como o serviço do Lote deve responder quando a Tarefa for concluída.

Nome Tipo Description
default

ExitOptions

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. Esse valor é usado se a Tarefa sair com qualquer código de saída não nulo não listado nas coleções exitCodes ou exitCodeRanges, com erro de pré-processamento se a propriedade pré-ErrorProcessamento não estiver presente, ou com erro de upload de arquivo se a propriedade ErrorCarregamento não estiver presente. Se você quiser comportamento não padrão no código de saída 0, deve listá-lo explicitamente usando a coleção exitCodes ou exitCodeRanges.

exitCodeRanges

ExitCodeRangeMapping[]

Uma lista dos intervalos de código de saída de tarefa e como o serviço Batch deve responder a eles.

exitCodes

ExitCodeMapping[]

Uma lista de códigos individuais de saída de Tarefa e como o serviço Batch deve responder a eles.

fileUploadError

ExitOptions

Como o serviço de lote deve responder caso ocorra um erro de upload de arquivo. Se a Tarefa saiu com um código de saída especificado via exitCodes ou exitCodeRanges, e então encontrou um erro de upload de arquivo, então a ação especificada pelo código de saída tem precedência.

preProcessingError

ExitOptions

Como o serviço Batch deve responder caso a Tarefa não inicie 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

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 esperando). O batch ainda não suporta o cancelamento de tarefas dependentes.

jobAction

BatchJobActionKind

Uma ação a ser tomada no Trabalho contendo 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 termina 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 a solicitação de adicionar Task falha com um erro de valor de propriedade inválido; se você está chamando diretamente a API REST, o código de status HTTP é 400 (Solicitação Ruim).

MultiInstanceSettings

Tarefas de várias instâncias geralmente são usadas para dar suporte a Tarefas de MPI. No caso do MPI, se alguma 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á. Em seguida, a Tarefa de várias instâncias é encerrada e repetida, até o limite de repetição.

Nome Tipo Description
commonResourceFiles

ResourceFile[]

Uma lista de arquivos que o serviço Batch baixará antes de executar a linha de comando de coordenação. A diferença entre arquivos de recursos comuns e arquivos de recursos de Tarefa é que arquivos de recursos comuns são baixados para todas as subtarefas, incluindo a primária, enquanto arquivos de recursos de Tarefa são baixados apenas para a primária. Também note que esses arquivos de recursos não são baixados 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 recurso. 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 deverá ser reduzida em tamanho. Isso pode ser feito usando arquivos .zip, pacotes de aplicativos ou contêineres do Docker.

coordinationCommandLine

string

A linha de comando para rodar em todos os Nós de Computação para permitir que eles coordenem quando o principal executa o comando principal de Tarefa. Uma linha de comando típica de coordenação inicia 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 omitido, o padrão é 1.

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

Em cada upload de arquivo, o serviço lote 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.

Nome Tipo Description
destination

OutputFileDestination

O destino para o(s) arquivo(s) de saída.

filePattern

string

Um padrão indicando qual(s) arquivo(s) enviar. Tanto caminhos relativos quanto absolutos são suportados. Caminhos relativos são relativos ao diretório de trabalho Tarefa. Os seguintes coringas são suportados: * 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 caractere, [ABC] corresponde a um caractere entre parênteses, e [A-C] corresponde a um caractere na faixa. Os parênteses podem incluir uma negação para corresponder a qualquer caractere não especificado (por exemplo, [!abc] corresponde a qualquer caractere que não seja a, b ou c). Se um nome de arquivo começar com "." ele é ignorado por padrão, mas pode ser correspondido especificando explicitamente (por exemplo ,.gif não corresponderá .a.gif, mas.gif vai). Um exemplo simples: ***.txt corresponde a qualquer arquivo que não comece em '.' e termine com .txt no diretório de trabalho Task ou em qualquer subdiretório. Se o nome do arquivo contiver um caractere coringa, ele pode ser escapado usando colchetes (por exemplo, abc[] corresponderia a um arquivo chamado abc). Note que tanto \ quanto / são tratados como separadores de diretórios no Windows, mas apenas / é no Linux. Variáveis de ambiente (%var% no Windows ou $var no Linux) são expandidas antes da aplicação do padrão.

uploadOptions

OutputFileUploadConfig

Opções adicionais para a operação de upload, incluindo sob quais condições realizar 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 (uri)

A URL do contêiner dentro do Azure Blob Storage para o qual enviar o(s) arquivo(s). Se não estiver usando uma identidade gerenciada, a URL deve incluir uma Assinatura de Acesso Compartilhada (SAS) concedendo permissões de escrita ao contêiner.

identityReference

BatchNodeIdentityReference

A referência à identidade atribuída pelo usuário para usar para acessar o Azure Blob Storage especificada pelo containerUrl. A identidade deve ter acesso de escrita ao contêiner Azure Blob Storage.

path

string

O blob de destino ou diretório virtual dentro do contêiner Azure Storage. Se filePattern se referir a um arquivo específico (ou seja, não contiver curingas), então path é o nome do blob para o qual enviar esse arquivo. Se filePattern contém um ou mais curingas (e, portanto, pode corresponder a vários arquivos), então path é o nome do diretório virtual do blob (que é preencaminhado a cada nome do blob) para o qual é enviado o(s) arquivo(s). Se omitidos, o(s) arquivo(s) são enviados para a raiz do contêiner com um nome de blob correspondente ao nome do arquivo.

uploadHeaders

OutputFileUploadHeader[]

Uma lista de pares nome-valor para cabeçalhos a serem usados no upload de arquivos de saída. Esses cabeçalhos serão especificados ao enviar arquivos para o Azure Storage. Documento oficial sobre cabeçalhos permitidos ao enviar blobs: https://v4.hkg1.meaqua.org/rest/api/storageservices/put-blob#request-headers-all-blob-types.

OutputFileDestination

O destino para o qual um arquivo deve ser carregado.

Nome Tipo Description
container

OutputFileBlobContainerDestination

Um local no armazenamento de blob do Azure para onde os arquivos são enviados.

OutputFileUploadCondition

Enums OutputFileUploadCondition

Valor Description
tasksuccess

Envie o(s) arquivo(s) somente após o processo Tarefa sair com código de saída 0.

taskfailure

Envie o(s) arquivo(s) somente após o processo de Tarefa sair com um código de saída diferente de zero.

taskcompletion

Envie o(s) arquivo(s) após o encerramento do processo Tarefa, não importa qual fosse o código de saída.

OutputFileUploadConfig

Opções para uma operação de upload de arquivo de saída, incluindo sob quais condições executar o upload.

Nome Tipo Description
uploadCondition

OutputFileUploadCondition

As condições sob as quais o arquivo de saída da Tarefa ou conjunto de arquivos deve ser carregado. O padrão é a conclusão de tarefas.

OutputFileUploadHeader

Um par nome-valor de cabeçalho HTTP

Nome Tipo Description
name

string

O nome insensível a maiúsculas minúsculas do cabeçalho a ser usado ao fazer upload dos arquivos de saída.

value

string

O valor do cabeçalho a ser usado ao fazer upload dos arquivos de saída.

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 container de armazenamento está 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 do 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 de modo de permissão de arquivo no formato octal. Essa propriedade se aplica apenas a arquivos sendo baixados para os Nós de Computação do Linux. Ele será ignorado se for especificado para um ResourceFile que será baixado em um Nó de Computação do Windows. Se essa propriedade não for especificada para um Nó de Computação Linux, então um valor padrão de 0770 é aplicado ao arquivo.

filePath

string

A localização no Nó de Computação para onde baixar o(s) arquivo(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 baixar os arquivos. No caso em que o filePath é usado como um diretório, qualquer estrutura de diretório já associada aos dados de entrada será retida na íntegra e acrescentada 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)

A URL do arquivo a ser baixado. 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 de nós de computação. Há três maneiras de obter essa URL para um blob no armazenamento do Azure: incluir uma SAS (Assinatura de Acesso Compartilhado) 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

BatchNodeIdentityReference

A referência à identidade atribuída pelo usuário para usar para acessar o Azure Blob Storage especificada por storageContainerUrl ou httpUrl.

storageContainerUrl

string (uri)

A URL do contêiner de blob no Armazenamento de Blobs do Azure. As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Essa URL deve ser legível e listável 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 para o contêiner para permitir acesso público.

UserIdentity

A definição da identidade do usuário na qual a Tarefa é executada. Especifique a propriedade userName ou autoUser, mas não ambas.

Nome Tipo Description
autoUser

AutoUserSpecification

O usuário 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 usuário sob a qual a Tarefa é executada. As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos.