Megosztás a következőn keresztül:

File - List From Task

  • Referencia
Szolgáltatás:
Batch Service
API-verzió:
2024-07-01.20.0

Egy tevékenység könyvtárában lévő fájlokat sorolja fel a számítási csomóponton.

GET {batchUrl}/jobs/{jobId}/tasks/{taskId}/files?api-version=2024-07-01.20.0
Opcionális paraméterekkel: 
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}/files?$filter={$filter}&recursive={recursive}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

URI-paraméterek

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

string

Az Összes Azure Batch-szolgáltatáskérés alap URL-címe.
jobId
 path True

string

A feladatot tartalmazó feladat azonosítója.
taskId
 path True

string

Annak a tevékenységnek az azonosítója, amelynek a fájljait listázni szeretné.
api-version
 query True

string

Ügyfél API-verziója.
$filter
 query

string

OData $filter záradék. A szűrő felépítésével kapcsolatos további információkért lásd: https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-task-files.
maxresults
 query

integer

int32

A válaszban visszaadandó elemek maximális száma. Legfeljebb 1000 fájl adható vissza.
recursive
 query

boolean

A feladatkönyvtár gyermekeinek listázása. Ez a paraméter a szűrőparaméterrel együtt használható adott fájltípusok listázására.
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 a rendszer az alapértelmezett értéket használja.

Kérelem fejléce

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

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

string

uuid

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

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.

Válaszok

Name Típus Description
200 OK

NodeFileListResult

A fájlok listáját tartalmazó válasz.

Fejlécek

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

BatchError

A Batch szolgáltatás hibája.

Biztonság

azure_auth

Microsoft Entra OAuth 2.0 hitelesítési kódfolyamat

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

Hatókörök

Name Description
user_impersonation A felhasználói fiók megszemélyesítése

Authorization

Típus: apiKey
In: header

Példák

File list from task

Mintakérelem

GET account.region.batch.azure.com/jobs/jobId/tasks/taskId/files?recursive=False&api-version=2024-07-01.20.0

Mintaválasz

Állapotkód:
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": "2014-09-19T21:56:17.679195Z",
        "lastModified": "2014-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": "2014-09-19T21:56:17.5590855Z",
        "lastModified": "2014-09-19T21:56:17.5590855Z",
        "contentLength": 0,
        "contentType": "application/octet-stream"
      }
    }
  ]
}

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.
ErrorMessage

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

A számítási csomóponton lévő fájlok tulajdonságai.
NodeFile

Információ a számítási csomóponton található fájlról vagy könyvtárról.
NodeFileListResult

A számítási csomóponton lévő fájlok vagy a számítási csomóponton lévő tevékenységhez társított fájlok listázásának eredménye.

BatchError

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

ErrorMessage

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

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.

ErrorMessage

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

Name Típus Description
lang

string

A hibaüzenet nyelvi kódja
value

string

Az üzenet szövege.

FileProperties

A számítási csomóponton lévő fájlok tulajdonságai.

Name Típus Description
contentLength

integer

A fájl hossza.
contentType

string

A fájl tartalomtípusa.
creationTime

string

A fájllétrehozás ideje.
A rendszer nem adja vissza a létrehozási időt a Linux számítási csomópontokon lévő fájlokhoz.
fileMode

string

A fájlmód attribútum oktális formátumban.
A fájlmód csak Linux számítási csomópontokon lévő fájlok esetén lesz visszaadva.
lastModified

string

A fájl utolsó módosításának időpontja.

NodeFile

Információ a számítási csomóponton található fájlról vagy könyvtárról.

Name Típus Description
isDirectory

boolean

Azt jelzi, hogy az objektum egy könyvtárat jelöl-e.
name

string

A fájl elérési útja.
properties

FileProperties

A fájl tulajdonságai.
url

string

A fájl URL-címe.

NodeFileListResult

A számítási csomóponton lévő fájlok vagy a számítási csomóponton lévő tevékenységhez társított fájlok listázásának eredménye.

Name Típus Description
odata.nextLink

string

A következő találatkészlet lekéréséhez tartozó URL-cím.
value

NodeFile[]

A fájlok listája.