Pools - List Pool Node Counts

Hizmet:: Batch Service

API Sürümü:: 2025-06-01

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 {endpoint}/nodecounts?api-version=2025-06-01

İsteğe bağlı parametrelerle:

GET {endpoint}/nodecounts?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}

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).
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
$filter	query		string	OData $filter yan tümcesi. Bu filtrenin oluşturulması hakkında daha fazla bilgi için bkz.https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-support-images
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Yanıtta döndürülecek en fazla öğe sayısı. En fazla 1000 başvuru iade edilebilir.
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ığı

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

Yanıtlar

Name	Tür	Description
200 OK	BatchPoolNodeCountsListResult	İstek başarılı oldu. Üst Bilgiler ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Beklenmeyen bir hata yanıtı.

Name

Tür

Description

200 OK

BatchPoolNodeCountsListResult

İstek başarılı oldu.

Üst Bilgiler

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

NodeCountsPayload

Örnek isteği

HTTP

GET {endpoint}/nodecounts?api-version=2025-06-01

Ö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.
BatchErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.
BatchNodeCounts	Her İşlem Düğümü durumundaki İşlem Düğümlerinin sayısı.
BatchPoolNodeCounts	Havuz için her durumdaki İşlem Düğümlerinin sayısı.
BatchPoolNodeCountsListResult	Hesaptaki İşlem Düğümü sayılarını listelemenin sonucu.

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.

BatchNodeCounts

Nesne

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

Name	Tür	Description
creating	integer (int32)	Oluşturma durumundaki Hesaplama Düğüm sayısı.
deallocated	integer (int32)	Hesap Noktası eyaletindeki Hesaplama Düğüm sayısı.
deallocating	integer (int32)	Deallocationing durumundaki Compute Node sayısı.
idle	integer (int32)	Boşta olan Compute Node sayısı.
leavingPool	integer (int32)	Leaving Pool durumundaki Compute Node sayısı.
offline	integer (int32)	Çevrimdışı durumdaki Hesaplama Düğüm sayısı.
preempted	integer (int32)	Öncelikli durumdaki Hesaplama Düğüm sayısı.
rebooting	integer (int32)	Yeniden başlatma durumundaki Compute Node'ların sayısı.
reimaging	integer (int32)	Yeniden görüntüleme durumundaki Hesaplama Düğüm sayısı.
running	integer (int32)	Çalışan durumdaki Hesaplama Düğüm sayısı.
startTaskFailed	integer (int32)	startTaskFailed durumundaki Compute Node sayısı.
starting	integer (int32)	Başlangıç durumundaki Hesaplama Düğüm sayısı.
total	integer (int32)	Toplam Hesaplama Düğüm sayısı.
unknown	integer (int32)	Bilinmeyen durumdaki Hesaplama Düğüm sayısı.
unusable	integer (int32)	Kullanılamaz durumdaki Hesaplama Düğümlerinin sayısı.
upgradingOS	integer (int32)	UpgradeOS durumundaki Compute Node sayısı.
waitingForStartTask	integer (int32)	waitingForStartTask durumundaki Compute Düğüm sayısı.

BatchPoolNodeCounts

Nesne

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

Name	Tür	Description
dedicated	BatchNodeCounts	Her eyalette özel Hesaplama Düğümlerinin sayısı.
lowPriority	BatchNodeCounts	Her eyaletteki Spot/Düşük Öncelikli Hesaplama Düğümü sayısı.
poolId	string	Havuzun kimliği.

BatchPoolNodeCountsListResult

Nesne

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

Name	Tür	Description
odata.nextLink	string (uri)	Bir sonraki sonuç kümesini almak için URL.
value	BatchPoolNodeCounts[]	Havuza göre Compute Node sayımlarının listesi.

Aracılığıyla paylaş

Pools - List Pool Node Counts

URI Parametreleri

İstek Başlığı

Yanıtlar

Güvenlik

OAuth2Auth

Kapsamlar

Örnekler

NodeCountsPayload

Örnek isteği

Örnek yanıt

Tanımlar

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeCounts

BatchPoolNodeCounts

BatchPoolNodeCountsListResult