Nodes - List Node Files

Dienst:: Batch Service

API-Version:: 2025-06-01

Listet alle Dateien in Task-Verzeichnissen auf dem angegebenen Compute-Node auf.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string (uri)	Batchkontoendpunkt (z. B. https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	Die ID des Compute-Knotens, dessen Dateien du auflisten möchtest.
poolId	path	True	string	Die ID des Pools, der den Computeknoten enthält.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
$filter	query		string	Eine OData-$filter-Klausel. Weitere Informationen zur Konstruktion dieses Filters finden Sie unter https://v4.hkg1.meaqua.org/rest/api/batchservice/odata-filters-in-batch#list-compute-node-files.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Die maximale Anzahl von Elementen, die in der Antwort zurückgegeben werden sollen. Maximal 1000 Anträge können zurückgeschickt werden.
recursive	query		boolean	Ob man Kinder eines Verzeichnisses auflisten sollte.
timeOut	query		integer (int32)	Die maximale Zeit, die der Server für die Verarbeitung der Anforderung in Sekunden ausgeben kann. Der Standardwert ist 30 Sekunden. Ist der Wert größer als 30, wird stattdessen der Standard verwendet."

Anforderungsheader

Name	Typ	Beschreibung
client-request-id	string	Die vom Aufrufer generierte Anforderungsidentität in Form einer GUID ohne Dekoration wie geschweifte Klammern, z. B. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Gibt an, ob der Server die Clientanforderungs-ID in der Antwort zurückgeben soll.
ocp-date	string (date-time-rfc7231)	Der Zeitpunkt, zu dem die Anforderung ausgestellt wurde. Clientbibliotheken legen dies in der Regel auf die aktuelle Systemuhrzeit fest. legen Sie sie explizit fest, wenn Sie die REST-API direkt aufrufen.

Antworten

Name	Typ	Beschreibung
200 OK	BatchNodeFileListResult	Die Anforderung ist erfolgreich. Header ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

BatchNodeFileListResult

Die Anforderung ist erfolgreich.

Header

ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Unerwartete Fehlerantwort.

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

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

Beispiele

File list from node

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
BatchError	Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.
BatchErrorDetail	Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.
BatchErrorMessage	Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.
BatchNodeFile	Informationen zu einer Datei oder einem Verzeichnis auf einem Computeknoten.
BatchNodeFileListResult	Das Ergebnis der Auflistung der Dateien auf einem Computeknoten oder der Dateien, die einer Aufgabe auf einem Computeknoten zugeordnet sind.
FileProperties	Die Eigenschaften einer Datei auf einem Computeknoten.

BatchError

Objekt

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message	BatchErrorMessage	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
values	BatchErrorDetail[]	Eine Sammlung von Schlüssel-Wert-Paaren, die zusätzliche Details zum Fehler enthalten.

BatchErrorDetail

Objekt

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.

Name	Typ	Beschreibung
key	string	Ein Bezeichner, der die Bedeutung der Value-Eigenschaft angibt.
value	string	Die zusätzlichen Informationen, die in der Fehlerantwort enthalten sind.

BatchErrorMessage

Objekt

Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.

Name	Typ	Beschreibung
lang	string	Der Sprachcode der Fehlermeldung.
value	string	Der Text der Nachricht.

BatchNodeFile

Objekt

Informationen zu einer Datei oder einem Verzeichnis auf einem Computeknoten.

Name	Typ	Beschreibung
isDirectory	boolean	Ob das Objekt ein Verzeichnis darstellt.
name	string	Der Dateipfad.
properties	FileProperties	Die Dateieigenschaften.
url	string (uri)	Die URL der Datei.

BatchNodeFileListResult

Objekt

Das Ergebnis der Auflistung der Dateien auf einem Computeknoten oder der Dateien, die einer Aufgabe auf einem Computeknoten zugeordnet sind.

Name	Typ	Beschreibung
odata.nextLink	string (uri)	Die URL zum Abrufen der nächsten Ergebnisse.
value	BatchNodeFile[]	Die Liste der Akten.

FileProperties

Objekt

Die Eigenschaften einer Datei auf einem Computeknoten.

Name	Typ	Beschreibung
contentLength	string (int64)	Die Länge der Akte.
contentType	string	Der Inhaltstyp der Datei.
creationTime	string (date-time)	Die Dateierstellungszeit. Die Erstellungszeit wird für Dateien auf Linux Compute Nodes nicht zurückgegeben.
fileMode	string	Das Dateimodus-Attribut im oktalen Format. Der Dateimodus wird nur für Dateien auf Linux Compute Nodes zurückgegeben.
lastModified	string (date-time)	Der Zeitpunkt, zu dem die Akte zuletzt geändert wurde.

Freigeben über

Nodes - List Node Files

URI-Parameter

Anforderungsheader

Antworten

Sicherheit

OAuth2Auth

Bereiche

Beispiele

File list from node

Beispielanforderung

Beispiel für eine Antwort

Definitionen

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeFile

BatchNodeFileListResult

FileProperties