Nodes - Upload Node Logs

Služba:: Batch Service

Verze rozhraní API:: 2025-06-01

Nahrajte Azure Batch service log soubory ze specifikovaného Compute Node do Azure Blob Storage.
Slouží k automatizovanému sběru logů služeb Azure Batch z Compute Nodes, pokud narazíte na chybu a chcete to eskalovat na podporu Azure. Soubory protokolu služby Azure Batch by se měly sdílet s podporou Azure, aby pomohly s laděním problémů se službou Batch.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Koncový bod účtu Batch (například: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	ID Compute Node, pro který chcete získat soubor Remote Desktop Protocol.
poolId	path	True	string	ID fondu, který obsahuje výpočetní uzel.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
timeOut	query		integer (int32)	Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota.".

Hlavička požadavku

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

Name	Typ	Description
client-request-id	string	Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Určuje, jestli má server v odpovědi vrátit ID požadavku klienta.
ocp-date	string (date-time-rfc7231)	Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API.

Text požadavku

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

Name	Vyžadováno	Typ	Description
containerUrl	True	string (uri)	URL kontejneru v Azure Blob Storage, do kterého se nahrávají logové soubory Batch Service. Pokud není používána spravovaná identita přiřazená uživatelem, musí URL obsahovat podpis sdíleného přístupu (SAS), který dává oprávnění k zápisu do kontejneru. Doba trvání SAS musí umožnit dostatečný čas na dokončení nahrávání. Čas začátku SAS je volitelný a doporučuje se nespecifikovat.
startTime	True	string (date-time)	Počáteční časové období, od kterého se nahrává log(y) Batch Service. Bude nahrán jakýkoli logovací soubor obsahující logovací zprávu v daném časovém rozmezí. To znamená, že operace může získat více logů, než bylo požadováno, protože celý logovací soubor je vždy nahrán, ale operace by neměla získat méně logů, než bylo požadováno.
endTime		string (date-time)	Konec časového rozmezí, od kterého se nahrává log(y) Batch Service. Bude nahrán jakýkoli logovací soubor obsahující logovací zprávu v daném časovém rozmezí. To znamená, že operace může získat více logů, než bylo požadováno, protože celý logovací soubor je vždy nahrán, ale operace by neměla získat méně logů, než bylo požadováno. Pokud je vynecháno, výchozí je nahrávat všechny dostupné logy po StartTime.
identityReference		BatchNodeIdentityReference	Odkaz na uživatelem přiřazenou identitu pro přístup k Azure Blob Storage specifikuje containerUrl. Identita musí mít přístup k zápisu do kontejneru Azure Blob Storage.

Odpovědi

Name	Typ	Description
200 OK	UploadBatchServiceLogsResult	Požadavek byl úspěšný. Hlavičky ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

UploadBatchServiceLogsResult

Požadavek byl úspěšný.

Hlavičky

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

Other Status Codes

BatchError

Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

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

Příklady

Upload BatchService Logs

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 200

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

Definice

Name	Description
BatchError	Odpověď na chybu přijatá ze služby Azure Batch
BatchErrorDetail	Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch
BatchErrorMessage	V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.
BatchNodeIdentityReference	Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel.
UploadBatchServiceLogsOptions	Soubory protokolu služby Azure Batch nahrají parametry výpočetního uzlu.
UploadBatchServiceLogsResult	Výsledek nahrání souborů protokolu služby Batch z konkrétního výpočetního uzlu.

BatchError

Objekt

Odpověď na chybu přijatá ze služby Azure Batch

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
message	BatchErrorMessage	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
values	BatchErrorDetail[]	Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Objekt

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

Name	Typ	Description
key	string	Identifikátor určující význam vlastnosti Value.
value	string	Další informace zahrnuté v odpovědi na chybu.

BatchErrorMessage

Objekt

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

Name	Typ	Description
lang	string	Jazykový kód chybové zprávy.
value	string	Text zprávy.

BatchNodeIdentityReference

Objekt

Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel.

Name	Typ	Description
resourceId	string (arm-id)	ID prostředku ARM identity přiřazené uživatelem.

UploadBatchServiceLogsOptions

Objekt

Soubory protokolu služby Azure Batch nahrají parametry výpočetního uzlu.

Name	Typ	Description
containerUrl	string (uri)	URL kontejneru v Azure Blob Storage, do kterého se nahrávají logové soubory Batch Service. Pokud není používána spravovaná identita přiřazená uživatelem, musí URL obsahovat podpis sdíleného přístupu (SAS), který dává oprávnění k zápisu do kontejneru. Doba trvání SAS musí umožnit dostatečný čas na dokončení nahrávání. Čas začátku SAS je volitelný a doporučuje se nespecifikovat.
endTime	string (date-time)	Konec časového rozmezí, od kterého se nahrává log(y) Batch Service. Bude nahrán jakýkoli logovací soubor obsahující logovací zprávu v daném časovém rozmezí. To znamená, že operace může získat více logů, než bylo požadováno, protože celý logovací soubor je vždy nahrán, ale operace by neměla získat méně logů, než bylo požadováno. Pokud je vynecháno, výchozí je nahrávat všechny dostupné logy po StartTime.
identityReference	BatchNodeIdentityReference	Odkaz na uživatelem přiřazenou identitu pro přístup k Azure Blob Storage specifikuje containerUrl. Identita musí mít přístup k zápisu do kontejneru Azure Blob Storage.
startTime	string (date-time)	Počáteční časové období, od kterého se nahrává log(y) Batch Service. Bude nahrán jakýkoli logovací soubor obsahující logovací zprávu v daném časovém rozmezí. To znamená, že operace může získat více logů, než bylo požadováno, protože celý logovací soubor je vždy nahrán, ale operace by neměla získat méně logů, než bylo požadováno.

UploadBatchServiceLogsResult

Objekt

Výsledek nahrání souborů protokolu služby Batch z konkrétního výpočetního uzlu.

Name	Typ	Description
numberOfFilesUploaded	integer (int32)	Počet logovacích souborů, které budou nahrany.
virtualDirectoryName	string	Virtuální adresář v kontejneru Azure Blob Storage, do kterého budou nahrány logové soubory Batch Service. Název virtuálního adresáře je součástí názvu blobu pro každý nahraný log soubor a je založen na poolId, nodeId a unikátním identifikátoru.