Tasks - List

Referencia

Szolgáltatás:: Container Registry

API-verzió:: 2019-04-01

Egy megadott tárolóregisztrációs adatbázis összes feladatát felsorolja.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/tasks?api-version=2019-04-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
registryName	path	True	string minLength: 5 maxLength: 50 pattern: ^[a-zA-Z0-9]*$	A tárolóregisztrációs adatbázis neve.
resourceGroupName	path	True	string minLength: 1	Annak az erőforráscsoportnak a neve, amelyhez a tárolóregisztrációs adatbázis tartozik.
subscriptionId	path	True	string	A Microsoft Azure-előfizetés azonosítója.
api-version	query	True	string	Az ügyfél API-verziója.

Válaszok

Name	Típus	Description
200 OK	TaskListResult	A kérés sikeres volt; a kérelem megfelelően alakult és megfelelően érkezett.
Other Status Codes		Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

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	a felhasználói fiók megszemélyesítése

Példák

Tasks_List

Mintakérelem

HTTP

GET https://management.azure.com/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/tasks?api-version=2019-04-01

Mintaválasz

Állapotkód:: 200

{
  "value": [
    {
      "properties": {
        "provisioningState": "Succeeded",
        "creationDate": "2018-01-25T06:54:23.536Z",
        "status": "Enabled",
        "platform": {
          "os": "Linux",
          "architecture": "amd64"
        },
        "agentConfiguration": {
          "cpu": 2
        },
        "step": {
          "type": "Docker",
          "imageNames": [
            "azurerest:testtag"
          ],
          "dockerFilePath": "src/DockerFile",
          "contextPath": "src",
          "isPushEnabled": true,
          "noCache": false,
          "arguments": [
            {
              "name": "mytestargument",
              "value": "mytestvalue",
              "isSecret": false
            }
          ]
        },
        "trigger": {
          "timerTriggers": [
            {
              "name": "myTimerTrigger",
              "status": "Enabled",
              "schedule": "30 9 * * 1-5"
            }
          ],
          "sourceTriggers": [
            {
              "name": "mySourceTrigger",
              "status": "Enabled",
              "sourceRepository": {
                "sourceControlType": "Github",
                "repositoryUrl": "https://github.com/Azure/azure-rest-api-specs",
                "branch": "master"
              },
              "sourceTriggerEvents": [
                "commit"
              ]
            }
          ],
          "baseImageTrigger": {
            "name": "myBaseImageTrigger",
            "status": "Enabled",
            "baseImageTriggerType": "Runtime"
          }
        },
        "credentials": {
          "customRegistries": {
            "myRegistry.azure.io": null
          },
          "sourceRegistry": null
        }
      },
      "id": "/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/tasks/myTask",
      "name": "myTask",
      "type": "Microsoft.ContainerRegistry/registries/tasks",
      "location": "eastus",
      "identity": {
        "principalId": "fa153151-b9fd-46f4-9088-5e6600f2689v",
        "tenantId": "f686d426-8d16-42db-81b7-abu4gm510ccd",
        "type": "SystemAssigned"
      },
      "tags": {
        "testkey": "value"
      }
    }
  ]
}

Definíciók

