

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

# Tipi di istanza AMI consentiti
<a name="ami-allowed-instance-types"></a>

In qualità di proprietario dell'AMI, puoi specificare quali tipi di istanze supporta o non supporta. Ciò impedisce l'avvio su tipi di istanza incompatibili. Amazon EC2 applica i tipi di istanza consentiti al momento del lancio.

Ad esempio, se la tua AMI richiede hardware GPU, puoi limitarla ai soli tipi di istanze GPU. Se la tua AMI è incompatibile con una specifica famiglia di istanze, puoi escludere quella famiglia dai tipi di istanze consentiti.

**Topics**
+ [Come funzionano i tipi di istanza consentiti](#ami-allowed-instance-types-how-it-works)
+ [Imposta i tipi di istanza consentiti per un'AMI](#ami-allowed-instance-types-set)
+ [Visualizza i tipi di istanza consentiti per un'AMI](#ami-allowed-instance-types-view)
+ [Comportamento di avvio con tipi di istanza consentiti](#ami-allowed-instance-types-launch-behavior)
+ [Considerazioni](#ami-allowed-instance-types-considerations)

## Come funzionano i tipi di istanza consentiti
<a name="ami-allowed-instance-types-how-it-works"></a>

È possibile controllare i tipi di istanza consentiti tramite l'`InstanceTypeSpecification`attributo su un'AMI. Questo attributo contiene due elenchi:
+ `SupportedInstanceTypes`— I tipi di istanza supportati dall'AMI. Solo questi tipi di istanza possono essere avviati con l'AMI.
+ `UnsupportedInstanceTypes`— I tipi di istanza che l'AMI non supporta. Tutti gli altri tipi di istanza possono essere avviati con l'AMI.

Amazon EC2 valuta le specifiche utilizzando la seguente logica:
+ Se non `InstanceTypeSpecification` è impostato, Amazon EC2 consente tutti i tipi di istanza. Questo è il comportamento che segue di default.
+ Se `SupportedInstanceTypes` è impostato only, sono consentiti solo i tipi di istanza specificati. Amazon EC2 blocca tutti gli altri tipi di istanza.
+ Se `UnsupportedInstanceTypes` è impostato solo, Amazon EC2 consente tutti i tipi di istanza tranne quelli specificati.
+ Se entrambi gli elenchi sono impostati, il tipo di istanza deve essere presente `SupportedInstanceTypes` e non deve essere presente`UnsupportedInstanceTypes`.

### Supporto per i caratteri jolly
<a name="ami-allowed-instance-types-wildcards"></a>

Entrambi gli elenchi supportano i caratteri jolly che utilizzano il `*` carattere. È possibile utilizzare i caratteri jolly per abbinare più tipi di istanza senza elencarli singolarmente.

La tabella seguente mostra alcuni esempi di modelli di caratteri jolly.


| Pattern | Corrispondenze | 
| --- | --- | 
| t3.\* | Tutte le dimensioni all'interno della famiglia di t3 istanze (ad esempiot3.micro,t3.small, et3.large) | 
| p4d.\* | Tutte le dimensioni all'interno della famiglia di p4d istanze | 
| g5.\* | Tutte le dimensioni all'interno della famiglia di g5 istanze | 
| \*xlarge | Qualsiasi tipo di istanza di dimensioni maggiori o maggiori in tutte le famiglie di istanze | 
| \*.12xlarge | Qualsiasi tipo di istanza 12xlarge in tutte le famiglie di istanze | 

## Imposta i tipi di istanza consentiti per un'AMI
<a name="ami-allowed-instance-types-set"></a>

Puoi impostare o modificare i tipi di istanza consentiti per un'AMI utilizzando la console Amazon EC2 o AWS Command Line Interface (AWS CLI). Per eseguire questa procedura, è necessario essere il proprietario dell’AMI.

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

**Per impostare i tipi di istanza consentiti 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, quindi scegli ** Azioni**, ** Gestisci la specifica del tipo di istanza**.

1. In Tipi di istanza ** supportati ** o Tipi di istanza ** non supportati**, scegli ** Aggiungi**.

1. Selezionare il tipo di istanza .

1. Selezionare **Salva**.

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

**Per impostare i tipi di istanza supportati per un'AMI**  
Utilizza il comando [replace-image-instance-type-specification](https://docs.aws.amazon.com/cli/latest/reference/ec2/replace-image-instance-type-specification.html). L'esempio seguente consente tutti `t3` i tipi di `a2` istanza tranne`t3.micro`.

```
aws ec2 replace-image-instance-type-specification \
    --image-id {{ami-1234567890abcdef0}} \
    --instance-type-specification '{"SupportedInstanceTypes": ["t3.*", "a2.*"], "UnsupportedInstanceTypes": ["t3.micro"]}'
```

**Per impostare solo i tipi di istanza non supportati per un'AMI**  
Usa il comando seguente per bloccare tipi di istanza specifici consentendone tutti gli altri.

```
aws ec2 replace-image-instance-type-specification \
    --image-id {{ami-1234567890abcdef0}} \
    --instance-type-specification '{"UnsupportedInstanceTypes": ["t3.micro", "t3.nano"]}'
```

**Per rimuovere la specifica del tipo di istanza da un'AMI**  
Utilizzate il seguente comando senza specificare `--instance-type-specification` per rimuovere la restrizione e consentire tutti i tipi di istanza.

```
aws ec2 replace-image-instance-type-specification \
    --image-id {{ami-1234567890abcdef0}}
```

------

## Visualizza i tipi di istanza consentiti per un'AMI
<a name="ami-allowed-instance-types-view"></a>

Puoi visualizzare le specifiche del tipo di istanza per un'AMI utilizzando la console Amazon EC2 o il AWS CLI.

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

**Per visualizzare i tipi di istanza consentiti 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. **Nella scheda ** Dettagli, visualizza i tipi di istanza supportati e non supportati.

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

**Per visualizzare le specifiche del tipo di istanza per un'AMI**  
Utilizza il comando [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html). Se l'AMI ha una specifica del tipo di istanza, la risposta include il `InstanceTypeSpecification` campo.

```
aws ec2 describe-images \
    --image-ids {{ami-1234567890abcdef0}}
```

Di seguito è riportato un esempio di output per un'AMI con una specifica del tipo di istanza.

```
{
    "Images": [
        {
            "ImageId": "ami-1234567890abcdef0",
            ...
            "InstanceTypeSpecification": {
                "SupportedInstanceTypes": [
                    {
                        "InstanceType": "t3.*"
                    },
                    {
                        "InstanceType": "a2.*"
                    }
                ],
                "UnsupportedInstanceTypes": [
                    {
                        "InstanceType": "t3.micro"
                    }
                ]
            }
        }
    ]
}
```

------

## Comportamento di avvio con tipi di istanza consentiti
<a name="ami-allowed-instance-types-launch-behavior"></a>

Quando avvii un'istanza, Amazon EC2 verifica se il tipo di istanza specificato è compatibile con la specifica del tipo di istanza dell'AMI. Se il tipo di istanza non è consentito, Amazon EC2 blocca l'avvio e restituisce un errore.

**Esempio: avvio bloccato**  
Il comando seguente tenta di avviare un'`t3.micro`istanza utilizzando un'AMI che non supporta`t3.micro`.

```
aws ec2 run-instances \
    --image-id {{ami-1234567890abcdef0}} \
    --instance-type t3.micro
```

Amazon EC2 restituisce il seguente errore:

```
An error occurred (InvalidParameterCombination) when calling the RunInstances operation: This AMI does not support the specified instance type. Check DescribeImages for InstanceTypeSpecification, and try again.
```

Per risolvere questo errore, scegli un tipo di istanza supportato dall'AMI. Utilizzate il `describe-images` comando per visualizzare le specifiche del tipo di istanza dell'AMI.

## Considerazioni
<a name="ami-allowed-instance-types-considerations"></a>

Tieni presente le seguenti informazioni quando utilizzi i tipi di istanza consentiti.
+ Per impostazione predefinita, un'AMI non ha una specifica del tipo di istanza. Amazon EC2 consente tutti i tipi di istanza fino a quando non viene impostata esplicitamente una specifica.
+ Solo il proprietario dell'AMI può impostare o modificare la specifica del tipo di istanza.
+ Quando si copia un'AMI utilizzando`CopyImage`, Amazon EC2 conserva la specifica del tipo di istanza nella nuova AMI.
+ Amazon EC2 applica la specifica del tipo di istanza come blocco fisso. Se il tipo di istanza non è consentito, l'avvio non riesce con un `InvalidParameterCombination` errore.
+ La specifica non influisce sulle istanze esistenti. Si applica solo ai nuovi lanci.
+ I modelli di avvio e i gruppi Auto Scaling che fanno riferimento a un'AMI con una specifica del tipo di istanza possono avere esito negativo se il tipo di istanza configurato non è consentito. Consigliamo di verificare la compatibilità prima di impostare una specifica sulle AMI condivise.
+ L'`ReplaceImageInstanceTypeSpecification`azione sostituisce l'intera specifica. Per aggiungere o rimuovere singoli tipi di istanza, è necessario includere la specifica completa aggiornata nella richiesta.