Compute Node - Upload Batch Service Logs

Riferimento

Service:: Batch Service

API Version:: 2023-11-01.18.0

Caricare Azure Batch file di log del servizio dal nodo di calcolo specificato per Archiviazione BLOB di Azure.
Questo è per raccogliere Azure Batch file di log del servizio in modo automatizzato dai nodi di calcolo se si verifica un errore e si vuole eseguire l'escalation a supporto tecnico di Azure. I file di log del servizio Azure Batch devono essere condivisi con supporto tecnico di Azure per facilitare il debug dei problemi con il servizio Batch.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?timeout={timeout}&api-version=2023-11-01.18.0

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
batchUrl	path	True	string	URL di base per tutte le richieste di servizio Azure Batch.
nodeId	path	True	string	ID del nodo di calcolo da cui si desidera caricare i file di log del servizio Azure Batch.
poolId	path	True	string	ID del pool che contiene il nodo di calcolo.
api-version	query	True	string	Versione dell'API client.
timeout	query		integer int32	Tempo massimo per cui il server può dedicare l'elaborazione della richiesta, in secondi. Il valore predefinito è 30 secondi.

Intestazione della richiesta

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

Nome	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 impostano in genere 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	URL del contenitore all'interno di Archiviazione BLOB di Azure in cui caricare i file di log del servizio Batch. Se non viene usata un'identità gestita assegnata dall'utente, l'URL deve includere una firma di accesso condiviso che concede le autorizzazioni di scrittura al contenitore. La durata della firma di accesso condiviso deve consentire un tempo sufficiente per il completamento del caricamento. L'ora di inizio per la firma di accesso condiviso è facoltativa e consigliata per non essere specificata.
startTime	True	string	Inizio dell'intervallo di tempo da cui caricare i file di log del servizio Batch. Tutti i file di log contenenti un messaggio di log nell'intervallo di tempo verranno caricati. Ciò significa che l'operazione potrebbe recuperare più log di quanto richiesto perché l'intero file di log viene sempre caricato, ma l'operazione non deve recuperare meno log di quanto richiesto.
endTime		string	Fine dell'intervallo di tempo da cui caricare i file di log del servizio Batch. Tutti i file di log contenenti un messaggio di log nell'intervallo di tempo verranno caricati. Ciò significa che l'operazione potrebbe recuperare più log di quanto richiesto perché l'intero file di log viene sempre caricato, ma l'operazione non deve recuperare meno log di quanto richiesto. Se omesso, l'impostazione predefinita consiste nel caricare tutti i log disponibili dopo startTime.
identityReference		ComputeNodeIdentityReference	Riferimento all'identità assegnata dall'utente da usare per accedere ai Archiviazione BLOB di Azure specificati da containerUrl. L'identità deve avere accesso in scrittura al contenitore Archiviazione BLOB di Azure.

Risposte

Nome	Tipo	Descrizione
200 OK	UploadBatchServiceLogsResult	La richiesta al servizio Batch ha avuto esito positivo. Headers client-request-id: string request-id: string
Other Status Codes	BatchError	Errore del servizio Batch.

Nome

Tipo

Descrizione

200 OK

UploadBatchServiceLogsResult

La richiesta al servizio Batch ha avuto esito positivo.

Headers

client-request-id: string
request-id: string

Other Status Codes

BatchError

Errore del servizio Batch.

Sicurezza

azure_auth

Microsoft Entra flusso del codice di autenticazione OAuth 2.0

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	Rappresentare l'account utente

Authorization

Type: apiKey
In: header

Esempio

Upload BatchService Logs

Sample Request

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2023-11-01.18.0



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

Sample Response

Status code:: 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 Azure Batch.
ComputeNodeIdentityReference	Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
ErrorMessage	Messaggio di errore ricevuto in una risposta di errore Azure Batch.
UploadBatchServiceLogsConfiguration	La configurazione di caricamento dei file di log del servizio Azure Batch per un nodo di calcolo.
UploadBatchServiceLogsResult	Risultato del caricamento dei file di log del servizio Batch da un nodo di calcolo specifico.

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, che deve 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 Azure Batch.

Nome	Tipo	Descrizione
key	string	Identificatore che specifica il significato della proprietà Value.
value	string	Informazioni aggiuntive incluse nella risposta di errore.

ComputeNodeIdentityReference

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	ID risorsa ARM dell'identità assegnata dall'utente.

ErrorMessage

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

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

UploadBatchServiceLogsConfiguration

La configurazione di caricamento dei file di log del servizio Azure Batch per un nodo di calcolo.

Nome	Tipo	Descrizione
containerUrl	string	URL del contenitore all'interno di Archiviazione BLOB di Azure in cui caricare i file di log del servizio Batch. Se non viene usata un'identità gestita assegnata dall'utente, l'URL deve includere una firma di accesso condiviso che concede le autorizzazioni di scrittura al contenitore. La durata della firma di accesso condiviso deve consentire un tempo sufficiente per il completamento del caricamento. L'ora di inizio per la firma di accesso condiviso è facoltativa e consigliata per non essere specificata.
endTime	string	Fine dell'intervallo di tempo da cui caricare i file di log del servizio Batch. Tutti i file di log contenenti un messaggio di log nell'intervallo di tempo verranno caricati. Ciò significa che l'operazione potrebbe recuperare più log di quanto richiesto perché l'intero file di log viene sempre caricato, ma l'operazione non deve recuperare meno log di quanto richiesto. Se omesso, l'impostazione predefinita consiste nel caricare tutti i log disponibili dopo startTime.
identityReference	ComputeNodeIdentityReference	Riferimento all'identità assegnata dall'utente da usare per accedere ai Archiviazione BLOB di Azure specificati da containerUrl. L'identità deve avere accesso in scrittura al contenitore Archiviazione BLOB di Azure.
startTime	string	Inizio dell'intervallo di tempo da cui caricare i file di log del servizio Batch. Tutti i file di log contenenti un messaggio di log nell'intervallo di tempo verranno caricati. Ciò significa che l'operazione potrebbe recuperare più log di quanto richiesto perché l'intero file di log viene sempre caricato, ma l'operazione non deve recuperare meno log di quanto richiesto.

UploadBatchServiceLogsResult

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

Nome	Tipo	Descrizione
numberOfFilesUploaded	integer	Numero di file di log che verranno caricati.
virtualDirectoryName	string	Directory virtuale all'interno di Archiviazione BLOB di Azure contenitore in cui verranno caricati i file di log del servizio Batch. Il nome della directory virtuale fa parte del nome del BLOB per ogni file di log caricato e viene compilato poolId, nodeId e un identificatore univoco.

Share via

Compute Node - Upload Batch Service Logs

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Scopes

Authorization

Esempio

Upload BatchService Logs

Sample Request

Sample Response

Definizioni

BatchError

BatchErrorDetail

ComputeNodeIdentityReference

ErrorMessage

UploadBatchServiceLogsConfiguration

UploadBatchServiceLogsResult

Risorse aggiuntive