Nodes - List Node Files

Tjänst:

Batch Service

API-version:

2025-06-01

Listar alla filer i Uppgiftskataloger på den angivna Compute Node.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string (uri)	Batch-kontoslutpunkt (till exempel: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	ID:t för den Compute-nod vars filer du vill lista.
poolId	path	True	string	ID:t för poolen som innehåller beräkningsnoden.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.
$filter	query		string	En OData-$filter-sats. För mer information om hur man konstruerar detta filter, se https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-compute-node-files.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Det maximala antalet objekt som ska returneras i svaret. Maximalt 1000 ansökningar kan returneras.
recursive	query		boolean	Om man ska lista barn till en katalog.
timeOut	query		integer (int32)	Den maximala tid som servern kan ägna åt att bearbeta begäran i sekunder. Standardvärdet är 30 sekunder. Om värdet är större än 30 används standardvärdet istället."

Begärandehuvud

Name	Obligatorisk	Typ	Description
client-request-id		string	Den anropargenererade begärandeidentiteten i form av ett GUID utan dekoration, till exempel klammerparenteser, t.ex. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Om servern ska returnera klient-request-id i svaret.
ocp-date		string (date-time-rfc7231)	Den tid då begäran utfärdades. Klientbibliotek anger vanligtvis detta till den aktuella systemklockatiden. ange det explicit om du anropar REST-API:et direkt.

Svar

Name	Typ	Description
200 OK	BatchNodeFileListResult	Begäran har slutförts. Sidhuvuden ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Ett oväntat felsvar.

Säkerhet

OAuth2Auth

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Omfattningar

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

Exempel

File list from node

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:

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"
      }
    }
  ]
}

Definitioner

Name	Description
BatchError	Ett felsvar som tagits emot från Azure Batch-tjänsten.
BatchErrorDetail	Ett objekt med ytterligare information som ingår i ett Azure Batch-felsvar.
BatchErrorMessage	Ett felmeddelande som togs emot i ett Azure Batch-felsvar.
BatchNodeFile	Information om en fil eller katalog på en beräkningsnod.
BatchNodeFileListResult	Resultatet av att visa filerna på en beräkningsnod eller de filer som är associerade med en aktivitet på en beräkningsnod.
FileProperties	Egenskaperna för en fil på en beräkningsnod.

BatchError

Objekt

Ett felsvar som tagits emot från Azure Batch-tjänsten.

Name	Typ	Description
code	string	En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.
message	BatchErrorMessage	Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.
values	BatchErrorDetail[]	En samling nyckel/värde-par som innehåller ytterligare information om felet.

BatchErrorDetail

Objekt

Ett objekt med ytterligare information som ingår i ett Azure Batch-felsvar.

Name	Typ	Description
key	string	En identifierare som anger innebörden av egenskapen Value.
value	string	Den ytterligare information som ingår i felsvaret.

BatchErrorMessage

Objekt

Ett felmeddelande som togs emot i ett Azure Batch-felsvar.

Name	Typ	Description
lang	string	Felmeddelandets språkkod.
value	string	Texten i meddelandet.

BatchNodeFile

Objekt

Information om en fil eller katalog på en beräkningsnod.

Name	Typ	Description
isDirectory	boolean	Om objektet representerar en katalog.
name	string	Filsökvägen.
properties	FileProperties	Filens egenskaper.
url	string (uri)	URL:en för filen.

BatchNodeFileListResult

Objekt

Resultatet av att visa filerna på en beräkningsnod eller de filer som är associerade med en aktivitet på en beräkningsnod.

Name	Typ	Description
odata.nextLink	string (uri)	URL:en för att få nästa uppsättning resultat.
value	BatchNodeFile[]	Listan över filer.

FileProperties

Objekt

Egenskaperna för en fil på en beräkningsnod.

Name	Typ	Description
contentLength	string (int64)	Längden på filen.
contentType	string	Filens innehållstyp.
creationTime	string (date-time)	Tiden för filskapande. Skapandetiden returneras inte för filer på Linux Compute Nodes.
fileMode	string	Fillägesattributet i oktalt format. Filläget returneras endast för filer på Linux Compute Nodes.
lastModified	string (date-time)	Tidpunkten då filen senast ändrades.