Partilhar via

Tasks - List Task Files

Serviço:
Batch Service
Versão da API:
2025-06-01

Lista os ficheiros no diretório de uma Tarefa no seu Nó de Computação.

GET {endpoint}/jobs/{jobId}/tasks/{taskId}/files?api-version=2025-06-01
Com parâmetros opcionais: 
GET {endpoint}/jobs/{jobId}/tasks/{taskId}/files?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&recursive={recursive}

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).
jobId
 path True

string

O ID do Trabalho que contém a Tarefa.
taskId
 path True

string

O ID da tarefa cujos ficheiros queres listar.
api-version
 query True

string

minLength: 1

A versão da API a utilizar para esta operação.
$filter
 query

string

Uma cláusula $filter OData. Para mais informações sobre como construir este filtro, veja https://v4.hkg1.meaqua.org/rest/api/batchservice/odata-filters-in-batch#list-task-files.
maxresults
 query

integer (int32)

minimum: 1
maximum: 1000

O número máximo de itens a serem retornados na resposta. Podem ser devolvidos um máximo de 1000 candidaturas.
recursive
 query

boolean

Se deve listar os filhos do diretório Tarefas. Este parâmetro pode ser usado em combinação com o parâmetro de filtro para listar tipos específicos de ficheiros.
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 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.

Respostas

Name Tipo Description
200 OK

BatchNodeFileListResult

O pedido foi bem-sucedido.

Cabeçalhos

  • 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
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

File list from task

Pedido de amostra

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

Resposta da amostra

Código de estado:
200 
{
  "value": [
    {
      "name": "startup\\ProcessEnv.cmd",
      "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId/files/startup/ProcessEnv.cmd",
      "isDirectory": false,
      "properties": {
        "creationTime": "2025-09-19T21:56:17.679195Z",
        "lastModified": "2025-09-19T21:56:17.679195Z",
        "contentLength": "1813",
        "contentType": "application/octet-stream"
      }
    },
    {
      "name": "startup\\stderr.txt",
      "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId/files/startup/stderr.txt",
      "isDirectory": false,
      "properties": {
        "creationTime": "2025-09-19T21:56:17.5590855Z",
        "lastModified": "2025-09-19T21:56:17.5590855Z",
        "contentLength": "0",
        "contentType": "application/octet-stream"
      }
    }
  ]
}

Definições

Name Description
BatchError

Uma resposta de erro recebida do serviço Batch 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.
BatchNodeFile

Informações sobre um arquivo ou diretório em um nó de computação.
BatchNodeFileListResult

O resultado da listagem dos arquivos em um nó de computação ou os arquivos associados a uma tarefa em um nó de computação.
FileProperties

As propriedades de um arquivo em um nó de computação.

BatchError

Object

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

BatchErrorMessage

Uma mensagem descrevendo 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

Object

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

Object

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.

BatchNodeFile

Object

Informações sobre um arquivo ou diretório em um nó de computação.

Name Tipo Description
isDirectory

boolean

Se o objeto representa um diretório.
name

string

O caminho do arquivo.
properties

FileProperties

As propriedades do ficheiro.
url

string (uri)

O URL do ficheiro.

BatchNodeFileListResult

Object

O resultado da listagem dos arquivos em um nó de computação ou os arquivos associados a uma tarefa em um nó de computação.

Name Tipo Description
odata.nextLink

string (uri)

O URL para obter o próximo conjunto de resultados.
value

BatchNodeFile[]

A lista de ficheiros.

FileProperties

Object

As propriedades de um arquivo em um nó de computação.

Name Tipo Description
contentLength

string (int64)

O comprimento do ficheiro.
contentType

string

O tipo de conteúdo do arquivo.
creationTime

string (date-time)

O tempo de criação do ficheiro. O tempo de criação não é devolvido para ficheiros nos Nós de Computação Linux.
fileMode

string

O atributo do modo de ficheiro em formato octal. O modo de ficheiro é devolvido apenas para ficheiros em Nós de Computação Linux.
lastModified

string (date-time)

A data em que o ficheiro foi modificado pela última vez.