Azure Container Registry als een Event Grid bron

Dit artikel bevat de eigenschappen en het schema voor Container Registry gebeurtenissen. Zie Gebeurtenisschema's maken voor Azure Event Grid inleiding tot gebeurtenisschema's.

Beschikbare gebeurtenistypen

Azure Container Registry de volgende gebeurtenistypen:

Gebeurtenistype Beschrijving
Microsoft.ContainerRegistry.ImagePushed Wordt verhoogd wanneer een afbeelding wordt ge pusht.
Microsoft.ContainerRegistry.ImageDeleted Wordt verhoogd wanneer een afbeelding wordt verwijderd.
Microsoft.ContainerRegistry.ChartPushed Wordt weergegeven wanneer een Helm-grafiek wordt ge pusht.
Microsoft.ContainerRegistry.ChartDeleted Wordt weergegeven wanneer een Helm-grafiek wordt verwijderd.

Voorbeeldgebeurtenis

In het volgende voorbeeld ziet u het schema van een gebeurtenis die door een afbeelding is pushen:

[{
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "topic": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ContainerRegistry/registries/<name>",
  "subject": "aci-helloworld:v1",
  "eventType": "ImagePushed",
  "eventTime": "2018-04-25T21:39:47.6549614Z",
  "data": {
    "id": "31c51664-e5bd-416a-a5df-e5206bc47ed0",
    "timestamp": "2018-04-25T21:39:47.276585742Z",
    "action": "push",
    "target": {
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "size": 3023,
      "digest": "sha256:213bbc182920ab41e18edc2001e06abcca6735d87782d9cef68abd83941cf0e5",
      "length": 3023,
      "repository": "aci-helloworld",
      "tag": "v1"
    },
    "request": {
      "id": "7c66f28b-de19-40a4-821c-6f5f6c0003a4",
      "host": "demo.azurecr.io",
      "method": "PUT",
      "useragent": "docker/18.03.0-ce go/go1.9.4 git-commit/0520e24 os/windows arch/amd64 UpstreamClient(Docker-Client/18.03.0-ce \\\\(windows\\\\))"
    }
  },
  "dataVersion": "1.0",
  "metadataVersion": "1"
}]

Het schema voor een verwijderde afbeeldingsgebeurtenis is vergelijkbaar:

[{
  "id": "f06e3921-301f-42ec-b368-212f7d5354bd",
  "topic": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ContainerRegistry/registries/<name>",
  "subject": "aci-helloworld",
  "eventType": "ImageDeleted",
  "eventTime": "2018-04-26T17:56:01.8211268Z",
  "data": {
    "id": "f06e3921-301f-42ec-b368-212f7d5354bd",
    "timestamp": "2018-04-26T17:56:00.996603117Z",
    "action": "delete",
    "target": {
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "digest": "sha256:213bbc182920ab41e18edc2001e06abcca6735d87782d9cef68abd83941cf0e5",
      "repository": "aci-helloworld"
    },
    "request": {
      "id": "aeda5b99-4197-409f-b8a8-ff539edb7de2",
      "host": "demo.azurecr.io",
      "method": "DELETE",
      "useragent": "python-requests/2.18.4"
    }
  },
  "dataVersion": "1.0",
  "metadataVersion": "1"
}]

Het schema voor een door een grafiek pushed gebeurtenis is vergelijkbaar met het schema voor een afbeelding van een pushgebeurtenis, maar bevat geen aanvraagobject:

[{
  "id": "ea3a9c28-5b17-40f6-a500-3f02b6829277",
  "topic": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ContainerRegistry/registries/<name>",
  "subject": "mychart:1.0.0",
  "eventType": "Microsoft.ContainerRegistry.ChartPushed",
  "eventTime": "2019-03-12T22:16:31.5164086Z",
  "data": {
    "id":"ea3a9c28-5b17-40f6-a500-3f02b682927",
    "timestamp":"2019-03-12T22:16:31.0087496+00:00",
    "action":"chart_push",
    "target":{
      "mediaType":"application/vnd.acr.helm.chart",
      "size":25265,
      "digest":"sha256:7f060075264b5ba7c14c23672698152ae6a3ebac1c47916e4efe19cd624d5fab",
      "repository":"repo",
      "tag":"mychart-1.0.0.tgz",
      "name":"mychart",
      "version":"1.0.0"
    }
  },
  "dataVersion": "1.0",
  "metadataVersion": "1"
}]