Name	Description
AgentProperties	A futtató ügynök konfigurációját meghatározó tulajdonságok.
Architecture	Az operációs rendszer architektúrája.
Argument	A futtatási argumentum tulajdonságai.
AuthInfo	A forráskódtár eléréséhez szükséges engedélyezési tulajdonságok.
BaseImageDependency	Az alaprendszerkép-függőséget leíró tulajdonságok.
BaseImageDependencyType	Az alaprendszerkép-függőség típusa.
BaseImageTrigger	Az eseményindító az alaprendszerkép-függőségen alapul.
BaseImageTriggerType	Az alaprendszerkép-függőségi frissítések automatikus eseményindítójának típusa.
Credentials	A futtatás meghívásakor használt hitelesítő adatok készletét leíró paraméterek.
CustomRegistryCredentials	Ismerteti azokat a hitelesítő adatokat, amelyeket az egyéni beállításjegyzékek futás közbeni eléréséhez használnak.
DockerBuildStep	A Docker buildelési lépése.
EncodedTaskStep	Kódolt feladatlépés tulajdonságai.
FileTaskStep	Egy tevékenységlépés tulajdonságai.
IdentityProperties	Az erőforrás felügyelt identitása.
OS	A futtatáshoz szükséges operációsrendszer-típus.
PlatformProperties	Azok a platformtulajdonságok, amelyeken a futtatásnak történnie kell.
ProvisioningState	Futtatás kiépítési állapota.
ResourceIdentityType	Az identitás típusa.
SecretObject	Egy titkos objektum értékének tulajdonságait ismerteti.
SecretObjectType	A titkos objektum típusa, amely meghatározza, hogyan kell értelmezni a titkos objektum értékét.
SetValue	Egy feladatsablonnak átadható felülírható érték tulajdonságai.
SourceControlType	A forrásvezérlő szolgáltatás típusa.
SourceProperties	A forráskódtár tulajdonságai.
SourceRegistryCredentials	A forrásregisztrációs adatbázis elérésének hitelesítő paramétereit ismerteti.
SourceRegistryLoginMode	A forrásregisztrációs adatbázis bejelentkezési hatókörét meghatározó hitelesítési mód. A forrásregisztrációs adatbázis hitelesítő adatai a megadott hatókör használatával jönnek létre. A rendszer ezeket a hitelesítő adatokat használja a forrásregisztrációs adatbázisba való bejelentkezéshez a futtatás során.
SourceTrigger	Egy forrásalapú eseményindító tulajdonságai.
SourceTriggerEvent	Az eseményindítónak megfelelő forrásesemény.
Task	Az ARM-erőforrást és tevékenységtulajdonságokat tartalmazó tevékenység. A feladat minden információval rendelkezik a futtatás ütemezéséhez.
TaskListResult	A feladatok gyűjteménye.
TaskStatus	A tevékenység aktuális állapota.
TimerTrigger	Az időzítő-eseményindító tulajdonságai.
TokenType	A hitelesítési jogkivonat típusa.
TriggerProperties	Az eseményindító tulajdonságai.
TriggerStatus	Az eseményindító aktuális állapota.
UserIdentityProperties
Variant	A processzor variánsa.

AgentProperties

Objektum

A futtató ügynök konfigurációját meghatározó tulajdonságok.

Name	Típus	Description
cpu	integer (int32)	A processzorkonfiguráció a futtatáshoz szükséges magok számát tekintve.

Architecture

Enumerálás

Az operációs rendszer architektúrája.

Érték	Description
amd64
arm
x86

Argument

Objektum

A futtatási argumentum tulajdonságai.

Name	Típus	Alapértelmezett érték	Description
isSecret	boolean	False	Jelző, amely jelzi, hogy az argumentum titkos kulcsot jelöl-e, és el szeretné-e távolítani a buildnaplókból.
name	string		Az argumentum neve.
value	string		Az argumentum értéke.

AuthInfo

Objektum

A forráskódtár eléréséhez szükséges engedélyezési tulajdonságok.

Name	Típus	Description
expiresIn	integer (int32)	A jogkivonat érvényességének időtartama másodpercben
refreshToken	string	A hozzáférési jogkivonat frissítéséhez használt frissítési jogkivonat.
scope	string	A hozzáférési jogkivonat hatóköre.
token	string	A forrásvezérlő szolgáltatóhoz való hozzáféréshez használt hozzáférési jogkivonat.
tokenType	TokenType	A hitelesítési jogkivonat típusa.

BaseImageDependency

Objektum

Az alaprendszerkép-függőséget leíró tulajdonságok.

Name	Típus	Description
digest	string	A képjegyzék sha256-alapú kivonata.
registry	string	A beállításjegyzék bejelentkezési kiszolgálója.
repository	string	Az adattár neve.
tag	string	A címke neve.
type	BaseImageDependencyType	Az alaprendszerkép-függőség típusa.

BaseImageDependencyType

Enumerálás

Az alaprendszerkép-függőség típusa.

Érték	Description
BuildTime
RunTime

BaseImageTrigger

Objektum

Az eseményindító az alaprendszerkép-függőségen alapul.

Name	Típus	Alapértelmezett érték	Description
baseImageTriggerType	BaseImageTriggerType		Az alaprendszerkép-függőségi frissítések automatikus eseményindítójának típusa.
name	string		Az eseményindító neve.
status	TriggerStatus	Enabled	Az eseményindító aktuális állapota.

BaseImageTriggerType

Enumerálás

