Nodes - List Node Files

Služba:

Batch Service

Verze rozhraní API:

2025-06-01

Uvádí všechny soubory v adresářích úloh na určeném Compute Node.

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/files?api-version=2025-06-01

S volitelnými parametry:

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/files?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&recursive={recursive}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Koncový bod účtu Batch (například: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	ID Compute Node, jehož soubory chcete uvést.
poolId	path	True	string	ID fondu, který obsahuje výpočetní uzel.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
$filter	query		string	Klauzule $filter OData. Pro více informací o konstrukci tohoto filtru viz https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-compute-node-files.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Maximální počet položek, které se mají vrátit v odpovědi. Maximálně 1000 žádostí lze vrátit.
recursive	query		boolean	Zda uvést potomky adresáře.
timeOut	query		integer (int32)	Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota.".

Hlavička požadavku

Name	Vyžadováno	Typ	Description
client-request-id		string	Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Určuje, jestli má server v odpovědi vrátit ID požadavku klienta.
ocp-date		string (date-time-rfc7231)	Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API.

Odpovědi

Name	Typ	Description
200 OK	BatchNodeFileListResult	Požadavek byl úspěšný. Hlavičky ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

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

Příklady

File list from node

Ukázkový požadavek

HTTP

GET {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/files?api-version=2025-06-01&recursive=False

Ukázková odpověď

Stavový kód:

200

{
  "value": [
    {
      "name": "shared",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_2-20140919t215614z/files/shared",
      "isDirectory": true
    },
    {
      "name": "startup\\ProcessEnv.cmd",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_2-20140919t215614z/files/startup/ProcessEnv.cmd",
      "isDirectory": false,
      "properties": {
        "creationTime": "2025-09-19T21:56:17.679195Z",
        "lastModified": "2025-09-19T21:56:17.679195Z",
        "contentLength": "1813",
        "contentType": "application/octet-stream"
      }
    },
    {
      "name": "startup\\stderr.txt",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_2-20140919t215614z/files/startup/stderr.txt",
      "isDirectory": false,
      "properties": {
        "creationTime": "2025-09-19T21:56:17.5590855Z",
        "lastModified": "2025-09-19T21:56:17.5590855Z",
        "contentLength": "0",
        "contentType": "application/octet-stream"
      }
    }
  ]
}

Definice

Name	Description
BatchError	Odpověď na chybu přijatá ze služby Azure Batch
BatchErrorDetail	Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch
BatchErrorMessage	V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.
BatchNodeFile	Informace o souboru nebo adresáři na výpočetním uzlu
BatchNodeFileListResult	Výsledek výpisu souborů na výpočetním uzlu nebo souborů přidružených k úkolu na výpočetním uzlu.
FileProperties	Vlastnosti souboru ve výpočetním uzlu

BatchError

Objekt

Odpověď na chybu přijatá ze služby Azure Batch

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
message	BatchErrorMessage	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
values	BatchErrorDetail[]	Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Objekt

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

Name	Typ	Description
key	string	Identifikátor určující význam vlastnosti Value.
value	string	Další informace zahrnuté v odpovědi na chybu.

BatchErrorMessage

Objekt

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

Name	Typ	Description
lang	string	Jazykový kód chybové zprávy.
value	string	Text zprávy.

BatchNodeFile

Objekt

Informace o souboru nebo adresáři na výpočetním uzlu

Name	Typ	Description
isDirectory	boolean	Zda objekt představuje adresář.
name	string	Cesta k souboru.
properties	FileProperties	Vlastnosti souboru.
url	string (uri)	Adresa URL souboru.

BatchNodeFileListResult

Objekt

Výsledek výpisu souborů na výpočetním uzlu nebo souborů přidružených k úkolu na výpočetním uzlu.

Name	Typ	Description
odata.nextLink	string (uri)	Adresa URL pro získání další sady výsledků.
value	BatchNodeFile[]	Seznam spisů.

FileProperties

Objekt

Vlastnosti souboru ve výpočetním uzlu

Name	Typ	Description
contentLength	string (int64)	Délka souboru.
contentType	string	Typ obsahu souboru.
creationTime	string (date-time)	Čas vytváření souboru. Čas vytvoření se nevrací pro soubory na Linux Compute Nodes.
fileMode	string	Atribut file mode je v oktálovém formátu. Režim souboru se vrací pouze pro soubory na Linux Compute Nodes.
lastModified	string (date-time)	Čas, kdy byl soubor naposledy upraven.