Het schema voor een verwijderde grafiekgebeurtenis is vergelijkbaar met het schema voor een verwijderde gebeurtenis met afbeeldingen, maar bevat geen aanvraagobject:

[{
  "id": "39136b3a-1a7e-416f-a09e-5c85d5402fca",
  "topic": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ContainerRegistry/registries/<name>",
  "subject": "mychart:1.0.0",
  "eventType": "Microsoft.ContainerRegistry.ChartDeleted",
  "eventTime": "019-03-12T22:42:08.7034064Z",
  "data": {
    "id":"ea3a9c28-5b17-40f6-a500-3f02b682927",
    "timestamp":"2019-03-12T22:42:08.3783775+00:00",
    "action":"chart_delete",
    "target":{
      "mediaType":"application/vnd.acr.helm.chart",
      "size":25265,
      "digest":"sha256:7f060075264b5ba7c14c23672698152ae6a3ebac1c47916e4efe19cd624d5fab",
      "repository":"repo",
      "tag":"mychart-1.0.0.tgz",
      "name":"mychart",
      "version":"1.0.0"
    }
  },
  "dataVersion": "1.0",
  "metadataVersion": "1"
}]

Gebeurteniseigenschappen

Een gebeurtenis heeft de volgende gegevens op het hoogste niveau:

Eigenschap Type Description
topic tekenreeks Volledig resourcepad naar de gebeurtenisbron. Dit veld kan niet worden geschreven. Event Grid biedt deze waarde.
subject tekenreeks Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
eventType tekenreeks Een van de geregistreerde gebeurtenistypen voor deze gebeurtenisbron.
eventTime tekenreeks De tijd dat de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider.
id tekenreeks De unieke id voor de gebeurtenis.
data object Blob Storage-gebeurtenisgegevens.
dataVersion tekenreeks De schemaversie van het gegevensobject. De uitgever definieert de schemaversie.
metadataVersion tekenreeks De schemaversie van de metagegevens van de gebeurtenis. Event Grid definieert het schema voor de eigenschappen op het hoogste niveau. Event Grid biedt deze waarde.

Het gegevensobject heeft de volgende eigenschappen:

Eigenschap Type Description
id tekenreeks De gebeurtenis-id.
timestamp tekenreeks Het tijdstip waarop de gebeurtenis heeft plaatsgevonden.
action tekenreeks De actie die de opgegeven gebeurtenis omvat.
target object Het doel van de gebeurtenis.
request object De aanvraag die de gebeurtenis heeft gegenereerd.

Het doelobject heeft de volgende eigenschappen:

Eigenschap Type Description
mediaType tekenreeks Het MIME-type van het object waarnaar wordt verwezen.
size geheel getal Het aantal bytes van de inhoud. Hetzelfde als het veld Lengte.
digest tekenreeks De samenvatting van de inhoud, zoals gedefinieerd door de Registry V2 HTTP API-specificatie.
length geheel getal Het aantal bytes van de inhoud. Hetzelfde als het veld Grootte.
repository tekenreeks De naam van de opslagplaats.
tag tekenreeks De tagnaam.
name tekenreeks De grafieknaam.
version tekenreeks De grafiekversie.

Het aanvraagobject heeft de volgende eigenschappen:

Eigenschap Type Description
id tekenreeks De id van de aanvraag die de gebeurtenis heeft gestart.
addr tekenreeks Het IP-adres of de hostnaam en mogelijk de poort van de clientverbinding die de gebeurtenis heeft gestart. Deze waarde is de RemoteAddr van de standaard HTTP-aanvraag.
host tekenreeks De extern toegankelijke hostnaam van het registerexe exemplaar, zoals opgegeven door de http-hostheader bij binnenkomende aanvragen.
method tekenreeks De aanvraagmethode die de gebeurtenis heeft gegenereerd.
useragent tekenreeks De header van de gebruikersagent van de aanvraag.

Zelfstudies en handleidingen

Titel Beschrijving
Quickstart: Containerregistergebeurtenissen verzenden Laat zien hoe u Azure CLI kunt gebruiken om Container Registry verzenden.

Volgende stappen