Task - List
Visar en lista över alla aktiviteter som är associerade med det angivna jobbet.
Information om aktiviteter med flera instanser, till exempel affinityId, executionInfo och nodeInfo, refererar till den primära aktiviteten. Använd API:et för listunderaktiviteter för att hämta information om underaktiviteter.
GET {batchUrl}/jobs/{jobId}/tasks?api-version=2023-11-01.18.0
GET {batchUrl}/jobs/{jobId}/tasks?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Bas-URL:en för alla Azure Batch tjänstbegäranden. |
job
|
path | True |
string |
Jobbets ID. |
api-version
|
query | True |
string |
Klient-API-version. |
$expand
|
query |
string |
En OData $expand-sats. |
|
$filter
|
query |
string |
En OData-$filter-sats. Mer information om hur du skapar det här filtret finns i https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-tasks. |
|
$select
|
query |
string |
En OData-$select-sats. |
|
maxresults
|
query |
integer int32 |
Det maximala antalet objekt som ska returneras i svaret. Högst 1 000 aktiviteter kan returneras. |
|
timeout
|
query |
integer int32 |
Den maximala tid som servern kan ägna åt att bearbeta begäran, i sekunder. Standardvärdet är 30 sekunder. |
Begärandehuvud
Media Types: "application/json; odata=minimalmetadata"
Name | Obligatorisk | Typ | Description |
---|---|---|---|
client-request-id |
string uuid |
Den anropargenererade begärandeidentiteten i form av ett GUID utan dekoration, till exempel klammerparenteser, t.ex. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Om servern ska returnera client-request-id i svaret. |
|
ocp-date |
string date-time-rfc1123 |
Den tid då begäran utfärdades. Klientbibliotek anger vanligtvis detta till systemets aktuella klocktid. ange det uttryckligen om du anropar REST-API:et direkt. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Ett svar som innehåller listan över aktiviteter. Sidhuvuden
|
|
Other Status Codes |
Felet från Batch-tjänsten. |
Säkerhet
azure_auth
Microsoft Entra OAuth 2.0-autentiseringskodflöde
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
user_impersonation | Personifiera ditt användarkonto |
Authorization
Typ:
apiKey
I:
header
Exempel
Task list
Exempelbegäran
GET account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0
Exempelsvar
{
"value": [
{
"id": "task1",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task1",
"eTag": "0x8D4125FD1A825A4",
"creationTime": "2016-11-21T22:43:31.4733476Z",
"lastModified": "2016-11-21T22:43:31.4733476Z",
"state": "active",
"stateTransitionTime": "2016-11-21T22:43:31.4733476Z",
"commandLine": "cmd /c echo task1",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 0
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
},
{
"id": "task2",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task2",
"eTag": "0x8D4125FD2153345",
"creationTime": "2016-11-21T22:43:31.6736345Z",
"lastModified": "2016-11-21T22:43:32.1880389Z",
"state": "active",
"stateTransitionTime": "2016-11-21T22:43:31.6736345Z",
"commandLine": "cmd /c echo task2",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 3
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
}
]
}
Definitioner
Name | Description |
---|---|
Access |
De Batch-resurser som token beviljar åtkomst till. |
Affinity |
En lokalitetstips som kan användas av Batch-tjänsten för att välja en beräkningsnod som en aktivitet ska startas på. |
Application |
En referens till ett paket som ska distribueras till beräkningsnoder. |
Authentication |
Inställningarna för en autentiseringstoken som aktiviteten kan använda för att utföra Batch-tjänståtgärder. |
Auto |
Omfånget för den automatiska användaren |
Auto |
Anger parametrarna för den automatiska användare som kör en aktivitet i Batch-tjänsten. |
Batch |
Ett felsvar som tagits emot från Azure Batch-tjänsten. |
Batch |
Ett objekt med ytterligare information som ingår i ett Azure Batch felsvar. |
Cloud |
En Azure Batch aktivitet. |
Cloud |
Resultatet av att visa en lista över aktiviteter i ett jobb. |
Compute |
Referensen till en användartilldelad identitet som är associerad med batchpoolen som en beräkningsnod ska använda. |
Compute |
Information om beräkningsnoden som en aktivitet kördes på. |
Container |
Ett privat containerregister. |
Container |
Platsen för containerns arbetskatalog för uppgift. |
Dependency |
En åtgärd som Batch-tjänsten utför på uppgifter som är beroende av den här aktiviteten. |
Elevation |
Användarens höjdnivå. |
Environment |
En miljövariabel som ska anges i en uppgiftsprocess. |
Error |
Kategorin för felet. |
Error |
Ett felmeddelande som tas emot i ett Azure Batch felsvar. |
Exit |
Hur Batch-tjänsten ska svara om en aktivitet avslutas med en viss slutkod. |
Exit |
Ett intervall med slutkoder och hur Batch-tjänsten ska svara på slutkoder inom det intervallet. |
Exit |
Anger hur Batch-tjänsten ska svara när uppgiften har slutförts. |
Exit |
Anger hur Batch-tjänsten svarar på ett visst avslutsvillkor. |
Http |
Ett namn/värde-par för HTTP-huvud |
Job |
En åtgärd att vidta för jobbet som innehåller aktiviteten, om aktiviteten slutförs med det angivna avslutsvillkoret och jobbets onTaskFailed-egenskap är "performExitOptionsJobAction". |
Multi |
Inställningar som anger hur du kör en aktivitet med flera instanser. |
Name |
Representerar ett namn/värde-par. |
Output |
En specifikation för att ladda upp filer från en Azure Batch Beräkningsnod till en annan plats när Batch-tjänsten har slutfört körningen av aktivitetsprocessen. |
Output |
Anger ett filuppladdningsmål i en Azure Blob Storage-container. |
Output |
Målet som en fil ska laddas upp till. |
Output |
De villkor under vilka en aktivitetsutdatafil eller uppsättning filer ska laddas upp. |
Output |
Information om en överföringsåtgärd för utdatafiler, inklusive under vilka villkor för att utföra uppladdningen. |
Resource |
En enskild fil eller flera filer som ska laddas ned till en beräkningsnod. |
Task |
Körningsbegränsningar som ska tillämpas på en aktivitet. |
Task |
Innehåller information om containern som en aktivitet körs i. |
Task |
Containerinställningarna för en aktivitet. |
Task |
Anger eventuella beroenden för en aktivitet. Alla aktiviteter som uttryckligen anges eller inom ett beroendeintervall måste slutföras innan den beroende aktiviteten schemaläggs. |
Task |
Information om körning av en aktivitet. |
Task |
Resultatet av aktivitetskörningen. |
Task |
Information om ett aktivitetsfel. |
Task |
Ett intervall med aktivitets-ID:t som en aktivitet kan vara beroende av. Alla aktiviteter med ID:t i intervallet måste slutföras innan den beroende aktiviteten kan schemaläggas. |
Task |
Status för aktiviteten. |
Task |
Resursanvändningsstatistik för en aktivitet. |
User |
Definitionen av den användaridentitet som aktiviteten körs under. |
AccessScope
De Batch-resurser som token beviljar åtkomst till.
Name | Typ | Description |
---|---|---|
job |
string |
Ger åtkomst för att utföra alla åtgärder på jobbet som innehåller aktiviteten. |
AffinityInformation
En lokalitetstips som kan användas av Batch-tjänsten för att välja en beräkningsnod som en aktivitet ska startas på.
Name | Typ | Description |
---|---|---|
affinityId |
string |
En täckande sträng som representerar platsen för en beräkningsnod eller en aktivitet som har körts tidigare. |
ApplicationPackageReference
En referens till ett paket som ska distribueras till beräkningsnoder.
Name | Typ | Description |
---|---|---|
applicationId |
string |
ID för programmet som ska distribueras. |
version |
string |
Den version av programmet som ska distribueras. Om den utelämnas distribueras standardversionen. |
AuthenticationTokenSettings
Inställningarna för en autentiseringstoken som aktiviteten kan använda för att utföra Batch-tjänståtgärder.
Name | Typ | Description |
---|---|---|
access |
De Batch-resurser som token ger åtkomst till. |
AutoUserScope
Omfånget för den automatiska användaren
Name | Typ | Description |
---|---|---|
pool |
string |
Anger att aktiviteten körs som det vanliga automatiska användarkontot som skapas på varje beräkningsnod i en pool. |
task |
string |
Anger att tjänsten ska skapa en ny användare för uppgiften. |
AutoUserSpecification
Anger parametrarna för den automatiska användare som kör en aktivitet i Batch-tjänsten.
Name | Typ | Description |
---|---|---|
elevationLevel |
Höjdnivån för den automatiska användaren. |
|
scope |
Omfånget för den automatiska användaren |
BatchError
Ett felsvar som tagits emot från Azure Batch-tjänsten.
Name | Typ | Description |
---|---|---|
code |
string |
En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt. |
message |
Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt. |
|
values |
En samling nyckel/värde-par som innehåller ytterligare information om felet. |
BatchErrorDetail
Ett objekt med ytterligare information som ingår i ett Azure Batch felsvar.
Name | Typ | Description |
---|---|---|
key |
string |
En identifierare som anger innebörden av egenskapen Value. |
value |
string |
Den ytterligare information som ingår i felsvaret. |
CloudTask
En Azure Batch aktivitet.
Name | Typ | Description |
---|---|---|
affinityInfo |
En lokalitetstips som kan användas av Batch-tjänsten för att välja en beräkningsnod som den nya aktiviteten ska startas på. |
|
applicationPackageReferences |
En lista över paket som Batch-tjänsten distribuerar till beräkningsnoden innan kommandoraden körs. |
|
authenticationTokenSettings |
Inställningarna för en autentiseringstoken som aktiviteten kan använda för att utföra Batch-tjänståtgärder. |
|
commandLine |
string |
Kommandoraden för aktiviteten. |
constraints |
De körningsbegränsningar som gäller för den här aktiviteten. |
|
containerSettings |
Inställningarna för containern under vilken aktiviteten körs. |
|
creationTime |
string |
Tiden då aktiviteten skapades. |
dependsOn |
De aktiviteter som den här aktiviteten är beroende av. |
|
displayName |
string |
Ett visningsnamn för aktiviteten. |
eTag |
string |
ETag för uppgiften. |
environmentSettings |
En lista över miljövariabelinställningar för aktiviteten. |
|
executionInfo |
Information om körningen av uppgiften. |
|
exitConditions |
Anger hur Batch-tjänsten ska svara när uppgiften har slutförts. |
|
id |
string |
En sträng som unikt identifierar uppgiften i jobbet. |
lastModified |
string |
Senast ändrad tid för aktiviteten. |
multiInstanceSettings |
Ett objekt som anger att aktiviteten är en aktivitet med flera instanser och innehåller information om hur du kör multiinstansaktiviteten. |
|
nodeInfo |
Information om beräkningsnoden som aktiviteten kördes på. |
|
outputFiles |
En lista över filer som Batch-tjänsten laddar upp från beräkningsnoden när kommandoraden har körts. |
|
previousState |
Det tidigare tillståndet för aktiviteten. |
|
previousStateTransitionTime |
string |
Den tidpunkt då aktiviteten övergick till sitt tidigare tillstånd. |
requiredSlots |
integer |
Antalet schemaläggningsplatser som aktiviteten kräver för att köras. |
resourceFiles |
En lista över filer som Batch-tjänsten laddar ned till beräkningsnoden innan du kör kommandoraden. |
|
state |
Aktivitetens aktuella tillstånd. |
|
stateTransitionTime |
string |
Den tid då aktiviteten övergick till sitt aktuella tillstånd. |
stats |
Resursanvändningsstatistik för aktiviteten. |
|
url |
string |
Url:en för aktiviteten. |
userIdentity |
Användaridentiteten som aktiviteten körs under. |
CloudTaskListResult
Resultatet av att visa en lista över aktiviteter i ett jobb.
Name | Typ | Description |
---|---|---|
odata.nextLink |
string |
URL:en för att hämta nästa uppsättning resultat. |
value |
Listan över aktiviteter. |
ComputeNodeIdentityReference
Referensen till en användartilldelad identitet som är associerad med batchpoolen som en beräkningsnod ska använda.
Name | Typ | Description |
---|---|---|
resourceId |
string |
ARM-resurs-ID för den användartilldelade identiteten. |
ComputeNodeInformation
Information om beräkningsnoden som en aktivitet kördes på.
Name | Typ | Description |
---|---|---|
affinityId |
string |
En identifierare för noden som aktiviteten kördes på, som kan skickas när en aktivitet läggs till för att begära att aktiviteten schemaläggs på den här beräkningsnoden. |
nodeId |
string |
ID:t för beräkningsnoden som aktiviteten kördes på. |
nodeUrl |
string |
URL:en för beräkningsnoden som aktiviteten kördes på. |
poolId |
string |
ID:t för poolen som aktiviteten kördes på. |
taskRootDirectory |
string |
Rotkatalogen för aktiviteten på beräkningsnoden. |
taskRootDirectoryUrl |
string |
URL:en till rotkatalogen för aktiviteten på beräkningsnoden. |
ContainerRegistry
Ett privat containerregister.
Name | Typ | Description |
---|---|---|
identityReference |
Referensen till den användartilldelade identitet som ska användas för att komma åt en Azure Container Registry i stället för användarnamn och lösenord. |
|
password |
string |
Lösenordet för att logga in på registerservern. |
registryServer |
string |
Registrets URL. |
username |
string |
Användarnamnet för att logga in på registerservern. |
ContainerWorkingDirectory
Platsen för containerns arbetskatalog för uppgift.
Name | Typ | Description |
---|---|---|
containerImageDefault |
string |
Använd arbetskatalogen som definierats i containern Avbildning. Se upp för att den här katalogen inte innehåller de resursfiler som laddats ned av Batch. |
taskWorkingDirectory |
string |
Använd arbetskatalogen för Batch-tjänstens standardtjänst, som innehåller de aktivitetsresursfiler som fylls i av Batch. |
DependencyAction
En åtgärd som Batch-tjänsten utför på uppgifter som är beroende av den här aktiviteten.
Name | Typ | Description |
---|---|---|
block |
string |
Blockerar aktiviteter som väntar på den här aktiviteten, vilket förhindrar att de schemaläggs. |
satisfy |
string |
Utför uppgifter som väntar på den här aktiviteten. När alla beroenden är uppfyllda schemaläggs aktiviteten att köras. |
ElevationLevel
Användarens höjdnivå.
Name | Typ | Description |
---|---|---|
admin |
string |
Användaren är en användare med förhöjd åtkomst och fungerar med fullständiga administratörsbehörigheter. |
nonadmin |
string |
Användaren är en standardanvändare utan förhöjd åtkomst. |
EnvironmentSetting
En miljövariabel som ska anges i en uppgiftsprocess.
Name | Typ | Description |
---|---|---|
name |
string |
Namnet på miljövariabeln. |
value |
string |
Värdet för miljövariabeln. |
ErrorCategory
Kategorin för felet.
Name | Typ | Description |
---|---|---|
servererror |
string |
Felet beror på ett internt serverproblem. |
usererror |
string |
Felet beror på ett användarproblem, till exempel felkonfiguration. |
ErrorMessage
Ett felmeddelande som tas emot i ett Azure Batch felsvar.
Name | Typ | Description |
---|---|---|
lang |
string |
Språkkoden för felmeddelandet |
value |
string |
Texten i meddelandet. |
ExitCodeMapping
Hur Batch-tjänsten ska svara om en aktivitet avslutas med en viss slutkod.
Name | Typ | Description |
---|---|---|
code |
integer |
En processavslutskod. |
exitOptions |
Hur Batch-tjänsten ska svara om uppgiften avslutas med den här slutkoden. |
ExitCodeRangeMapping
Ett intervall med slutkoder och hur Batch-tjänsten ska svara på slutkoder inom det intervallet.
Name | Typ | Description |
---|---|---|
end |
integer |
Den sista slutkoden i intervallet. |
exitOptions |
Hur Batch-tjänsten ska svara om uppgiften avslutas med en slutkod i intervallet start till slut (inklusive). |
|
start |
integer |
Den första slutkoden i intervallet. |
ExitConditions
Anger hur Batch-tjänsten ska svara när uppgiften har slutförts.
Name | Typ | Description |
---|---|---|
default |
Hur Batch-tjänsten ska svara om uppgiften misslyckas med ett avslutsvillkor som inte omfattas av någon av de andra egenskaperna. |
|
exitCodeRanges |
En lista över aktivitetsavslutskodintervall och hur Batch-tjänsten ska svara på dem. |
|
exitCodes |
En lista över enskilda aktivitetsavslutskoder och hur Batch-tjänsten ska svara på dem. |
|
fileUploadError |
Hur Batch-tjänsten ska svara om ett filuppladdningsfel uppstår. |
|
preProcessingError |
Hur Batch-tjänsten ska svara om uppgiften inte startar på grund av ett fel. |
ExitOptions
Anger hur Batch-tjänsten svarar på ett visst avslutsvillkor.
Name | Typ | Description |
---|---|---|
dependencyAction |
En åtgärd som Batch-tjänsten utför på uppgifter som är beroende av den här uppgiften. |
|
jobAction |
En åtgärd att vidta för jobbet som innehåller uppgiften, om aktiviteten slutförs med det angivna avslutsvillkoret och jobbets onTaskFailed-egenskap är "performExitOptionsJobAction". |
HttpHeader
Ett namn/värde-par för HTTP-huvud
Name | Typ | Description |
---|---|---|
name |
string |
Det skiftlägeskänsliga namnet på rubriken som ska användas vid uppladdning av utdatafiler |
value |
string |
Värdet för rubriken som ska användas vid uppladdning av utdatafiler |
JobAction
En åtgärd att vidta för jobbet som innehåller aktiviteten, om aktiviteten slutförs med det angivna avslutsvillkoret och jobbets onTaskFailed-egenskap är "performExitOptionsJobAction".
Name | Typ | Description |
---|---|---|
disable |
string |
Inaktivera jobbet. Detta motsvarar anropet av jobb-API:et disable, med värdet disableTasks för att fråga igen. |
none |
string |
Vidta inga åtgärder. |
terminate |
string |
Avsluta jobbet. TerminateReason i jobbets executionInfo är inställd på "TaskFailed". |
MultiInstanceSettings
Inställningar som anger hur du kör en aktivitet med flera instanser.
Name | Typ | Description |
---|---|---|
commonResourceFiles |
En lista över filer som Batch-tjänsten laddar ned innan du kör kommandoraden för samordning. |
|
coordinationCommandLine |
string |
Kommandoraden som ska köras på alla beräkningsnoder så att de kan samordna när den primära kör huvuduppgiftskommandot. |
numberOfInstances |
integer |
Antalet beräkningsnoder som krävs av aktiviteten. |
NameValuePair
Representerar ett namn/värde-par.
Name | Typ | Description |
---|---|---|
name |
string |
Namnet i namn/värde-paret. |
value |
string |
Värdet i namn/värde-paret. |
OutputFile
En specifikation för att ladda upp filer från en Azure Batch Beräkningsnod till en annan plats när Batch-tjänsten har slutfört körningen av aktivitetsprocessen.
Name | Typ | Description |
---|---|---|
destination |
Målet för utdatafilerna. |
|
filePattern |
string |
Ett mönster som anger vilka filer som ska laddas upp. |
uploadOptions |
Ytterligare alternativ för uppladdningsåtgärden, inklusive under vilka villkor för att utföra uppladdningen. |
OutputFileBlobContainerDestination
Anger ett filuppladdningsmål i en Azure Blob Storage-container.
Name | Typ | Description |
---|---|---|
containerUrl |
string |
URL:en för containern i Azure Blob Storage som filen/filerna ska laddas upp till. |
identityReference |
Referensen till den användartilldelade identitet som ska användas för att komma åt Azure Blob Storage som anges av containerUrl |
|
path |
string |
Målbloben eller den virtuella katalogen i Azure Storage-containern. |
uploadHeaders |
En lista över namn/värde-par för rubriker som ska användas vid uppladdning av utdatafiler |
OutputFileDestination
Målet som en fil ska laddas upp till.
Name | Typ | Description |
---|---|---|
container |
En plats i Azure Blob Storage som filer laddas upp till. |
OutputFileUploadCondition
De villkor under vilka en aktivitetsutdatafil eller uppsättning filer ska laddas upp.
Name | Typ | Description |
---|---|---|
taskcompletion |
string |
Ladda upp filen/filerna när uppgiftsprocessen har avslutats, oavsett vilken slutkod det var. |
taskfailure |
string |
Ladda upp filen/filerna först när aktivitetsprocessen avslutas med en slutkod som inte är noll. |
tasksuccess |
string |
Ladda upp filen/filerna först när aktivitetsprocessen avslutas med slutkoden 0. |
OutputFileUploadOptions
Information om en överföringsåtgärd för utdatafiler, inklusive under vilka villkor för att utföra uppladdningen.
Name | Typ | Description |
---|---|---|
uploadCondition |
De villkor under vilka uppgiftsutdatafilen eller uppsättningen filer ska laddas upp. |
ResourceFile
En enskild fil eller flera filer som ska laddas ned till en beräkningsnod.
Name | Typ | Description |
---|---|---|
autoStorageContainerName |
string |
Namnet på lagringscontainern i det automatiska lagringskontot. |
blobPrefix |
string |
Blobprefixet som ska användas vid nedladdning av blobar från en Azure Storage-container. Endast de blobbar vars namn börjar med det angivna prefixet laddas ned. |
fileMode |
string |
Attributet för filbehörighetsläge i oktalt format. |
filePath |
string |
Platsen på beräkningsnoden som filen eller filerna ska laddas ned till i förhållande till aktivitetens arbetskatalog. |
httpUrl |
string |
URL:en för filen som ska laddas ned. |
identityReference |
Referensen till den användartilldelade identitet som ska användas för att komma åt Azure Blob Storage som anges av storageContainerUrl eller httpUrl |
|
storageContainerUrl |
string |
URL:en för blobcontainern i Azure Blob Storage. |
TaskConstraints
Körningsbegränsningar som ska tillämpas på en aktivitet.
Name | Typ | Description |
---|---|---|
maxTaskRetryCount |
integer |
Det maximala antalet gånger som aktiviteten kan försökas igen. Batch-tjänsten försöker utföra en aktivitet igen om dess slutkod inte är noll. |
maxWallClockTime |
string |
Den maximala förflutna tiden som aktiviteten kan köras, mätt från den tidpunkt då aktiviteten startar. Om aktiviteten inte slutförs inom tidsgränsen avslutar Batch-tjänsten den. |
retentionTime |
string |
Den minsta tid det tar att behålla aktivitetskatalogen på den beräkningsnod där den kördes, från den tidpunkt då körningen slutfördes. Efter den här tiden kan Batch-tjänsten ta bort aktivitetskatalogen och allt dess innehåll. |
TaskContainerExecutionInformation
Innehåller information om containern som en aktivitet körs i.
Name | Typ | Description |
---|---|---|
containerId |
string |
Containerns ID. |
error |
string |
Detaljerad felinformation om containern. |
state |
string |
Containerns tillstånd. |
TaskContainerSettings
Containerinställningarna för en aktivitet.
Name | Typ | Description |
---|---|---|
containerRunOptions |
string |
Ytterligare alternativ för kommandot container create. |
imageName |
string |
Avbildningen som ska användas för att skapa containern där aktiviteten ska köras. |
registry |
Det privata registret som innehåller containern Image. |
|
workingDirectory |
Platsen för containerns arbetskatalog för uppgift. |
TaskDependencies
Anger eventuella beroenden för en aktivitet. Alla aktiviteter som uttryckligen anges eller inom ett beroendeintervall måste slutföras innan den beroende aktiviteten schemaläggs.
Name | Typ | Description |
---|---|---|
taskIdRanges |
Listan över aktivitets-ID-intervall som den här aktiviteten är beroende av. Alla aktiviteter i alla intervall måste slutföras innan den beroende aktiviteten kan schemaläggas. |
|
taskIds |
string[] |
Listan över aktivitets-ID:t som den här aktiviteten är beroende av. Alla aktiviteter i den här listan måste slutföras innan den beroende aktiviteten kan schemaläggas. |
TaskExecutionInformation
Information om körning av en aktivitet.
Name | Typ | Description |
---|---|---|
containerInfo |
Information om containern som aktiviteten körs under. |
|
endTime |
string |
Tidpunkt då aktiviteten slutfördes. |
exitCode |
integer |
Slutkoden för programmet som anges på kommandoraden Aktivitet. |
failureInfo |
Information som beskriver aktivitetsfelet, om det finns någon. |
|
lastRequeueTime |
string |
Den senaste gången aktiviteten har begärts på nytt av Batch-tjänsten som ett resultat av en användarbegäran. |
lastRetryTime |
string |
Den senaste gången ett återförsök av aktiviteten började köras. |
requeueCount |
integer |
Antalet gånger som uppgiften har begärts på nytt av Batch-tjänsten som ett resultat av en användarbegäran. |
result |
Resultatet av aktivitetskörningen. |
|
retryCount |
integer |
Antalet gånger som uppgiften har gjorts om av Batch-tjänsten. |
startTime |
string |
Den tidpunkt då aktiviteten började köras. |
TaskExecutionResult
Resultatet av aktivitetskörningen.
Name | Typ | Description |
---|---|---|
failure |
string |
Ett fel uppstod under bearbetningen av aktiviteten. Felet kan ha inträffat innan aktivitetsprocessen startades, medan aktivitetsprocessen kördes eller efter att uppgiftsprocessen avslutades. |
success |
string |
Uppgiften har körts. |
TaskFailureInformation
Information om ett aktivitetsfel.
Name | Typ | Description |
---|---|---|
category |
Kategorin för aktivitetsfelet. |
|
code |
string |
En identifierare för aktivitetsfelet. Koder är invarianta och är avsedda att användas programmatiskt. |
details |
En lista med ytterligare information som rör felet. |
|
message |
string |
Ett meddelande som beskriver aktivitetsfelet, avsett att vara lämpligt för visning i ett användargränssnitt. |
TaskIdRange
Ett intervall med aktivitets-ID:t som en aktivitet kan vara beroende av. Alla aktiviteter med ID:t i intervallet måste slutföras innan den beroende aktiviteten kan schemaläggas.
Name | Typ | Description |
---|---|---|
end |
integer |
Det sista aktivitets-ID:t i intervallet. |
start |
integer |
Det första aktivitets-ID:t i intervallet. |
TaskState
Status för aktiviteten.
Name | Typ | Description |
---|---|---|
active |
string |
Uppgiften placeras i kö och kan köras, men är för närvarande inte tilldelad till en beräkningsnod. En aktivitet anger det här tillståndet när den skapas, när den är aktiverad efter att den har inaktiverats eller när den väntar på ett nytt försök efter en misslyckad körning. |
completed |
string |
Aktiviteten är inte längre berättigad att köras, vanligtvis på grund av att aktiviteten har slutförts, eller så har aktiviteten slutförts utan framgång och har överskridit gränsen för återförsök. En aktivitet markeras också som slutförd om ett fel uppstod när aktiviteten startades eller när aktiviteten har avslutats. |
preparing |
string |
Aktiviteten har tilldelats till en beräkningsnod, men väntar på att en obligatorisk jobbförberedelseaktivitet ska slutföras på beräkningsnoden. Om jobbförberedelseaktiviteten lyckas flyttas aktiviteten till att köras. Om jobbförberedelseaktiviteten misslyckas återgår aktiviteten till aktiv och är berättigad att tilldelas till en annan beräkningsnod. |
running |
string |
Aktiviteten körs på en beräkningsnod. Detta inkluderar förberedelse på aktivitetsnivå, till exempel nedladdning av resursfiler eller distribution av paket som anges i aktiviteten – det betyder inte nödvändigtvis att kommandoraden Aktivitet har börjat köras. |
TaskStatistics
Resursanvändningsstatistik för en aktivitet.
Name | Typ | Description |
---|---|---|
kernelCPUTime |
string |
Den totala cpu-tiden för kernelläge (summerad över alla kärnor och alla beräkningsnoder) som används av aktiviteten. |
lastUpdateTime |
string |
Tidpunkten då statistiken senast uppdaterades. All statistik är begränsad till intervallet mellan startTime och lastUpdateTime. |
readIOGiB |
number |
Det totala antalet gibibyte som lästs från disken av aktiviteten. |
readIOps |
integer |
Det totala antalet diskläsningsåtgärder som aktiviteten utför. |
startTime |
string |
Starttiden för det tidsintervall som omfattas av statistiken. |
url |
string |
URL:en för statistiken. |
userCPUTime |
string |
Den totala cpu-tiden för användarläge (summerad över alla kärnor och alla beräkningsnoder) som används av aktiviteten. |
waitTime |
string |
Den totala väntetiden för aktiviteten. Väntetiden för en aktivitet definieras som den förflutna tiden mellan skapandet av aktiviteten och starten av aktivitetskörningen. (Om aktiviteten görs om på grund av fel är väntetiden den senaste aktivitetskörningen.) |
wallClockTime |
string |
Den totala klocktiden för aktiviteten. |
writeIOGiB |
number |
Det totala antalet gibibyte som skrivits till disken av aktiviteten. |
writeIOps |
integer |
Det totala antalet diskskrivningsåtgärder som aktiviteten utför. |
UserIdentity
Definitionen av den användaridentitet som aktiviteten körs under.
Name | Typ | Description |
---|---|---|
autoUser |
Den automatiska användare som aktiviteten körs under. |
|
username |
string |
Namnet på den användaridentitet som aktiviteten körs under. |