Pools - Resize Pool

Hizmet:

Batch Service

API Sürümü:

2025-06-01

Havuza atanan İşlem Düğümlerinin sayısını değiştirir.
Havuzu yalnızca ayırma durumu sabit olduğunda yeniden boyutlandırabilirsiniz. Havuz zaten yeniden boyutlandırılıyorsa istek 409 durum koduyla başarısız olur. Havuzu yeniden boyutlandırdığınızda Havuzun ayırma durumu sabitten yeniden boyutlandırmaya dönüşür. Otomatik ölçeklendirme için yapılandırılmış havuzları yeniden boyutlandıramazsınız. Bunu yapmaya çalışırsanız, Batch hizmeti 409 hatasını döndürür. Havuzu aşağı doğru yeniden boyutlandırırsanız, Batch hizmeti hangi İşlem Düğümlerinin kaldırılacağını seçer. Belirli İşlem Düğümlerini kaldırmak için bunun yerine Havuz kaldırma İşlem Düğümleri API'sini kullanın.

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

İsteğe bağlı parametrelerle:

POST {endpoint}/pools/{poolId}/resize?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	Tür	Description
nodeDeallocationOption	BatchNodeDeallocationOption	Havuz boyutu azaldıysa İşlem Düğümü ve çalışan görevleriyle ne yapacağınızı belirler. Varsayılan değer yeniden sorgulanır.
resizeTimeout	string (duration)	Düğümlerin Havuza ayrılması veya İşlem Düğümlerinin Havuzdan 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).
targetDedicatedNodes	integer (int32)	Havuzdaki ayrılmış İşlem Düğümlerinin istenen sayısı.
targetLowPriorityNodes	integer (int32)	Havuzdaki spot/düşük öncelikli işlem düğümlerinin istenen sayısı.

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 resize

Örnek isteği

HTTP

POST {endpoint}/pools/resizePool/resize?api-version=2025-06-01



{
  "targetDedicatedNodes": 1,
  "targetLowPriorityNodes": 0
}

Ö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
BatchPoolResizeOptions	Azure Batch Havuzunun boyutunu değiştirmeye yönelik parametreler.

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.

BatchPoolResizeOptions

Nesne

Azure Batch Havuzunun boyutunu değiştirmeye yönelik parametreler.

Name	Tür	Description
nodeDeallocationOption	BatchNodeDeallocationOption	Havuz boyutu azaldıysa İşlem Düğümü ve çalışan görevleriyle ne yapacağınızı belirler. Varsayılan değer yeniden sorgulanır.
resizeTimeout	string (duration)	Düğümlerin Havuza ayrılması veya İşlem Düğümlerinin Havuzdan 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).
targetDedicatedNodes	integer (int32)	Havuzdaki ayrılmış İşlem Düğümlerinin istenen sayısı.
targetLowPriorityNodes	integer (int32)	Havuzdaki spot/düşük öncelikli işlem düğümlerinin istenen sayısı.