Condividi tramite

File - List From Compute Node

  • Riferimento
Servizio:
Batch Service
Versione API:
2024-07-01.20.0

Elenca tutti i file nelle directory attività nel nodo di calcolo specificato.

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/files?api-version=2024-07-01.20.0
Con parametri facoltativi: 
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/files?$filter={$filter}&recursive={recursive}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

Parametri dell'URI

Nome In Necessario Tipo Descrizione
batchUrl
 path True

string

URL di base per tutte le richieste del servizio Azure Batch.
nodeId
 path True

string

ID del nodo di calcolo di cui si desidera elencare i file.
poolId
 path True

string

ID del pool che contiene il nodo di calcolo.
api-version
 query True

string

Versione dell'API client.
$filter
 query

string

Clausola di $filter OData. Per altre informazioni sulla creazione di questo filtro, vedere https://docs.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-compute-node-files.
maxresults
 query

integer

int32

Numero massimo di elementi da restituire nella risposta. È possibile restituire un massimo di 1000 file.
recursive
 query

boolean

Indica se elencare gli elementi figlio di una directory.
timeout
 query

integer

int32

Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è maggiore di 30, verrà usato il valore predefinito.

Intestazione della richiesta

Media Types: "application/json; odata=minimalmetadata"

Nome Necessario Tipo Descrizione
client-request-id

string

uuid

Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Indica se il server deve restituire l'ID richiesta client nella risposta.
ocp-date

string

date-time-rfc1123

Ora di emissione della richiesta. Le librerie client in genere impostano questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST.

Risposte

Nome Tipo Descrizione
200 OK

NodeFileListResult

Risposta contenente l'elenco di file.

Intestazioni

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

BatchError

Errore del servizio Batch.

Sicurezza

azure_auth

Flusso del codice di autenticazione di Microsoft Entra OAuth 2.0

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation Rappresentare l'account utente

Authorization

Tipo: apiKey
In: header

Esempio

File list from node

Esempio di richiesta

GET account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/files?recursive=False&api-version=2024-07-01.20.0

Risposta di esempio

Codice di stato:
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": "2014-09-19T21:56:17.679195Z",
        "lastModified": "2014-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": "2014-09-19T21:56:17.5590855Z",
        "lastModified": "2014-09-19T21:56:17.5590855Z",
        "contentLength": 0,
        "contentType": "application/octet-stream"
      }
    }
  ]
}

Definizioni

Nome Descrizione
BatchError

Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.
ErrorMessage

Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
FileProperties

Proprietà di un file in un nodo di calcolo.
NodeFile

Informazioni su un file o una directory in un nodo di calcolo.
NodeFileListResult

Risultato dell'elenco dei file in un nodo di calcolo o dei file associati a un'attività in un nodo di calcolo.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message

ErrorMessage

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
values

BatchErrorDetail[]

Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.

Nome Tipo Descrizione
key

string

Identificatore che specifica il significato della proprietà Value.
value

string

Informazioni aggiuntive incluse nella risposta di errore.

ErrorMessage

Messaggio di errore ricevuto in una risposta di errore di Azure Batch.

Nome Tipo Descrizione
lang

string

Codice linguistico del messaggio di errore
value

string

Testo del messaggio.

FileProperties

Proprietà di un file in un nodo di calcolo.

Nome Tipo Descrizione
contentLength

integer

Lunghezza del file.
contentType

string

Tipo di contenuto del file.
creationTime

string

Ora di creazione del file.
L'ora di creazione non viene restituita per i file nei nodi di calcolo Linux.
fileMode

string

Attributo della modalità file in formato ottale.
La modalità file viene restituita solo per i file nei nodi di calcolo Linux.
lastModified

string

Ora dell'ultima modifica del file.

NodeFile

Informazioni su un file o una directory in un nodo di calcolo.

Nome Tipo Descrizione
isDirectory

boolean

Indica se l'oggetto rappresenta una directory.
name

string

Percorso del file.
properties

FileProperties

Proprietà del file.
url

string

URL del file.

NodeFileListResult

Risultato dell'elenco dei file in un nodo di calcolo o dei file associati a un'attività in un nodo di calcolo.

Nome Tipo Descrizione
odata.nextLink

string

URL per ottenere il set di risultati successivo.
value

NodeFile[]

Elenco di file.