Nodes - Upload Node Logs

Servizio:: Batch Service

Versione API:: 2025-06-01

Carica i file di log del servizio batch Azure dal nodo di calcolo specificato allo Azure Blob Storage.
Questo serve per raccogliere file di log di servizio Azure Batch in modo automatizzato dai Compute Nodes se stai riscontrando un errore e desideri passare al supporto Azure. I file di log del servizio Azure Batch devono essere condivisi con il supporto di Azure per facilitare il debug dei problemi con il servizio Batch.

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

Con parametri facoltativi:

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2025-06-01&timeOut={timeOut}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	Endpoint dell'account Batch (ad esempio: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	L'ID del Nodo di Calcolo per cui vuoi ottenere il file del Protocollo Desktop Remoto.
poolId	path	True	string	ID del pool che contiene il nodo di calcolo.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
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 è superiore a 30, verrà utilizzato il valore predefinito.".

Intestazione della richiesta

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

Nome	Tipo	Descrizione
client-request-id	string	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-rfc7231)	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.

Corpo della richiesta

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

Nome	Necessario	Tipo	Descrizione
containerUrl	True	string (uri)	L'URL del container all'interno di Azure Blob Storage su cui caricare il/i file di log del Batch Service. Se non viene utilizzato un utente con un'identità gestita, l'URL deve includere una Firma di Accesso Condiviso (SAS) che concede permessi di scrittura al container. La durata del SAS deve permettere il tempo necessario per completare il caricamento. L'orario di inizio per SAS è opzionale e si consiglia di non essere specificato.
startTime	True	string (date-time)	L'inizio dell'intervallo temporale da cui caricare il file o i file di log del Batch Service. Qualsiasi file di log contenente un messaggio di log nell'intervallo temporale verrà caricato. Ciò significa che l'operazione potrebbe recuperare più log di quanti ne siano stati richiesti, poiché l'intero file di log viene sempre caricato, ma l'operazione non dovrebbe recuperare meno log di quanti ne siano stati richiesti.
endTime		string (date-time)	La fine dell'intervallo di tempo da cui caricare il file di log del Batch Service. Qualsiasi file di log contenente un messaggio di log nell'intervallo temporale verrà caricato. Ciò significa che l'operazione potrebbe recuperare più log di quanti ne siano stati richiesti, poiché l'intero file di log viene sempre caricato, ma l'operazione non dovrebbe recuperare meno log di quanti ne siano stati richiesti. Se omesso, il predefinito è caricare tutti i log disponibili dopo il startTime.
identityReference		BatchNodeIdentityReference	Il riferimento all'identità assegnata dall'utente da utilizzare per accedere a Azure Blob Storage specificato da containerUrl. L'identità deve avere accesso di scrittura al container Azure Blob Storage.

Risposte

Nome	Tipo	Descrizione
200 OK	UploadBatchServiceLogsResult	La richiesta ha avuto esito positivo. Intestazioni ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

UploadBatchServiceLogsResult

La richiesta ha avuto esito positivo.

Intestazioni

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

Other Status Codes

BatchError

Risposta di errore imprevista.

Sicurezza

OAuth2Auth

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

Ambiti

Nome	Descrizione
https://batch.core.windows.net//.default

Esempio

Upload BatchService Logs

Esempio di richiesta

HTTP

POST {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2025-06-01



{
  "containerUrl": "https://somestorageacct.blob.core.windows.net/batch-compute-node-logs?se=2025-12-09T18%3A51%3A00Z&sp=w&sv=2025-05-31&sr=c&sig",
  "startTime": "2025-11-27T00:00:00Z"
}

Risposta di esempio

Codice di stato:: 200

{
  "virtualDirectoryName": "poolId/tvm-1695681911-1-20161121t182739z/0795539d-82fe-48e3-bbff-2964905b6de0",
  "numberOfFilesUploaded": 8
}

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.
BatchErrorMessage	Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
BatchNodeIdentityReference	Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
UploadBatchServiceLogsOptions	I file di log del servizio Azure Batch caricano i parametri per un nodo di calcolo.
UploadBatchServiceLogsResult	Risultato del caricamento dei file di log del servizio Batch da un nodo di calcolo specifico.

BatchError

Oggetto

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	BatchErrorMessage	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

Oggetto

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.

BatchErrorMessage

Oggetto

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

Nome	Tipo	Descrizione
lang	string	Il codice linguistico del messaggio di errore.
value	string	Testo del messaggio.

BatchNodeIdentityReference

Oggetto

Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.

Nome	Tipo	Descrizione
resourceId	string (arm-id)	ID risorsa ARM dell'identità assegnata dall'utente.

UploadBatchServiceLogsOptions

Oggetto

I file di log del servizio Azure Batch caricano i parametri per un nodo di calcolo.

Nome	Tipo	Descrizione
containerUrl	string (uri)	L'URL del container all'interno di Azure Blob Storage su cui caricare il/i file di log del Batch Service. Se non viene utilizzato un utente con un'identità gestita, l'URL deve includere una Firma di Accesso Condiviso (SAS) che concede permessi di scrittura al container. La durata del SAS deve permettere il tempo necessario per completare il caricamento. L'orario di inizio per SAS è opzionale e si consiglia di non essere specificato.
endTime	string (date-time)	La fine dell'intervallo di tempo da cui caricare il file di log del Batch Service. Qualsiasi file di log contenente un messaggio di log nell'intervallo temporale verrà caricato. Ciò significa che l'operazione potrebbe recuperare più log di quanti ne siano stati richiesti, poiché l'intero file di log viene sempre caricato, ma l'operazione non dovrebbe recuperare meno log di quanti ne siano stati richiesti. Se omesso, il predefinito è caricare tutti i log disponibili dopo il startTime.
identityReference	BatchNodeIdentityReference	Il riferimento all'identità assegnata dall'utente da utilizzare per accedere a Azure Blob Storage specificato da containerUrl. L'identità deve avere accesso di scrittura al container Azure Blob Storage.
startTime	string (date-time)	L'inizio dell'intervallo temporale da cui caricare il file o i file di log del Batch Service. Qualsiasi file di log contenente un messaggio di log nell'intervallo temporale verrà caricato. Ciò significa che l'operazione potrebbe recuperare più log di quanti ne siano stati richiesti, poiché l'intero file di log viene sempre caricato, ma l'operazione non dovrebbe recuperare meno log di quanti ne siano stati richiesti.

UploadBatchServiceLogsResult

Oggetto

Risultato del caricamento dei file di log del servizio Batch da un nodo di calcolo specifico.

Nome	Tipo	Descrizione
numberOfFilesUploaded	integer (int32)	Il numero di file di log che verranno caricati.
virtualDirectoryName	string	La directory virtuale all'interno del contenitore Azure Blob Storage su cui verranno caricati i file di log del Batch Service. Il nome della directory virtuale fa parte del nome del blob per ogni file di log caricato, ed è costruito basandosi su poolId, nodeId e un identificatore unico.

Condividi tramite

Nodes - Upload Node Logs

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

OAuth2Auth

Ambiti

Esempio

Upload BatchService Logs

Esempio di richiesta

Risposta di esempio

Definizioni

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeIdentityReference

UploadBatchServiceLogsOptions

UploadBatchServiceLogsResult