Tasks - Get Task File

Szolgáltatás:
Batch Service
API-verzió:
2025-06-01

A megadott feladatfájl tartalmát adja vissza.

GET {endpoint}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2025-06-01
Opcionális paraméterekkel: 
GET {endpoint}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2025-06-01&timeOut={timeOut}

URI-paraméterek

Name In Kötelező Típus Description
endpoint
 path True

string (uri)

Batch-fiók végpontja (például: https://batchaccount.eastus2.batch.azure.com).
filePath
 path True

string

Az út a Feladatfájlhoz, amelynek tartalmát szeretnéd megszerezni.
jobId
 path True

string

Az Feladat azonosítója, amely tartalmazza a feladatot.
taskId
 path True

string

Az a feladat azonosítója, amelynek fájlját szeretnéd visszaszerezni.
api-version
 query True

string

minLength: 1

A művelethez használandó API-verzió.
timeOut
 query

integer (int32)

A kiszolgáló által a kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 másodperc. Ha az érték nagyobb, mint 30, akkor az alapértelmezett értéket használják helyette.".

Kérelem fejléce

Name Kötelező Típus Description
client-request-id

string

A hívó által generált kérési identitás guid formában, díszítés nélkül, például kapcsos zárójelek, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Azt jelzi, hogy a kiszolgálónak vissza kell-e adnia az ügyfél-kérelem azonosítóját a válaszban.
ocp-date

string (date-time-rfc7231)

A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróra-időpontra állítják be; állítsa be explicit módon, ha közvetlenül a REST API-t hívja meg.
If-Modified-Since

string (date-time-rfc7231)

Az ügyfél által ismert erőforrás utolsó módosítási idejét jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás a megadott időpont óta módosult.
If-Unmodified-Since

string (date-time-rfc7231)

Az ügyfél által ismert erőforrás utolsó módosítási idejét jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás a megadott időpont óta nem módosult.
ocp-range

string

A vissza kell kérni a bájttartományt. Az alapértelmezett megoldás az egész fájl lekérése. A formátum: bytes=startRange-endRange.

Válaszok

Name Típus Description
200 OK

file

A kérés sikeres volt.

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

Fejlécek

  • 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

Váratlan hibaválasz.

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

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

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

Példák

Get File From Task

Mintakérelem

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

Mintaválasz

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

Definíciók

Name Description
BatchError

Az Azure Batch szolgáltatástól kapott hibaválasz.
BatchErrorDetail

Az Azure Batch-hibaválaszban szereplő további információk egy eleme.
BatchErrorMessage

Hibaüzenet érkezett egy Azure Batch-hibaválaszban.

BatchError

Tárgy

Az Azure Batch szolgáltatástól kapott hibaválasz.

Name Típus Description
code

string

A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message

BatchErrorMessage

A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
values

BatchErrorDetail[]

Kulcs-érték párok gyűjteménye, amelyek további részleteket tartalmaznak a hibáról.

BatchErrorDetail

Tárgy

Az Azure Batch-hibaválaszban szereplő további információk egy eleme.

Name Típus Description
key

string

Az Érték tulajdonság jelentését meghatározó azonosító.
value

string

A hibaválasz további információi.

BatchErrorMessage

Tárgy

Hibaüzenet érkezett egy Azure Batch-hibaválaszban.

Name Típus Description
lang

string

A hibaüzenet nyelvkódja.
value

string

Az üzenet szövege.