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

# Gestisci le impostazioni per le AMI consentite
<a name="manage-settings-allowed-amis"></a>

Puoi gestire le impostazioni per le AMI consentite. Queste impostazioni sono specifiche per ogni regione e per ogni account.

**Topics**
+ [Abilitare le AMI consentite](#enable-allowed-amis-criteria)
+ [Imposta i criteri delle AMI consentite](#update-allowed-amis-criteria)
+ [Disabilitare le AMI consentite](#disable-allowed-amis-criteria)
+ [Ottieni i criteri delle AMI consentite](#identify-allowed-amis-state-and-criteria)
+ [Trova le AMI consentite](#identify-amis-that-meet-allowed-amis-criteria)
+ [Trova le istanze avviate da AMI che non sono consentite](#identify-instances-with-allowed-AMIs)

## Abilitare le AMI consentite
<a name="enable-allowed-amis-criteria"></a>

Puoi abilitare le AMI consentite e specificare i criteri delle AMI consentite. Consigliamo di iniziare in modalità di controllo, che mostra quali AMI sarebbero interessate dai criteri senza limitare effettivamente l’accesso.

------
#### [ Console ]

**Per abilitare le AMI consentite**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Nel pannello di navigazione seleziona **Pannello di controllo**.

1. Nella scheda **Attributi dell'account**, in **Impostazioni**, scegli AMI **consentite**.

1. Nella scheda **AMI consentite**, seleziona **Gestisci**.

1. Per **Impostazioni AMI consentite**, seleziona **Modalità di controllo** o **Abilitato**. Consigliamo di iniziare in modalità di controllo, testare i criteri e poi tornare a questo passaggio per abilitare le AMI consentite.

1. (Facoltativo) Per i **criteri delle AMI**, inserisci i criteri in formato JSON.

1. Scegliere **Aggiorna**.

------
#### [ AWS CLI ]

**Per abilitare le AMI consentite**  
Utilizza il comando [enable-allowed-images-settings](https://docs.aws.amazon.com/cli/latest/reference/ec2/enable-allowed-images-settings.html).

```
aws ec2 enable-allowed-images-settings --allowed-images-settings-state enabled
```

Per abilitare la modalità di controllo, invece, specifica `audit-mode` invece di `enabled`.

```
aws ec2 enable-allowed-images-settings --allowed-images-settings-state audit-mode
```

------
#### [ PowerShell ]

**Per abilitare le AMI consentite**  
Utilizza il cmdlet [Enable-EC2AllowedImagesSetting](https://docs.aws.amazon.com/powershell/latest/reference/items/Enable-EC2AllowedImagesSetting.html).

```
Enable-EC2AllowedImagesSetting -AllowedImagesSettingsState enabled
```

Per abilitare la modalità di controllo, invece, specifica `audit-mode` invece di `enabled`.

```
Enable-EC2AllowedImagesSetting -AllowedImagesSettingsState audit-mode
```

------

## Imposta i criteri delle AMI consentite
<a name="update-allowed-amis-criteria"></a>

Dopo aver abilitato le AMI consentite, puoi impostare o sostituire i criteri delle AMI consentite.

Per la corretta configurazione e i valori validi, consulta [Configurazione delle AMI consentite](ec2-allowed-amis.md#allowed-amis-json-configuration) e [Parametri per le AMI consentite](ec2-allowed-amis.md#allowed-amis-criteria).

------
#### [ Console ]

**Per impostare i criteri delle AMI consentite**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Nel pannello di navigazione seleziona **Pannello di controllo**.

1. Nella scheda **Attributi dell'account**, in **Impostazioni**, scegli **AMI consentite**.

1. Nella scheda **AMI consentite**, seleziona **Gestisci**.

1. Per i **criteri delle AMI**, inserisci i criteri in formato JSON.

1. Scegliere **Aggiorna**.

------
#### [ AWS CLI ]

**Per impostare i criteri delle AMI consentite**  
Utilizza il comando [replace-image-criteria-in-allowed-images-settings](https://docs.aws.amazon.com/cli/latest/reference/ec2/replace-image-criteria-in-allowed-images-settings.html) e specifica il file JSON che contiene i criteri delle AMI consentite.

```
aws ec2 replace-image-criteria-in-allowed-images-settings --cli-input-json file://{{file_name.json}}
```

------
#### [ PowerShell ]

**Per impostare i criteri delle AMI consentite**  
Utilizza il [Set-EC2ImageCriteriaInAllowedImagesSetting](https://docs.aws.amazon.com/powershell/latest/reference/items/Set-EC2ImageCriteriaInAllowedImagesSetting.html)cmdlet e specifica il file JSON che contiene i criteri delle AMI consentite.

```
$imageCriteria = Get-Content -Path .\{{file_name.json}} | ConvertFrom-Json
Set-EC2ImageCriteriaInAllowedImagesSetting -ImageCriterion $imageCriteria
```

------

## Disabilitare le AMI consentite
<a name="disable-allowed-amis-criteria"></a>

Puoi disabilitare le AMI consentite come segue.

------
#### [ Console ]

**Per disabilitare le AMI consentite**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Nel pannello di navigazione seleziona **Pannello di controllo**.

1. **Nella scheda **Attributi dell'account**, in **Impostazioni, scegli AMI consentite**.**

1. Nella scheda **AMI consentite**, seleziona **Gestisci**.

1. Per le **impostazioni delle AMI consentite**, scegli **Disabilitato**.

1. Scegliere **Aggiorna**.

------
#### [ AWS CLI ]

**Per disabilitare le AMI consentite**  
Utilizza il comando [disable-allowed-images-settings](https://docs.aws.amazon.com/cli/latest/reference/ec2/disable-allowed-images-settings.html).

```
aws ec2 disable-allowed-images-settings
```

------
#### [ PowerShell ]

**Per disabilitare le AMI consentite**  
Utilizza il cmdlet [Disable-EC2AllowedImagesSetting](https://docs.aws.amazon.com/powershell/latest/reference/items/Disable-EC2AllowedImagesSetting.html).

```
Disable-EC2AllowedImagesSetting
```

------

## Ottieni i criteri delle AMI consentite
<a name="identify-allowed-amis-state-and-criteria"></a>

Puoi ottenere lo stato corrente dell’impostazione delle AMI consentite e dei criteri delle AMI consentite.

------
#### [ Console ]

**Per ottenere lo stato e i criteri delle AMI consentite**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Nel pannello di navigazione seleziona **Pannello di controllo**.

1. Nella scheda **Attributi dell'account**, in **Impostazioni**, scegli **AMI consentite**.

1. Nella scheda **AMI consentite**, **l’impostazione AMI consentite** è impostata su **Abilitato**, **Disabilitato** o **Modalità di controllo**.

1. Se lo stato delle AMI consentite è **Abilitato** o **Modalità di controllo**, i **criteri AMI** visualizzano i criteri AMI in formato JSON.

------
#### [ AWS CLI ]

**Per ottenere lo stato e i criteri delle AMI consentite**  
Utilizza il comando [get-allowed-images-settings](https://docs.aws.amazon.com/cli/latest/reference/ec2/get-allowed-images-settings.html).

```
aws ec2 get-allowed-images-settings
```

Nell’output dell’esempio seguente, lo stato è `audit-mode` e i criteri per le immagini sono impostati nell’account.

```
{
    "State": "audit-mode",
    "ImageCriteria": [
        {
            "MarketplaceProductCodes": [
                "abcdefg1234567890"
            ]
        },
        {
            "ImageProviders": [
                "123456789012",
                "123456789013"
            ],
            "CreationDateCondition": {
                "MaximumDaysSinceCreated": 300
            }
        },
        {
            "ImageProviders": [
                "123456789014"
            ],
            "ImageNames": [
                "golden-ami-*"
            ]
        },
        {
            "ImageProviders": [
                "amazon"
            ],
            "DeprecationTimeCondition": {
                "MaximumDaysSinceDeprecated": 0
            }
        }
    ],
    "ManagedBy": "account"
}
```

------
#### [ PowerShell ]

**Per ottenere lo stato e i criteri delle AMI consentite**  
Utilizza il cmdlet [Get-EC2AllowedImagesSetting](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2AllowedImagesSetting.html).

```
Get-EC2AllowedImagesSetting | Select-Object `
    State, `
    ManagedBy, `
    @{Name='ImageProviders'; Expression={($_.ImageCriteria.ImageProviders)}}, `
    @{Name='MarketplaceProductCodes'; Expression={($_.ImageCriteria.MarketplaceProductCodes)}}, `
    @{Name='ImageNames'; Expression={($_.ImageCriteria.ImageNames)}}, `
    @{Name='MaximumDaysSinceCreated'; Expression={($_.ImageCriteria.CreationDateCondition.MaximumDaysSinceCreated)}}, `
    @{Name='MaximumDaysSinceDeprecated'; Expression={($_.ImageCriteria.DeprecationTimeCondition.MaximumDaysSinceDeprecated)}}
```

Nell’output dell’esempio seguente, lo stato è `audit-mode` e i criteri per le immagini sono impostati nell’account.

```
State      : audit-mode
ManagedBy  : account
ImageProviders            : {123456789012, 123456789013, 123456789014, amazon}
MarketplaceProductCodes   : {abcdefg1234567890}
ImageNames                : {golden-ami-*}
MaximumDaysSinceCreated  : 300
MaximumDaysSinceDeprecated: 0
```

------

## Trova le AMI consentite
<a name="identify-amis-that-meet-allowed-amis-criteria"></a>

Puoi trovare le AMI consentite o non consentite in base ai criteri delle AMI consentite attuali.

**Nota**  
Abilita le AMI consentite nella modalità di controllo.

------
#### [ Console ]

**Per controllare se un’AMI soddisfa i criteri delle AMI consentite**

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** (se hai selezionato la casella di spunta) o nell'area di riepilogo (se hai selezionato l'ID dell'AMI), trova il campo **Immagine consentita**.
   + **Sì**: l’AMI soddisfa i criteri per le AMI consentite. Questa AMI sarà disponibile per gli utenti del tuo account dopo aver abilitato le AMI consentite.
   + **No**: l’AMI non soddisfa i criteri per le AMI consentite.

1. Nel riquadro di navigazione seleziona **AMI Catalog** (catalogo AMI).

   Un'AMI contrassegnata come **Non consentita** indica un'AMI che non soddisfa i criteri delle AMI consentite. Questa AMI non sarà visibile o disponibile per gli utenti nel tuo account quando le AMI consentite sono abilitate.

------
#### [ AWS CLI ]

**Per controllare se un’AMI soddisfa i criteri delle AMI consentite**  
Utilizzare il comando [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) .

```
aws ec2 describe-images \
    --image-id {{ami-0abcdef1234567890}} \
    --query Images[].ImageAllowed \
    --output text
```

Di seguito è riportato un output di esempio.

```
True
```

**Per trovare le AMI che soddisfano i criteri delle AMI consentite**  
Utilizzare il comando [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) .

```
aws ec2 describe-images \
    --filters "Name=image-allowed,Values=true" \
    --max-items 10 \
    --query Images[].ImageId
```

Di seguito è riportato un output di esempio.

```
ami-000eaaa8be2fd162a
ami-000f82db25e50de8e
ami-000fc21eb34c7a9a6
ami-0010b876f1287d7be
ami-0010b929226fe8eba
ami-0010957836340aead
ami-00112c992a47ba871
ami-00111759e194abcc1
ami-001112565ffcafa5e
ami-0011e45aaee9fba88
```

------
#### [ PowerShell ]

**Per controllare se un’AMI soddisfa i criteri delle AMI consentite**  
Utilizza il cmdlet [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html).

```
(Get-EC2Image -ImageId {{ami-0abcdef1234567890}}).ImageAllowed
```

Di seguito è riportato un output di esempio.

```
True
```

**Per trovare le AMI che soddisfano i criteri delle AMI consentite**  
Utilizza il cmdlet [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html).

```
Get-EC2Image `
    -Filter @{Name="image-allows";Values="true"} `
    -MaxResult 10 | `
    Select ImageId
```

Di seguito è riportato un output di esempio.

```
ami-000eaaa8be2fd162a
ami-000f82db25e50de8e
ami-000fc21eb34c7a9a6
ami-0010b876f1287d7be
ami-0010b929226fe8eba
ami-0010957836340aead
ami-00112c992a47ba871
ami-00111759e194abcc1
ami-001112565ffcafa5e
ami-0011e45aaee9fba88
```

------

## Trova le istanze avviate da AMI che non sono consentite
<a name="identify-instances-with-allowed-AMIs"></a>

Puoi identificare le istanze avviate utilizzando un’AMI che non soddisfa i criteri delle AMI consentite.

------
#### [ Console ]

**Per verificare se un’istanza è stata avviata utilizzando un’AMI non consentita**

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, seleziona **Instances (Istanze)**.

1. Selezionare l'istanza.

1. Nella scheda **Dettagli**, sotto **Dettagli istanza**, trova **Immagine consentita**.
   + **Sì**: l’AMI soddisfa i criteri per le AMI consentite.
   + **No**: l’AMI non soddisfa i criteri per le AMI consentite.

------
#### [ AWS CLI ]

**Per trovare le istanze avviate utilizzando AMI non consentite**  
Utilizza il comando [describe-instance-image-metadata](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-image-metadata.html) con il filtro `image-allowed`.

```
aws ec2 describe-instance-image-metadata \
    --filters "Name=image-allowed,Values=false" \
    --query "InstanceImageMetadata[*].[InstanceId,ImageMetadata.ImageId]" \
    --output table
```

Di seguito è riportato un output di esempio.

```
--------------------------------------------------
|          DescribeInstanceImageMetadata         |
+----------------------+-------------------------+
|  i-08fd74f3f1595fdbd |  ami-09245d5773578a1d6  |
|  i-0b1bf24fd4f297ab9 |  ami-07cccf2bd80ed467f  |
|  i-026a2eb590b4f7234 |  ami-0c0ec0a3a3a4c34c0  |
|  i-006a6a4e8870c828f |  ami-0a70b9d193ae8a799  |
|  i-0781e91cfeca3179d |  ami-00c257e12d6828491  |
|  i-02b631e2a6ae7c2d9 |  ami-0bfddf4206f1fa7b9  |
+----------------------+-------------------------+
```

------
#### [ PowerShell ]

**Per trovare le istanze avviate utilizzando AMI non consentite**  
Utilizza il cmdlet [Get-EC2InstanceImageMetadata](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceImageMetadata.html).

```
Get-EC2InstanceImageMetadata `
    -Filter @{Name="image-allowed";Values="false"} | `
    Select InstanceId, @{Name='ImageId'; Expression={($_.ImageMetadata.ImageId)}}
```

Di seguito è riportato un output di esempio.

```
InstanceId          ImageId
----------          -------
i-08fd74f3f1595fdbd ami-09245d5773578a1d6
i-0b1bf24fd4f297ab9 ami-07cccf2bd80ed467f
i-026a2eb590b4f7234 ami-0c0ec0a3a3a4c34c0
i-006a6a4e8870c828f ami-0a70b9d193ae8a799
i-0781e91cfeca3179d ami-00c257e12d6828491
i-02b631e2a6ae7c2d9 ami-0bfddf4206f1fa7b9
```

------
#### [ AWS Config ]

Puoi aggiungere la AWS Config regola **ec2-instance-launched-with-allowed-ami**, configurarla in base alle tue esigenze e poi usarla per valutare le tue istanze.

[https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config_add-rules.html](https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config_add-rules.html)

------