Pools - Enable Pool Auto Scale

Hizmet:

Batch Service

API Sürümü:

2025-06-01

Havuz için otomatik ölçeklendirmeyi etkinleştirir.
Havuz üzerinde yeniden boyutlandırma işlemi sürüyorsa, Havuz üzerinde otomatik ölçeklendirmeyi etkinleştiremezsiniz. Havuzun otomatik ölçeklendirmesi şu anda devre dışıysa, isteğin bir parçası olarak geçerli bir otomatik ölçeklendirme formülü belirtmeniz gerekir. Havuzun otomatik ölçeklendirmesi zaten etkinse, yeni bir otomatik ölçeklendirme formülü ve/veya yeni bir değerlendirme aralığı belirtebilirsiniz. Aynı Havuz için bu API'yi 30 saniyede bir birden fazla çağıramazsınız.

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

İsteğe bağlı parametrelerle:

POST {endpoint}/pools/{poolId}/enableautoscale?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
autoScaleEvaluationInterval	string (duration)	Havuz boyutunun otomatik ölçeklendirme formülüne göre otomatik olarak ayarlandığı zaman aralığı. Varsayılan değer 15 dakikadır. En düşük ve en yüksek değer sırasıyla 5 dakika ve 168 saattir. 5 dakikadan kısa veya 168 saatten uzun bir değer belirtirseniz, Batch hizmeti isteği geçersiz bir özellik değeri hatasıyla reddeder; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek). Yeni bir aralık belirtirseniz, mevcut otomatik ölçeklendirme takvimi durdurulur ve yeni bir otomatik ölçeklendirme takvimi başlatılır; bu zaman bu talebin verildiği zamandır.
autoScaleFormula	string	Havuzdaki istenen İşlem Düğümü sayısı için formül. Varsayılan değer 15 dakikadır. En düşük ve en yüksek değer sırasıyla 5 dakika ve 168 saattir. 5 dakikadan kısa veya 168 saatten uzun bir değer belirtirseniz, Batch hizmeti isteği geçersiz bir özellik değeri hatasıyla reddeder; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek). Yeni bir aralık belirtirseniz, mevcut otomatik ölçeklendirme takvimi durdurulur ve yeni bir otomatik ölçeklendirme takvimi başlatılır; bu zaman bu talebin verildiği zamandır.

Yanıtlar

Name	Tür	Description
200 OK		İstek başarılı oldu. Ü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 enable autoscale

Örnek isteği

HTTP

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



{
  "autoScaleFormula": "$TargetDedicated=0",
  "autoScaleEvaluationInterval": "PT8M"
}

Örnek yanıt

Durum kodu:

200

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ı.
BatchPoolEnableAutoScaleOptions	Azure Batch Havuzu'nda otomatik ölçeklendirmeyi etkinleş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.

BatchPoolEnableAutoScaleOptions

Nesne

Azure Batch Havuzu'nda otomatik ölçeklendirmeyi etkinleştirmeye yönelik parametreler.

Name	Tür	Description
autoScaleEvaluationInterval	string (duration)	Havuz boyutunun otomatik ölçeklendirme formülüne göre otomatik olarak ayarlandığı zaman aralığı. Varsayılan değer 15 dakikadır. En düşük ve en yüksek değer sırasıyla 5 dakika ve 168 saattir. 5 dakikadan kısa veya 168 saatten uzun bir değer belirtirseniz, Batch hizmeti isteği geçersiz bir özellik değeri hatasıyla reddeder; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek). Yeni bir aralık belirtirseniz, mevcut otomatik ölçeklendirme takvimi durdurulur ve yeni bir otomatik ölçeklendirme takvimi başlatılır; bu zaman bu talebin verildiği zamandır.
autoScaleFormula	string	Havuzdaki istenen İşlem Düğümü sayısı için formül. Varsayılan değer 15 dakikadır. En düşük ve en yüksek değer sırasıyla 5 dakika ve 168 saattir. 5 dakikadan kısa veya 168 saatten uzun bir değer belirtirseniz, Batch hizmeti isteği geçersiz bir özellik değeri hatasıyla reddeder; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek). Yeni bir aralık belirtirseniz, mevcut otomatik ölçeklendirme takvimi durdurulur ve yeni bir otomatik ölçeklendirme takvimi başlatılır; bu zaman bu talebin verildiği zamandır.