Compute Node - Upload Batch Service Logs

Referensi

Service:: Batch Service

API Version:: 2022-01-01.15.0

Upload Azure Batch file log layanan dari Simpul Komputasi yang ditentukan ke Azure Blob Storage.
Ini untuk mengumpulkan Azure Batch file log layanan secara otomatis dari Simpul 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 {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2022-01-01.15.0

With optional parameters:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?timeout={timeout}&api-version=2022-01-01.15.0

Parameter URI

Name	In	Required	Type	Description
batchUrl	path	True	string	URL dasar untuk semua permintaan layanan Azure Batch.
nodeId	path	True	string	ID Simpul Komputasi tempat Anda ingin mengunggah file log layanan Azure Batch.
poolId	path	True	string	ID Kumpulan yang berisi Simpul Komputasi.
api-version	query	True	string	Versi API Klien.
timeout	query		integer int32	Waktu maksimum yang dapat dihabiskan server untuk memproses permintaan, dalam hitung detik. Defaultnya adalah 30 detik.

Header Permintaan

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

Name	Type	Description
client-request-id	string uuid	Identitas permintaan yang dihasilkan pemanggil, 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-rfc1123	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"

Name	Required	Type	Description
containerUrl	True	string	URL kontainer dalam Azure Blob Storage untuk mengunggah file log Batch Service. 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 memungkinkan cukup waktu untuk menyelesaikan unggahan. Waktu mulai untuk SAS bersifat opsional dan disarankan untuk tidak ditentukan.
startTime	True	string	Awal rentang waktu untuk mengunggah file log Layanan Batch. File log apa pun yang berisi pesan log dalam rentang waktu akan diunggah. Ini berarti bahwa operasi mungkin mengambil lebih banyak log daripada yang diminta karena seluruh file log selalu diunggah, tetapi operasi tidak boleh mengambil lebih sedikit log daripada yang diminta.
endTime		string	Akhir rentang waktu untuk mengunggah file log Batch Service. File log apa pun yang berisi pesan log dalam rentang waktu akan diunggah. Ini berarti bahwa operasi mungkin mengambil lebih banyak log daripada yang diminta karena seluruh file log selalu diunggah, tetapi operasi tidak boleh mengambil lebih sedikit log daripada yang diminta. Jika dihilangkan, defaultnya adalah mengunggah semua log yang tersedia setelah startTime.
identityReference		ComputeNodeIdentityReference	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

Name	Type	Description
200 OK	UploadBatchServiceLogsResult	Permintaan ke layanan Batch berhasil. Headers client-request-id: string request-id: string
Other Status Codes	BatchError	Kesalahan dari layanan Batch.

Name

Type

Description

200 OK

UploadBatchServiceLogsResult

Permintaan ke layanan Batch berhasil.

Headers

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

Other Status Codes

BatchError

Kesalahan dari layanan Batch.

Keamanan

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name	Description
user_impersonation	Meniru akun pengguna Anda

Authorization

Type: apiKey
In: header

Contoh

Upload BatchService Logs

Sample Request

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2022-01-01.15.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
}

Definisi

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

BatchError

Respons kesalahan yang diterima dari layanan Azure Batch.

Name	Type	Description
code	string	Pengidentifikasi untuk kesalahan. Kode tidak berubah dan dimaksudkan untuk dikonsumsi secara terprogram.
message	ErrorMessage	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

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

Name	Type	Description
key	string	Pengidentifikasi yang menentukan arti properti Nilai.
value	string	Informasi tambahan disertakan dengan respons kesalahan.

ComputeNodeIdentityReference

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

Name	Type	Description
resourceId	string	Id sumber daya ARM dari identitas yang ditetapkan pengguna.

ErrorMessage

Pesan kesalahan yang diterima dalam respons kesalahan Azure Batch.

Name	Type	Description
lang	string	Kode bahasa pesan kesalahan
value	string	Teks pesan.

UploadBatchServiceLogsConfiguration

Konfigurasi unggah file log layanan Azure Batch untuk Simpul Komputasi.

Name	Type	Description
containerUrl	string	URL kontainer dalam Azure Blob Storage untuk mengunggah file log Batch Service. 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 memungkinkan cukup waktu untuk menyelesaikan unggahan. Waktu mulai untuk SAS bersifat opsional dan disarankan untuk tidak ditentukan.
endTime	string	Akhir rentang waktu untuk mengunggah file log Batch Service. File log apa pun yang berisi pesan log dalam rentang waktu akan diunggah. Ini berarti bahwa operasi mungkin mengambil lebih banyak log daripada yang diminta karena seluruh file log selalu diunggah, tetapi operasi tidak boleh mengambil lebih sedikit log daripada yang diminta. Jika dihilangkan, defaultnya adalah mengunggah semua log yang tersedia setelah startTime.
identityReference	ComputeNodeIdentityReference	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	Awal rentang waktu untuk mengunggah file log Layanan Batch. File log apa pun yang berisi pesan log dalam rentang waktu akan diunggah. Ini berarti bahwa operasi mungkin mengambil lebih banyak log daripada yang diminta karena seluruh file log selalu diunggah, tetapi operasi tidak boleh mengambil lebih sedikit log daripada yang diminta.

UploadBatchServiceLogsResult

Hasil mengunggah file log layanan Batch dari Simpul Komputasi tertentu.

Name	Type	Description
numberOfFilesUploaded	integer	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 dibuat berdasarkan poolId, nodeId, dan pengidentifikasi unik.