View a markdown version of this page

Usa le filigrane AMI per tracciare e identificare le AMI - Amazon Elastic Compute Cloud

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 far rispettare le politiche di governance. Le filigrane persistono per tutto il ciclo di vita dell'AMI:

  • Se crei una nuova AMI da un'istanza in esecuzione avviata da un'AMI con filigrana, la nuova AMI eredita la filigrana.

  • Se si copia un'AMI con filigrana, la copia riporta la filigrana.

  • Se condividi un'AMI con filigrana con un altro account, la filigrana rimane visibile al destinatario.

Vantaggi principali
  • Tieni traccia della provenienza tra account e aree geografiche: identifica quali AMI derivano dalle tue 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.

  • Applica la governance combinando le filigrane con le AMI consentite per limitare l'avvio delle istanze alle sole AMI con filigrane approvate.

Come funzionano le filigrane AMI

Le filigrane AMI sono identificatori strutturati che alleghi 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 dell'AMI può allegare 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 filigrane.

  • Non disponibile sulle AMI pubbliche: non è possibile allegare filigrane alle AMI pubbliche o rendere pubbliche le AMI se sono dotate di 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 titolare dell'AMI. La parte relativa al nome in filigrana è un nome specificato dal cliente.

  • SourceImageRegion— La regione dell'AMI a cui hai originariamente associato la filigrana.

  • SourceImageId— L'AMI a cui hai originariamente allegato la filigrana.

  • SourceImageCreationDate— La data di creazione dell'AMI a cui hai originariamente allegato 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 ('), chiocciola (@) o trattini bassi (_).

Autorizzazioni richieste

Per lavorare con le filigrane AMI, sono necessarie le seguenti autorizzazioni IAM:

  • ec2:AttachImageWatermark— Per allegare una filigrana a un'AMI.

  • ec2:DetachImageWatermark— Per staccare una filigrana da un AMI.

  • ec2:DescribeImages— Per visualizzare le filigrane sulle AMI.

Allega una filigrana a un'AMI

Puoi allegare una filigrana a un'AMI utilizzando la console, il AWS CLI, o. PowerShell

Console
Per allegare una filigrana a un'AMI
  1. Apri la console Amazon EC2 all'indirizzo https://console.aws.amazon.com/ec2/.

  2. Nel riquadro di navigazione scegliere AMIs (AMI).

  3. Seleziona l’AMI.

  4. Nella scheda Dettagli, nella sezione Filigrane, scegli Gestisci filigrane.

  5. Inserisci un nome per la filigrana e scegli Allega.

AWS CLI
Per allegare una filigrana a un'AMI

Usa il comando https://docs.aws.amazon.com/cli/latest/reference/ec2/attach-image-watermark.html attach-image-watermark.

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 allegare una filigrana a un'AMI

Utilizza il cmdlet Add-EC2ImageWatermark.

Add-EC2ImageWatermark ` -ImageId ami-1111111111EXAMPLE ` -ImageWatermarkName "prod-baseline"

Puoi allegare fino a 5 filigrane a una singola AMI.

Stacca una filigrana da un'AMI

Puoi staccare una filigrana da un'AMI usando la console, o. AWS CLI PowerShell

Console
Per staccare una filigrana da un'AMI
  1. Apri la console Amazon EC2 all'indirizzo https://console.aws.amazon.com/ec2/.

  2. Nel riquadro di navigazione scegliere AMIs (AMI).

  3. Seleziona l’AMI.

  4. Nella scheda Dettagli, nella sezione Filigrane, scegli Gestisci filigrane.

  5. Seleziona la filigrana da rimuovere, quindi scegli Rimuovi.

AWS CLI
Per staccare una filigrana da un'AMI

Usa il comando detach-image-watermark.

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.

Remove-EC2ImageWatermark ` -ImageId ami-1111111111EXAMPLE ` -ImageWatermarkKey "111122223333:prod-baseline"
Nota

La rimozione 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:DetachImageWatermarkautorizzazione solo agli amministratori fidati che devono gestire le filigrane.

Visualizza le filigrane AMI

È possibile visualizzare le filigrane per un'AMI utilizzando la console, il AWS CLI, o. PowerShell

Console
Per visualizzare le filigrane di un'AMI
  1. Apri la console Amazon EC2 all'indirizzo https://console.aws.amazon.com/ec2/.

  2. Nel riquadro di navigazione scegliere AMIs (AMI).

  3. Seleziona l’AMI.

  4. Visualizza le filigrane nella sezione Filigrane della scheda Dettagli.

AWS CLI
Per visualizzare le filigrane per un'AMI

Utilizzare il comando describe-images .

aws ec2 describe-images \ --image-ids ami-046863d776a820ccd \ --region us-east-1

La risposta include l'ImageWatermarksarray 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.

(Get-EC2Image -ImageId ami-046863d776a820ccd).ImageWatermarks

Filtrare le AMI in base alla 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/.

  2. Nel riquadro di navigazione scegliere AMIs (AMI).

  3. 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 con il filtro image-watermark-key.

aws ec2 describe-images \ --filters "Name=image-watermark-key,Values=111122223333:prod-baseline"

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 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.