Aracılığıyla paylaş

Account - List Pool Node Counts

  • Başvuru
Hizmet:
Batch Service
API Sürümü:
2024-07-01.20.0

Havuza göre gruplandırılmış her durumdaki İşlem Düğümlerinin sayısını alır. Döndürülen sayıların her zaman güncel olmayabileceğini unutmayın. Tam düğüm sayılarına ihtiyacınız varsa bir liste sorgusu kullanın.

GET {batchUrl}/nodecounts?api-version=2024-07-01.20.0
İsteğe bağlı parametrelerle: 
GET {batchUrl}/nodecounts?$filter={$filter}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

URI Parametreleri

Name İçinde Gerekli Tür Description
batchUrl
 path True

string

Tüm Azure Batch hizmet isteklerinin temel URL'si.
api-version
 query True

string

İstemci API Sürümü.
$filter
 query

string

OData $filter yan tümcesi. Bu filtreyi oluşturma hakkında daha fazla bilgi için bkz. https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
maxresults
 query

integer (int32)

minimum: 1
maximum: 10

Yanıtta döndürülecek en fazla öğe sayısı.
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, bunun yerine varsayılan değer kullanılır.

İstek Başlığı

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

Name Gerekli Tür Description
client-request-id

string (uuid)

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-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.

Yanıtlar

Name Tür Description
200 OK

PoolNodeCountsListResult

Yanıt, havuza göre gruplandırılmış her İşlem Düğümü durumundaki İşlem Düğümlerinin sayısını içerir.

Üst Bilgiler

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

BatchError

Batch hizmetinden gelen hata.

Güvenlik

azure_auth

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

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

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

Authorization

Tür: apiKey
İçinde: header

Örnekler

NodeCountsPayload

Örnek isteği

GET account.region.batch.azure.com/nodecounts?api-version=2024-07-01.20.0

Örnek yanıt

Durum kodu:
200 
{
  "value": [
    {
      "poolId": "pool1",
      "dedicated": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 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,
        "upgradingOS": 0,
        "total": 0
      },
      "lowPriority": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 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,
        "upgradingOS": 0,
        "total": 3
      }
    },
    {
      "poolId": "pool2",
      "dedicated": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 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,
        "upgradingOS": 0,
        "total": 4
      },
      "lowPriority": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 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,
        "upgradingOS": 0,
        "total": 0
      }
    },
    {
      "poolId": "pool3",
      "dedicated": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 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,
        "upgradingOS": 0,
        "total": 9
      },
      "lowPriority": {
        "creating": 7,
        "deallocated": 0,
        "deallocating": 0,
        "idle": 0,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 4,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "upgradingOS": 0,
        "total": 11
      }
    }
  ]
}

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.
ErrorMessage

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

Her İşlem Düğümü durumundaki İşlem Düğümlerinin sayısı.
PoolNodeCounts

Havuz için her durumdaki İşlem Düğümlerinin sayısı.
PoolNodeCountsListResult

Hesaptaki İşlem Düğümü sayılarını listelemenin sonucu.

BatchError

Object

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[]

Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Object

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.

ErrorMessage

Object

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.

NodeCounts

Object

Her İşlem Düğümü durumundaki İşlem Düğümlerinin sayısı.

Name Tür Description
creating

integer (int32)

Oluşturma durumundaki İşlem Düğümlerinin sayısı.
deallocated

integer (int32)

Serbest bırakılmış durumdaki İşlem Düğümlerinin sayısı.
deallocating

integer (int32)

Serbest bırakma durumundaki İşlem Düğümlerinin sayısı.
idle

integer (int32)

Boşta durumundaki İşlem Düğümlerinin sayısı.
leavingPool

integer (int32)

leavingPool durumundaki İşlem Düğümlerinin sayısı.
offline

integer (int32)

Çevrimdışı durumdaki İşlem Düğümlerinin sayısı.
preempted

integer (int32)

Önceden damgalanmış durumdaki İşlem Düğümlerinin sayısı.
rebooting

integer (int32)

Yeniden başlatma durumundaki İşlem Düğümlerinin sayısı.
reimaging

integer (int32)

Yeniden oluşturma durumundaki İşlem Düğümlerinin sayısı.
running

integer (int32)

Çalışma durumundaki İşlem Düğümlerinin sayısı.
startTaskFailed

integer (int32)

startTaskFailed durumundaki İşlem Düğümlerinin sayısı.
starting

integer (int32)

Başlangıç durumundaki İşlem Düğümlerinin sayısı.
total

integer (int32)

toplam İşlem Düğümü sayısı.
unknown

integer (int32)

Bilinmeyen durumdaki İşlem Düğümlerinin sayısı.
unusable

integer (int32)

Kullanılamaz durumdaki İşlem Düğümlerinin sayısı.
upgradingOS

integer (int32)

YükseltmeOS durumundaki İşlem Düğümlerinin sayısı.
waitingForStartTask

integer (int32)

waitingForStartTask durumundaki İşlem Düğümlerinin sayısı.

PoolNodeCounts

Object

Havuz için her durumdaki İşlem Düğümlerinin sayısı.

Name Tür Description
dedicated

NodeCounts

Her durumdaki ayrılmış İşlem Düğümlerinin sayısı.
lowPriority

NodeCounts

Her durumdaki Spot/Düşük öncelikli İşlem Düğümlerinin sayısı.
poolId

string

Havuzun Kimliği.

PoolNodeCountsListResult

Object

Hesaptaki İşlem Düğümü sayılarını listelemenin sonucu.

Name Tür Description
odata.nextLink

string

Sonraki sonuç kümesini almak için URL.
value

PoolNodeCounts[]

Havuza göre İşlem Düğümü sayılarının listesi.