Pool - Evaluate Auto Scale

Mendapatkan hasil evaluasi rumus penskalaan otomatis pada Kumpulan.
API ini terutama untuk memvalidasi rumus skala otomatis, karena hanya mengembalikan hasil tanpa menerapkan rumus ke Kumpulan. Kumpulan harus mengaktifkan penskalaan otomatis untuk mengevaluasi rumus.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
batchUrl
path True

string

URL dasar untuk semua permintaan layanan Azure Batch.

poolId
path True

string

ID Kumpulan untuk mengevaluasi rumus penskalaan otomatis.

api-version
query True

string

Versi API Klien.

timeout
query

integer

int32

Waktu maksimum yang dapat dihabiskan server untuk memproses permintaan, dalam hitung detik. Defaultnya adalah 30 detik.

Header Permintaan

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

Nama Diperlukan Jenis Deskripsi
client-request-id

string

uuid

Identitas permintaan yang dihasilkan pemanggil, dalam bentuk GUID tanpa dekorasi seperti kurung kurawal, misalnya 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Apakah server harus mengembalikan client-request-id dalam respons.

ocp-date

string

date-time-rfc1123

Waktu permintaan dikeluarkan. Pustaka klien biasanya mengatur ini ke waktu jam sistem saat ini; atur secara eksplisit jika Anda memanggil REST API secara langsung.

Isi Permintaan

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

Nama Diperlukan Jenis Deskripsi
autoScaleFormula True

string

Rumus untuk jumlah Simpul Komputasi yang diinginkan di Kumpulan.
Rumus divalidasi dan hasilnya dihitung, tetapi tidak diterapkan ke Kumpulan. Untuk menerapkan rumus ke Kumpulan, 'Aktifkan penskalaan otomatis pada Kumpulan'. Untuk informasi selengkapnya tentang menentukan rumus ini, lihat Menskalakan Simpul Komputasi secara otomatis dalam Kumpulan Azure Batch (https://azure.microsoft.com/en-us/documentation/articles/batch-automatic-scaling).

Respons

Nama Jenis Deskripsi
200 OK

AutoScaleRun

Respons yang berisi hasil evaluasi skala otomatis.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

Kesalahan dari layanan Batch.

Keamanan

azure_auth

Microsoft Entra alur kode autentikasi OAuth 2.0

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

Scopes

Nama Deskripsi
user_impersonation Meniru akun pengguna Anda

Authorization

Type: apiKey
In: header

Contoh

Pool evaluate autoscale

Sample Request

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



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

Sample Response

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

Definisi

Nama Deskripsi
AutoScaleRun

Hasil dan kesalahan dari eksekusi rumus skala otomatis Kumpulan.

AutoScaleRunError

Kesalahan yang terjadi saat mengeksekusi atau mengevaluasi rumus skala otomatis Kumpulan.

BatchError

Respons kesalahan yang diterima dari layanan Azure Batch.

BatchErrorDetail

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

ErrorMessage

Pesan kesalahan yang diterima dalam respons kesalahan Azure Batch.

NameValuePair

Mewakili pasangan nama-nilai.

PoolEvaluateAutoScaleParameter

Opsi untuk mengevaluasi rumus penskalaan otomatis pada Kumpulan.

AutoScaleRun

Hasil dan kesalahan dari eksekusi rumus skala otomatis Kumpulan.

Nama Jenis Deskripsi
error

AutoScaleRunError

Detail kesalahan yang ditemui mengevaluasi rumus skala otomatis pada Kumpulan, jika evaluasi tidak berhasil.

results

string

Nilai akhir dari semua variabel yang digunakan dalam evaluasi rumus skala otomatis.
Setiap nilai variabel dikembalikan dalam formulir $variable=value, dan variabel dipisahkan oleh titik koma.

timestamp

string

Waktu saat rumus skala otomatis terakhir dievaluasi.

AutoScaleRunError

Kesalahan yang terjadi saat mengeksekusi atau mengevaluasi rumus skala otomatis Kumpulan.

Nama Jenis Deskripsi
code

string

Pengidentifikasi untuk kesalahan skala otomatis. Kode tidak berubah dan dimaksudkan untuk dikonsumsi secara terprogram.

message

string

Pesan yang menjelaskan kesalahan skala otomatis, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

values

NameValuePair[]

Daftar detail kesalahan tambahan yang terkait dengan kesalahan skala otomatis.

BatchError

Respons kesalahan yang diterima dari layanan Azure Batch.

Nama Jenis Deskripsi
code

string

Pengidentifikasi untuk kesalahan. Kode tidak berubah dan dimaksudkan untuk dikonsumsi secara terprogram.

message

ErrorMessage

Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

values

BatchErrorDetail[]

Kumpulan pasangan kunci-nilai yang berisi detail tambahan tentang kesalahan.

BatchErrorDetail

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

Nama Jenis Deskripsi
key

string

Pengidentifikasi yang menentukan arti properti Nilai.

value

string

Informasi tambahan disertakan dengan respons kesalahan.

ErrorMessage

Pesan kesalahan yang diterima dalam respons kesalahan Azure Batch.

Nama Jenis Deskripsi
lang

string

Kode bahasa pesan kesalahan

value

string

Teks pesan.

NameValuePair

Mewakili pasangan nama-nilai.

Nama Jenis Deskripsi
name

string

Nama dalam pasangan nama-nilai.

value

string

Nilai dalam pasangan nama-nilai.

PoolEvaluateAutoScaleParameter

Opsi untuk mengevaluasi rumus penskalaan otomatis pada Kumpulan.

Nama Jenis Deskripsi
autoScaleFormula

string

Rumus untuk jumlah Simpul Komputasi yang diinginkan di Kumpulan.
Rumus divalidasi dan hasilnya dihitung, tetapi tidak diterapkan ke Kumpulan. Untuk menerapkan rumus ke Kumpulan, 'Aktifkan penskalaan otomatis pada Kumpulan'. Untuk informasi selengkapnya tentang menentukan rumus ini, lihat Menskalakan Simpul Komputasi secara otomatis dalam Kumpulan Azure Batch (https://azure.microsoft.com/en-us/documentation/articles/batch-automatic-scaling).