Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Eventi Amazon ECR e EventBridge
Amazon ti EventBridge consente di automatizzare AWS i tuoi servizi e di rispondere automaticamente a eventi di sistema come problemi di disponibilità delle applicazioni o modifiche delle risorse. Gli eventi AWS relativi ai servizi vengono forniti quasi EventBridge in tempo reale. Puoi scrivere regole semplici che indichino quali eventi sono considerati di interesse per te e includere le azioni automatizzate da intraprendere quando un evento corrisponde a una regola. Le azioni che possono essere attivate automaticamente includono le seguenti:
+ Aggiungere eventi ai gruppi di log in CloudWatch Logs
+ Invocare una funzione AWS Lambda
+ Richiamo del comando di esecuzione di Amazon EC2
+ Inoltro dell'evento a Amazon Kinesis Data Streams
+ Attivazione di una macchina a stati AWS Step Functions
+ Notifica di un argomento Amazon SNS o di una coda Amazon SQS
Per ulteriori informazioni, consulta [Getting Started with Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) nella *Amazon EventBridge User Guide*.
## Esempi di eventi da Amazon ECR
Di seguito sono riportati eventi di esempio di Amazon ECR. Gli eventi vengono emessi secondo il principio del massimo sforzo.
**Evento per il push di un'immagine completata**
Il seguente evento viene inviato al termine di ogni push dell'immagine. Per ulteriori informazioni, consulta [Trasferimento di un'immagine Docker a un repository privato Amazon ECR](docker-push-ecr-image.md).
```
{
"version": "0",
"id": "13cde686-328b-6117-af20-0e5566167482",
"detail-type": "ECR Image Action",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2019-11-16T01:54:34Z",
"region": "us-west-2",
"resources": [],
"detail": {
"result": "SUCCESS",
"repository-name": "{{my-repository-name}}",
"image-digest": "{{sha256:7f5b2640fe6fb4f46592dfd3410c4a79dac4f89e4782432e0378abcd1234}}",
"action-type": "PUSH",
"image-tag": "latest"
}
}
```
**Evento per un'azione di cache pull-through**
Il seguente evento viene inviato quando viene tentata un'azione di cache pull-through. Per ulteriori informazioni, consulta [Sincronizzazione di un registro upstream con un registro privato Amazon ECR](pull-through-cache.md).
```
{
"version": "0",
"id": "85fc3613-e913-7fc4-a80c-a3753e4aa9ae",
"detail-type": "ECR Pull Through Cache Action",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2023-02-29T02:36:48Z",
"region": "us-west-2",
"resources": [
"arn:aws:ecr:us-west-2:{{123456789012}}:repository/docker-hub/alpine"
],
"detail": {
"rule-version": "1",
"sync-status": "SUCCESS",
"ecr-repository-prefix": "docker-hub",
"repository-name": "docker-hub/alpine",
"upstream-registry-url": "public.ecr.aws",
"image-tag": "3.17.2",
"image-digest": "{{sha256:4aa08ef415aecc80814cb42fa41b658480779d80c77ab15EXAMPLE}}",
}
}
```
**Evento per la scansione completa di un'immagine (scansione di base)**
Quando la scansione di base è abilitata per il registro, viene inviato il seguente evento al termine di ogni scansione dell'immagine. Il parametro `finding-severity-counts` restituirà un valore per un livello di gravità solo se ne esiste uno. Ad esempio, se l'immagine non contiene risultati a livello `CRITICAL`, non viene restituito alcun conteggio critico. Per ulteriori informazioni, consulta [Scansiona le immagini per individuare le vulnerabilità del sistema operativo in Amazon ECR](image-scanning-basic.md).
**Nota**
Per informazioni dettagliate sugli eventi emessi da Amazon Inspector quando è abilitata la scansione avanzata, consulta [EventBridge eventi inviati per una scansione avanzata in Amazon ECR](image-scanning-enhanced-events.md).
```
{
"version": "0",
"id": "85fc3613-e913-7fc4-a80c-a3753e4aa9ae",
"detail-type": "ECR Image Scan",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2019-10-29T02:36:48Z",
"region": "{{us-east-1}}",
"resources": [
"arn:aws:ecr:{{us-east-1}}:{{123456789012}}:repository/{{my-repository-name}}"
],
"detail": {
"scan-status": "COMPLETE",
"repository-name": "{{my-repository-name}}",
"finding-severity-counts": {
"CRITICAL": {{10}},
"MEDIUM": {{9}}
},
"image-digest": "{{sha256:7f5b2640fe6fb4f46592dfd3410c4a79dac4f89e4782432e0378abcd1234}}",
"image-tags": []
}
}
```
**Evento per una notifica di modifica su una risorsa con scansione avanzata abilitata (scansione avanzata)**
Quando la scansione avanzata è abilitata per il registro, il seguente evento viene inviato da Amazon ECR quando si verifica una modifica con una risorsa che ha abilitato la scansione avanzata. Ciò include la creazione di nuovi repository, la modifica della frequenza di scansione di un repository o la creazione o eliminazione di immagini nei repository con la scansione avanzata abilitata. Per ulteriori informazioni, consulta [Scansiona le immagini per individuare le vulnerabilità del software in Amazon ECR](image-scanning.md).
```
{
"version": "0",
"id": "0c18352a-a4d4-6853-ef53-0ab8638973bf",
"detail-type": "ECR Scan Resource Change",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2021-10-14T20:53:46Z",
"region": "{{us-east-1}}",
"resources": [],
"detail": {
"action-type": "SCAN_FREQUENCY_CHANGE",
"repositories": [{
"repository-name": "repository-1",
"repository-arn": "arn:aws:ecr:{{us-east-1}}:{{123456789012}}:repository/repository-1",
"scan-frequency": "SCAN_ON_PUSH",
"previous-scan-frequency": "MANUAL"
},
{
"repository-name": "repository-2",
"repository-arn": "arn:aws:ecr:{{us-east-1}}:{{123456789012}}:repository/repository-2",
"scan-frequency": "CONTINUOUS_SCAN",
"previous-scan-frequency": "SCAN_ON_PUSH"
},
{
"repository-name": "repository-3",
"repository-arn": "arn:aws:ecr:{{us-east-1}}:{{123456789012}}:repository/repository-3",
"scan-frequency": "CONTINUOUS_SCAN",
"previous-scan-frequency": "SCAN_ON_PUSH"
}
],
"resource-type": "REPOSITORY",
"scan-type": "ENHANCED"
}
}
```
**Evento per l'eliminazione di un'immagine**
Il seguente evento viene inviato quando un'immagine viene eliminata. Per ulteriori informazioni, consulta [Eliminazione di un'immagine in Amazon ECR](delete_image.md).
```
{
"version": "0",
"id": "dd3b46cb-2c74-f49e-393b-28286b67279d",
"detail-type": "ECR Image Action",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2019-11-16T02:01:05Z",
"region": "us-west-2",
"resources": [],
"detail": {
"result": "SUCCESS",
"repository-name": "{{my-repository-name}}",
"image-digest": "{{sha256:7f5b2640fe6fb4f46592dfd3410c4a79dac4f89e4782432e0378abcd1234}}",
"action-type": "DELETE",
"image-tag": "latest"
}
}
```
**Evento per un'azione di archiviazione di immagini**
Il seguente evento viene inviato quando un'immagine viene archiviata. Il `target-storage-class` campo verrà impostato su. `ARCHIVE` L'evento include i tipi di media manifest e artifact per identificare il tipo di contenuto da archiviare.
```
{
"version": "0",
"id": "4f5ec4d5-4de4-7aad-a046-EXAMPLE",
"detail-type": "ECR Image Action",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2019-08-06T00:58:09Z",
"region": "{{us-east-1}}",
"resources": [],
"detail": {
"action-type": "UPDATE_STORAGE_CLASS",
"target-storage-class": "ARCHIVE",
"image-digest": "{{sha256:f98d67af8e53a536502bfc600de3266556b06ed635a32d60aa7a5fe6d7e609d7}}",
"repository-name": "{{ubuntu}}",
"result": "SUCCESS",
"manifest-media-type": "application/vnd.oci.image.manifest.v1+json",
"artifact-media-type": "application/vnd.oci.image.config.v1+json"
}
}
```
**Evento relativo a un'azione di ripristino dell'immagine**
Il seguente evento viene inviato quando viene ripristinata un'immagine archiviata. Il `target-storage-class` campo verrà impostato su. `STANDARD` L'evento include un `last-activated-at` campo che mostra quando l'immagine è stata ripristinata l'ultima volta.
```
{
"version": "0",
"id": "7b8fc5e6-5ef5-8bbe-b157-EXAMPLE",
"detail-type": "ECR Image Action",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2019-08-06T01:15:22Z",
"region": "{{us-east-1}}",
"resources": [],
"detail": {
"action-type": "UPDATE_STORAGE_CLASS",
"target-storage-class": "STANDARD",
"image-digest": "{{sha256:f98d67af8e53a536502bfc600de3266556b06ed635a32d60aa7a5fe6d7e609d7}}",
"repository-name": "{{ubuntu}}",
"result": "SUCCESS",
"manifest-media-type": "application/vnd.oci.image.manifest.v1+json",
"artifact-media-type": "application/vnd.oci.image.config.v1+json",
"last-activated-at": "2025-10-10T19:13:02.74Z"
}
}
```
**Evento relativo a un'azione di ripristino del referente**
L'evento seguente viene inviato quando viene ripristinato un referrer archiviato (elemento di riferimento come un SBOM, una firma o un attestato). Nota che serve a distinguerlo dalle normali azioni `detail-type` relative `ECR Referrer Action` all'immagine. I `artifact-media-type` campi `manifest-media-type` e identificano il tipo specifico di referente da ripristinare. In questo esempio, viene ripristinato un elemento SBOM.
```
{
"version": "0",
"id": "8c9gd6f7-6fg6-9ccf-c268-EXAMPLE",
"detail-type": "ECR Referrer Action",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2019-08-06T01:20:45Z",
"region": "{{us-east-1}}",
"resources": [],
"detail": {
"action-type": "UPDATE_STORAGE_CLASS",
"target-storage-class": "STANDARD",
"image-digest": "{{sha256:f98d67af8e53a536502bfc600de3266556b06ed635a32d60aa7a5fe6d7e609d7}}",
"repository-name": "{{sbom}}",
"result": "SUCCESS",
"manifest-media-type": "application/vnd.cncf.oras.artifact.manifest.v1+json",
"artifact-media-type": "text/sbom+json",
"last-activated-at": "2025-10-10T19:13:02.74Z"
}
}
```
**Evento per una replica dell'immagine completata**
Il seguente evento viene inviato al termine di ogni replica dell'immagine. Per ulteriori informazioni, consulta [Private image replication in Amazon ECR](replication.md).
```
{
"version": "0",
"id": "c8b133b1-6029-ee73-e2a1-4f466b8ba999",
"detail-type": "ECR Replication Action",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2024-05-08T20:44:54Z",
"region": "us-east-1",
"resources": [
"arn:aws:ecr:{{us-east-1}}:{{123456789012}}:repository/docker-hub/alpine"
],
"detail": {
"result": "SUCCESS",
"repository-name": "{{docker-hub/alpine}}",
"image-digest": "{{sha256:7f5b2640fe6fb4f46592dfd3410c4a79dac4f89e4782432e0378abcd1234}}",
"source-account": "{{123456789012}}",
"action-type": "REPLICATE",
"source-region": "{{us-west-2}}",
"image-tag": "3.17.2"
}
}
```
**Evento relativo a una replica dell'immagine non riuscita**
Il seguente evento viene inviato quando una replica dell'immagine fallisce. Il `result` campo conterrà `FAILED` e nei dettagli dell'evento potrebbero essere incluse ulteriori informazioni sull'errore.
```
{
"version": "0",
"id": "d9c244c2-7130-ff84-f3b2-5g577c9cb000",
"detail-type": "ECR Replication Action",
"source": "aws.ecr",
"account": "{{123456789012}}",
"time": "2024-05-08T20:45:12Z",
"region": "us-east-1",
"resources": [
"arn:aws:ecr:{{us-east-1}}:{{123456789012}}:repository/my-app"
],
"detail": {
"result": "FAILED",
"repository-name": "{{my-app}}",
"image-digest": "{{sha256:8g6c3751gf7gc5g47603ege4511d5a80ead5g90f5893543f1489bde2345}}",
"source-account": "{{123456789012}}",
"action-type": "REPLICATE",
"source-region": "{{us-west-2}}",
"image-tag": "latest"
}
}
```