

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

# Menambahkan pemetaan perangkat blok ke AMI
<a name="ami-block-device-mapping"></a>

Setiap AMI memiliki pemetaan perangkat blok yang menentukan perangkat blok yang akan dipasang ke suatu instans ketika diluncurkan dari AMI. Untuk menambahkan lebih banyak perangkat blok ke AMI, Anda harus membuat AMI sendiri.

**Topics**
+ [Tentukan pemetaan perangkat blok untuk AMI](#create-ami-bdm)
+ [Lihat volume EBS dalam pemetaan perangkat blok AMI](#view-ami-bdm)

## Tentukan pemetaan perangkat blok untuk AMI
<a name="create-ami-bdm"></a>

Ada dua cara untuk menentukan volume sebagai tambahan pada volume root saat Anda membuat AMI. Jika Anda telah melampirkan volume ke instans yang sedang berjalan sebelum membuat AMI dari instans, pemetaan perangkat blok untuk AMI akan menyertakan volume yang sama. Untuk volume EBS, data yang ada disimpan ke snapshot baru, dan snapshot baru inilah yang ditentukan dalam pemetaan perangkat blok. Untuk volume penyimpanan instans, data tidak disimpan.

Untuk AMI yang didukung EBS, Anda dapat menambahkan volume EBS dan volume penyimpanan instans menggunakan pemetaan perangkat blok. Untuk AMI yang didukung Amazon S3, Anda dapat menambahkan volume penyimpanan instance hanya dengan memodifikasi entri pemetaan perangkat blok dalam file manifes gambar saat mendaftarkan gambar.

**catatan**  
Untuk instans M3, Anda harus menentukan volume penyimpanan instans dalam pemetaan perangkat blok untuk instans ketika Anda meluncurkannya. Saat Anda meluncurkan instans M3, volume penyimpanan instans yang ditentukan dalam pemetaan perangkat blok untuk AMI dapat diabaikan jika tidak ditentukan sebagai bagian dari pemetaan perangkat blok instans.

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

**Untuk menambahkan volume ke AMI**

1. Buka konsol Amazon EC2.

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

1. Pilih suatu instans dan pilih **Tindakan**, **Citra dan templat**, **Buat citra**.

1. Masukkan nama dan deskripsi untuk citra.

1. Volume instans muncul di bawah **Volume instans**. Untuk menambahkan volume lainnya, pilih **Tambahkan volume**.

1. Untuk **Tipe volume**, pilih tipe volume. Untuk **Perangkat** pilih nama perangkat. Untuk volume EBS, Anda dapat menentukan detail tambahan, seperti snapshot, ukuran volume, tipe volume, IOPS, dan status enkripsi.

1. Pilih **Buat citra**.

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

**Untuk menambahkan volume ke AMI**

Gunakan perintah [create-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-image.html) untuk menentukan pemetaan perangkat blok untuk AMI yang didukung EBS. Gunakan perintah [register-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-image.html) untuk menentukan pemetaan perangkat blok untuk AMI yang didukung Amazon S3.

Tentukan pemetaan perangkat blok menggunakan parameter `--block-device-mappings`. Anda dapat menentukan argumen yang dikodekan dalam JSON langsung pada baris perintah atau dengan mereferensikan file JSON, seperti yang ditunjukkan di sini.

```
--block-device-mappings file://mapping.json
```

Untuk menambahkan volume penyimpanan instans, gunakan pemetaan berikut. Perhatikan bahwa volume penyimpanan NVMe instance ditambahkan secara otomatis.

```
{
    "DeviceName": "device_name",
    "VirtualName": "ephemeral0"
}
```

Untuk menambahkan volume kosong 100 GiB, gunakan pemetaan berikut ini.

```
{
    "DeviceName": "device_name",
    "Ebs": {
      "VolumeSize": 100
    }
}
```

Untuk menambahkan volume EBS berdasarkan snapshot, gunakan pemetaan berikut.

```
{
    "DeviceName": "device_name",
    "Ebs": {
      "SnapshotId": "snap-1234567890abcdef0"
    }
}
```

Untuk pemetaan perangkat, gunakan pemetaan berikut.

```
{
    "DeviceName": "device_name",
    "NoDevice": ""
}
```

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

Gunakan [New-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Image.html)cmdlet untuk menentukan pemetaan perangkat blok untuk AMI yang didukung EBS. Gunakan [Register-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2Image.html)cmdlet untuk menentukan pemetaan perangkat blok untuk AMI yang didukung Amazon S3.

Tambahkan `-BlockDeviceMapping` opsi, tentukan pembaruan di`bdm`:

```
-BlockDeviceMapping $bdm
```

Pemetaan berikut menambahkan volume berdasarkan snapshot.

```
$ebd = New-Object -TypeName Amazon.EC2.Model.EbsBlockDevice
$ebd.SnapshotId = "snap-1234567890abcdef0"
$bdm = New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping
$bdm.DeviceName = "device_name"
$bdm.Ebs = $ebd
```

Pemetaan berikut menambahkan volume 100 GB kosong.

```
$ebd = New-Object -TypeName Amazon.EC2.Model.EbsBlockDevice
$ebd.VolumeSize = 100
$bdm = New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping
$bdm.DeviceName = "device_name"
$bdm.Ebs = $ebd
```

------

## Lihat volume EBS dalam pemetaan perangkat blok AMI
<a name="view-ami-bdm"></a>

Anda dapat dengan mudah mengenumerasi volume EBS dalam pemetaan perangkat blok untuk AMI.

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

**Untuk melihat volume EBS untuk AMI**

1. Buka konsol Amazon EC2.

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

1. Pilih **gambar EBS** dari daftar **Filter** untuk mendapatkan daftar AMIs EBS yang didukung. 

1. Pilih AMI yang diinginkan, dan lihat tab **Detail**. Minimal, informasi berikut tersedia untuk volume root (di mana istilah **perangkat root** setara dengan **volume root**):
   + **Jenis Perangkat Root** (`ebs`)
   + **Nama Perangkat Root** (misalnya, `/dev/sda1`)
   + **Perangkat blok** (misalnya, `/dev/sda1=snap-1234567890abcdef0:8:true`)

   Jika AMI dibuat dengan volume EBS tambahan menggunakan pemetaan perangkat blok, **Perangkat Blok** menampilkan pemetaan untuk volume tambahan juga. Jika AMI dibuat dengan volume EBS tambahan menggunakan pemetaan perangkat blok, Perangkat Blok menampilkan pemetaan untuk volume tambahan juga.

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

**Untuk melihat volume EBS untuk AMI**  
Gunakan perintah [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html).

```
aws ec2 describe-images \
    --image-ids ami-0abcdef1234567890 \
    --query Image[0].BlockDeviceMappings
```

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

**Untuk melihat volume EBS untuk AMI**  
Gunakan [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html)cmdlet.

```
(Get-EC2Image -ImageId ami-0abcdef1234567890).BlockDeviceMappings
```

------