Nodes - Upload Node Logs

Dienst:: Batch Service

API-Version:: 2025-06-01

Upload Azure Batch Service Log Dateien vom angegebenen Compute Node auf Azure Blob Storage.
Dies dient dazu, Azure Batch-Service-Logdateien automatisiert von Compute Nodes zu sammeln, falls Sie einen Fehler haben und an den Azure-Support eskalieren möchten. Die Azure Batch-Dienstprotokolldateien sollten mit Azure-Unterstützung geteilt werden, um Debuggingprobleme mit dem Batchdienst zu unterstützen.

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

Mit optionalen Parametern:

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

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, für den Sie die Remote Desktop Protocol-Datei erhalten möchten.
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.
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

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

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.

Anforderungstext

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

Name	Erforderlich	Typ	Beschreibung
containerUrl	True	string (uri)	Die URL des Containers innerhalb von Azure Blob Storage, auf die die Batch Service-Logdatei(s) hochgeladen werden können. Wenn eine vom Benutzer zugewiesene verwaltete Identität nicht verwendet wird, muss die URL eine Shared Access Signature (SAS) enthalten, die dem Container Schreibrechte gewährt. Die SAS-Dauer muss genug Zeit lassen, bis der Upload abgeschlossen ist. Die Startzeit für SAS ist optional und sollte nicht angegeben werden.
startTime	True	string (date-time)	Der Beginn des Zeitrahmens, aus dem die Batch-Service-Logdatei hochgeladen werden müssen. Jede Logdatei, die eine Lognachricht in diesem Zeitraum enthält, wird hochgeladen. Das bedeutet, dass die Operation möglicherweise mehr Logs abruft, als angefordert wurden, da die gesamte Logdatei immer hochgeladen wird, aber die Operation sollte nicht weniger Logs abrufen als angefordert wurden.
endTime		string (date-time)	Das Ende des Zeitrahmens, ab dem die Batch-Service-Logdatei hochgeladen werden müssen. Jede Logdatei, die eine Lognachricht in diesem Zeitraum enthält, wird hochgeladen. Das bedeutet, dass die Operation möglicherweise mehr Logs abruft, als angefordert wurden, da die gesamte Logdatei immer hochgeladen wird, aber die Operation sollte nicht weniger Logs abrufen als angefordert wurden. Wenn es weggelassen wird, ist der Standard, alle nach dem StartTime verfügbaren Logs hochzuladen.
identityReference		BatchNodeIdentityReference	Der Verweis auf die vom Benutzer zugewiesene Identität, die zum Zugriff auf Azure Blob Storage verwendet werden soll, spezifiziert durch containerUrl. Die Identität muss Schreibzugriff auf den Azure Blob Storage Container haben.

Antworten

Name	Typ	Beschreibung
200 OK	UploadBatchServiceLogsResult	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

UploadBatchServiceLogsResult

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

Upload BatchService Logs

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 200

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

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.
BatchNodeIdentityReference	Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet.
UploadBatchServiceLogsOptions	Die Uploadparameter der Azure Batch-Dienstprotokolldateien für einen Computeknoten.
UploadBatchServiceLogsResult	Das Ergebnis des Hochladens von Batchdienstprotokolldateien aus einem bestimmten 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.

BatchNodeIdentityReference

Objekt

Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet.

Name	Typ	Beschreibung
resourceId	string (arm-id)	Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität.

UploadBatchServiceLogsOptions

Objekt

Die Uploadparameter der Azure Batch-Dienstprotokolldateien für einen Computeknoten.

Name	Typ	Beschreibung
containerUrl	string (uri)	Die URL des Containers innerhalb von Azure Blob Storage, auf die die Batch Service-Logdatei(s) hochgeladen werden können. Wenn eine vom Benutzer zugewiesene verwaltete Identität nicht verwendet wird, muss die URL eine Shared Access Signature (SAS) enthalten, die dem Container Schreibrechte gewährt. Die SAS-Dauer muss genug Zeit lassen, bis der Upload abgeschlossen ist. Die Startzeit für SAS ist optional und sollte nicht angegeben werden.
endTime	string (date-time)	Das Ende des Zeitrahmens, ab dem die Batch-Service-Logdatei hochgeladen werden müssen. Jede Logdatei, die eine Lognachricht in diesem Zeitraum enthält, wird hochgeladen. Das bedeutet, dass die Operation möglicherweise mehr Logs abruft, als angefordert wurden, da die gesamte Logdatei immer hochgeladen wird, aber die Operation sollte nicht weniger Logs abrufen als angefordert wurden. Wenn es weggelassen wird, ist der Standard, alle nach dem StartTime verfügbaren Logs hochzuladen.
identityReference	BatchNodeIdentityReference	Der Verweis auf die vom Benutzer zugewiesene Identität, die zum Zugriff auf Azure Blob Storage verwendet werden soll, spezifiziert durch containerUrl. Die Identität muss Schreibzugriff auf den Azure Blob Storage Container haben.
startTime	string (date-time)	Der Beginn des Zeitrahmens, aus dem die Batch-Service-Logdatei hochgeladen werden müssen. Jede Logdatei, die eine Lognachricht in diesem Zeitraum enthält, wird hochgeladen. Das bedeutet, dass die Operation möglicherweise mehr Logs abruft, als angefordert wurden, da die gesamte Logdatei immer hochgeladen wird, aber die Operation sollte nicht weniger Logs abrufen als angefordert wurden.

UploadBatchServiceLogsResult

Objekt

Das Ergebnis des Hochladens von Batchdienstprotokolldateien aus einem bestimmten Computeknoten.

Name	Typ	Beschreibung
numberOfFilesUploaded	integer (int32)	Die Anzahl der hochgeladenen Logdateien.
virtualDirectoryName	string	Das virtuelle Verzeichnis innerhalb des Azure Blob Storage-Containers, in das die Batch Service-Logdatei(n) hochgeladen werden. Der virtuelle Verzeichnisname ist Teil des Blob-Namens jeder hochgeladenen Logdatei und wird basierend auf poolId, nodeId und einer eindeutigen Kennung erstellt.

Freigeben über

Nodes - Upload Node Logs

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

OAuth2Auth

Bereiche

Beispiele

Upload BatchService Logs

Beispielanforderung

Beispiel für eine Antwort

Definitionen

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeIdentityReference

UploadBatchServiceLogsOptions

UploadBatchServiceLogsResult