Udostępnij przez

Nodes - Upload Node Logs

Usługa:
Batch Service
Wersja interfejsu API:
2025-06-01

Upload Azure Batch service log files z określonego Compute Node do Azure Blob Storage.
Służy to do automatycznego zbierania plików logów usług Azure Batch z węzłów obliczeniowych, jeśli napotkasz błąd i chcesz eskalować do wsparcia Azure. Pliki dziennika usługi Azure Batch powinny być udostępniane pomocy technicznej platformy Azure, aby ułatwić debugowanie problemów z usługą Batch.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
endpoint
 path True

string (uri)

Punkt końcowy konta usługi Batch (na przykład: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

ID węzła obliczeniowego, dla którego chcesz pobrać plik protokołu Remote Desktop.
poolId
 path True

string

Identyfikator puli zawierającej węzeł obliczeniowy.
api-version
 query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.
timeOut
 query

integer (int32)

Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund. Jeśli wartość jest większa niż 30, zostanie użyta domyślna wersja domyślna.".

Nagłówek żądania

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

Nazwa Wymagane Typ Opis
client-request-id

string

Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takiej jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Czy serwer powinien zwrócić identyfikator żądania klienta w odpowiedzi.
ocp-date

string (date-time-rfc7231)

Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Treść żądania

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

Nazwa Wymagane Typ Opis
containerUrl True

string (uri)

URL kontenera w Azure Blob Storage, do którego należy przesłać plik(y) loga serwisu wsadowego. Jeśli nie jest używana zarządzana tożsamość przypisana przez użytkownika, adres URL musi zawierać podpis współdzielonego dostępu (SAS) przyznający uprawnienia do zapisu do kontenera. Czas trwania SAS musi umożliwić zakończenie przesyłania. Godzina rozpoczęcia SAS jest opcjonalna i zaleca się nie podawać szczegółów.
startTime True

string (date-time)

Początek czasu to czas przesyłania plików logów usługi wsadowej. Każdy plik loga zawierający wiadomość logową w danym przedziale czasowym zostanie przesłany. Oznacza to, że operacja może pobrać więcej logów niż zostało zażądanych, ponieważ cały plik logu jest zawsze przesyłany, ale nie powinna pobierać mniejszej liczby logów niż zostało zażądanych.
endTime

string (date-time)

Koniec okresu, z którego należy przesyłać plik(y) logu usługi wsadowej. Każdy plik loga zawierający wiadomość logową w danym przedziale czasowym zostanie przesłany. Oznacza to, że operacja może pobrać więcej logów niż zostało zażądanych, ponieważ cały plik logu jest zawsze przesyłany, ale nie powinna pobierać mniejszej liczby logów niż zostało zażądanych. Jeśli to pominie, domyślnie przesyła się wszystkie logi dostępne po StartTime.
identityReference

BatchNodeIdentityReference

Odniesienie do tożsamości przypisanej przez użytkownika do dostępu do Azure Blob Storage określone przez containerUrl. Tożsamość musi mieć dostęp do zapisu do kontenera Azure Blob Storage.

Odpowiedzi

Nazwa Typ Opis
200 OK

UploadBatchServiceLogsResult

Żądanie zakończyło się pomyślnie.

Nagłówki

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

BatchError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwa Opis
https://batch.core.windows.net//.default

Przykłady

Upload BatchService Logs

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
BatchError

Odebrano odpowiedź o błędzie z usługi Azure Batch.
BatchErrorDetail

Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.
BatchErrorMessage

Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.
BatchNodeIdentityReference

Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.
UploadBatchServiceLogsOptions

Pliki dziennika usługi Azure Batch przekazują parametry dla węzła obliczeniowego.
UploadBatchServiceLogsResult

Wynik przekazywania plików dziennika usługi Batch z określonego węzła obliczeniowego.

BatchError

Objekt

Odebrano odpowiedź o błędzie z usługi Azure Batch.

Nazwa Typ Opis
code

string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message

BatchErrorMessage

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
values

BatchErrorDetail[]

Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu.

BatchErrorDetail

Objekt

Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.

Nazwa Typ Opis
key

string

Identyfikator określający znaczenie właściwości Value.
value

string

Dodatkowe informacje zawarte w odpowiedzi na błąd.

BatchErrorMessage

Objekt

Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.

Nazwa Typ Opis
lang

string

Kod językowy komunikatu o błędzie.
value

string

Tekst wiadomości.

BatchNodeIdentityReference

Objekt

Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.

Nazwa Typ Opis
resourceId

string (arm-id)

Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika.

UploadBatchServiceLogsOptions

Objekt

Pliki dziennika usługi Azure Batch przekazują parametry dla węzła obliczeniowego.

Nazwa Typ Opis
containerUrl

string (uri)

URL kontenera w Azure Blob Storage, do którego należy przesłać plik(y) loga serwisu wsadowego. Jeśli nie jest używana zarządzana tożsamość przypisana przez użytkownika, adres URL musi zawierać podpis współdzielonego dostępu (SAS) przyznający uprawnienia do zapisu do kontenera. Czas trwania SAS musi umożliwić zakończenie przesyłania. Godzina rozpoczęcia SAS jest opcjonalna i zaleca się nie podawać szczegółów.
endTime

string (date-time)

Koniec okresu, z którego należy przesyłać plik(y) logu usługi wsadowej. Każdy plik loga zawierający wiadomość logową w danym przedziale czasowym zostanie przesłany. Oznacza to, że operacja może pobrać więcej logów niż zostało zażądanych, ponieważ cały plik logu jest zawsze przesyłany, ale nie powinna pobierać mniejszej liczby logów niż zostało zażądanych. Jeśli to pominie, domyślnie przesyła się wszystkie logi dostępne po StartTime.
identityReference

BatchNodeIdentityReference

Odniesienie do tożsamości przypisanej przez użytkownika do dostępu do Azure Blob Storage określone przez containerUrl. Tożsamość musi mieć dostęp do zapisu do kontenera Azure Blob Storage.
startTime

string (date-time)

Początek czasu to czas przesyłania plików logów usługi wsadowej. Każdy plik loga zawierający wiadomość logową w danym przedziale czasowym zostanie przesłany. Oznacza to, że operacja może pobrać więcej logów niż zostało zażądanych, ponieważ cały plik logu jest zawsze przesyłany, ale nie powinna pobierać mniejszej liczby logów niż zostało zażądanych.

UploadBatchServiceLogsResult

Objekt

Wynik przekazywania plików dziennika usługi Batch z określonego węzła obliczeniowego.

Nazwa Typ Opis
numberOfFilesUploaded

integer (int32)

Liczba plików logów, które zostaną przesłane.
virtualDirectoryName

string

Wirtualny katalog w kontenerze Azure Blob Storage, do którego zostaną przesłane pliki loga usługi wsadowej. Nazwa katalogu wirtualnego jest częścią nazwy blobu dla każdego przesyłanego pliku loga i jest zbudowana na podstawie poolId, nodeId oraz unikalnego identyfikatora.