Task - List

Service:

Batch Service

API Version:

2023-11-01.18.0

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

With optional parameters:

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
batchUrl	path	True	string	Bas-URL:en för alla Azure Batch tjänstbegäranden.
jobId	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	CloudTaskListResult	Ett svar som innehåller listan över aktiviteter. Headers client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Felet från Batch-tjänsten.

Säkerhet

azure_auth

Microsoft Entra OAuth 2.0-autentiseringskodflöde

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	Personifiera ditt användarkonto

Authorization

Type: apiKey
In: header

Exempel

Task list

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "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
AccessScope	De Batch-resurser som token beviljar åtkomst till.
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å.
ApplicationPackageReference	En referens till ett paket som ska distribueras till beräkningsnoder.
AuthenticationTokenSettings	Inställningarna för en autentiseringstoken som aktiviteten kan använda för att utföra Batch-tjänståtgärder.
AutoUserScope	Omfånget för den automatiska användaren
AutoUserSpecification	Anger parametrarna för den automatiska användare som kör en aktivitet i Batch-tjänsten.
BatchError	Ett felsvar som tagits emot från Azure Batch-tjänsten.
BatchErrorDetail	Ett objekt med ytterligare information som ingår i ett Azure Batch felsvar.
CloudTask	En Azure Batch aktivitet.
CloudTaskListResult	Resultatet av att visa en lista över aktiviteter i ett jobb.
ComputeNodeIdentityReference	Referensen till en användartilldelad identitet som är associerad med batchpoolen som en beräkningsnod ska använda.
ComputeNodeInformation	Information om beräkningsnoden som en aktivitet kördes på.
ContainerRegistry	Ett privat containerregister.
ContainerWorkingDirectory	Platsen för containerns arbetskatalog för uppgift.
DependencyAction	En åtgärd som Batch-tjänsten utför på uppgifter som är beroende av den här aktiviteten.
ElevationLevel	Användarens höjdnivå.
EnvironmentSetting	En miljövariabel som ska anges i en uppgiftsprocess.
ErrorCategory	Kategorin för felet.
ErrorMessage	Ett felmeddelande som tas emot i ett Azure Batch felsvar.
ExitCodeMapping	Hur Batch-tjänsten ska svara om en aktivitet avslutas med en viss slutkod.
ExitCodeRangeMapping	Ett intervall med slutkoder och hur Batch-tjänsten ska svara på slutkoder inom det intervallet.
ExitConditions	Anger hur Batch-tjänsten ska svara när uppgiften har slutförts.
ExitOptions	Anger hur Batch-tjänsten svarar på ett visst avslutsvillkor.
HttpHeader	Ett namn/värde-par för HTTP-huvud
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".
MultiInstanceSettings	Inställningar som anger hur du kör en aktivitet med flera instanser.
NameValuePair	Representerar ett namn/värde-par.
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.
OutputFileBlobContainerDestination	Anger ett filuppladdningsmål i en Azure Blob Storage-container.
OutputFileDestination	Målet som en fil ska laddas upp till.
OutputFileUploadCondition	De villkor under vilka en aktivitetsutdatafil eller uppsättning filer ska laddas upp.
OutputFileUploadOptions	Information om en överföringsåtgärd för utdatafiler, inklusive under vilka villkor för att utföra uppladdningen.
ResourceFile	En enskild fil eller flera filer som ska laddas ned till en beräkningsnod.
TaskConstraints	Körningsbegränsningar som ska tillämpas på en aktivitet.
TaskContainerExecutionInformation	Innehåller information om containern som en aktivitet körs i.
TaskContainerSettings	Containerinställningarna för en aktivitet.
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.
TaskExecutionInformation	Information om körning av en aktivitet.
TaskExecutionResult	Resultatet av aktivitetskörningen.
TaskFailureInformation	Information om ett aktivitetsfel.
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.
TaskState	Status för aktiviteten.
TaskStatistics	Resursanvändningsstatistik för en aktivitet.
UserIdentity	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. Du kan skicka affinityId för en nod för att ange att den här aktiviteten måste köras på beräkningsnoden. Observera att detta bara är en mjuk tillhörighet. Om mål-beräkningsnoden är upptagen eller otillgänglig när aktiviteten schemaläggs schemaläggs aktiviteten någon annanstans.

