Job - Get Task Counts
Získá počet úloh pro zadanou úlohu.
Počty úkolů poskytují počet úkolů podle stavu aktivních, spuštěných nebo dokončených úkolů a počet úspěšných nebo neúspěšných úkolů. Úkoly ve stavu přípravy se počítají jako spuštěné. Všimněte si, že vrácená čísla nemusí být vždy aktuální. Pokud potřebujete přesné počty úkolů, použijte dotaz na seznam.
GET {batchUrl}/jobs/{jobId}/taskcounts?api-version=2023-11-01.18.0
GET {batchUrl}/jobs/{jobId}/taskcounts?timeout={timeout}&api-version=2023-11-01.18.0
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Základní adresa URL pro všechny požadavky služby Azure Batch. |
job
|
path | True |
string |
ID úlohy. |
api-version
|
query | True |
string |
Verze klientského rozhraní API. |
timeout
|
query |
integer int32 |
Maximální čas, který může server strávit zpracováním požadavku, v sekundách. Výchozí hodnota je 30 sekund. |
Hlavička požadavku
Media Types: "application/json; odata=minimalmetadata"
Name | Vyžadováno | Typ | Description |
---|---|---|---|
client-request-id |
string uuid |
Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez ozdob, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Jestli má server v odpovědi vrátit client-request-id. |
|
ocp-date |
string date-time-rfc1123 |
Čas, kdy byla žádost vystavena. Klientské knihovny obvykle tuto možnost nastaví na aktuální systémový čas. pokud přímo voláte rozhraní REST API, nastavte ho explicitně. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Odpověď obsahující počet úkolů pro zadanou úlohu. Hlavičky
|
|
Other Status Codes |
Chyba ze služby Batch. |
Zabezpečení
azure_auth
Microsoft Entra tok kódu ověřování OAuth 2.0
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | Zosobnění uživatelského účtu |
Authorization
Typ:
apiKey
V:
header
Příklady
Job get task counts
Ukázkový požadavek
GET account.region.batch.azure.com/jobs/jobId/taskcounts?api-version=2023-11-01.18.0
Ukázková odpověď
{
"taskCounts": {
"active": 5,
"running": 7,
"completed": 4,
"succeeded": 2,
"failed": 2
},
"taskSlotCounts": {
"active": 5,
"running": 7,
"completed": 4,
"succeeded": 2,
"failed": 2
}
}
Definice
Name | Description |
---|---|
Batch |
Ze služby Azure Batch byla přijata chybová odpověď. |
Batch |
Položka s dalšími informacemi, které jsou součástí Azure Batch odpovědi na chybu. |
Error |
Chybová zpráva přijatá v Azure Batch odpověď na chybu. |
Task |
Úkol se počítá pro úlohu. |
Task |
Task a TaskSlot se počítají pro úlohu. |
Task |
TaskSlot se počítá pro úlohu. |
BatchError
Ze služby Azure Batch byla přijata chybová odpověď.
Name | Typ | Description |
---|---|---|
code |
string |
Identifikátor chyby. Kódy jsou invariantní a mají být využívány programově. |
message |
Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní. |
|
values |
Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě. |
BatchErrorDetail
Položka s dalšími informacemi, které jsou součástí Azure Batch odpovědi na chybu.
Name | Typ | Description |
---|---|---|
key |
string |
Identifikátor určující význam vlastnosti Value. |
value |
string |
Další informace zahrnuté v chybové odpovědi. |
ErrorMessage
Chybová zpráva přijatá v Azure Batch odpověď na chybu.
Name | Typ | Description |
---|---|---|
lang |
string |
Kód jazyka chybové zprávy |
value |
string |
Text zprávy. |
TaskCounts
Úkol se počítá pro úlohu.
Name | Typ | Description |
---|---|---|
active |
integer |
Počet úkolů v aktivním stavu. |
completed |
integer |
Počet úkolů v dokončeném stavu. |
failed |
integer |
Počet úkolů, které selhaly. Úloha selže, pokud její výsledek (nachází se ve vlastnosti executionInfo) je "selhání". |
running |
integer |
Počet úkolů ve stavu spuštěných nebo přípravných. |
succeeded |
integer |
Počet úspěšných úkolů. Úkol je úspěšný, pokud jeho výsledek (nachází se ve vlastnosti executionInfo) je "úspěch". |
TaskCountsResult
Task a TaskSlot se počítají pro úlohu.
Name | Typ | Description |
---|---|---|
taskCounts |
Počet úkolů na stav. |
|
taskSlotCounts |
Počet úkolů požadovaných úkoly na stav. |
TaskSlotCounts
TaskSlot se počítá pro úlohu.
Name | Typ | Description |
---|---|---|
active |
integer |
Počet objektů taskSlots pro aktivní úkoly. |
completed |
integer |
Počet objektů taskSlots pro dokončené úkoly. |
failed |
integer |
Počet objektů taskSlots pro neúspěšné úkoly. |
running |
integer |
Počet objektů taskSlots pro spuštěné úlohy. |
succeeded |
integer |
Počet objektů taskSlots pro úspěšné úkoly. |