Dela via

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

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.