Az alaprendszerkép-függőségi frissítések automatikus eseményindítójának típusa.

Érték	Description
All
Runtime

Credentials

Objektum

A futtatás meghívásakor használt hitelesítő adatok készletét leíró paraméterek.

Name	Típus	Description
customRegistries	<string, CustomRegistryCredentials>	A többi egyéni regisztrációs adatbázishoz való hozzáférés hitelesítő paramétereit ismerteti. A szótárelem kulcsa a beállításjegyzék bejelentkezési kiszolgálója (myregistry.azurecr.io), az elem értéke pedig a beállításjegyzék eléréséhez szükséges hitelesítő adatok lesznek.
sourceRegistry	SourceRegistryCredentials	A forrásregisztrációs adatbázis elérésének hitelesítő paramétereit ismerteti.

CustomRegistryCredentials

Objektum

Ismerteti azokat a hitelesítő adatokat, amelyeket az egyéni beállításjegyzékek futás közbeni eléréséhez használnak.

Name	Típus	Description
identity	string	Az egyéni hitelesítő adatokhoz rendelt felügyelt identitást jelzi. Felhasználó által hozzárendelt identitás esetén ez az érték az ügyfélazonosító. Rendszer által hozzárendelt identitás esetén az érték `system`lesz. Rendszer által hozzárendelt identitás esetén az ügyfélazonosítót a futó határozza meg. Ez az identitás használható a Key Vault hitelesítésére a hitelesítő adatok lekéréséhez, vagy ez lehet az egyetlen hitelesítési forrás, amelyet a beállításjegyzék eléréséhez használnak.
password	SecretObject	Az egyéni beállításjegyzékbe való bejelentkezés jelszava. A jelszó egy titkos objektum, amely több módon is lehetővé teszi az érték megadását.
userName	SecretObject	Az egyéni beállításjegyzékbe való bejelentkezés felhasználóneve.

DockerBuildStep

Objektum

A Docker buildelési lépése.

Name	Típus	Alapértelmezett érték	Description
arguments	Argument[]		A buildelési lépés végrehajtásakor használandó felülbírálási argumentumok gyűjteménye.
baseImageDependencies	BaseImageDependency[]		Egy lépés alaprendszerkép-függőségeinek listája.
contextAccessToken	string		A környezethez társított jogkivonat (a tárfiók-blob git PAT- vagy SAS-jogkivonata).
contextPath	string		A tevékenységlépés forráskörnyezetének URL-címe (abszolút vagy relatív).
dockerFilePath	string		A Docker-fájl elérési útja a forráskörnyezethez képest.
imageNames	string[]		A teljes képnevek, beleértve az adattárat és a címkét.
isPushEnabled	boolean	True	A tulajdonság értéke azt jelzi, hogy a létrehozott rendszerképet le kell-e küldeni a beállításjegyzékbe.
noCache	boolean	False	A tulajdonság értéke azt jelzi, hogy a képgyorsítótár engedélyezve van-e.
target	string		A docker-build cél buildelési szakaszának neve.
type	string: Docker		A lépés típusa.

EncodedTaskStep

Objektum

Kódolt feladatlépés tulajdonságai.

Name	Típus	Description
baseImageDependencies	BaseImageDependency[]	Egy lépés alaprendszerkép-függőségeinek listája.
contextAccessToken	string	A környezethez társított jogkivonat (a tárfiók-blob git PAT- vagy SAS-jogkivonata).
contextPath	string	A tevékenységlépés forráskörnyezetének URL-címe (abszolút vagy relatív).
encodedTaskContent	string	A sablon/definíció fájl tartalmának Base64 kódolású értéke.
encodedValuesContent	string	A paraméterek/értékek fájltartalmának Base64 kódolású értéke.
type	string: EncodedTask	A lépés típusa.
values	SetValue[]	A feladat futtatásakor átadható felülírható értékek gyűjteménye.

FileTaskStep

Objektum

Egy tevékenységlépés tulajdonságai.

