Pools - Evaluate Pool Auto Scale

Hizmet:

Batch Service

API Sürümü:

2025-06-01

Havuzdaki otomatik ölçeklendirme formülünü değerlendirmenin sonucunu alır.
Bu API öncelikle formülü Havuza uygulamadan sonucu döndürdüğünden otomatik ölçeklendirme formülünü doğrulamaya yöneliktir. Formülü değerlendirmek için Havuzda otomatik ölçeklendirme etkinleştirilmelidir.

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

İsteğe bağlı parametrelerle:

POST {endpoint}/pools/{poolId}/evaluateautoscale?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	Otomatik ölçeklendirme formülünün değerlendirileceği 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.

İstek Gövdesi

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

Name	Gerekli	Tür	Description
autoScaleFormula	True	string	Havuzdaki istenen İşlem Düğümü sayısı için formül. Formül doğrulanır ve sonuçları hesaplanır, ancak Havuz'a uygulanmaz. Formülü Havuz'a uygulamak için, 'Havuzda otomatik ölçeklendirmeyi etkinleştir'. Bu formülü belirtmek hakkında daha fazla bilgi için bkz. Otomatik ölçeklendirme Hesaplama Düğümleri in bir Azure Batch Pool (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).

Yanıtlar

Name	Tür	Description
200 OK	AutoScaleRun	İ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 evaluate autoscale

Örnek isteği

HTTP

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



{
  "autoScaleFormula": "$TargetDedicated=1"
}

Örnek yanıt

Durum kodu:

200

{
  "timestamp": "2025-11-22T19:39:28.5246331Z",
  "results": "$TargetDedicated=1;$NodeDeallocationOption=requeue"
}

Tanımlar

Name	Description
AutoScaleRun	Havuz otomatik ölçeklendirme formülünün yürütülmesiyle ilgili sonuçlar ve hatalar.
AutoScaleRunError	Havuz otomatik ölçeklendirme formülü yürütülürken veya değerlendirilirken oluşan bir hata.
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ı.
BatchPoolEvaluateAutoScaleOptions	Azure Batch Havuzu'nda otomatik ölçeklendirme formülünü değerlendirmeye yönelik parametreler.
NameValuePair	Ad-değer çiftini temsil eder.

AutoScaleRun

Nesne

Havuz otomatik ölçeklendirme formülünün yürütülmesiyle ilgili sonuçlar ve hatalar.

Name	Tür	Description
error	AutoScaleRunError	Havuzda otomatik ölçeklendirme formülünü değerlendirirken karşılaşılan hata detayları, eğer değerlendirme başarısız olursa.
results	string	Otomatik ölçeklendirme formülünün değerlendirilmesinde kullanılan tüm değişkenlerin son değerleri. Her değişken değeri $variable=değer biçiminde döndürülür ve değişkenler noktalı virgülle ayrılır.
timestamp	string (date-time)	Otomatik ölçeklendirme formülünü son değerlendirme zamanı.

AutoScaleRunError

Nesne

Havuz otomatik ölçeklendirme formülü yürütülürken veya değerlendirilirken oluşan bir hata.

Name	Tür	Description
code	string	Otomatik ölçeklendirme hatası için bir tanımlayıcı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	string	Otomatik ölçeklendirme hatasını tanımlayan bir mesaj, kullanıcı arayüzünde görüntülenmeye uygun olması amaçlanmıştır.
values	NameValuePair[]	Otomatik ölçeklendirme hatasıyla ilgili ek hata detaylarının listesi.

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.

BatchPoolEvaluateAutoScaleOptions

Nesne

Azure Batch Havuzu'nda otomatik ölçeklendirme formülünü değerlendirmeye yönelik parametreler.

Name	Tür	Description
autoScaleFormula	string	Havuzdaki istenen İşlem Düğümü sayısı için formül. Formül doğrulanır ve sonuçları hesaplanır, ancak Havuz'a uygulanmaz. Formülü Havuz'a uygulamak için, 'Havuzda otomatik ölçeklendirmeyi etkinleştir'. Bu formülü belirtmek hakkında daha fazla bilgi için bkz. Otomatik ölçeklendirme Hesaplama Düğümleri in bir Azure Batch Pool (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).

NameValuePair

Nesne

Ad-değer çiftini temsil eder.

Name	Tür	Description
name	string	İsim-değer çiftindeki isim.
value	string	İsim-değer çiftindeki değer.