Pool - Evaluate Auto Scale

Service:

Batch Service

API Version:

2023-11-01.18.0

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

POST {batchUrl}/pools/{poolId}/evaluateautoscale?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/pools/{poolId}/evaluateautoscale?timeout={timeout}&api-version=2023-11-01.18.0

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
batchUrl	path	True	string	Tüm Azure Batch hizmet isteklerinin temel URL'si.
poolId	path	True	string	Otomatik ölçeklendirme formülünün değerlendirildiği 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 tarafından oluşturulan istek kimliği, küme ayraçları gibi dekorasyonu olmayan 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 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 Havuza uygulanmaz. Formülü Havuza uygulamak için 'Havuzda otomatik ölçeklendirmeyi etkinleştir'. Bu formülü belirtme hakkında daha fazla bilgi için bkz. Azure Batch Havuzunda İşlem Düğümlerini otomatik olarak ölçeklendirme (https://azure.microsoft.com/en-us/documentation/articles/batch-automatic-scaling).

Yanıtlar

Name	Tür	Description
200 OK	AutoScaleRun	Otomatik ölçeklendirme değerlendirmesinin sonuçlarını içeren yanıt. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Batch hizmetinden gelen hata.

Güvenlik

azure_auth

OAuth 2.0 kimlik doğrulama kodu akışını Microsoft Entra

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	Kullanıcı hesabınızın kimliğine bürünme

Authorization

Type: apiKey
In: header

Örnekler

Pool evaluate autoscale

Sample Request

HTTP

POST account.region.batch.azure.com/pools/poolId/evaluateautoscale?api-version=2023-11-01.18.0



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

Sample Response

Status code:

200

{
  "timestamp": "2016-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 eklenen ek bilgilerden oluşan bir öğe.
ErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.
NameValuePair	Ad-değer çiftini temsil eder.
PoolEvaluateAutoScaleParameter	Havuzdaki otomatik ölçeklendirme formülünü değerlendirme seçenekleri.

AutoScaleRun

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

Name	Tür	Description
error	AutoScaleRunError	Değerlendirme başarısız olduysa Havuzdaki otomatik ölçeklendirme formülünü değerlendirirken karşılaşılan hatanın ayrıntıları.
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	Otomatik ölçeklendirme formülünü en son değerlendirme zamanı.

AutoScaleRunError

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ının tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	string	Kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan otomatik ölçeklendirme hatasını açıklayan bir ileti.
values	NameValuePair[]	Otomatik ölçeklendirme hatasıyla ilgili ek hata ayrıntılarının listesi.

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	ErrorMessage	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values	BatchErrorDetail[]	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.

ErrorMessage

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

Name	Tür	Description
lang	string	Hata iletisinin dil kodu
value	string	İletinin metni.

NameValuePair

Ad-değer çiftini temsil eder.

Name	Tür	Description
name	string	Ad-değer çiftindeki ad.
value	string	Ad-değer çiftindeki değer.

PoolEvaluateAutoScaleParameter

Havuzdaki otomatik ölçeklendirme formülünü değerlendirme seçenekleri.

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 Havuza uygulanmaz. Formülü Havuza uygulamak için 'Havuzda otomatik ölçeklendirmeyi etkinleştir'. Bu formülü belirtme hakkında daha fazla bilgi için bkz. Azure Batch Havuzunda İşlem Düğümlerini otomatik olarak ölçeklendirme (https://azure.microsoft.com/en-us/documentation/articles/batch-automatic-scaling).