Pool - Remove Nodes
Belirtilen Havuzdan İşlem Düğümlerini kaldırır.
Bu işlem yalnızca Havuzun ayırma durumu sabit olduğunda çalıştırılabilir. Bu işlem çalıştırıldığında ayırma durumu sabitten yeniden boyutlandırmaya dönüşür. Her istek en fazla 100 düğümü kaldırabilir.
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
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Tüm Azure Batch hizmet isteklerinin temel URL'si. |
pool
|
path | True |
string |
İşlem Düğümlerini kaldırmak istediğiniz Havuzun kimliği. |
api-version
|
query | True |
string |
İstemci API Sürümü. |
timeout
|
query |
integer int32 |
Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye olarak). Varsayılan değer 30 saniyedir. |
İstek Başlığı
Media Types: "application/json; odata=minimalmetadata"
Name | Gerekli | Tür | Description |
---|---|---|---|
client-request-id |
string uuid |
Çağıranın oluşturduğu istek kimliği, küme ayraçları gibi süsleme içermeyen bir GUID biçimindedir; örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Sunucunun yanıtta client-request-id döndürip döndürmeyeceği. |
|
ocp-date |
string date-time-rfc1123 |
İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saati olarak ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın. |
|
If-Match |
string |
İstemci tarafından bilinen kaynağın sürümüyle ilişkili bir ETag değeri. İşlem yalnızca kaynağın hizmetteki geçerli ETag'i istemci tarafından belirtilen değerle tam olarak eşleşiyorsa gerçekleştirilir. |
|
If-None-Match |
string |
İstemci tarafından bilinen kaynağın sürümüyle ilişkili bir ETag değeri. İşlem yalnızca kaynağın hizmetteki geçerli ETag'i istemci tarafından belirtilen değerle eşleşmiyorsa gerçekleştirilir. |
|
If-Modified-Since |
string date-time-rfc1123 |
İstemci tarafından bilinen kaynağın son değiştirme zamanını gösteren zaman damgası. İşlem yalnızca hizmet üzerindeki kaynak belirtilen süreden sonra değiştirildiğinde gerçekleştirilir. |
|
If-Unmodified-Since |
string date-time-rfc1123 |
İstemci tarafından bilinen kaynağın son değiştirme zamanını gösteren zaman damgası. İşlem yalnızca hizmet üzerindeki kaynak belirtilen süreden bu yana değiştirilmediyse gerçekleştirilir. |
İstek Gövdesi
Media Types: "application/json; odata=minimalmetadata"
Name | Gerekli | Tür | Description |
---|---|---|---|
nodeList | True |
string[] |
Belirtilen Havuzdan kaldırılacak İşlem Düğümlerinin kimliklerini içeren liste. |
nodeDeallocationOption |
Serbest bırakma için seçildikten sonra İşlem Düğümü ve çalışan görevleriyle ne yapacağını belirler. |
||
resizeTimeout |
string |
İşlem Düğümlerinin Havuza kaldırılması için zaman aşımı. |
Yanıtlar
Name | Tür | Description |
---|---|---|
202 Accepted |
Batch hizmetine yapılan istek başarılı oldu. Üst Bilgiler
|
|
Other Status Codes |
Batch hizmetinden gelen hata. |
Güvenlik
azure_auth
OAuth 2.0 kimlik doğrulama kodu akışını Microsoft Entra
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | Kullanıcı hesabınızın kimliğine bürünme |
Authorization
Tür:
apiKey
İçinde:
header
Örnekler
Pool remove nodes
Örnek isteği
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"
]
}
Örnek yanıt
Tanımlar
Name | Description |
---|---|
Batch |
Azure Batch hizmetinden alınan bir hata yanıtı. |
Batch |
Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe. |
Compute |
Serbest bırakma için seçildikten sonra İşlem Düğümü ve çalışan görevleriyle ne yapacağını belirler. |
Error |
Azure Batch hata yanıtında alınan bir hata iletisi. |
Node |
Bir Havuzdan İşlem Düğümlerini kaldırma seçenekleri. |
BatchError
Azure Batch hizmetinden alınan bir hata yanıtı.
Name | Tür | Description |
---|---|---|
code |
string |
Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır. |
message |
Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti. |
|
values |
Hatayla ilgili ek ayrıntıları içeren anahtar-değer çiftleri koleksiyonu. |
BatchErrorDetail
Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe.
Name | Tür | Description |
---|---|---|
key |
string |
Value özelliğinin anlamını belirten tanımlayıcı. |
value |
string |
Hata yanıtına eklenen ek bilgiler. |
ComputeNodeDeallocationOption
Serbest bırakma için seçildikten sonra İşlem Düğümü ve çalışan görevleriyle ne yapacağını belirler.
Name | Tür | Description |
---|---|---|
requeue |
string |
Çalışan Görev işlemlerini sonlandırın ve Görevleri yeniden sorguya çekin. İşlem Düğümü kullanılabilir olduğunda Görevler yeniden çalışır. Görevler sonlandırıldıktan hemen sonra İşlem Düğümlerini kaldırın. |
retaineddata |
string |
Çalışmakta olan Görevlerin tamamlanmasına izin verin, ardından tüm Görev verileri saklama sürelerinin dolmasını bekleyin. Beklerken yeni Görev zamanlama. Tüm Görev saklama sürelerinin süresi dolduğunda İşlem Düğümlerini kaldırın. |
taskcompletion |
string |
Çalışmakta olan Görevlerin tamamlanmasına izin verin. Beklerken yeni Görev zamanlama. Tüm Görevler tamamlandığında İşlem Düğümlerini kaldırın. |
terminate |
string |
Çalışan Görevleri sonlandır. Görevler, sonlandırıldıklarını belirten failureInfo ile tamamlanır ve yeniden çalışmaz. Görevler sonlandırıldıktan hemen sonra İşlem Düğümlerini kaldırın. |
ErrorMessage
Azure Batch hata yanıtında alınan bir hata iletisi.
Name | Tür | Description |
---|---|---|
lang |
string |
Hata iletisinin dil kodu |
value |
string |
İletinin metni. |
NodeRemoveParameter
Bir Havuzdan İşlem Düğümlerini kaldırma seçenekleri.
Name | Tür | Description |
---|---|---|
nodeDeallocationOption |
Serbest bırakma için seçildikten sonra İşlem Düğümü ve çalışan görevleriyle ne yapacağını belirler. |
|
nodeList |
string[] |
Belirtilen Havuzdan kaldırılacak İşlem Düğümlerinin kimliklerini içeren liste. |
resizeTimeout |
string |
İşlem Düğümlerinin Havuza kaldırılması için zaman aşımı. |