Partager via

Tasks - Get Task File

Service:
Batch Service
Version d'API:
2025-06-01

Retourne le contenu du fichier Task spécifié.

GET {endpoint}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2025-06-01
Avec des paramètres facultatifs: 
GET {endpoint}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2025-06-01&timeOut={timeOut}

Paramètres URI

Nom Dans Obligatoire Type Description
endpoint
 path True

string (uri)

Point de terminaison de compte Batch (par exemple : https://batchaccount.eastus2.batch.azure.com).
filePath
 path True

string

Le chemin vers le fichier Task dont vous souhaitez obtenir le contenu.
jobId
 path True

string

L’ID du Job qui contient la Tâche.
taskId
 path True

string

L’ID de la tâche dont vous souhaitez récupérer le fichier.
api-version
 query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.
timeOut
 query

integer (int32)

Durée maximale pendant laquelle le serveur peut passer le traitement de la requête, en secondes. La valeur par défaut est de 30 secondes. Si la valeur est supérieure à 30, le par défaut sera utilisé à la place. »

En-tête de la demande

Nom Obligatoire Type Description
client-request-id

string

L’identité de requête générée par l’appelant, sous la forme d’un GUID sans décoration telle que les accolades, par exemple 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Indique si le serveur doit retourner l’ID client-request-id dans la réponse.
ocp-date

string (date-time-rfc7231)

Heure à laquelle la demande a été émise. Les bibliothèques clientes définissent généralement cette valeur sur l’heure de l’horloge système actuelle ; définissez-le explicitement si vous appelez directement l’API REST.
If-Modified-Since

string (date-time-rfc7231)

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.
If-Unmodified-Since

string (date-time-rfc7231)

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service n’a pas été modifiée depuis l’heure spécifiée.
ocp-range

string

La plage d’octets à récupérer. Par défaut, il faut récupérer tout le fichier. Le format est bytes=startRange-endRange.

Réponses

Nom Type Description
200 OK

file

La demande a réussi.

Media Types: "application/octet-stream", "application/json"

En-têtes

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

BatchError

Réponse d’erreur inattendue.

Media Types: "application/octet-stream", "application/json"

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Étendues

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

Exemples

Get File From Task

Exemple de requête

GET {endpoint}/jobs/jobId/tasks/task1/files/wd\testFile.txt?api-version=2025-06-01

Exemple de réponse

Code d’état:
200 
"This is actually a byte stream. This request/response is being presented as a string for readability in the example"

Définitions

Nom Description
BatchError

Réponse d’erreur reçue du service Azure Batch.
BatchErrorDetail

Élément d’informations supplémentaires inclus dans une réponse d’erreur Azure Batch.
BatchErrorMessage

Message d’erreur reçu dans une réponse d’erreur Azure Batch.

BatchError

Objet

Réponse d’erreur reçue du service Azure Batch.

Nom Type Description
code

string

Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
message

BatchErrorMessage

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
values

BatchErrorDetail[]

Collection de paires clé-valeur contenant des détails supplémentaires sur l’erreur.

BatchErrorDetail

Objet

Élément d’informations supplémentaires inclus dans une réponse d’erreur Azure Batch.

Nom Type Description
key

string

Identificateur spécifiant la signification de la propriété Value.
value

string

Informations supplémentaires incluses dans la réponse d’erreur.

BatchErrorMessage

Objet

Message d’erreur reçu dans une réponse d’erreur Azure Batch.

Nom Type Description
lang

string

Le code de langue du message d’erreur.
value

string

Le texte du message.