Account - List Pool Node Counts

Mendapatkan jumlah Simpul Komputasi di setiap status, dikelompokkan menurut Kumpulan. Perhatikan bahwa angka yang dikembalikan mungkin tidak selalu diperbarui. Jika Anda memerlukan jumlah simpul yang tepat, gunakan kueri daftar.

GET {batchUrl}/nodecounts?api-version=2022-01-01.15.0
GET {batchUrl}/nodecounts?$filter={$filter}&maxresults={maxresults}&timeout={timeout}&api-version=2022-01-01.15.0

Parameter URI

Name In Required Type Description
batchUrl
path True
  • string

URL dasar untuk semua permintaan layanan Azure Batch.

api-version
query True
  • string

Versi API Klien.

$filter
query
  • string

Klausa $filter OData. Untuk informasi selengkapnya tentang membuat filter ini, lihat https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch.

maxresults
query
  • integer
int32

Jumlah maksimum item yang akan dikembalikan dalam respons.

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"

Name Required Type Description
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.

Respons

Name Type Description
200 OK

Respons berisi jumlah Simpul Komputasi di setiap status Simpul Komputasi, yang dikelompokkan menurut Kumpulan.

Headers

  • client-request-id: string
  • request-id: string
Other Status Codes

Kesalahan dari layanan Batch.

Keamanan

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name Description
user_impersonation Meniru akun pengguna Anda

Authorization

Type: apiKey
In: header

Contoh

NodeCountsPayload

Sample Request

GET account.region.batch.azure.com/nodecounts?api-version=2022-01-01.15.0


Sample Response

{
  "value": [
    {
      "poolId": "pool1",
      "dedicated": {
        "creating": 0,
        "idle": 0,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 0,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "total": 0
      },
      "lowPriority": {
        "creating": 0,
        "idle": 0,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 2,
        "starting": 1,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "total": 3
      }
    },
    {
      "poolId": "pool2",
      "dedicated": {
        "creating": 0,
        "idle": 1,
        "leavingPool": 0,
        "offline": 3,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 0,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "total": 4
      },
      "lowPriority": {
        "creating": 0,
        "idle": 0,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 0,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "total": 0
      }
    },
    {
      "poolId": "pool3",
      "dedicated": {
        "creating": 0,
        "idle": 5,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 4,
        "running": 0,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "total": 9
      },
      "lowPriority": {
        "creating": 7,
        "idle": 0,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 4,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "total": 11
      }
    }
  ]
}

Definisi

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.

NodeCounts

Jumlah Simpul Komputasi di setiap status Simpul Komputasi.

PoolNodeCounts

Jumlah Simpul Komputasi di setiap status untuk Kumpulan.

PoolNodeCountsListResult

Hasil daftar jumlah Simpul Komputasi di Akun.

BatchError

Respons kesalahan yang diterima dari layanan Azure Batch.

Name Type Description
code
  • string

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

message

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

values

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

BatchErrorDetail

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

Name Type Description
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.

Name Type Description
lang
  • string

Kode bahasa pesan kesalahan

value
  • string

Teks pesan.

NodeCounts

Jumlah Simpul Komputasi di setiap status Simpul Komputasi.

Name Type Description
creating
  • integer

Jumlah Simpul Komputasi dalam status pembuatan.

idle
  • integer

Jumlah Simpul Komputasi dalam status diam.

leavingPool
  • integer

Jumlah Simpul Komputasi dalam status leavingPool.

offline
  • integer

Jumlah Simpul Komputasi dalam status offline.

preempted
  • integer

Jumlah Simpul Komputasi dalam status yang didahului.

rebooting
  • integer

Jumlah Simpul Komputasi dalam status reboot.

reimaging
  • integer

Jumlah Simpul Komputasi dalam status penomoran ulang.

running
  • integer

Jumlah Simpul Komputasi dalam status berjalan.

startTaskFailed
  • integer

Jumlah Simpul Komputasi dalam status startTaskFailed.

starting
  • integer

Jumlah Simpul Komputasi dalam status awal.

total
  • integer

Jumlah total Simpul Komputasi.

unknown
  • integer

Jumlah Simpul Komputasi dalam status tidak diketahui.

unusable
  • integer

Jumlah Simpul Komputasi dalam status tidak dapat digunakan.

waitingForStartTask
  • integer

Jumlah Simpul Komputasi dalam status waitingForStartTask.

PoolNodeCounts

Jumlah Simpul Komputasi di setiap status untuk Kumpulan.

Name Type Description
dedicated

Jumlah Simpul Komputasi khusus di setiap status.

lowPriority

Jumlah Simpul Komputasi Spot/Prioritas rendah di setiap status.

poolId
  • string

ID Kumpulan.

PoolNodeCountsListResult

Hasil daftar jumlah Simpul Komputasi di Akun.

Name Type Description
odata.nextLink
  • string

URL untuk mendapatkan serangkaian hasil berikutnya.

value

Daftar Jumlah Simpul Komputasi menurut Kumpulan.