Compartilhar via

File - Get Properties From Task

  • Referência
Service:
Batch Service
API Version:
2023-11-01.18.0

Obtém as propriedades do arquivo task especificado.

HEAD {batchUrl}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2023-11-01.18.0
With optional parameters: 
HEAD {batchUrl}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?timeout={timeout}&api-version=2023-11-01.18.0

Parâmetros de URI

Nome Em Obrigatório Tipo Description
batchUrl
 path True

string

A URL base para todas as solicitações de serviço Lote do Azure.
filePath
 path True

string

O caminho para o arquivo task do qual você deseja obter as propriedades.
jobId
 path True

string

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

string

A ID da Tarefa cujo arquivo você deseja obter as propriedades.
api-version
 query True

string

Versão da API do cliente.
timeout
 query

integer

int32

O tempo máximo que o servidor pode gastar processando a solicitação, em segundos. O padrão é 30 segundos.

Cabeçalho da solicitação

Media Types: "application/json; odata=minimalmetadata"

Nome Obrigatório Tipo Description
client-request-id

string

uuid

A identidade de 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 client-request-id na resposta.
ocp-date

string

date-time-rfc1123

A hora em que a solicitação foi emitida. As bibliotecas de cliente normalmente definem isso como a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente.
If-Modified-Since

string

date-time-rfc1123

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde a hora especificada.
If-Unmodified-Since

string

date-time-rfc1123

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço não tiver sido modificado desde a hora especificada.

Respostas

Nome Tipo Description
200 OK

Uma resposta que contém as propriedades do arquivo.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • ocp-creation-time: string
  • ocp-batch-file-isdirectory: boolean
  • ocp-batch-file-url: string
  • ocp-batch-file-mode: string
  • Content-Type: string
  • Content-Length: integer
Other Status Codes

BatchError

O erro do serviço do Lote.

Segurança

azure_auth

Microsoft Entra fluxo de código de autenticação OAuth 2.0

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Description
user_impersonation Representar sua conta de usuário

Authorization

Type: apiKey
In: header

Exemplos

File get properties from task

Sample Request

HEAD account.region.batch.azure.com/jobs/jobId/tasks/taskId/files/wd\testFile.txt?api-version=2023-11-01.18.0

Sample Response

Status code:
200

Definições

Nome Description
BatchError

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

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

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

BatchError

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

ErrorMessage

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 que contém detalhes adicionais sobre o erro.

BatchErrorDetail

Um item de informações adicionais incluído em uma resposta de erro 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.

ErrorMessage

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

Nome Tipo Description
lang

string

O código de idioma da mensagem de erro
value

string

O texto da mensagem.