Megosztás a következőn keresztül:

Task - Update

  • Referencia
Szolgáltatás:
Batch Service
API-verzió:
2023-11-01.18.0

Frissítések a megadott tevékenység tulajdonságait.

PUT {batchUrl}/jobs/{jobId}/tasks/{taskId}?api-version=2023-11-01.18.0
Opcionális paraméterekkel: 
PUT {batchUrl}/jobs/{jobId}/tasks/{taskId}?timeout={timeout}&api-version=2023-11-01.18.0

URI-paraméterek

Name In Kötelező Típus Description
batchUrl
 path True

string

Az összes Azure Batch szolgáltatáskérés alap URL-címe.
jobId
 path True

string

A tevékenységet tartalmazó feladat azonosítója.
taskId
 path True

string

A frissíteni kívánt feladat azonosítója.
api-version
 query True

string

Ügyfél API-verziója.
timeout
 query

integer

int32

A kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 mp.

Kérelem fejléce

Media Types: "application/json; odata=minimalmetadata"

Name Kötelező Típus Description
client-request-id

string

uuid

A hívó által generált kérési identitás, olyan GUID formátumban, amely nem rendelkezik díszítéssel, például kapcsos zárójelekkel, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Azt határozza meg, hogy a kiszolgálónak vissza kell-e küldenie a válaszban szereplő client-request-id azonosítót.
ocp-date

string

date-time-rfc1123

A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróraidőre állítják be; állítsa be explicit módon, ha a REST API-t közvetlenül hívja meg.
If-Match

string

Az ügyfél által ismert erőforrás verziójához társított ETag-érték. A művelet csak akkor lesz végrehajtva, ha az erőforrás aktuális ETagje a szolgáltatásban pontosan megegyezik az ügyfél által megadott értékkel.
If-None-Match

string

Az ügyfél által ismert erőforrás verziójához társított ETag-érték. A művelet csak akkor lesz végrehajtva, ha az erőforrás aktuális ETagje a szolgáltatásban nem egyezik meg az ügyfél által megadott értékkel.
If-Modified-Since

string

date-time-rfc1123

Az ügyfél által ismert erőforrás utolsó módosításának időpontját jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás a megadott időpont óta módosult.
If-Unmodified-Since

string

date-time-rfc1123

Az ügyfél által ismert erőforrás utolsó módosításának időpontját jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás nem módosult a megadott időpont óta.

Kérelem törzse

Media Types: "application/json; odata=minimalmetadata"

Name Típus Description
constraints

TaskConstraints

A tevékenységre vonatkozó korlátozások.
Ha nincs megadva, a tevékenységhez az alapértelmezett korlátozások lesznek megadva. Többpéldányos feladatok esetén a megőrzési idő frissítése csak az elsődleges tevékenységre vonatkozik, altevékenységekre nem.

Válaszok

Name Típus Description
200 OK

A Batch szolgáltatásnak küldött kérés sikeres volt.

Fejlécek

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

A Batch szolgáltatás hibája.

Biztonság

azure_auth

Microsoft Entra OAuth 2.0 hitelesítési kódfolyamata

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation A felhasználói fiók megszemélyesítése

Authorization

Típus: apiKey
In: header

Példák

Task update

Mintakérelem

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



{
  "constraints": {
    "maxWallClockTime": "PT1H",
    "maxTaskRetryCount": 3,
    "retentionTime": "PT1H"
  }
}

Mintaválasz

Állapotkód:
200

Definíciók

Name Description
BatchError

Hibaválasz érkezett a Azure Batch szolgáltatástól.
BatchErrorDetail

Egy Azure Batch hibaválaszban szereplő további információk egy eleme.
ErrorMessage

Hibaüzenet érkezett egy Azure Batch hibaválaszban.
TaskConstraints

A tevékenységre alkalmazandó végrehajtási korlátozások.
TaskUpdateParameter

A tevékenységen végrehajtott módosítások halmaza.

BatchError

Hibaválasz érkezett a Azure Batch szolgáltatástól.

Name Típus Description
code

string

A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message

ErrorMessage

A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
values

BatchErrorDetail[]

Kulcs-érték párok gyűjteménye, amely további részleteket tartalmaz a hibáról.

BatchErrorDetail

Egy Azure Batch hibaválaszban szereplő további információk egy eleme.

Name Típus Description
key

string

Egy azonosító, amely az Érték tulajdonság jelentését adja meg.
value

string

A hibaválaszban szereplő további információk.

ErrorMessage

Hibaüzenet érkezett egy Azure Batch hibaválaszban.

Name Típus Description
lang

string

A hibaüzenet nyelvkódja
value

string

Az üzenet szövege.

TaskConstraints

A tevékenységre alkalmazandó végrehajtási korlátozások.

Name Típus Description
maxTaskRetryCount

integer

A tevékenység újrapróbálkozásának maximális száma. A Batch szolgáltatás újrapróbál egy feladatot, ha a kilépési kódja nem nulla.
Vegye figyelembe, hogy ez az érték kifejezetten szabályozza az újrapróbálkozások számát a végrehajtható feladathoz egy nem nulla kilépési kód miatt. A Batch szolgáltatás egyszer próbálja meg a feladatot, majd megpróbálkozhat ezzel a korláttal. Ha például a maximális újrapróbálkozások száma 3, a Batch legfeljebb 4 alkalommal próbálja meg a feladatot (egy kezdeti próbálkozás és 3 újrapróbálkozás). Ha a maximális újrapróbálkozási szám 0, a Batch szolgáltatás az első kísérlet után nem próbálkozik újra a feladattal. Ha a maximális újrapróbálkozások száma -1, a Batch szolgáltatás korlátozás nélkül újrapróbálkozott a tevékenységtel, de ez nem ajánlott indítási tevékenységhez vagy tevékenységhez. Az alapértelmezett érték a 0 (nincs újrapróbálkozás).
maxWallClockTime

string

A tevékenység futásának maximális időtartama a tevékenység indításának időpontjától mérve. Ha a tevékenység nem fejeződik be az időkorláton belül, a Batch szolgáltatás leállítja.
Ha ez nincs megadva, nincs időkorlát arra vonatkozóan, hogy a tevékenység mennyi ideig futhat.
retentionTime

string

A tevékenységkönyvtár megőrzésének minimális ideje azon a számítási csomóponton, ahol futott, a végrehajtás befejezésének időpontjától kezdve. Ezután a Batch szolgáltatás törölheti a Tevékenység könyvtárat és annak tartalmát.
Az alapértelmezett érték 7 nap, azaz a Tevékenység könyvtár 7 napig marad meg, hacsak nem távolítja el a számítási csomópontot, vagy nem törli a feladatot.

TaskUpdateParameter

A tevékenységen végrehajtott módosítások halmaza.

Name Típus Description
constraints

TaskConstraints

A tevékenységre vonatkozó korlátozások.
Ha nincs megadva, a tevékenységhez az alapértelmezett korlátozások lesznek megadva. Többpéldányos feladatok esetén a megőrzési idő frissítése csak az elsődleges tevékenységre vonatkozik, altevékenységekre nem.