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à.
# Usa le filigrane AMI per tracciare e identificare le AMI
Una filigrana AMI è un identificatore che alleghi alle tue AMI private per tracciare la provenienza e applicare le politiche di governance. Le filigrane persistono per l'intero ciclo di vita dell'AMI:
+ Se crei una nuova AMI da un'istanza in esecuzione lanciata da un'AMI con filigrana, la nuova AMI eredita la filigrana.
+ Se si copia un AMI con filigrana, la filigrana viene riportata sulla copia.
+ Se memorizzi un'AMI con filigrana su S3 e la ripristini, l'AMI ripristinata conserva la filigrana.
+ Se condividi un'AMI con filigrana con un altro account, la filigrana rimane visibile al destinatario.
L'uso delle filigrane AMI ti aiuta a:
**Vantaggi principali**
+ Tieni traccia della provenienza tra account e regioni: identifica quali AMI derivano dalle immagini di base approvate.
+ Filtra e trova le AMI correlate nei tuoi account.
+ Aiuta i consumatori AMI a scoprire e identificare le AMI affidabili associate a un progetto o a un'organizzazione.
**Topics**
+ [Come funzionano le filigrane AMI](#ami-watermark-how-it-works)
+ [Autorizzazioni richieste](#ami-watermark-permissions)
+ [Aggiungi una filigrana a un AMI](#ami-watermark-attach)
+ [Staccare una filigrana da un AMI](#ami-watermark-detach)
+ [Visualizza filigrane AMI](#ami-watermark-view)
+ [Filtra le AMI per filigrana](#ami-watermark-filter)
## Come funzionano le filigrane AMI
Le filigrane AMI sono identificatori strutturati che puoi allegare alle tue AMI. Di seguito vengono descritte le caratteristiche principali delle filigrane:
+ **Persiste**: quando si allega una filigrana a un'AMI, questa viene trasferita a tutte le AMI derivate.
+ **Owner-only**— Solo il proprietario di un AMI può aggiungere filigrane a un AMI.
+ **Visibile a tutti**: chiunque abbia accesso all'AMI può visualizzarne le filigrane.
+ **Limite di 5**: un'AMI può avere fino a un totale di 5 watermark.
+ **Non disponibile sulle AMI pubbliche**: non puoi allegare filigrane alle AMI pubbliche o rendere pubbliche le AMI se dispongono di una filigrana.
+ **Filtrabile: puoi filtrare** le AMI in base alla filigrana durante l'utilizzo. `describe-images`
### Formato filigrana
Una filigrana è un oggetto strutturato con i seguenti campi:
+ `WatermarkKey`— L'identificatore univoco della filigrana, composto da. `{{account-id}}:{{watermark-name}}` La parte relativa all'ID dell'account è l'ID dell' AWS account a 12 cifre del proprietario dell'AMI. La parte relativa al nome della filigrana è un nome specificato dal cliente.
+ `SourceImageRegion`— La regione dell'AMI a cui è stata originariamente applicata la filigrana.
+ `SourceImageId`— L'AMI a cui è stata originariamente applicata la filigrana.
+ `SourceImageCreationDate`— La data di creazione dell'AMI a cui è stata originariamente allegata la filigrana.
+ `WatermarkCreationTime`— Il timestamp di quando hai applicato la filigrana.
Il nome della filigrana deve contenere da 3 a 128 caratteri e può contenere caratteri alfanumerici, parentesi ((()), parentesi quadre ([]), spazi, punti (.), barre (/), trattini (-), virgolette singole ('), segni (@) o caratteri di sottolineatura (\_).
## Autorizzazioni richieste
Per utilizzare le filigrane AMI, sono necessarie le seguenti autorizzazioni IAM:
+ `ec2:AttachImageWatermark`— Per aggiungere una filigrana a un AMI.
+ `ec2:DetachImageWatermark`— Per staccare una filigrana da un AMI.
+ `ec2:DescribeImages`— Per visualizzare le filigrane sulle AMI.
## Aggiungi una filigrana a un AMI
È possibile allegare una filigrana a un'AMI utilizzando la console, il AWS CLI, o PowerShell.
------
#### [ Console ]
**Per aggiungere una filigrana a un AMI**
1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Nel riquadro di navigazione scegliere **AMIs (AMI)**.
1. Seleziona l’AMI.
1. Nella scheda **Dettagli**, nella sezione Filigrane, scegli **Gestisci** **filigrane**.
1. **Inserisci il nome di una filigrana e scegli Allega.**
------
#### [ AWS CLI ]
**Per aggiungere una filigrana a un AMI**
Utilizzate il comando [attach-image-watermark](https://docs.aws.amazon.com/cli/latest/reference/ec2/attach-image-watermark.html).
```
aws ec2 attach-image-watermark \
--image-id {{ami-1111111111EXAMPLE}} \
--image-watermark-name "{{prod-baseline}}"
```
Di seguito è riportato un output di esempio.
```
{
"WatermarkKey": "123456789012:prod-baseline"
}
```
------
#### [ PowerShell ]
**Per aggiungere una filigrana a un AMI**
Utilizza il cmdlet [Add-EC2ImageWatermark](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-EC2ImageWatermark.html).
```
Add-EC2ImageWatermark `
-ImageId {{ami-1111111111EXAMPLE}} `
-ImageWatermarkName "{{prod-baseline}}"
```
------
Puoi allegare fino a 5 filigrane a un singolo AMI.
## Staccare una filigrana da un AMI
Puoi staccare una filigrana da un'AMI utilizzando la console, il AWS CLI, o. PowerShell
------
#### [ Console ]
**Per staccare una filigrana da un AMI**
1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Nel riquadro di navigazione scegliere **AMIs (AMI)**.
1. Seleziona l’AMI.
1. **Nella scheda **Dettagli**, nella sezione Filigrane, scegli **Gestisci filigrane**.**
1. **Seleziona la filigrana da rimuovere, quindi scegli Rimuovi.**
------
#### [ AWS CLI ]
**Per staccare una filigrana da un AMI**
Usa il comando [detach-image-watermark](https://docs.aws.amazon.com/cli/latest/reference/ec2/detach-image-watermark.html).
```
aws ec2 detach-image-watermark \
--image-id {{ami-1111111111EXAMPLE}} \
--image-watermark-key "{{111122223333:prod-baseline}}"
```
------
#### [ PowerShell ]
**Per staccare una filigrana da un AMI**
Utilizza il cmdlet [Remove-EC2ImageWatermark](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2ImageWatermark.html).
```
Remove-EC2ImageWatermark `
-ImageId {{ami-1111111111EXAMPLE}} `
-ImageWatermarkKey "{{111122223333:prod-baseline}}"
```
------
**Nota**
Il distacco di una filigrana da un'AMI non la rimuove dalle AMI derivate che già contengono la filigrana. Per garantire che le filigrane rimangano persistenti, concedi l'`ec2:DetachImageWatermark`autorizzazione solo ad amministratori affidabili che devono gestire le filigrane.
## Visualizza filigrane AMI
È possibile visualizzare le filigrane per un'AMI utilizzando la console, il AWS CLI, o PowerShell.
------
#### [ Console ]
**Per visualizzare le filigrane per un'AMI**
1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Nel riquadro di navigazione scegliere **AMIs (AMI)**.
1. Seleziona l’AMI.
1. **Visualizza le filigrane nella sezione **Filigrane** della scheda Dettagli.**
------
#### [ AWS CLI ]
**Per visualizzare le filigrane per un'AMI**
Utilizzare il comando [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) .
```
aws ec2 describe-images \
--image-ids {{ami-046863d776a820ccd}} \
--region {{us-east-1}}
```
La risposta include l'`ImageWatermarks`array per ogni AMI.
```
{
"Images": [
{
"ImageId": "ami-046863d776a820ccd",
"Public": false,
"OwnerId": "123456789012",
...
"ImageWatermarks": [
{
"WatermarkKey": "111122223333:prod-baseline",
"Region": "us-east-1",
"SourceImageId": "ami-0b752bf1df193a6c4",
"SourceImageCreationDate": "2024-07-10T08:15:00",
"CreationDate": "2024-07-12T14:30:00"
},
{
"WatermarkKey": "222222222222:security-approved",
"Region": "eu-north-1",
"SourceImageId": "ami-12345678",
"SourceImageCreationDate": "2024-06-01T10:00:00",
"CreationDate": "2024-06-05T09:45:00"
}
]
}
]
}
```
------
#### [ PowerShell ]
**Per visualizzare le filigrane per un'AMI**
Utilizza il cmdlet [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html).
```
(Get-EC2Image -ImageId {{ami-046863d776a820ccd}}).ImageWatermarks
```
------
## Filtra le AMI per filigrana
Puoi filtrare le AMI in base alla filigrana utilizzando la console, il, o. AWS CLI PowerShell
------
#### [ Console ]
**Per filtrare le AMI in base alla filigrana**
1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Nel riquadro di navigazione scegliere **AMIs (AMI)**.
1. Nella barra di ricerca, scegli il filtro **chiave Watermark e inserisci il valore della chiave** Watermark.
------
#### [ AWS CLI ]
**Per filtrare le AMI in base alla filigrana**
Utilizza il comando [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) con il filtro `image-watermark-key`.
```
aws ec2 describe-images \
--filters "Name=image-watermark-key,Values={{111122223333:prod-baseline}}"
```
In questo modo vengono restituite tutte le AMI a cui hai accesso che riportano la filigrana specificata, incluse le AMI derivate che l'hanno ereditata tramite operazioni di copia.
------
#### [ PowerShell ]
**Per filtrare le AMI in base alla filigrana**
Utilizzare il [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html)cmdlet con il parametro. `-Filter`
```
Get-EC2Image `
-Filter @{Name="image-watermark-key"; Values="{{111122223333:prod-baseline}}"}
```
Ciò restituisce tutte le AMI a cui hai accesso che riportano la filigrana specificata, incluse le AMI derivate che l'hanno ereditata tramite operazioni di copia.
------