Nodes - Upload Node Logs

Layanan:: Batch Service

Versi API:: 2025-06-01

Unggah file log layanan Azure Batch dari Simpul Komputasi yang ditentukan ke Azure Blob Storage.
Ini untuk mengumpulkan file log layanan Azure Batch secara otomatis dari Node Komputasi jika Anda mengalami kesalahan dan ingin meningkatkan ke dukungan Azure. File log layanan Azure Batch harus dibagikan dengan dukungan Azure untuk membantu dalam men-debug masalah dengan layanan Batch.

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

Dengan parameter opsional:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string (uri)	Titik akhir akun batch (misalnya: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	ID Node Komputasi yang ingin Anda dapatkan file Protokol Desktop Jarak Jauh.
poolId	path	True	string	ID Kumpulan yang berisi Simpul Komputasi.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
timeOut	query		integer (int32)	Waktu maksimum yang dapat dihabiskan server untuk memproses permintaan, dalam hitung detik. Defaultnya adalah 30 detik. Jika nilainya lebih besar dari 30, defaultnya akan digunakan sebagai gantinya.".

Header Permintaan

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

Nama	Jenis	Deskripsi
client-request-id	string	Identitas permintaan yang dihasilkan penelepon, dalam bentuk GUID tanpa dekorasi seperti kurung kurawal, misalnya 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Apakah server harus mengembalikan client-request-id dalam respons.
ocp-date	string (date-time-rfc7231)	Waktu permintaan dikeluarkan. Pustaka klien biasanya mengatur ini ke waktu jam sistem saat ini; atur secara eksplisit jika Anda memanggil REST API secara langsung.

Isi Permintaan

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

Nama	Diperlukan	Jenis	Deskripsi
containerUrl	True	string (uri)	URL kontainer dalam Azure Blob Storage tempat mengunggah file log Layanan Batch. Jika identitas terkelola yang ditetapkan pengguna tidak digunakan, URL harus menyertakan Tanda Tangan Akses Bersama (SAS) yang memberikan izin tulis ke kontainer. Durasi SAS harus memberikan waktu yang cukup untuk pengunggahan selesai. Waktu mulai untuk SAS bersifat opsional dan disarankan untuk tidak ditentukan.
startTime	True	string (date-time)	Awal rentang waktu untuk mengunggah file log Layanan Batch. Setiap file log yang berisi pesan log dalam rentang waktu akan diunggah. Ini berarti bahwa operasi mungkin mengambil lebih banyak log daripada yang telah diminta karena seluruh file log selalu diunggah, tetapi operasi tidak boleh mengambil lebih sedikit log daripada yang telah diminta.
endTime		string (date-time)	Akhir rentang waktu untuk mengunggah file log Layanan Batch. Setiap file log yang berisi pesan log dalam rentang waktu akan diunggah. Ini berarti bahwa operasi mungkin mengambil lebih banyak log daripada yang telah diminta karena seluruh file log selalu diunggah, tetapi operasi tidak boleh mengambil lebih sedikit log daripada yang telah diminta. Jika dihilangkan, defaultnya adalah mengunggah semua log yang tersedia setelah startTime.
identityReference		BatchNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna untuk digunakan untuk mengakses Azure Blob Storage yang ditentukan oleh containerUrl. Identitas harus memiliki akses tulis ke kontainer Azure Blob Storage.

Respons

Nama	Jenis	Deskripsi
200 OK	UploadBatchServiceLogsResult	Permintaan telah berhasil. Header ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

200 OK

UploadBatchServiceLogsResult

Permintaan telah berhasil.

Header

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

Other Status Codes

BatchError

Respons kesalahan tak terduga.

Keamanan

OAuth2Auth

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Cakupan

Nama	Deskripsi
https://batch.core.windows.net//.default

Contoh

Upload BatchService Logs

Permintaan sampel

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

Respon sampel

Kode status:: 200

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

Definisi

Nama	Deskripsi
BatchError	Respons kesalahan diterima dari layanan Azure Batch.
BatchErrorDetail	Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.
BatchErrorMessage	Pesan kesalahan diterima dalam respons kesalahan Azure Batch.
BatchNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna yang terkait dengan kumpulan Batch yang akan digunakan simpul komputasi.
UploadBatchServiceLogsOptions	Parameter unggah file log layanan Azure Batch untuk Simpul Komputasi.
UploadBatchServiceLogsResult	Hasil dari mengunggah file log layanan Batch dari Simpul Komputasi tertentu.

BatchError

Objek

Respons kesalahan diterima dari layanan Azure Batch.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
message	BatchErrorMessage	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
values	BatchErrorDetail[]	Kumpulan pasangan kunci-nilai yang berisi detail tambahan tentang kesalahan.

BatchErrorDetail

Objek

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
key	string	Pengidentifikasi yang menentukan arti properti Nilai.
value	string	Informasi tambahan yang disertakan dengan respons kesalahan.

BatchErrorMessage

Objek

Pesan kesalahan diterima dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
lang	string	Kode bahasa pesan kesalahan.
value	string	Teks pesan.

BatchNodeIdentityReference

Objek

Referensi ke identitas yang ditetapkan pengguna yang terkait dengan kumpulan Batch yang akan digunakan simpul komputasi.

Nama	Jenis	Deskripsi
resourceId	string (arm-id)	Id sumber daya ARM dari identitas yang ditetapkan pengguna.

UploadBatchServiceLogsOptions

Objek

Parameter unggah file log layanan Azure Batch untuk Simpul Komputasi.

Nama	Jenis	Deskripsi
containerUrl	string (uri)	URL kontainer dalam Azure Blob Storage tempat mengunggah file log Layanan Batch. Jika identitas terkelola yang ditetapkan pengguna tidak digunakan, URL harus menyertakan Tanda Tangan Akses Bersama (SAS) yang memberikan izin tulis ke kontainer. Durasi SAS harus memberikan waktu yang cukup untuk pengunggahan selesai. Waktu mulai untuk SAS bersifat opsional dan disarankan untuk tidak ditentukan.
endTime	string (date-time)	Akhir rentang waktu untuk mengunggah file log Layanan Batch. Setiap file log yang berisi pesan log dalam rentang waktu akan diunggah. Ini berarti bahwa operasi mungkin mengambil lebih banyak log daripada yang telah diminta karena seluruh file log selalu diunggah, tetapi operasi tidak boleh mengambil lebih sedikit log daripada yang telah diminta. Jika dihilangkan, defaultnya adalah mengunggah semua log yang tersedia setelah startTime.
identityReference	BatchNodeIdentityReference	Referensi ke identitas yang ditetapkan pengguna untuk digunakan untuk mengakses Azure Blob Storage yang ditentukan oleh containerUrl. Identitas harus memiliki akses tulis ke kontainer Azure Blob Storage.
startTime	string (date-time)	Awal rentang waktu untuk mengunggah file log Layanan Batch. Setiap file log yang berisi pesan log dalam rentang waktu akan diunggah. Ini berarti bahwa operasi mungkin mengambil lebih banyak log daripada yang telah diminta karena seluruh file log selalu diunggah, tetapi operasi tidak boleh mengambil lebih sedikit log daripada yang telah diminta.

UploadBatchServiceLogsResult

Objek

Hasil dari mengunggah file log layanan Batch dari Simpul Komputasi tertentu.

Nama	Jenis	Deskripsi
numberOfFilesUploaded	integer (int32)	Jumlah file log yang akan diunggah.
virtualDirectoryName	string	Direktori virtual dalam kontainer Azure Blob Storage tempat file log Layanan Batch akan diunggah. Nama direktori virtual adalah bagian dari nama blob untuk setiap file log yang diunggah, dan dibangun berbasis poolId, nodeId, dan pengidentifikasi unik.