Bagikan melalui

Compute Node - Reimage

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

Menginstal ulang sistem operasi pada Simpul Komputasi yang ditentukan.
Anda dapat menginstal ulang sistem operasi pada Simpul Komputasi hanya jika berada dalam status menganggur atau berjalan. API ini hanya dapat dipanggil pada Kumpulan yang dibuat dengan properti konfigurasi layanan cloud.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2023-11-01.18.0
Dengan parameter opsional: 
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?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 yang ingin Anda mulai ulang.
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 Jenis Deskripsi
nodeReimageOption

ComputeNodeReimageOption

Kapan harus menggambar ulang Simpul Komputasi dan apa yang harus dilakukan dengan Tugas yang sedang berjalan.
Nilai defaultnya adalah mengantri-ulang.

Respons

Nama Jenis Deskripsi
202 Accepted

Permintaan ke layanan Batch berhasil.

Header

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: 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

Node reimage

Permintaan sampel

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2023-11-01.18.0



{
  "nodeReimageOption": "terminate"
}

Respon sampel

Kode status:
202

Definisi

Nama Deskripsi
BatchError

Respons kesalahan yang diterima dari layanan Azure Batch.
BatchErrorDetail

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.
ComputeNodeReimageOption

Kapan harus menggambar ulang Simpul Komputasi dan apa yang harus dilakukan dengan Tugas yang sedang berjalan.
ErrorMessage

Pesan kesalahan yang diterima dalam respons kesalahan Azure Batch.
NodeReimageParameter

Opsi untuk menbidik ulang Simpul Komputasi.

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.

ComputeNodeReimageOption

Kapan harus menggambar ulang Simpul Komputasi dan apa yang harus dilakukan dengan Tugas yang sedang berjalan.

Nama Jenis Deskripsi
requeue

string

Hentikan proses Tugas yang sedang berjalan dan antre ulang Tugas. Tugas akan berjalan lagi ketika Simpul Komputasi tersedia. Gambar ulang Simpul Komputasi segera setelah Tugas dihentikan.
retaineddata

string

Perbolehkan Tugas yang sedang berjalan selesai, lalu tunggu semua periode retensi data Tugas kedaluwarsa. Jadwalkan tidak ada Tugas baru saat menunggu. Reimage Compute Node ketika semua periode retensi Tugas telah kedaluwarsa.
taskcompletion

string

Perbolehkan Tugas yang sedang berjalan untuk diselesaikan. Jadwalkan tidak ada Tugas baru saat menunggu. Gambar ulang Simpul Komputasi ketika semua Tugas telah selesai.
terminate

string

Hentikan tugas yang sedang berjalan. Tugas akan diselesaikan dengan failureInfo yang menunjukkan bahwa tugas dihentikan, dan tidak akan berjalan lagi. Gambar ulang Simpul Komputasi segera setelah Tugas dihentikan.

ErrorMessage

Pesan kesalahan yang diterima dalam respons kesalahan Azure Batch.

Nama Jenis Deskripsi
lang

string

Kode bahasa pesan kesalahan
value

string

Teks pesan.

NodeReimageParameter

Opsi untuk menbidik ulang Simpul Komputasi.

Nama Jenis Deskripsi
nodeReimageOption

ComputeNodeReimageOption

Kapan harus menggambar ulang Simpul Komputasi dan apa yang harus dilakukan dengan Tugas yang sedang berjalan.
Nilai defaultnya adalah mengantri-ulang.