Bagikan melalui

Compute Node - Upload Batch Service Logs

  • Referensi
Layanan:
Batch Service
Versi API:
2023-11-01.18.0

Unggah file log layanan Azure Batch 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=2023-11-01.18.0
Dengan parameter opsional: 
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?timeout={timeout}&api-version=2023-11-01.18.0

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
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"

Nama Diperlukan Jenis Deskripsi
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"

Nama Diperlukan Jenis Deskripsi
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

Nama Jenis Deskripsi
200 OK

UploadBatchServiceLogsResult

Permintaan ke layanan Batch berhasil.

Header

  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

Kesalahan dari layanan Batch.

Keamanan

azure_auth

Microsoft Entra alur kode autentikasi OAuth 2.0

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

Cakupan

Nama Deskripsi
user_impersonation Meniru akun pengguna Anda

Authorization

Jenis: apiKey
Dalam: header

Contoh

Upload BatchService Logs

Permintaan sampel

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

Respon sampel

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

Definisi

Nama Deskripsi
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.

Nama Jenis Deskripsi
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.

Nama Jenis Deskripsi
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.

Nama Jenis Deskripsi
resourceId

string

Id sumber daya ARM dari identitas yang ditetapkan pengguna.

ErrorMessage

Pesan kesalahan yang diterima dalam respons kesalahan Azure Batch.

Nama Jenis Deskripsi
lang

string

Kode bahasa pesan kesalahan
value

string

Teks pesan.

UploadBatchServiceLogsConfiguration

Konfigurasi unggah file log layanan Azure Batch untuk Simpul Komputasi.

Nama Jenis Deskripsi
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.

Nama Jenis Deskripsi
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.