Name	Típus	Description
baseImageDependencies	BaseImageDependency[]	Egy lépés alaprendszerkép-függőségeinek listája.
contextAccessToken	string	A környezethez társított jogkivonat (a tárfiók-blob git PAT- vagy SAS-jogkivonata).
contextPath	string	A tevékenységlépés forráskörnyezetének URL-címe (abszolút vagy relatív).
taskFilePath	string	A feladatsablon/definíció fájl elérési útja a forráskörnyezethez viszonyítva.
type	string: FileTask	A lépés típusa.
values	SetValue[]	A feladat futtatásakor átadható felülírható értékek gyűjteménye.
valuesFilePath	string	A tevékenységértékek/paraméterek fájl elérési útja a forráskörnyezethez viszonyítva.

IdentityProperties

Objektum

Az erőforrás felügyelt identitása.

Name	Típus	Description
principalId	string	Az erőforrás-identitás egyszerű azonosítója.
tenantId	string	Az erőforrás bérlőazonosítója.
type	ResourceIdentityType	Az identitás típusa.
userAssignedIdentities	<string, UserIdentityProperties>	Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai a következő formában jelennek meg: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

OS

Enumerálás

A futtatáshoz szükséges operációsrendszer-típus.

Érték	Description
Linux
Windows

PlatformProperties

Objektum

Azok a platformtulajdonságok, amelyeken a futtatásnak történnie kell.

Name	Típus	Description
architecture	Architecture	Az operációs rendszer architektúrája.
os	OS	A futtatáshoz szükséges operációsrendszer-típus.
variant	Variant	A processzor variánsa.

ProvisioningState

Enumerálás

Futtatás kiépítési állapota.

Érték	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

ResourceIdentityType

Enumerálás

Az identitás típusa.

Érték	Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

SecretObject

Objektum

Egy titkos objektum értékének tulajdonságait ismerteti.

Name	Típus	Description
type	SecretObjectType	A titkos objektum típusa, amely meghatározza, hogyan kell értelmezni a titkos objektum értékét.
value	string	A titkos kód értéke. Ennek az értéknek a formátuma a titkos objektum típusa alapján lesz meghatározva. Ha a típus átlátszatlan, a rendszer módosítás nélkül használja az értéket.

SecretObjectType

Enumerálás

A titkos objektum típusa, amely meghatározza, hogyan kell értelmezni a titkos objektum értékét.

Érték	Description
Opaque
Vaultsecret

SetValue

Objektum

Egy feladatsablonnak átadható felülírható érték tulajdonságai.

Name	Típus	Alapértelmezett érték	Description
isSecret	boolean	False	Jelző, amely jelzi, hogy az érték titkos kulcsot jelöl-e vagy sem.
name	string		A felülírható érték neve.
value	string		A felülírható érték.

SourceControlType

Enumerálás

A forrásvezérlő szolgáltatás típusa.

Érték	Description
Github
VisualStudioTeamService

SourceProperties

Objektum

A forráskódtár tulajdonságai.

Name	Típus	Description
branch	string	A forráskód ágneve.
repositoryUrl	string	A forráskódtár teljes URL-címe
sourceControlAuthProperties	AuthInfo	A forráskódtár eléréséhez és az értesítésekhez tartozó webhookok beállításához szükséges engedélyezési tulajdonságok.
sourceControlType	SourceControlType	A forrásvezérlő szolgáltatás típusa.

SourceRegistryCredentials

Objektum

A forrásregisztrációs adatbázis elérésének hitelesítő paramétereit ismerteti.

Name	Típus	Description
loginMode	SourceRegistryLoginMode	A forrásregisztrációs adatbázis bejelentkezési hatókörét meghatározó hitelesítési mód. A forrásregisztrációs adatbázis hitelesítő adatai a megadott hatókör használatával jönnek létre. A rendszer ezeket a hitelesítő adatokat használja a forrásregisztrációs adatbázisba való bejelentkezéshez a futtatás során.

SourceRegistryLoginMode

Enumerálás

A forrásregisztrációs adatbázis bejelentkezési hatókörét meghatározó hitelesítési mód. A forrásregisztrációs adatbázis hitelesítő adatai a megadott hatókör használatával jönnek létre. A rendszer ezeket a hitelesítő adatokat használja a forrásregisztrációs adatbázisba való bejelentkezéshez a futtatás során.

Érték	Description
Default
None

SourceTrigger

Objektum

Egy forrásalapú eseményindító tulajdonságai.

Name	Típus	Alapértelmezett érték	Description
name	string		Az eseményindító neve.
sourceRepository	SourceProperties		A feladat forrását (kódját) leíró tulajdonságok.
sourceTriggerEvents	SourceTriggerEvent[]		Az eseményindítónak megfelelő forrásesemény.
status	TriggerStatus	Enabled	Az eseményindító aktuális állapota.

