Nodes - Reimage Node

Layanan:: Batch Service

Versi API:: 2025-06-01

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

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

Dengan parameter opsional:

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reimage?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 Simpul Komputasi yang ingin Anda mulai ulang.
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	Jenis	Deskripsi
nodeReimageOption	BatchNodeReimageOption	Kapan harus menggambar ulang Simpul Komputasi dan apa yang harus dilakukan dengan Tugas yang sedang berjalan. Nilai defaultnya adalah antrean ulang.

Respons

Nama	Jenis	Deskripsi
202 Accepted		Permintaan telah diterima untuk diproses, tetapi pemrosesan belum selesai. Header DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

202 Accepted

Permintaan telah diterima untuk diproses, tetapi pemrosesan belum selesai.

Header

DataServiceId: string
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

Node reimage

Permintaan sampel

HTTP

POST {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2025-06-01

Respon sampel

Kode status:: 202

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.
BatchNodeReimageOption	BatchNodeReimageOption enum
BatchNodeReimageOptions	Parameter untuk meniru kembali Simpul Komputasi Azure Batch.

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.

BatchNodeReimageOption

Enumerasi

BatchNodeReimageOption enum

Nilai	Deskripsi
requeue	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.
terminate	Hentikan tugas yang sedang berjalan. Tugas akan diselesaikan dengan failureInfo yang menunjukkan bahwa mereka dihentikan, dan tidak akan berjalan lagi. Gambar ulang Simpul Komputasi segera setelah Tugas dihentikan.
taskcompletion	Perbolehkan Tugas yang sedang berjalan selesai. Jadwalkan tidak ada Tugas baru saat menunggu. Gambar ulang Simpul Komputasi ketika semua Tugas telah selesai.
retaineddata	Tidak digunakan lagi, kami menyarankan Anda untuk mengunggah data tugas ke Azure Storage dalam tugas Anda dan menggunakannya `TaskCompletion` sebagai gantinya. Perbolehkan Tugas yang sedang berjalan selesai, lalu tunggu semua periode retensi data Tugas kedaluwarsa. Jadwalkan tidak ada Tugas baru saat menunggu. Gambar ulang Simpul Komputasi ketika semua periode retensi Tugas telah kedaluwarsa.

BatchNodeReimageOptions

Objek

Parameter untuk meniru kembali Simpul Komputasi Azure Batch.

Nama	Jenis	Deskripsi
nodeReimageOption	BatchNodeReimageOption	Kapan harus menggambar ulang Simpul Komputasi dan apa yang harus dilakukan dengan Tugas yang sedang berjalan. Nilai defaultnya adalah antrean ulang.