Delen via

Nodes - List Node Files

Service:
Batch Service
API-versie:
2025-06-01

Geeft alle bestanden een lijst in Taakmappen op de opgegeven Compute Node.

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

URI-parameters

Name In Vereist Type Description
endpoint
 path True

string (uri)

Batch-accounteindpunt (bijvoorbeeld: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

De ID van de Compute Node waarvan je de bestanden wilt vermelden.
poolId
 path True

string

De id van de pool die het rekenknooppunt bevat.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.
$filter
 query

string

Een OData-$filter-component. Voor meer informatie over het construeren van dit filter, zie https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-compute-node-files.
maxresults
 query

integer (int32)

minimum: 1
maximum: 1000

Het maximum aantal items dat moet worden geretourneerd in het antwoord. Maximaal 1000 aanvragen kunnen worden teruggestuurd.
recursive
 query

boolean

Of je kinderen van een directory moet vermelden.
timeOut
 query

integer (int32)

De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden. Als de waarde groter is dan 30, wordt de standaard in plaats daarvan gebruikt."

Aanvraagkoptekst

Name Vereist Type Description
client-request-id

string

De door de aanroeper gegenereerde aanvraagidentiteit, in de vorm van een GUID zonder decoratie, zoals accolades, bijvoorbeeld 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Of de server de clientaanvraag-id in het antwoord moet retourneren.
ocp-date

string (date-time-rfc7231)

Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige kloktijd van het systeem; stel deze expliciet in als u de REST API rechtstreeks aanroept.

Antwoorden

Name Type Description
200 OK

BatchNodeFileListResult

De aanvraag is voltooid.

Kopteksten

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

BatchError

Een onverwachte foutreactie.

Beveiliging

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiken

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

Voorbeelden

File list from node

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
BatchError

Er is een foutbericht ontvangen van de Azure Batch-service.
BatchErrorDetail

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
BatchErrorMessage

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.
BatchNodeFile

Informatie over een bestand of map op een rekenknooppunt.
BatchNodeFileListResult

Het resultaat van het weergeven van de bestanden op een rekenknooppunt of de bestanden die zijn gekoppeld aan een taak op een rekenknooppunt.
FileProperties

De eigenschappen van een bestand op een rekenknooppunt.

BatchError

Object

Er is een foutbericht ontvangen van de Azure Batch-service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
message

BatchErrorMessage

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
values

BatchErrorDetail[]

Een verzameling sleutel-waardeparen met aanvullende informatie over de fout.

BatchErrorDetail

Object

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.

Name Type Description
key

string

Een id die de betekenis van de eigenschap Waarde aangeeft.
value

string

De aanvullende informatie die is opgenomen in het foutbericht.

BatchErrorMessage

Object

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.

Name Type Description
lang

string

De taalcode van het foutbericht.
value

string

De tekst van het bericht.

BatchNodeFile

Object

Informatie over een bestand of map op een rekenknooppunt.

Name Type Description
isDirectory

boolean

Of het object een directory vertegenwoordigt.
name

string

Het bestandspad.
properties

FileProperties

De eigenschappen van het bestand.
url

string (uri)

De URL van het bestand.

BatchNodeFileListResult

Object

Het resultaat van het weergeven van de bestanden op een rekenknooppunt of de bestanden die zijn gekoppeld aan een taak op een rekenknooppunt.

Name Type Description
odata.nextLink

string (uri)

De URL om de volgende reeks resultaten te krijgen.
value

BatchNodeFile[]

De lijst met dossiers.

FileProperties

Object

De eigenschappen van een bestand op een rekenknooppunt.

Name Type Description
contentLength

string (int64)

De lengte van het dossier.
contentType

string

Het inhoudstype van het bestand.
creationTime

string (date-time)

De tijd voor het aanmaken van bestanden. De aanmaaktijd wordt niet teruggegeven voor bestanden op Linux Compute Nodes.
fileMode

string

Het bestandsmodus-attribuut in octaal formaat. De bestandsmodus wordt alleen teruggegeven voor bestanden op Linux Compute Nodes.
lastModified

string (date-time)

Het tijdstip waarop het bestand voor het laatst werd aangepast.