SourceTriggerEvent

Enumerálás

Az eseményindítónak megfelelő forrásesemény.

Érték	Description
commit
pullrequest

Task

Objektum

Az ARM-erőforrást és tevékenységtulajdonságokat tartalmazó tevékenység. A feladat minden információval rendelkezik a futtatás ütemezéséhez.

Name	Típus	Alapértelmezett érték	Description
id	string		Az erőforrás-azonosító.
identity	IdentityProperties		Az erőforrás identitása.
location	string		Az erőforrás helye. Ez az erőforrás létrehozása után nem módosítható.
name	string		Az erőforrás neve.
properties.agentConfiguration	AgentProperties		A futtató ügynök gépkonfigurációja.
properties.creationDate	string (date-time)		A tevékenység létrehozási dátuma.
properties.credentials	Credentials		A futtatás meghívásakor használt hitelesítő adatok készletét leíró tulajdonságok.
properties.platform	PlatformProperties		Azok a platformtulajdonságok, amelyeken a futtatásnak történnie kell.
properties.provisioningState	ProvisioningState		A tevékenység kiépítési állapota.
properties.status	TaskStatus		A tevékenység aktuális állapota.
properties.step	TaskStepProperties: DockerBuildStep EncodedTaskStep FileTaskStep		Egy tevékenységlépés tulajdonságai.
properties.timeout	integer (int32) minimum: 300 maximum: 28800	3600	Futtassa az időtúllépést másodpercben.
properties.trigger	TriggerProperties		A tevékenység összes eseményindítójának tulajdonságait leíró tulajdonságok.
tags	object		Az erőforrás címkéi.
type	string		Az erőforrás típusa.

TaskListResult

Objektum

A feladatok gyűjteménye.

Name	Típus	Description
nextLink	string	A lapozott eredmények következő készletének lekéréséhez használható URI.
value	Task[]	A gyűjtemény értéke.

TaskStatus

Enumerálás

A tevékenység aktuális állapota.

Érték	Description
Disabled
Enabled

TimerTrigger

Objektum

Az időzítő-eseményindító tulajdonságai.

Name	Típus	Alapértelmezett érték	Description
name	string		Az eseményindító neve.
schedule	string		A tevékenységütemezés CRON-kifejezése
status	TriggerStatus	Enabled	Az eseményindító aktuális állapota.

TokenType

Enumerálás

A hitelesítési jogkivonat típusa.

Érték	Description
OAuth
PAT

TriggerProperties

Objektum

Az eseményindító tulajdonságai.

Name	Típus	Description
baseImageTrigger	BaseImageTrigger	Az eseményindító alaprendszerkép-függőségeken alapul.
sourceTriggers	SourceTrigger[]	Triggerek gyűjteménye a forráskódtár alapján.
timerTriggers	TimerTrigger[]	Időzítő-eseményindítók gyűjteménye.

TriggerStatus

Enumerálás

Az eseményindító aktuális állapota.

Érték	Description
Disabled
Enabled

UserIdentityProperties

Objektum

Name	Típus	Description
clientId	string	A felhasználó által hozzárendelt identitás ügyfélazonosítója.
principalId	string	A felhasználó által hozzárendelt identitás egyszerű azonosítója.

Variant

Enumerálás

A processzor variánsa.

Érték	Description
v6
v7
v8

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

Tasks - List

URI-paraméterek

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

Tasks_List

Mintakérelem

Mintaválasz

Definíciók

AgentProperties

Architecture

Argument

AuthInfo

BaseImageDependency

BaseImageDependencyType

BaseImageTrigger

BaseImageTriggerType

Credentials

CustomRegistryCredentials

DockerBuildStep

EncodedTaskStep

FileTaskStep

IdentityProperties

OS

PlatformProperties

ProvisioningState

ResourceIdentityType

SecretObject

SecretObjectType

SetValue

SourceControlType

SourceProperties

SourceRegistryCredentials

SourceRegistryLoginMode

SourceTrigger

SourceTriggerEvent

Task

TaskListResult

TaskStatus

TimerTrigger

TokenType

TriggerProperties

TriggerStatus

UserIdentityProperties

Variant

További források