ApplicationPackageReference

En referens till ett paket som ska distribueras till beräkningsnoder.

Name	Typ	Description
applicationId	string	ID för programmet som ska distribueras. När du skapar en pool måste paketets program-ID vara fullständigt kvalificerat (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Den version av programmet som ska distribueras. Om den utelämnas distribueras standardversionen. Om detta utelämnas i en pool och ingen standardversion har angetts för det här programmet misslyckas begäran med felkoden InvalidApplicationPackageReferences och HTTP-statuskod 409. Om detta utelämnas för en aktivitet och ingen standardversion har angetts för det här programmet misslyckas uppgiften med ett förbearbetningsfel.

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	AccessScope[]	De Batch-resurser som token ger åtkomst till. Autentiseringstoken ger åtkomst till en begränsad uppsättning Batch-tjänståtgärder. För närvarande är det enda värdet som stöds för åtkomstegenskapen "jobb", vilket ger åtkomst till alla åtgärder som är relaterade till jobbet som innehåller uppgiften.

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	ElevationLevel	Höjdnivån för den automatiska användaren. Standardvärdet är nonAdmin.
scope	AutoUserScope	Omfånget för den automatiska användaren Standardvärdet är pool. Om poolen kör Windows ska värdet Aktivitet anges om striktare isolering mellan aktiviteter krävs. Om uppgiften till exempel muterar registret på ett sätt som kan påverka andra aktiviteter, eller om certifikat har angetts i poolen som inte ska vara tillgängliga för normala aktiviteter men som ska vara tillgängliga av StartTasks.

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	ErrorMessage	Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.
values	BatchErrorDetail[]	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	AffinityInformation	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	ApplicationPackageReference[]	En lista över paket som Batch-tjänsten distribuerar till beräkningsnoden innan kommandoraden körs. Programpaket laddas ned och distribueras till en delad katalog, inte till arbetskatalogen Aktivitet. Om ett refererat paket redan finns på noden och är uppdaterat laddas det därför inte ned igen. den befintliga kopian på beräkningsnoden används. Om det inte går att installera ett refererat paket, till exempel på grund av att paketet har tagits bort eller eftersom nedladdningen misslyckades, misslyckas uppgiften.
authenticationTokenSettings	AuthenticationTokenSettings	Inställningarna för en autentiseringstoken som aktiviteten kan använda för att utföra Batch-tjänståtgärder. Om den här egenskapen anges tillhandahåller Batch-tjänsten uppgiften med en autentiseringstoken som kan användas för att autentisera Batch-tjänståtgärder utan att kräva en kontoåtkomstnyckel. Token tillhandahålls via miljövariabeln AZ_BATCH_AUTHENTICATION_TOKEN. Vilka åtgärder som aktiviteten kan utföra med hjälp av token beror på inställningarna. En aktivitet kan till exempel begära jobbbehörigheter för att lägga till andra aktiviteter i jobbet eller kontrollera status för jobbet eller andra aktiviteter under jobbet.
commandLine	string	Kommandoraden för aktiviteten. För aktiviteter med flera instanser körs kommandoraden som den primära aktiviteten, efter att den primära aktiviteten och alla underaktiviteter har slutfört körningen av kommandoraden för samordning. Kommandoraden körs inte under ett gränssnitt och kan därför inte dra nytta av gränssnittsfunktioner som expansion av miljövariabler. Om du vill dra nytta av sådana funktioner bör du anropa gränssnittet på kommandoraden, till exempel med "cmd /c MyCommand" i Windows eller "/bin/sh -c MyCommand" i Linux. Om kommandoraden refererar till filsökvägar bör den använda en relativ sökväg (i förhållande till arbetskatalogen Uppgift) eller använda miljövariabeln som tillhandahålls av Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
constraints	TaskConstraints	De körningsbegränsningar som gäller för den här aktiviteten.
containerSettings	TaskContainerSettings	Inställningarna för containern under vilken aktiviteten körs. Om den pool som ska köra den här aktiviteten har containerConfiguration angivet måste detta också anges. Om den pool som ska köra uppgiften inte har containerConfiguration angivet får detta inte anges. När detta anges mappas alla kataloger rekursivt under AZ_BATCH_NODE_ROOT_DIR (roten av Azure Batch kataloger på noden) till containern, alla miljövariabler för aktivitet mappas till containern och kommandoraden Task körs i containern. Filer som skapas i containern utanför AZ_BATCH_NODE_ROOT_DIR kanske inte återspeglas på värddisken, vilket innebär att Batch-fil-API:er inte kommer åt dessa filer.
creationTime	string	Tiden då aktiviteten skapades.
dependsOn	TaskDependencies	De aktiviteter som den här aktiviteten är beroende av. Den här aktiviteten schemaläggs inte förrän alla aktiviteter som den är beroende av har slutförts. Om någon av dessa aktiviteter misslyckas och tar bort antalet återförsök kommer den här aktiviteten aldrig att schemaläggas.
displayName	string	Ett visningsnamn för aktiviteten. Visningsnamnet behöver inte vara unikt och kan innehålla unicode-tecken upp till en maximal längd på 1 024.
eTag	string	ETag för uppgiften. Det här är en täckande sträng. Du kan använda den för att identifiera om uppgiften har ändrats mellan begäranden. I synnerhet kan du skicka ETag när du uppdaterar en aktivitet för att ange att ändringarna endast ska börja gälla om ingen annan har ändrat aktiviteten under tiden.
environmentSettings	EnvironmentSetting[]	En lista över miljövariabelinställningar för aktiviteten.
executionInfo	TaskExecutionInformation	Information om körningen av uppgiften.
exitConditions	ExitConditions	Anger hur Batch-tjänsten ska svara när uppgiften har slutförts. Hur Batch-tjänsten ska svara när uppgiften har slutförts.
id	string	En sträng som unikt identifierar uppgiften i jobbet. ID:t kan innehålla valfri kombination av alfanumeriska tecken, inklusive bindestreck och understreck, och får inte innehålla fler än 64 tecken.
lastModified	string	Senast ändrad tid för aktiviteten.
multiInstanceSettings	MultiInstanceSettings	Ett objekt som anger att aktiviteten är en aktivitet med flera instanser och innehåller information om hur du kör multiinstansaktiviteten. Uppgifter med flera instanser används ofta för att stödja MPI-uppgifter. I MPI-fallet misslyckas hela multiinstansaktiviteten om någon av underaktiviteterna misslyckas (till exempel på grund av att den avslutas med en slutkod som inte är noll). Aktiviteten för flera instanser avslutas och görs ett nytt försök, upp till gränsen för återförsök.
nodeInfo	ComputeNodeInformation	Information om beräkningsnoden som aktiviteten kördes på.
outputFiles	OutputFile[]	En lista över filer som Batch-tjänsten laddar upp från beräkningsnoden när kommandoraden har körts. För aktiviteter med flera instanser laddas filerna bara upp från beräkningsnoden där den primära aktiviteten körs.
previousState	TaskState	Det tidigare tillståndet för aktiviteten. Den här egenskapen anges inte om aktiviteten är i sitt ursprungliga aktiva tillstånd.
previousStateTransitionTime	string	Den tidpunkt då aktiviteten övergick till sitt tidigare tillstånd. Den här egenskapen anges inte om aktiviteten är i sitt ursprungliga aktiva tillstånd.
requiredSlots	integer	Antalet schemaläggningsplatser som aktiviteten kräver för att köras. Standard är 1. En aktivitet kan bara schemaläggas att köras på en beräkningsnod om noden har tillräckligt med tillgängliga kostnadsfria schemaläggningsplatser. För uppgifter med flera instanser måste detta vara 1.
resourceFiles	ResourceFile[]	En lista över filer som Batch-tjänsten laddar ned till beräkningsnoden innan du kör kommandoraden. För aktiviteter med flera instanser laddas resursfilerna bara ned till beräkningsnoden där den primära aktiviteten körs. Det finns en maximal storlek för listan över resursfiler. När maxstorleken överskrids misslyckas begäran och svarsfelkoden är RequestEntityTooLarge. Om detta inträffar måste mängden ResourceFiles minskas i storlek. Detta kan uppnås med hjälp av .zip filer, programpaket eller Docker-containrar.
state	TaskState	Aktivitetens aktuella tillstånd.
stateTransitionTime	string	Den tid då aktiviteten övergick till sitt aktuella tillstånd.
stats	TaskStatistics	Resursanvändningsstatistik för aktiviteten.
url	string	Url:en för aktiviteten.
userIdentity	UserIdentity	Användaridentiteten som aktiviteten körs under. Om den utelämnas körs aktiviteten som en icke-administrativ användare som är unik för aktiviteten.

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	CloudTask[]	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	ComputeNodeIdentityReference	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. Referensen till en användartilldelad identitet som är associerad med batchpoolen som en beräkningsnod ska använda.
password	string	Lösenordet för att logga in på registerservern.
registryServer	string	Registrets URL. Om det utelämnas är standardvärdet "docker.io".
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	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	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	ExitOptions	Hur Batch-tjänsten ska svara om uppgiften misslyckas med ett avslutsvillkor som inte omfattas av någon av de andra egenskaperna. Det här värdet används om aktiviteten avslutas med någon slutkod som inte är noll som inte anges i samlingen exitCodes eller exitCodeRanges, med ett förbearbetningsfel om egenskapen preProcessingError inte finns eller med ett filuppladdningsfel om egenskapen fileUploadError inte finns. Om du vill ha ett beteende som inte är standard för slutkod 0 måste du uttryckligen ange det med samlingen exitCodes eller exitCodeRanges.
exitCodeRanges	ExitCodeRangeMapping[]	En lista över aktivitetsavslutskodintervall och hur Batch-tjänsten ska svara på dem.
exitCodes	ExitCodeMapping[]	En lista över enskilda aktivitetsavslutskoder och hur Batch-tjänsten ska svara på dem.
fileUploadError	ExitOptions	Hur Batch-tjänsten ska svara om ett filuppladdningsfel uppstår. Om uppgiften avslutades med en slutkod som angavs via exitCodes eller exitCodeRanges och sedan påträffade ett filuppladdningsfel, har åtgärden som anges av slutkoden företräde.
preProcessingError	ExitOptions	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	DependencyAction	En åtgärd som Batch-tjänsten utför på uppgifter som är beroende av den här uppgiften. Möjliga värden är "uppfyller" (så att beroende aktiviteter kan fortsätta) och "blockera" (beroende aktiviteter fortsätter att vänta). Batch stöder ännu inte annullering av beroende aktiviteter.
jobAction	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". Standardvärdet är ingen för slutkod 0 och avslutas för alla andra avslutningsvillkor. Om jobbets onTaskFailed-egenskap är noaction returnerar du ett fel när du anger den här egenskapen och lägg till uppgiftsbegäran misslyckas med ett ogiltigt egenskapsvärdefel. om du anropar REST API direkt är HTTP-statuskoden 400 (felaktig begäran).

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	ResourceFile[]	En lista över filer som Batch-tjänsten laddar ned innan du kör kommandoraden för samordning. Skillnaden mellan vanliga resursfiler och aktivitetsresursfiler är att vanliga resursfiler laddas ned för alla underaktiviteter, inklusive den primära, medan aktivitetsresursfiler endast laddas ned för den primära. Observera också att dessa resursfiler inte laddas ned till arbetskatalogen Aktivitet, utan i stället laddas ned till rotkatalogen Aktivitet (en katalog ovanför arbetskatalogen). Det finns en maximal storlek för listan över resursfiler. När maxstorleken överskrids misslyckas begäran och svarsfelkoden är RequestEntityTooLarge. Om detta inträffar måste samlingen resourcefiles minskas i storlek. Detta kan uppnås med hjälp av .zip filer, programpaket eller Docker-containrar.
coordinationCommandLine	string	Kommandoraden som ska köras på alla beräkningsnoder så att de kan samordna när den primära kör huvuduppgiftskommandot. En typisk samordningskommandorad startar en bakgrundstjänst och verifierar att tjänsten är redo att bearbeta meddelanden mellan noder.
numberOfInstances	integer	Antalet beräkningsnoder som krävs av aktiviteten. Om det utelämnas är standardvärdet 1.

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	OutputFileDestination	Målet för utdatafilerna.
filePattern	string	Ett mönster som anger vilka filer som ska laddas upp. Både relativa och absoluta sökvägar stöds. Relativa sökvägar är i förhållande till arbetskatalogen Aktivitet. Följande jokertecken stöds: * matchar 0 eller fler tecken (till exempel mönster abc* skulle matcha abc eller abcdef), ** matchar alla kataloger, ? matchar ett enskilt tecken, [abc] matchar ett tecken inom hakparenteserna och [a-c] matchar ett tecken i intervallet. Hakparenteser kan innehålla en negation som matchar alla tecken som inte har angetts (till exempel [!abc] matchar alla tecken utom a, b eller c). Om ett filnamn börjar med "." ignoreras det som standard men kan matchas genom att uttryckligen ange det (till exempel .gif inte matchar .a.gif, men ..gif kommer att göra det). Ett enkelt exempel: ***.txt matchar alla filer som inte startar i och slutar med .txt i arbetskatalogen aktivitet eller någon underkatalog. Om filnamnet innehåller ett jokertecken kan det undantas med hakparenteser (till exempel abc[] skulle matcha en fil med namnet abc). Observera att både \ och /behandlas som katalogavgränsare i Windows, men endast/finns i Linux. Miljövariabler (%var% i Windows eller $var på Linux) utökas innan mönstret tillämpas.
uploadOptions	OutputFileUploadOptions	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. Om du inte använder en hanterad identitet måste URL:en innehålla en signatur för delad åtkomst (SAS) som beviljar skrivbehörighet till containern.
identityReference	ComputeNodeIdentityReference	Referensen till den användartilldelade identitet som ska användas för att komma åt Azure Blob Storage som anges av containerUrl Identiteten måste ha skrivbehörighet till Azure Blob Storage-containern
path	string	Målbloben eller den virtuella katalogen i Azure Storage-containern. Om filePattern refererar till en specifik fil (dvs. inte innehåller några jokertecken) är sökvägen namnet på den blob som filen ska laddas upp till. Om filePattern innehåller ett eller flera jokertecken (och därför kan matcha flera filer) är sökvägen namnet på den virtuella blobkatalogen (som läggs till i varje blobnamn) som filen/filerna ska laddas upp till. Om de utelämnas laddas filer upp till roten i containern med ett blobnamn som matchar deras filnamn.
uploadHeaders	HttpHeader[]	En lista över namn/värde-par för rubriker som ska användas vid uppladdning av utdatafiler Dessa huvuden anges när du laddar upp filer till Azure Storage. Officiellt dokument om tillåtna rubriker när blobar laddas upp: https://docs.microsoft.com/en-us/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Målet som en fil ska laddas upp till.

Name	Typ	Description
container	OutputFileBlobContainerDestination	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	OutputFileUploadCondition	De villkor under vilka uppgiftsutdatafilen eller uppsättningen filer ska laddas upp. Standardvärdet är uppgiftskomplettering.

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. Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges.
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. Egenskapen är endast giltig när autoStorageContainerName eller storageContainerUrl används. Det här prefixet kan vara ett partiellt filnamn eller en underkatalog. Om inget prefix har angetts laddas alla filer i containern ned.
fileMode	string	Attributet för filbehörighetsläge i oktalt format. Den här egenskapen gäller endast för filer som laddas ned till Linux-beräkningsnoder. Den ignoreras om den anges för en resourceFile som laddas ned till en Windows Compute-nod. Om den här egenskapen inte har angetts för en Linux-beräkningsnod tillämpas standardvärdet 0770 på filen.
filePath	string	Platsen på beräkningsnoden som filen eller filerna ska laddas ned till i förhållande till aktivitetens arbetskatalog. Om egenskapen httpUrl anges krävs filePath och beskriver sökvägen som filen ska laddas ned till, inklusive filnamnet. Om egenskapen autoStorageContainerName eller storageContainerUrl har angetts är filePath valfritt och är den katalog som filerna ska laddas ned till. Om filePath används som en katalog behålls alla katalogstrukturer som redan är associerade med indata i sin helhet och läggs till i den angivna filePath-katalogen. Den angivna relativa sökvägen kan inte bryta sig ut från aktivitetens arbetskatalog (till exempel med hjälp av ..).
httpUrl	string	URL:en för filen som ska laddas ned. Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. Om URL:en pekar på Azure Blob Storage måste den vara läsbar från beräkningsnoder. Det finns tre sätt att hämta en sådan URL för en blob i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läsbehörigheter för bloben, använda en hanterad identitet med läsbehörighet eller ange ACL för bloben eller dess container för att tillåta offentlig åtkomst.
identityReference	ComputeNodeIdentityReference	Referensen till den användartilldelade identitet som ska användas för att komma åt Azure Blob Storage som anges av storageContainerUrl eller httpUrl Referensen till en användartilldelad identitet som är associerad med batchpoolen som en beräkningsnod ska använda.
storageContainerUrl	string	URL:en för blobcontainern i Azure Blob Storage. Egenskaperna autoStorageContainerName, storageContainerUrl och httpUrl är ömsesidigt uteslutande och en av dem måste anges. Den här URL:en måste vara läsbar och listbar från beräkningsnoder. Det finns tre sätt att hämta en sådan URL för en container i Azure Storage: inkludera en signatur för delad åtkomst (SAS) som beviljar läs- och listbehörigheter för containern, använder en hanterad identitet med läs- och listbehörigheter eller anger ACL för containern så att den tillåter offentlig åtkomst.

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. Observera att det här värdet specifikt styr antalet återförsök för den körbara aktiviteten på grund av en icke-nollavslutskod. Batch-tjänsten provar uppgiften en gång och kan sedan försöka igen upp till den här gränsen. Om det maximala antalet återförsök till exempel är 3 försöker Batch aktiviteten upp till 4 gånger (ett första försök och 3 återförsök). Om det maximala antalet återförsök är 0 försöker inte Batch-tjänsten uppgiften igen efter det första försöket. Om det maximala antalet återförsök är -1 försöker Batch-tjänsten uppgiften utan begränsning igen, men detta rekommenderas inte för en startaktivitet eller någon aktivitet. Standardvärdet är 0 (inga återförsök).
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. Om detta inte anges finns det ingen tidsgräns för hur länge aktiviteten kan köras.
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. Standardvärdet är 7 dagar, dvs. Aktivitetskatalogen behålls i 7 dagar om inte beräkningsnoden tas bort eller jobbet tas bort.

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. Det här är den detaljerade felsträngen från Docker-tjänsten, om den är tillgänglig. Det motsvarar det felfält som returneras av "docker inspect".
state	string	Containerns tillstånd. Det här är containerns tillstånd enligt Docker-tjänsten. Det motsvarar statusfältet som returneras av "docker inspect".

TaskContainerSettings

Containerinställningarna för en aktivitet.

Name	Typ	Description
containerRunOptions	string	Ytterligare alternativ för kommandot container create. Dessa ytterligare alternativ anges som argument till kommandot "docker create", utöver de som styrs av Batch-tjänsten.
imageName	string	Avbildningen som ska användas för att skapa containern där aktiviteten ska köras. Det här är den fullständiga avbildningsreferensen, som skulle anges till "docker pull". Om ingen tagg anges som en del av avbildningsnamnet används taggen ":latest" som standard.
registry	ContainerRegistry	Det privata registret som innehåller containern Image. Den här inställningen kan utelämnas om den redan angavs när poolen skapades.
workingDirectory	ContainerWorkingDirectory	Platsen för containerns arbetskatalog för uppgift. Standardvärdet är "taskWorkingDirectory".

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	TaskIdRange[]	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. TaskIds-samlingen är begränsad till totalt 64 000 tecken (dvs. den kombinerade längden på alla aktivitets-ID:n). Om taskIds-samlingen överskrider den maximala längden misslyckas lägg till uppgiftsbegäran med felkoden TaskDependencyListTooLong. I det här fallet bör du överväga att använda aktivitets-ID-intervall i stället.

TaskExecutionInformation

Information om körning av en aktivitet.

Name	Typ	Description
containerInfo	TaskContainerExecutionInformation	Information om containern som aktiviteten körs under. Den här egenskapen anges endast om aktiviteten körs i en containerkontext.
endTime	string	Tidpunkt då aktiviteten slutfördes. Den här egenskapen anges endast om aktiviteten är i tillståndet Slutförd.
exitCode	integer	Slutkoden för programmet som anges på kommandoraden Aktivitet. Den här egenskapen anges endast om aktiviteten är i slutfört tillstånd. I allmänhet återspeglar slutkoden för en process den specifika konvention som implementerats av programutvecklaren för den processen. Om du använder slutkodsvärdet för att fatta beslut i koden ska du vara säker på att du känner till den slutkodskonvention som används av programprocessen. Men om Batch-tjänsten avslutar aktiviteten (på grund av timeout eller användaravslut via API:et) kan du se en operativsystemdefinierad slutkod.
failureInfo	TaskFailureInformation	Information som beskriver aktivitetsfelet, om det finns någon. Den här egenskapen anges endast om aktiviteten är i slutfört tillstånd och påträffade ett fel.
lastRequeueTime	string	Den senaste gången aktiviteten har begärts på nytt av Batch-tjänsten som ett resultat av en användarbegäran. Den här egenskapen anges endast om requeueCount är icke-zero.
lastRetryTime	string	Den senaste gången ett återförsök av aktiviteten började köras. Det här elementet finns bara om aktiviteten har gjorts om (dvs. retryCount är inte noll). Om det finns är detta vanligtvis samma som startTime, men kan vara annorlunda om aktiviteten har startats om av andra orsaker än återförsök. Om beräkningsnoden till exempel startades om under ett nytt försök uppdateras startTime men inte lastRetryTime.
requeueCount	integer	Antalet gånger som uppgiften har begärts på nytt av Batch-tjänsten som ett resultat av en användarbegäran. När användaren tar bort beräkningsnoder från en pool (genom att ändra storlek på/krympa poolen) eller när jobbet inaktiveras kan användaren ange att aktiviteter som körs på beräkningsnoderna ska ställas in på nytt för körning. Det här antalet spårar hur många gånger uppgiften har ställts in på nytt av dessa skäl.
result	TaskExecutionResult	Resultatet av aktivitetskörningen. Om värdet är "failed" (misslyckades) finns information om felet i egenskapen failureInfo.
retryCount	integer	Antalet gånger som uppgiften har gjorts om av Batch-tjänsten. Fel i aktivitetsprogrammet (icke-nollavslutskod) görs på nytt, förbearbetningsfel (aktiviteten kunde inte köras) och filuppladdningsfel görs inte igen. Batch-tjänsten försöker uppgiften igen upp till den gräns som anges av begränsningarna.
startTime	string	Den tidpunkt då aktiviteten började köras. "Körs" motsvarar körningstillståndet, så om aktiviteten anger resursfiler eller paket återspeglar starttiden den tidpunkt då aktiviteten började ladda ned eller distribuera dessa. Om aktiviteten har startats om eller gjorts om är det här den senaste gången aktiviteten började köras. Den här egenskapen finns bara för aktiviteter som är i körnings- eller slutfört tillstånd.

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	ErrorCategory	Kategorin för aktivitetsfelet.
code	string	En identifierare för aktivitetsfelet. Koder är invarianta och är avsedda att användas programmatiskt.
details	NameValuePair[]	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. Tiden för väggklockan är den tid som förflutit från när aktiviteten började köras på en beräkningsnod till när den var klar (eller till sista gången statistiken uppdaterades, om aktiviteten inte hade slutförts då). Om uppgiften gjordes på nytt inkluderar detta klocktiden för alla återförsök i 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	AutoUserSpecification	Den automatiska användare som aktiviteten körs under. Egenskaperna userName och autoUser är ömsesidigt uteslutande. du måste ange en men inte båda.
username	string	Namnet på den användaridentitet som aktiviteten körs under. Egenskaperna userName och autoUser är ömsesidigt uteslutande. du måste ange en men inte båda.