Pool - Remove Nodes
Menghapus Simpul Komputasi dari Kumpulan yang ditentukan.
Operasi ini hanya dapat berjalan ketika status alokasi Kumpulan stabil. Ketika operasi ini berjalan, status alokasi berubah dari stabil menjadi mengubah ukuran. Setiap permintaan dapat menghapus hingga 100 simpul.
POST {batchUrl}/pools/{poolId}/removenodes?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/removenodes?timeout={timeout}&api-version=2023-11-01.18.0
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
batch
|
path | True |
string |
URL dasar untuk semua permintaan layanan Azure Batch. |
pool
|
path | True |
string |
ID Kumpulan tempat Anda ingin menghapus 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. |
|
If-Match |
string |
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan sama persis dengan nilai yang ditentukan oleh klien. |
|
If-None-Match |
string |
Nilai ETag yang terkait dengan versi sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika ETag sumber daya saat ini pada layanan tidak cocok dengan nilai yang ditentukan oleh klien. |
|
If-Modified-Since |
string date-time-rfc1123 |
Tanda waktu yang menunjukkan waktu modifikasi terakhir sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan telah dimodifikasi sejak waktu yang ditentukan. |
|
If-Unmodified-Since |
string date-time-rfc1123 |
Tanda waktu yang menunjukkan waktu modifikasi terakhir sumber daya yang diketahui oleh klien. Operasi akan dilakukan hanya jika sumber daya pada layanan belum dimodifikasi sejak waktu yang ditentukan. |
Isi Permintaan
Media Types: "application/json; odata=minimalmetadata"
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
nodeList | True |
string[] |
Daftar yang berisi ID Simpul Komputasi yang akan dihapus dari Kumpulan yang ditentukan. |
nodeDeallocationOption |
Menentukan apa yang harus dilakukan dengan Simpul Komputasi dan tugas yang sedang berjalan setelah dipilih untuk pembatalan alokasi. |
||
resizeTimeout |
string |
Batas waktu untuk penghapusan Simpul Komputasi ke Kumpulan. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
202 Accepted |
Permintaan ke layanan Batch berhasil. Headers
|
|
Other Status Codes |
Kesalahan dari layanan Batch. |
Keamanan
azure_auth
Microsoft Entra alur kode autentikasi OAuth 2.0
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nama | Deskripsi |
---|---|
user_impersonation | Meniru akun pengguna Anda |
Authorization
Type:
apiKey
In:
header
Contoh
Pool remove nodes
Sample Request
POST account.region.batch.azure.com/pools/poolId/removenodes?api-version=2023-11-01.18.0
{
"nodeList": [
"tvm-1695681911_1-20161122t224741z",
"tvm-1695681911_2-20161122t224741z"
]
}
Sample Response
Definisi
Nama | Deskripsi |
---|---|
Batch |
Respons kesalahan yang diterima dari layanan Azure Batch. |
Batch |
Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch. |
Compute |
Menentukan apa yang harus dilakukan dengan Simpul Komputasi dan tugas yang sedang berjalan setelah dipilih untuk pembatalan alokasi. |
Error |
Pesan kesalahan diterima dalam respons kesalahan Azure Batch. |
Node |
Opsi untuk menghapus Simpul Komputasi dari Kumpulan. |
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 |
Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna. |
|
values |
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. |
ComputeNodeDeallocationOption
Menentukan apa yang harus dilakukan dengan Simpul Komputasi dan tugas yang sedang berjalan setelah dipilih untuk pembatalan alokasi.
Nama | Jenis | Deskripsi |
---|---|---|
requeue |
string |
Hentikan proses Tugas yang sedang berjalan dan antre ulang Tugas. Tugas akan berjalan lagi ketika Simpul Komputasi tersedia. Hapus Simpul Komputasi segera setelah Tugas dihentikan. |
retaineddata |
string |
Perbolehkan Tugas yang sedang berjalan selesai, lalu tunggu hingga semua periode retensi data Tugas kedaluwarsa. Jadwalkan tidak ada Tugas baru saat menunggu. Hapus Simpul Komputasi saat semua periode retensi Tugas telah kedaluwarsa. |
taskcompletion |
string |
Perbolehkan Tugas yang sedang berjalan selesai. Jadwalkan tidak ada Tugas baru saat menunggu. Hapus 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. Hapus Simpul Komputasi segera setelah Tugas dihentikan. |
ErrorMessage
Pesan kesalahan diterima dalam respons kesalahan Azure Batch.
Nama | Jenis | Deskripsi |
---|---|---|
lang |
string |
Kode bahasa pesan kesalahan |
value |
string |
Teks pesan. |
NodeRemoveParameter
Opsi untuk menghapus Simpul Komputasi dari Kumpulan.
Nama | Jenis | Deskripsi |
---|---|---|
nodeDeallocationOption |
Menentukan apa yang harus dilakukan dengan Simpul Komputasi dan tugas yang sedang berjalan setelah dipilih untuk pembatalan alokasi. |
|
nodeList |
string[] |
Daftar yang berisi ID Simpul Komputasi yang akan dihapus dari Kumpulan yang ditentukan. |
resizeTimeout |
string |
Batas waktu untuk penghapusan Simpul Komputasi ke Kumpulan. |