Jobs - Get
Egy Container Apps-feladat tulajdonságainak lekérése.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/jobs/{jobName}?api-version=2024-03-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
job
|
path | True |
string |
Feladat neve Reguláris kifejezési minta: |
resource
|
path | True |
string |
Az erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket. |
subscription
|
path | True |
string |
A cél-előfizetés azonosítója. |
api-version
|
query | True |
string |
A művelethez használandó API-verzió. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK gombra. |
|
Other Status Codes |
Gyakori hibaválasz. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
Get Container Apps Job
Mintakérelem
Mintaválasz
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/jobs/testcontainerappsjob0",
"name": "testcontainerappsjob0",
"type": "Microsoft.App/jobs",
"location": "East US",
"properties": {
"provisioningState": "Succeeded",
"environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
"configuration": {
"replicaTimeout": 10,
"replicaRetryLimit": 10,
"manualTriggerConfig": {
"replicaCompletionCount": 1,
"parallelism": 4
},
"triggerType": "Manual"
},
"template": {
"containers": [
{
"image": "repo/testcontainerappsjob0:v4",
"name": "testcontainerappsjob0",
"resources": {
"cpu": 0.5,
"memory": "1Gi"
}
}
],
"initContainers": [
{
"image": "repo/testcontainerappsjob0:v4",
"name": "testinitcontainerAppsJob0",
"resources": {
"cpu": 0.5,
"memory": "1Gi"
}
}
]
}
}
}
Definíciók
Name | Description |
---|---|
Container |
Tárolóalkalmazás tárolódefiníciója |
Container |
A mintavétel egy tárolón végrehajtandó állapot-ellenőrzést ír le annak megállapításához, hogy az életben van-e, vagy készen áll-e a forgalom fogadására. |
Container |
Tárolóalkalmazás tárolóerőforrás-követelményei. |
created |
Az erőforrást létrehozó identitás típusa. |
Default |
App Service hibaválasz. |
Details |
Részletek vagy hiba |
Environment |
Tárolóalkalmazás tárolókörnyezeti változója. |
Error |
Hibamodell. |
Event |
Eseményvezérelt feladat triggerkonfigurációja. |
Http |
A HTTPGet a végrehajtandó HTTP-kérést adja meg. |
Http |
Egyéni fejlécek, a kérésben beállítva. A HTTP lehetővé teszi az ismétlődő fejléceket. |
Init |
Tárolóalkalmazás init tárolódefiníciója |
Job |
Tárolóalkalmazás-feladat |
Job |
Nem verziószámozott tárolóalkalmazások feladatkonfigurációs tulajdonságai |
Job |
A Container Apps-feladat kiépítési állapota. |
Job |
Eseményvezérelt feladatok konfigurációinak skálázása. |
Job |
Skálázási szabály. |
Job |
Container Apps-feladat verziószámozott alkalmazásdefiníciója. Meghatározza egy nem módosítható változat kívánt állapotát. A szakasz bármely módosítása új változat létrehozását eredményezi |
Managed |
Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások) |
Managed |
A felügyeltszolgáltatás-identitás típusa (ahol a SystemAssigned és a UserAssigned típus egyaránt engedélyezett). |
Manual |
Manuális triggerkonfiguráció egyetlen végrehajtási feladathoz. A properties replicaCompletionCount és a parallelism alapértelmezés szerint 1-et adna meg |
Registry |
Tárolóalkalmazás privát beállításjegyzéke |
Scale |
Hitelesítési titkos kódok a méretezési szabályhoz |
Schedule |
Cron formátumú ismétlődő eseményindító ütemezése ("* * * * * *") cronjobshoz. A tulajdonságok befejezése és a párhuzamosság alapértelmezés szerint 1-re van állítva |
Scheme |
A gazdagéphez való csatlakozáshoz használható séma. Alapértelmezés szerint HTTP. |
Secret |
Titkos kód definíciója. |
Secret |
A kötethez hozzáadandó titkos kód. |
Storage |
A kötet tárolási típusa. Ha nincs megadva, használja az EmptyDir parancsot. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
Tcp |
A TCPSocket egy TCP-portot érintő műveletet határoz meg. A TCP-horgok még nem támogatottak. |
Trigger |
A feladat triggertípusa |
Type |
A mintavétel típusa. |
User |
Felhasználó által hozzárendelt identitás tulajdonságai |
Volume |
Kötetdefiníciók a tárolóalkalmazáshoz. |
Volume |
Kötet csatlakoztatása a tárolóalkalmazáshoz. |
Container
Tárolóalkalmazás tárolódefiníciója
Name | Típus | Description |
---|---|---|
args |
string[] |
Tárolóindítási parancs argumentumai. |
command |
string[] |
Tárolóindítási parancs. |
env |
Tárolókörnyezeti változók. |
|
image |
string |
Tárolórendszerkép címkéje. |
name |
string |
Egyéni tároló neve. |
probes |
A tároló mintavételeinek listája. |
|
resources |
Tárolóerőforrás-követelmények. |
|
volumeMounts |
Tárolókötet csatlakoztatása. |
ContainerAppProbe
A mintavétel egy tárolón végrehajtandó állapot-ellenőrzést ír le annak megállapításához, hogy az életben van-e, vagy készen áll-e a forgalom fogadására.
Name | Típus | Description |
---|---|---|
failureThreshold |
integer |
A mintavétel sikerességét követően meghiúsultnak tekinthető minimális egymást követő hibák. Alapértelmezés szerint 3. A minimális érték 1. A maximális érték 10. |
httpGet |
A HTTPGet a végrehajtandó HTTP-kérést adja meg. |
|
initialDelaySeconds |
integer |
A tároló elindítása utáni másodpercek száma az élőségi mintavételek elindítása előtt. A minimális érték 1. A maximális érték 60. |
periodSeconds |
integer |
Milyen gyakran (másodpercben) hajthatja végre a mintavételt. Alapértelmezés szerint 10 másodperc. A minimális érték 1. A maximális érték 240. |
successThreshold |
integer |
A mintavétel sikeresnek minősítendő sikerességének minimális egymást követő sikerei a sikertelenség után. Alapértelmezés szerint 1. Az élethez és az indításhoz 1-nek kell lennie. A minimális érték 1. A maximális érték 10. |
tcpSocket |
A TCPSocket egy TCP-portot érintő műveletet határoz meg. A TCP-horgok még nem támogatottak. |
|
terminationGracePeriodSeconds |
integer |
Nem kötelező időtartam másodpercben a podnak türelmesen le kell állítania a mintavételi hiba esetén. A türelmi időszak az az időtartam másodpercben, amikor a podban futó folyamatok leállítási jelet küldenek, és az az idő, amikor a folyamatokat kényszerítetten leállítják egy leállítási jellel. Állítsa be ezt az értéket hosszabb ideig, mint a folyamat várt tisztítási ideje. Ha ez az érték nulla, a pod végpontjaGracePeriodSeconds lesz használva. Ellenkező esetben ez az érték felülbírálja a podspecifikáció által megadott értéket. Az értéknek nem negatív egész számnak kell lennie. A nulla érték azt jelzi, hogy a leállítási jel azonnal leáll (nincs lehetőség a leállításra). Ez egy alfa mező, és engedélyeznie kell a ProbeTerminationGracePeriod funkciókaput. A maximális érték 3600 másodperc (1 óra) |
timeoutSeconds |
integer |
Azon másodpercek száma, amelyek után a mintavétel túllépi az időkorlátot. Alapértelmezés szerint 1 másodperc. A minimális érték 1. A maximális érték 240. |
type |
A mintavétel típusa. |
ContainerResources
Tárolóalkalmazás tárolóerőforrás-követelményei.
Name | Típus | Description |
---|---|---|
cpu |
number |
Processzor szükséges magokban, pl. 0,5 |
ephemeralStorage |
string |
Rövid élettartamú tárolás, pl. "1Gi" |
memory |
string |
Szükséges memória, pl. "250 Mb" |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultErrorResponse
App Service hibaválasz.
Name | Típus | Description |
---|---|---|
error |
Hibamodell. |
Details
Részletek vagy hiba
Name | Típus | Description |
---|---|---|
code |
string |
Szabványosított sztring a hiba programozott azonosításához. |
message |
string |
Részletes hibaleírás és hibakeresési információk. |
target |
string |
Részletes hibaleírás és hibakeresési információk. |
EnvironmentVar
Tárolóalkalmazás tárolókörnyezeti változója.
Name | Típus | Description |
---|---|---|
name |
string |
Környezeti változó neve. |
secretRef |
string |
Annak a tárolóalkalmazás-titkos kódnak a neve, amelyből le szeretné vonni a környezeti változó értékét. |
value |
string |
Nem titkos környezeti változó értéke. |
Error
Hibamodell.
Name | Típus | Description |
---|---|---|
code |
string |
Szabványosított sztring a hiba programozott azonosításához. |
details |
Details[] |
Részletek vagy hiba |
innererror |
string |
További információ a hibakeresésről. |
message |
string |
Részletes hibaleírás és hibakeresési információk. |
target |
string |
Részletes hibaleírás és hibakeresési információk. |
EventTriggerConfig
Eseményvezérelt feladat triggerkonfigurációja.
Name | Típus | Description |
---|---|---|
parallelism |
integer |
Egy adott időpontban futtatható feladatok párhuzamos replikáinak száma. |
replicaCompletionCount |
integer |
A sikeres replika-befejezések minimális száma a teljes feladat befejezése előtt. |
scale |
Eseményvezérelt feladatok skálázási konfigurációi. |
HttpGet
A HTTPGet a végrehajtandó HTTP-kérést adja meg.
Name | Típus | Description |
---|---|---|
host |
string |
A csatlakozáshoz használt állomásnév alapértelmezés szerint a pod IP-címéhez kapcsolódik. Valószínűleg inkább a "Gazdagép" beállítást szeretné beállítani a httpHeadersben. |
httpHeaders |
Egyéni fejlécek, a kérésben beállítva. A HTTP lehetővé teszi az ismétlődő fejléceket. |
|
path |
string |
Elérési út a HTTP-kiszolgálón. |
port |
integer |
A tárolón elérni kívánt port neve vagy száma. A számnak az 1 és 65535 közötti tartományban kell lennie. A névnek IANA_SVC_NAME kell lennie. |
scheme |
A gazdagéphez való csatlakozáshoz használható séma. Alapértelmezés szerint HTTP. |
HttpHeaders
Egyéni fejlécek, a kérésben beállítva. A HTTP lehetővé teszi az ismétlődő fejléceket.
Name | Típus | Description |
---|---|---|
name |
string |
A fejlécmező neve |
value |
string |
A fejlécmező értéke |
InitContainer
Tárolóalkalmazás init tárolódefiníciója
Name | Típus | Description |
---|---|---|
args |
string[] |
Tárolóindítási parancs argumentumai. |
command |
string[] |
Container start parancs. |
env |
Tárolókörnyezeti változók. |
|
image |
string |
Tárolórendszerkép címkéje. |
name |
string |
Egyéni tároló neve. |
resources |
Tárolóerőforrás-követelmények. |
|
volumeMounts |
Tárolókötet csatlakoztatása. |
Job
Tárolóalkalmazás-feladat
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Például : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
A tárolóalkalmazás-feladatok által igényelt felügyelt identitások más Azure-szolgáltatásokkal való interakcióhoz szükségesek ahhoz, hogy ne tartsanak fenn titkos kódokat vagy hitelesítő adatokat a kódban. |
|
location |
string |
A földrajzi hely, ahol az erőforrás él |
name |
string |
Az erőforrás neve |
properties.configuration |
Tárolóalkalmazások feladatkonfigurációs tulajdonságai. |
|
properties.environmentId |
string |
A környezet erőforrás-azonosítója. |
properties.eventStreamEndpoint |
string |
A tárolóalkalmazás-feladat eventstreamjének végpontja. |
properties.outboundIpAddresses |
string[] |
Egy tárolóalkalmazás-feladat kimenő IP-címei. |
properties.provisioningState |
A Container Apps-feladat kiépítési állapota. |
|
properties.template |
Container Apps-feladatdefiníció. |
|
properties.workloadProfileName |
string |
A tárolóalkalmazások feladatvégrehajtásához rögzítendő számításifeladat-profil neve. |
systemData |
Az Azure Resource Manager createdBy és modifiedBy adatokat tartalmazó metaadatokat. |
|
tags |
object |
Erőforráscímkék. |
type |
string |
Az erőforrás típusa. Például"Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
JobConfiguration
Nem verziószámozott tárolóalkalmazások feladatkonfigurációs tulajdonságai
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
eventTriggerConfig |
Eseményvezérelt feladat triggerkonfigurációja. |
||
manualTriggerConfig |
Manuális triggerkonfiguráció egyetlen végrehajtási feladathoz. A properties replicaCompletionCount és a parallelism alapértelmezés szerint 1-et adna meg |
||
registries |
Tárolóalkalmazás-feladat által használt privát tárolóregisztrációs adatbázis hitelesítő adatainak gyűjteménye |
||
replicaRetryLimit |
integer |
Az újrapróbálkozások maximális száma a feladat meghiúsulása előtt. |
|
replicaTimeout |
integer |
A replika futtatásának maximális száma másodpercben. |
|
scheduleTriggerConfig |
Cron formátumú ismétlődő eseményindító ütemezése ("* * * * * *") cronjobshoz. A tulajdonságok befejezése és a párhuzamosság alapértelmezés szerint 1-re van állítva |
||
secrets |
Secret[] |
Tárolóalkalmazás-feladat által használt titkos kulcsok gyűjteménye |
|
triggerType | Manual |
A feladat triggertípusa |
JobProvisioningState
A Container Apps-feladat kiépítési állapota.
Name | Típus | Description |
---|---|---|
Canceled |
string |
|
Deleting |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
JobScale
Eseményvezérelt feladatok konfigurációinak skálázása.
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
maxExecutions |
integer |
100 |
Az eseményindítóhoz létrehozott feladatvégrehajtások maximális száma, alapértelmezés szerint 100. |
minExecutions |
integer |
0 |
Az eseményindítóhoz létrehozott feladatvégrehajtások minimális száma, alapértelmezés szerint 0 |
pollingInterval |
integer |
Időköz az egyes eseményforrások másodpercben történő ellenőrzéséhez. Alapértelmezett érték 30-ra |
|
rules |
Skálázási szabályok. |
JobScaleRule
Skálázási szabály.
Name | Típus | Description |
---|---|---|
auth |
A méretezési szabály hitelesítési titkos kódjai. |
|
metadata |
object |
Metaadatok tulajdonságai a skálázási szabály leírásához. |
name |
string |
Skálázási szabály neve |
type |
string |
A skálázási szabály típusa, például: azure-servicebus, redis stb. |
JobTemplate
Container Apps-feladat verziószámozott alkalmazásdefiníciója. Meghatározza egy nem módosítható változat kívánt állapotát. A szakasz bármely módosítása új változat létrehozását eredményezi
Name | Típus | Description |
---|---|---|
containers |
A tárolóalkalmazás tárolódefinícióinak listája. |
|
initContainers |
Az alkalmazástárolók előtt futó speciális tárolók listája. |
|
volumes |
Volume[] |
A tárolóalkalmazás kötetdefinícióinak listája. |
ManagedServiceIdentity
Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)
Name | Típus | Description |
---|---|---|
principalId |
string |
A rendszer által hozzárendelt identitás szolgáltatásnév-azonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva. |
tenantId |
string |
A rendszer által hozzárendelt identitás bérlőazonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva. |
type |
A felügyeltszolgáltatás-identitás típusa (ahol a SystemAssigned és a UserAssigned típus egyaránt engedélyezett). |
|
userAssignedIdentities |
<string,
User |
User-Assigned-identitások |
ManagedServiceIdentityType
A felügyeltszolgáltatás-identitás típusa (ahol a SystemAssigned és a UserAssigned típus egyaránt engedélyezett).
Name | Típus | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
ManualTriggerConfig
Manuális triggerkonfiguráció egyetlen végrehajtási feladathoz. A properties replicaCompletionCount és a parallelism alapértelmezés szerint 1-et adna meg
Name | Típus | Description |
---|---|---|
parallelism |
integer |
Egy adott időpontban futtatható feladatok párhuzamos replikáinak száma. |
replicaCompletionCount |
integer |
A sikeres replika-befejezések minimális száma a teljes feladat befejezése előtt. |
RegistryCredentials
Tárolóalkalmazás privát beállításjegyzéke
Name | Típus | Description |
---|---|---|
identity |
string |
A Azure Container Registry hitelesítéséhez használandó felügyelt identitás. Felhasználó által hozzárendelt identitások esetén használja a teljes felhasználó által hozzárendelt identitás erőforrás-azonosítóját. A rendszer által hozzárendelt identitások esetében használja a "system" kifejezést |
passwordSecretRef |
string |
A regisztrációs adatbázis bejelentkezési jelszavát tartalmazó titkos kód neve |
server |
string |
Tárolóregisztrációs adatbázis kiszolgálója |
username |
string |
Tárolóregisztrációs adatbázis felhasználóneve |
ScaleRuleAuth
Hitelesítési titkos kódok a méretezési szabályhoz
Name | Típus | Description |
---|---|---|
secretRef |
string |
Annak a titkos kódnak a neve, amelyből le kell húzni a hitelesítési paramokat. |
triggerParameter |
string |
A titkos kulcsot használó triggerparaméter |
ScheduleTriggerConfig
Cron formátumú ismétlődő eseményindító ütemezése ("* * * * * *") cronjobshoz. A tulajdonságok befejezése és a párhuzamosság alapértelmezés szerint 1-re van állítva
Name | Típus | Description |
---|---|---|
cronExpression |
string |
Cron-feladat ismétlődő ütemezése ("* * * * * *"). |
parallelism |
integer |
Egy adott időpontban futtatható feladatok párhuzamos replikáinak száma. |
replicaCompletionCount |
integer |
A sikeres replika-befejezések minimális száma a teljes feladat befejezése előtt. |
Scheme
A gazdagéphez való csatlakozáshoz használható séma. Alapértelmezés szerint HTTP.
Name | Típus | Description |
---|---|---|
HTTP |
string |
|
HTTPS |
string |
Secret
Titkos kód definíciója.
Name | Típus | Description |
---|---|---|
identity |
string |
Egy felügyelt identitás erőforrás-azonosítója az Azure Key Vault vagy a rendszer által hozzárendelt identitás használatához. |
keyVaultUrl |
string |
Az Azure Key Vault URL-címe, amely a tárolóalkalmazás által hivatkozott titkos kódra mutat. |
name |
string |
Titkos kód neve. |
value |
string |
Titkos érték. |
SecretVolumeItem
A kötethez hozzáadandó titkos kód.
Name | Típus | Description |
---|---|---|
path |
string |
A projekt titkos kulcsának elérési útja. Ha nincs megadva elérési út, az elérési út alapértelmezés szerint a secretRef fájlban szereplő titkos kód neve lesz. |
secretRef |
string |
Annak a tárolóalkalmazás-titkos kódnak a neve, amelyből lekérhető a titkos kód értéke. |
StorageType
A kötet tárolási típusa. Ha nincs megadva, használja az EmptyDir parancsot.
Name | Típus | Description |
---|---|---|
AzureFile |
string |
|
EmptyDir |
string |
|
Secret |
string |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az erőforrást utoljára módosító identitás. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |
TcpSocket
A TCPSocket egy TCP-portot érintő műveletet határoz meg. A TCP-horgok még nem támogatottak.
Name | Típus | Description |
---|---|---|
host |
string |
Nem kötelező: A pod IP-címéhez való csatlakozáshoz használt állomásnév alapértelmezés szerint a pod IP-címéhez kapcsolódik. |
port |
integer |
A tárolón elérni kívánt port száma vagy neve. A számnak az 1 és 65535 közötti tartományban kell lennie. A névnek IANA_SVC_NAME kell lennie. |
TriggerType
A feladat triggertípusa
Name | Típus | Description |
---|---|---|
Event |
string |
|
Manual |
string |
|
Schedule |
string |
Type
A mintavétel típusa.
Name | Típus | Description |
---|---|---|
Liveness |
string |
|
Readiness |
string |
|
Startup |
string |
UserAssignedIdentity
Felhasználó által hozzárendelt identitás tulajdonságai
Name | Típus | Description |
---|---|---|
clientId |
string |
A hozzárendelt identitás ügyfél-azonosítója. |
principalId |
string |
A hozzárendelt identitás egyszerű azonosítója. |
Volume
Kötetdefiníciók a tárolóalkalmazáshoz.
Name | Típus | Description |
---|---|---|
mountOptions |
string |
Az AzureFile csatlakoztatása során használt csatlakoztatási beállítások. Vesszővel elválasztott sztringnek kell lennie. |
name |
string |
Kötet neve. |
secrets |
A kötetbe felvenni kívánt titkos kódok listája. Ha nincsenek megadva titkos kódok, a gyűjteményben lévő összes titkos kód hozzá lesz adva a kötethez. |
|
storageName |
string |
A tárolási erőforrás neve. Nem kell megadnia az EmptyDir és a Secret elemet. |
storageType |
A kötet tárolási típusa. Ha nincs megadva, használja az EmptyDir parancsot. |
VolumeMount
Kötet csatlakoztatása a tárolóalkalmazáshoz.
Name | Típus | Description |
---|---|---|
mountPath |
string |
Elérési út azon a tárolón belül, amelyhez a kötetet csatlakoztatni kell. Nem tartalmazhat ":" szöveget. |
subPath |
string |
Elérési út azon a köteten belül, amelyből a tároló kötetét csatlakoztatni kell. Alapértelmezés szerint "" (kötet gyökere). |
volumeName |
string |
Ennek meg kell egyeznie egy kötet nevével. |