Freigeben über

Tasks - Get Task File

Dienst:
Batch Service
API-Version:
2025-06-01

Gibt den Inhalt der angegebenen Task-Datei zurück.

GET {endpoint}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2025-06-01
Mit optionalen Parametern: 
GET {endpoint}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2025-06-01&timeOut={timeOut}

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpoint
 path True

string (uri)

Batchkontoendpunkt (z. B. https://batchaccount.eastus2.batch.azure.com).
filePath
 path True

string

Der Pfad zur Task-Datei, von der du den Inhalt erhalten möchtest.
jobId
 path True

string

Die ID des Jobs, der die Aufgabe enthält.
taskId
 path True

string

Die ID der Aufgabe, deren Datei Sie abrufen möchten.
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.
timeOut
 query

integer (int32)

Die maximale Zeit, die der Server für die Verarbeitung der Anforderung in Sekunden ausgeben kann. Der Standardwert ist 30 Sekunden. Ist der Wert größer als 30, wird stattdessen der Standard verwendet."

Anforderungsheader

Name Erforderlich Typ Beschreibung
client-request-id

string

Die vom Aufrufer generierte Anforderungsidentität in Form einer GUID ohne Dekoration wie geschweifte Klammern, z. B. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Gibt an, ob der Server die Clientanforderungs-ID in der Antwort zurückgeben soll.
ocp-date

string (date-time-rfc7231)

Der Zeitpunkt, zu dem die Anforderung ausgestellt wurde. Clientbibliotheken legen dies in der Regel auf die aktuelle Systemuhrzeit fest. legen Sie sie explizit fest, wenn Sie die REST-API direkt aufrufen.
If-Modified-Since

string (date-time-rfc7231)

Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
If-Unmodified-Since

string (date-time-rfc7231)

Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
ocp-range

string

Der zu abrufende Bytebereich. Standardmäßig wird die gesamte Datei abgerufen. Das Format lautet bytes=startRange-endRange.

Antworten

Name Typ Beschreibung
200 OK

file

Die Anforderung ist erfolgreich.

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

Header

  • 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

Unerwartete Fehlerantwort.

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

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name Beschreibung
https://batch.core.windows.net//.default

Beispiele

Get File From Task

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200 
"This is actually a byte stream. This request/response is being presented as a string for readability in the example"

Definitionen

Name Beschreibung
BatchError

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.
BatchErrorDetail

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.
BatchErrorMessage

Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.

BatchError

Objekt

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message

BatchErrorMessage

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
values

BatchErrorDetail[]

Eine Sammlung von Schlüssel-Wert-Paaren, die zusätzliche Details zum Fehler enthalten.

BatchErrorDetail

Objekt

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.

Name Typ Beschreibung
key

string

Ein Bezeichner, der die Bedeutung der Value-Eigenschaft angibt.
value

string

Die zusätzlichen Informationen, die in der Fehlerantwort enthalten sind.

BatchErrorMessage

Objekt

Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.

Name Typ Beschreibung
lang

string

Der Sprachcode der Fehlermeldung.
value

string

Der Text der Nachricht.