Job - Get Task Counts

Service:

Batch Service

API Version:

2023-11-01.18.0

Belirtilen İş için Görev sayılarını alır.
Görev sayıları etkin, çalıştırılan veya tamamlanan Görev durumuna göre Görevlerin sayısını ve başarılı veya başarısız olan Görevlerin sayısını sağlar. Hazırlık durumundaki görevler çalışıyor olarak sayılır. Döndürülen sayıların her zaman güncel olmayabileceğini unutmayın. Tam görev sayılarına ihtiyacınız varsa, bir liste sorgusu kullanın.

GET {batchUrl}/jobs/{jobId}/taskcounts?api-version=2023-11-01.18.0

With optional parameters:

GET {batchUrl}/jobs/{jobId}/taskcounts?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.
jobId	path	True	string	İşin 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ın oluşturduğu istek kimliği, küme ayraçları gibi süsleme içermeyen 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 saati olarak ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

Yanıtlar

Name	Tür	Description
200 OK	TaskCountsResult	Belirtilen İş için Görev sayılarını içeren bir yanıt. Headers client-request-id: string request-id: 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

Job get task counts

Sample Request

HTTP

GET account.region.batch.azure.com/jobs/jobId/taskcounts?api-version=2023-11-01.18.0

Sample Response

Status code:

200

{
  "taskCounts": {
    "active": 5,
    "running": 7,
    "completed": 4,
    "succeeded": 2,
    "failed": 2
  },
  "taskSlotCounts": {
    "active": 5,
    "running": 7,
    "completed": 4,
    "succeeded": 2,
    "failed": 2
  }
}

Tanımlar

Name	Description
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 alınan bir hata iletisi.
TaskCounts	Görev, bir İş için sayılır.
TaskCountsResult	Task ve TaskSlot, bir işin sayısını gösterir.
TaskSlotCounts	TaskSlot, bir İş için sayılır.

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 alınan bir hata iletisi.

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

TaskCounts

Görev, bir İş için sayılır.

Name	Tür	Description
active	integer	Etkin durumdaki Görevlerin sayısı.
completed	integer	Tamamlanmış durumdaki Görevlerin sayısı.
failed	integer	Başarısız olan Görevlerin sayısı. Bir Görev, sonucu (executionInfo özelliğinde bulunur) 'failure' olduğunda başarısız olur.
running	integer	Çalışıyor veya hazırlanıyor durumundaki Görevlerin sayısı.
succeeded	integer	Başarılı olan Görevlerin sayısı. Görev, sonucu (executionInfo özelliğinde bulunur) 'success' ise başarılı olur.

TaskCountsResult

Task ve TaskSlot, bir işin sayısını gösterir.

Name	Tür	Description
taskCounts	TaskCounts	Durum başına Görev sayısı.
taskSlotCounts	TaskSlotCounts	Durum başına Görevler için gereken TaskSlots sayısı.

TaskSlotCounts

TaskSlot, bir İş için sayılır.

Name	Tür	Description
active	integer	Etkin Görevler için TaskSlots sayısı.
completed	integer	Tamamlanan Görevler için TaskSlots sayısı.
failed	integer	Başarısız Görevler için TaskSlots sayısı.
running	integer	Görevleri çalıştırmak için TaskSlots sayısı.
succeeded	integer	Başarılı Görevler için TaskSlots sayısı.