

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Jenis instans yang diizinkan AMI
<a name="ami-allowed-instance-types"></a>

Sebagai pemilik AMI, Anda dapat menentukan jenis instans mana yang didukung atau tidak didukung AMI Anda. Ini mencegah peluncuran pada jenis instance yang tidak kompatibel. Amazon EC2 memberlakukan jenis instans yang diizinkan pada waktu peluncuran.

Misalnya, jika AMI Anda memerlukan perangkat keras GPU, Anda dapat membatasinya hanya untuk jenis instans GPU. Jika AMI Anda tidak kompatibel dengan keluarga instans tertentu, Anda dapat mengecualikan keluarga tersebut dari jenis instans yang diizinkan.

**Topics**
+ [Cara kerja jenis instans yang diizinkan](#ami-allowed-instance-types-how-it-works)
+ [Menetapkan jenis instans yang diizinkan untuk AMI](#ami-allowed-instance-types-set)
+ [Melihat jenis instans yang diizinkan untuk AMI](#ami-allowed-instance-types-view)
+ [Perilaku luncurkan dengan jenis instance yang diizinkan](#ami-allowed-instance-types-launch-behavior)
+ [Pertimbangan-pertimbangan](#ami-allowed-instance-types-considerations)

## Cara kerja jenis instans yang diizinkan
<a name="ami-allowed-instance-types-how-it-works"></a>

Anda mengontrol jenis instans yang diizinkan melalui `InstanceTypeSpecification` atribut pada AMI. Atribut ini berisi dua daftar:
+ `SupportedInstanceTypes`- Jenis instance yang didukung AMI. Hanya jenis instance ini yang dapat diluncurkan dengan AMI.
+ `UnsupportedInstanceTypes`- Jenis instance yang tidak didukung AMI. Semua jenis instance lainnya dapat diluncurkan dengan AMI.

Amazon EC2 mengevaluasi spesifikasi menggunakan logika berikut:
+ Jika tidak `InstanceTypeSpecification` disetel, Amazon EC2 mengizinkan semua jenis instans. Ini adalah perilaku default.
+ Jika hanya `SupportedInstanceTypes` disetel, hanya jenis instance yang ditentukan yang diizinkan. Amazon EC2 memblokir semua jenis instans lainnya.
+ Jika hanya `UnsupportedInstanceTypes` disetel, Amazon EC2 mengizinkan semua jenis instans kecuali yang ditentukan.
+ Jika kedua daftar disetel, jenis instance harus masuk `SupportedInstanceTypes` dan tidak boleh masuk`UnsupportedInstanceTypes`.

### Dukungan wildcard
<a name="ami-allowed-instance-types-wildcards"></a>

Kedua daftar mendukung pola wildcard menggunakan `*` karakter. Anda dapat menggunakan wildcard untuk mencocokkan beberapa jenis instans tanpa mencantumkan masing-masing satu per satu.

Tabel berikut menunjukkan contoh pola wildcard.


| Pola | Cocok | 
| --- | --- | 
| t3.\* | Semua ukuran dalam keluarga t3 instance (misalnya,t3.micro,t3.small, dant3.large) | 
| p4d.\* | Semua ukuran dalam keluarga p4d instance | 
| g5.\* | Semua ukuran dalam keluarga g5 instance | 
| \*xlarge | Setiap jenis instans yang xlarge atau lebih besar di semua keluarga instans | 
| \*.12xlarge | Setiap jenis instance 12xlarge di semua keluarga instans | 

## Menetapkan jenis instans yang diizinkan untuk AMI
<a name="ami-allowed-instance-types-set"></a>

Anda dapat mengatur atau mengubah jenis instans yang diizinkan untuk AMI menggunakan konsol Amazon EC2 atau AWS Command Line Interface (AWS CLI). Anda harus merupakan pemilik AMI untuk melakukan prosedur ini.

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

**Untuk menyetel jenis instans yang diizinkan untuk AMI**

1. Buka konsol Amazon EC2 di [ https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Di panel navigasi, pilih **AMI**.

1. Pilih AMI, lalu pilih Ac ** tions**, Kel ** ola spesifikasi jenis instance**.

1. Di bawah ** Jenis instans yang didukung ** atau Jenis instans ** yang tidak didukung**, pilih Tam ** bah**.

1. Pilih jenis instans.

1. Pilih **Simpan**.

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

**Untuk menyetel jenis instans yang didukung untuk AMI**  
Gunakan perintah [replace-image-instance-type-specification](https://docs.aws.amazon.com/cli/latest/reference/ec2/replace-image-instance-type-specification.html). Contoh berikut memungkinkan semua `t3` dan jenis `a2` instance kecuali`t3.micro`.

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

**Untuk menyetel hanya jenis instans yang tidak didukung untuk AMI**  
Gunakan perintah berikut untuk memblokir jenis instance tertentu sambil mengizinkan semua yang lain.

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

**Untuk menghapus spesifikasi tipe instance dari AMI**  
Gunakan perintah berikut tanpa menentukan `--instance-type-specification` untuk menghapus batasan dan mengizinkan semua jenis instance.

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

------

## Melihat jenis instans yang diizinkan untuk AMI
<a name="ami-allowed-instance-types-view"></a>

Anda dapat melihat spesifikasi jenis instans untuk AMI menggunakan konsol Amazon EC2 atau. AWS CLI

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

**Untuk melihat jenis instans yang diizinkan untuk AMI**

1. Buka konsol Amazon EC2 di [ https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Di panel navigasi, pilih **AMI**.

1. Pilih AMI.

1. Pada ** tab ** Detail, lihat jenis instans yang didukung dan tidak didukung.

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

**Untuk melihat spesifikasi tipe instans untuk AMI**  
Gunakan perintah [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html). Jika AMI memiliki spesifikasi tipe instance, respons menyertakan `InstanceTypeSpecification` bidang tersebut.

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

Berikut ini adalah contoh output untuk AMI dengan spesifikasi tipe instance.

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

------

## Perilaku luncurkan dengan jenis instance yang diizinkan
<a name="ami-allowed-instance-types-launch-behavior"></a>

Saat Anda meluncurkan instans, Amazon EC2 memeriksa apakah jenis instans yang ditentukan kompatibel dengan spesifikasi jenis instans AMI. Jika jenis instans tidak diizinkan, Amazon EC2 memblokir peluncuran dan mengembalikan kesalahan.

**Contoh: Peluncuran yang diblokir**  
Perintah berikut mencoba meluncurkan `t3.micro` instance menggunakan AMI yang tidak mendukung`t3.micro`.

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

Amazon EC2 mengembalikan kesalahan berikut:

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

Untuk mengatasi kesalahan ini, pilih jenis instance yang didukung AMI. Gunakan `describe-images` perintah untuk melihat spesifikasi tipe instance AMI.

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

Ingatlah informasi berikut saat Anda menggunakan jenis instans yang diizinkan.
+ Secara default, AMI tidak memiliki spesifikasi tipe instance. Amazon EC2 mengizinkan semua jenis instans hingga Anda menetapkan spesifikasi secara eksplisit.
+ Hanya pemilik AMI yang dapat mengatur atau mengubah spesifikasi tipe instance.
+ Saat Anda menyalin AMI menggunakan`CopyImage`, Amazon EC2 mempertahankan spesifikasi jenis instans di AMI baru.
+ Amazon EC2 memberlakukan spesifikasi tipe instans sebagai blok keras. Jika jenis instance tidak diizinkan, peluncuran gagal dengan `InvalidParameterCombination` kesalahan.
+ Spesifikasi tidak mempengaruhi instance yang ada. Ini hanya berlaku untuk peluncuran baru.
+ Peluncuran templat dan grup Penskalaan Otomatis yang mereferensikan AMI dengan spesifikasi tipe instance dapat gagal jika jenis instance yang dikonfigurasi tidak diizinkan. Sebaiknya verifikasi kompatibilitas sebelum menetapkan spesifikasi pada AMI bersama.
+ T `ReplaceImageInstanceTypeSpecification` indakan menggantikan seluruh spesifikasi. Untuk menambah atau menghapus tipe instance individual, Anda harus menyertakan spesifikasi lengkap yang diperbarui dalam permintaan.