Pools - Remove Nodes

Hizmet:

Batch Service

API Sürümü:

2025-06-01

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 {endpoint}/pools/{poolId}/removenodes?api-version=2025-06-01

İsteğe bağlı parametrelerle:

POST {endpoint}/pools/{poolId}/removenodes?api-version=2025-06-01&timeOut={timeOut}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Batch hesabı uç noktası (örneğin: https://batchaccount.eastus2.batch.azure.com).
poolId	path	True	string	Alınacak Havuzun kimliği.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
timeOut	query		integer (int32)	Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye cinsinden). Varsayılan değer 30 saniyedir. Değer 30'dan büyükse, varsayılan kullanılacaktır.".

İstek Başlığı

Media Types: "application/json; odata=minimalmetadata"

Name	Gerekli	Tür	Description
client-request-id		string	Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, ö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-rfc7231)	İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.
If-Modified-Since		string (date-time-rfc7231)	İ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ştirilmişse gerçekleştirilir.
If-Unmodified-Since		string (date-time-rfc7231)	İ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ştirilmemişse gerçekleştirilir.
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.

İ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. İstek başına en fazla 100 düğüm kaldırılabilir.
nodeDeallocationOption		BatchNodeDeallocationOption	İşlem Düğümü ve serbest bırakma için seçildikten sonra çalışan görevleriyle ne yapacağını belirler. Varsayılan değer yeniden sorgulanır.
resizeTimeout		string (duration)	İşlem Düğümlerinin Havuza kaldırılması için zaman aşımı. Varsayılan değer 15 dakikadır. En düşük değer 5 dakikadır. 5 dakikadan kısa bir değer belirtirseniz, Batch hizmeti bir hata döndürür; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek).

Yanıtlar

Name	Tür	Description
202 Accepted		İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı. Üst Bilgiler DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Beklenmeyen bir hata yanıtı.

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Kapsamlar

Name	Description
https://batch.core.windows.net//.default

Örnekler

Pool remove nodes

Örnek isteği

HTTP

POST {endpoint}/pools/poolId/removenodes?api-version=2025-06-01



{
  "nodeList": [
    "tvm-1695681911_1-20161122t224741z",
    "tvm-1695681911_2-20161122t224741z"
  ]
}

Örnek yanıt

Durum kodu:

202

Tanımlar

Name	Description
BatchError	Azure Batch hizmetinden alınan bir hata yanıtı.
BatchErrorDetail	Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.
BatchErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.
BatchNodeDeallocationOption	BatchNodeDeallocationOption enums
BatchNodeRemoveOptions	Azure Batch Havuzundan düğümleri kaldırma parametreleri.

BatchError

Nesne

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	BatchErrorMessage	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values	BatchErrorDetail[]	Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Nesne

Azure Batch hata yanıtına dahil edilen 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.

BatchErrorMessage

Nesne

Azure Batch hata yanıtında bir hata iletisi alındı.

Name	Tür	Description
lang	string	Hata mesajının dil kodu.
value	string	İletinin metni.

BatchNodeDeallocationOption

Numaralandırma

BatchNodeDeallocationOption enums

Değer	Description
requeue	Çalışan Görev işlemlerini sonlandırın ve Görevleri yeniden sıraya getirin. İşlem Düğümü kullanılabilir olduğunda Görevler yeniden çalışır. Görevler sonlandırılır sonlandırılmaz İşlem Düğümlerini kaldırın.
terminate	Çalışan Görevleri sonlandır. Görevler, sonlandırıldıklarını belirten failureInfo ile tamamlanır ve yeniden çalıştırılmaz. Görevler sonlandırılır sonlandırılmaz İşlem Düğümlerini kaldırın.
taskcompletion	Ç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.
retaineddata	Kullanım dışı olduğundan, görev verilerini görevinizdeki Azure Depolama'ya yüklemenizi ve bunun yerine kullanmanızı TaskCompletion öneririz. Ç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.

BatchNodeRemoveOptions

Nesne

Azure Batch Havuzundan düğümleri kaldırma parametreleri.

Name	Tür	Description
nodeDeallocationOption	BatchNodeDeallocationOption	İşlem Düğümü ve serbest bırakma için seçildikten sonra çalışan görevleriyle ne yapacağını belirler. Varsayılan değer yeniden sorgulanır.
nodeList	string[]	Belirtilen Havuzdan kaldırılacak İşlem Düğümlerinin kimliklerini içeren liste. İstek başına en fazla 100 düğüm kaldırılabilir.
resizeTimeout	string (duration)	İşlem Düğümlerinin Havuza kaldırılması için zaman aşımı. Varsayılan değer 15 dakikadır. En düşük değer 5 dakikadır. 5 dakikadan kısa bir değer belirtirseniz, Batch hizmeti bir hata döndürür; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek).