

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

# Blokir pemetaan perangkat untuk volume di instans Amazon EC2
<a name="block-device-mapping-concepts"></a>

Setiap instance yang Anda luncurkan memiliki volume root terkait, yaitu volume Amazon EBS atau volume penyimpanan instans. Anda dapat menggunakan pemetaan perangkat blokir untuk menentukan volume EBS tambahan atau volume penyimpanan instans untuk dilampirkan ke instance saat diluncurkan. Anda juga dapat melampirkan volume EBS tambahan ke instance yang sedang berjalan. Namun, satu-satunya cara untuk melampirkan volume penyimpanan instance ke sebuah instance adalah dengan menggunakan pemetaan perangkat blok untuk melampirkan volume saat instance diluncurkan.

**Topics**
+ [Konsep pemetaan perangkat blok](#block-device-mapping-def)
+ [Menambahkan pemetaan perangkat blok ke AMI](ami-block-device-mapping.md)
+ [Tambahkan pemetaan perangkat blok ke instans Amazon EC2](instance-block-device-mapping.md)

## Konsep pemetaan perangkat blok
<a name="block-device-mapping-def"></a>

*Perangkat blok* adalah perangkat penyimpanan yang memindahkan data dalam urutan byte atau(blok). Perangkat ini mendukung akses acak dan umumnya menggunakan I/O buffer. Contohnya termasuk hard disk, drive CD-ROM, dan flash drive. Perangkat blok dapat dipasang secara fisik ke komputer atau diakses dari jarak jauh seolah-olah perangkat tersebut terpasang secara fisik ke komputer.

Amazon EC2 mendukung dua jenis perangkat blok: 
+ Volume penyimpanan instans (perangkat virtual yang perangkat keras yang mendasari secara fisik terpasang ke komputer host untuk instans)
+ Volume EBS (perangkat penyimpanan jarak jauh)

*pemetaan perangkat blok* menentukan perangkat blok (volume penyimpanan instans dan volume EBS) untuk dilampirkan ke suatu instans. Anda dapat menentukan pemetaan perangkat blok sebagai bagian dari pembuatan AMI sehingga pemetaan tersebut digunakan oleh semua instans yang diluncurkan dari AMI. Atau, Anda dapat menentukan pemetaan perangkat blok ketika Anda meluncurkan instans, sehingga pemetaan ini menimpa pemetaan yang ditentukan dalam AMI tempat Anda meluncurkan instans. Perhatikan bahwa semua volume penyimpanan NVMe instans yang didukung oleh tipe instans secara otomatis dihitung dan diberi nama perangkat pada peluncuran instance; memasukkannya ke dalam pemetaan perangkat blokir tidak berpengaruh.

**Topics**
+ [Entri pemetaan perangkat blok](#parts-of-a-block-device-mapping)
+ [Peringatan penyimpanan instans pemetaan perangkat pemetaan perangkat blok](#instance_store_caveats)
+ [Contoh pemetaan perangkat blok](#block-device-mapping-ex)
+ [Cara perangkat disediakan dalam sistem operasi](#bdm-to-os)

### Entri pemetaan perangkat blok
<a name="parts-of-a-block-device-mapping"></a>

Ketika Anda membuat pemetaan perangkat blok, Anda menentukan informasi berikut untuk setiap perangkat blok yang perlu dilampirkan ke instans:
+ Nama perangkat yang digunakan Amazon EC2. Driver perangkat blok untuk instans menetapkan nama volume aktual saat melakukan pemasangan volume. Nama yang diberikan dapat berbeda dari nama yang direkomendasikan oleh Amazon EC2. Untuk informasi selengkapnya, lihat [Nama perangkat untuk volume di EC2 instans Amazon](device_naming.md).

Untuk volume penyimpanan instans, Anda juga menentukan informasi berikut:
+ Perangkat virtual: `ephemeral[0-23]`. Perhatikan bahwa jumlah dan ukuran volume penyimpanan instans yang tersedia untuk instans Anda berbeda-beda menurut tipe instans.

 NVMe Misalnya volume toko, informasi berikut juga berlaku:
+ Volume ini secara otomatis dienumerasi dan diberi nama perangkat; menyertakannya dalam pemetaan perangkat blok Anda tidak akan berpengaruh.

Untuk volume EBS, Anda juga menentukan informasi berikut:
+ ID snapshot yang digunakan untuk membuat perangkat blok (snap-*xxxxxxxx*). Nilai ini opsional selama Anda menentukan ukuran volume. Anda tidak dapat menentukan ID snapshot yang diarsipkan.
+ Ukuran volume, dalam GiB. Ukuran yang ditentukan harus lebih besar atau sama dengan ukuran snapshot yang ditentukan.
+ Apakah akan menghapus volume pada saat pengakhiran instans (`true` atau `false`). Nilai default adalah `true` untuk volume root dan `false` volume terlampir. Saat Anda membuat AMI, sistem pemetaan perangkat blok mewarisi pengaturan ini dari instans. Saat diluncurkan, instans akan mewarisi pengaturan ini dari AMI.
+ Tipe volume, yang bisa berupa `gp2` dan `gp3` untuk SSD Tujuan Umum, `io1` dan `io2` untuk SSD IOPS yang Tersedia, `st1` untuk HDD Throughput Dioptimalkan, `sc1` untuk Cold HDD, atau `standard` untuk Magnetik.
+ Jumlah input/output operasi per detik (IOPS) yang didukung volume. (Hanya digunakan dengan volume `io1` dan `io2`.)
+ Beberapa jenis contoh mendukung lebih dari satu kartu EBS. Anda dapat memilih kartu EBS untuk volume yang akan dilampirkan dengan menentukan indeks kartu EBS. Untuk informasi selengkapnya, lihat [Kartu EBS](ebs_cards.md#ebs_cards.title).

### Peringatan penyimpanan instans pemetaan perangkat pemetaan perangkat blok
<a name="instance_store_caveats"></a>

Ada beberapa peringatan yang perlu dipertimbangkan saat meluncurkan instance AMIs yang memiliki volume penyimpanan instance dalam pemetaan perangkat bloknya.
+ Beberapa tipe instans menyertakan lebih banyak volume penyimpanan instans daripada yang lain, dan beberapa tipe instans tidak mengandung volume penyimpanan instans sama sekali. Jika tipe instans Anda mendukung satu volume penyimpanan instans, dan AMI Anda memiliki pemetaan untuk dua volume penyimpanan instans, instans akan meluncurkan dengan satu volume penyimpanan instans.
+ Volume penyimpanan instans hanya dapat dipetakan pada waktu peluncuran. Anda tidak dapat menghentikan instans tanpa volume penyimpanan instans (seperti `t2.micro`), mengubah instans ke tipe yang mendukung volume penyimpanan instans, lalu memulai ulang instans dengan volume penyimpanan instans. Namun, Anda dapat membuat AMI dari instans dan meluncurkannya pada tipe instans yang mendukung volume penyimpanan instans, dan memetakan volume penyimpanan instans tersebut ke instans.
+ Jika Anda meluncurkan instans dengan volume penyimpanan instans yang dipetakan, lalu menghentikan instans dan mengubahnya menjadi tipe instans dengan volume penyimpanan instans yang lebih sedikit, lalu memulai ulang instans tersebut, pemetaan volume penyimpanan instans dari peluncuran awal akan tetap muncul di metadata instans. Namun, hanya jumlah maksimum volume penyimpanan instans yang didukung untuk tipe instans tersebut yang tersedia untuk instans tersebut.
**catatan**  
Saat instans dihentikan atau diakhiri, semua data pada volume penyimpanan instans akan hilang.
+ Bergantung pada kapasitas penyimpanan instans pada saat peluncuran, instans M3 dapat mengabaikan pemetaan perangkat blok penyimpanan instans AMI pada saat peluncuran kecuali jika ditentukan pada saat peluncuran. Anda harus menentukan instans pemetaan perangkat blok penyimpanan pada saat peluncuran, bahkan jika AMI yang Anda luncurkan memiliki volume penyimpanan yang dipetakan di AMI, untuk memastikan bahwa volume penyimpanan instans tersedia saat peluncuran. 

### Contoh pemetaan perangkat blok
<a name="block-device-mapping-ex"></a>

Gambar ini menunjukkan contoh pemetaan perangkat blok untuk instans yang didukung EBS. Gambar ini memetakan `/dev/sdb` ke `ephemeral0` dan memetakan dua volume EBS, satu untuk `/dev/sdh` dan yang lainnya ke `/dev/sdj`. Ini juga menunjukkan volume EBS yang merupakan volume root,`/dev/sda1`.

![\[Hubungan antara instans, volume penyimpanan instans, dan volume EBS.\]](http://docs.aws.amazon.com/id_id/AWSEC2/latest/UserGuide/images/block_device_mapping_figure.png)


Perhatikan bahwa contoh pemetaan perangkat blok ini digunakan dalam perintah contoh dan APIs dalam topik ini. Anda dapat menemukan perintah contoh dan APIs yang membuat pemetaan perangkat blok di [Tentukan pemetaan perangkat blok untuk AMI](ami-block-device-mapping.md#create-ami-bdm) dan. [Memperbarui pemetaan perangkat blok saat meluncurkan suatu instans](instance-block-device-mapping.md#Using_OverridingAMIBDM)

### Cara perangkat disediakan dalam sistem operasi
<a name="bdm-to-os"></a>

Nama perangkat seperti `/dev/sdh` dan `xvdh` digunakan oleh Amazon EC2 untuk menjelaskan perangkat blok. Pemetaan perangkat blok digunakan oleh Amazon EC2 untuk menentukan perangkat blok yang akan dilampirkan di instans EC2. Setelah dilampirkan pada suatu instans, perangkat blok harus dipasang oleh sistem operasi sebelum Anda dapat mengakses perangkat penyimpanan. Ketika dilepaskan dari suatu instans, perangkat blok dilepaskan oleh sistem operasi dan Anda tidak dapat lagi mengakses perangkat penyimpanan.

**Instance Linux** — Nama perangkat yang ditentukan dalam pemetaan perangkat blok dipetakan ke perangkat blok yang sesuai saat instance pertama kali melakukan booting. Tipe instans menentukan volume penyimpanan instans mana yang diformat dan dipasang secara default. Anda dapat memasang volume penyimpanan instans tambahan saat peluncuran, selama Anda tidak melebihi jumlah volume penyimpanan instans yang tersedia untuk tipe instans Anda. Untuk informasi selengkapnya, lihat [Instans menyimpan penyimpanan blok sementara untuk instans EC2](InstanceStorage.md). Driver perangkat blok untuk instans menentukan perangkat yang digunakan saat volume diformat dan dipasang.

**Instans Windows** - Nama perangkat yang ditentukan dalam pemetaan perangkat blok dipetakan ke perangkat blok yang sesuai saat instance pertama kali melakukan boot, dan kemudian layanan Ec2Config menginisialisasi dan memasang drive. Volume root dipasang sebagai`C:\`. Volume penyimpanan instans dipasang sebagai `Z:\`, `Y:\`, dan sebagainya. Saat dipasang, volume EBS dapat dipasang menggunakan huruf drive yang tersedia. Namun, Anda dapat mengonfigurasi bagaimana huruf drive ditetapkan ke volume EBS; untuk informasi selengkapnya, lihat[Agen peluncuran Windows di instans Amazon EC2 Windows](configure-launch-agents.md).

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

------

# Tambahkan pemetaan perangkat blok ke instans Amazon EC2
<a name="instance-block-device-mapping"></a>

Secara default, instans yang Anda luncurkan menyertakan perangkat penyimpanan apa pun yang ditentukan dalam pemetaan perangkat blok AMI tempat Anda meluncurkan instans. Anda dapat menentukan perubahan pada pemetaan perangkat blok untuk sebuah instans saat Anda meluncurkannya, dan pembaruan ini akan menimpa atau bergabung dengan pemetaan perangkat blok AMI.

**Batasan**
+ Untuk volume root, Anda hanya dapat memodifikasi hal berikut: ukuran volume, tipe volume, dan tanda **Hapus saat Pengakhiran**.
+ Saat Anda memodifikasi volume EBS, Anda tidak dapat mengurangi ukuran. Oleh karena itu, Anda harus menentukan snapshot yang ukurannya sama atau lebih besar dari ukuran snapshot yang ditentukan dalam pemetaan perangkat blok AMI.

**Topics**
+ [Memperbarui pemetaan perangkat blok saat meluncurkan suatu instans](#Using_OverridingAMIBDM)
+ [Perbarui pemetaan perangkat blok instans yang berjalan](#update-instance-bdm)
+ [Lihat volume EBS dalam pemetaan perangkat blok instans](#view-instance-bdm)
+ [Lihat pemetaan perangkat blok instans untuk volume penyimpanan instans](#bdm-instance-metadata)

## Memperbarui pemetaan perangkat blok saat meluncurkan suatu instans
<a name="Using_OverridingAMIBDM"></a>

Anda dapat menambahkan volume EBS dan volume penyimpanan instans ke instans pada saat Anda meluncurkannya. Perhatikan bahwa pembaruan pemetaan perangkat blok untuk suatu instans tidak membuat perubahan permanen pada pemetaan perangkat blok AMI tempatnya diluncurkan.

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

**Untuk memperbarui volume untuk sebuah instance saat peluncuran**

1. Ikuti prosedur untuk [meluncurkan instance](ec2-launch-instance-wizard.md), tetapi jangan meluncurkan instance sampai Anda menyelesaikan langkah-langkah berikut untuk memperbarui volume.

1. (Opsional) Untuk menambahkan volume, pilih **Konfigurasi penyimpanan**, **Tambahkan volume baru**. Pilih ukuran volume dan jenis volume.

1. **(Opsional) Untuk menekan volume yang ditentukan oleh pemetaan perangkat blok AMI, pilih **Konfigurasi penyimpanan**, Hapus.**

1. **(Opsional) Untuk mengubah konfigurasi volume EBS, pada panel **Configure storage**, pilih Advanced.** Perluas informasi untuk volume, dan buat perubahan apa pun yang Anda butuhkan.

1. Di panel **Summary**, tinjau konfigurasi instans Anda, lalu pilih **Launch instans**. Untuk informasi selengkapnya, lihat [Luncurkan instans EC2 menggunakan wizard instans peluncuran di konsol](ec2-launch-instance-wizard.md).

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

**Untuk memperbarui volume untuk sebuah instance saat peluncuran**  
Gunakan perintah [run-instance](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) dengan opsi. `--block-device-mappings`

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

Misalnya, misalkan pemetaan perangkat blok AMI menentukan hal berikut:
+ `/dev/xvda`- Volume akar EBS
+ `/dev/sdh`- Volume EBS dibuat dari `snap-1234567890abcdef0`
+ `/dev/sdj`- Volume EBS kosong dengan ukuran `100`
+ `/dev/sdb`- Volume toko instans `ephemeral0`

Misalkan berikut ini adalah pemetaan perangkat blok instance di`mapping.json`.

```
[
    {
        "DeviceName": "/dev/xvda",
        "Ebs": {
            "VolumeSize": 100
        }
    },
    {
        "DeviceName": "/dev/sdj",
        "NoDevice": ""
    },
    {
        "DeviceName": "/dev/sdh",
        "Ebs": {
            "VolumeSize": 300
        }
    },
    {
        "DeviceName": "/dev/sdc",
        "VirtualName": "ephemeral1"
    }
]
```

Pemetaan perangkat blok instance melakukan hal berikut:
+ Mengesampingkan ukuran volume root,`/dev/xvda`, meningkatkannya menjadi 100 GiB.
+ Mencegah `/dev/sdj` dari melampirkan ke instance.
+ Mengesampingkan ukuran`/dev/sdh`, meningkatkannya menjadi 300 GiB. Perhatikan bahwa Anda tidak perlu menentukan ID snapshot lagi.
+ Menambahkan volume fana,. `/dev/sdc` Jika jenis instance tidak mendukung beberapa volume penyimpanan instance, ini tidak berpengaruh. Jika tipe instans mendukung volume penyimpanan NVMe instance, maka secara otomatis disebutkan dan disertakan dalam pemetaan perangkat blok instance dan tidak dapat diganti.

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

**Untuk memperbarui volume untuk sebuah instance saat peluncuran**  
Gunakan `-BlockDeviceMapping` parameter dengan [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html)cmdlet dengan parameter. `-BlockDeviceMapping`

```
-BlockDeviceMapping $bdm
```

Misalkan berikut ini adalah pemetaan perangkat blok instance di`$bdm`.

```
$bdm = @()

$root = New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping
$root.DeviceName = "/dev/xvda"
$ebs1 = New-Object -TypeName Amazon.EC2.Model.EbsBlockDevice
$ebs1.VolumeSize = 100
$root.Ebs = $ebs1
$bdm += $root

$sdj = New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping
$sdj.DeviceName = "/dev/sdj"
$sdj.NoDevice = ""
$bdm += $sdj

$sdh = New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping
$sdh.DeviceName = "/dev/sdh"
$ebs2 = New-Object -TypeName Amazon.EC2.Model.EbsBlockDevice
$ebs2.VolumeSize = 300
$sdh.Ebs = $ebs2
$bdm += $sdh

$sdc = New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping
$sdc.DeviceName = "/dev/sdc"
$sdc.VirtualName = "ephemeral1"
$bdm += $sdc
```

Pemetaan perangkat blok instance melakukan hal berikut:
+ Mengesampingkan ukuran volume root,`/dev/xvda`, meningkatkannya menjadi 100 GiB.
+ Mencegah `/dev/sdj` dari melampirkan ke instance.
+ Mengesampingkan ukuran`/dev/sdh`, meningkatkannya menjadi 300 GiB. Perhatikan bahwa Anda tidak perlu menentukan ID snapshot lagi.
+ Menambahkan volume fana,. `/dev/sdc` Jika jenis instance tidak mendukung beberapa volume penyimpanan instance, ini tidak berpengaruh. Jika tipe instans mendukung volume penyimpanan NVMe instance, maka secara otomatis disebutkan dan disertakan dalam pemetaan perangkat blok instance dan tidak dapat diganti.

------

## Perbarui pemetaan perangkat blok instans yang berjalan
<a name="update-instance-bdm"></a>

Anda tidak perlu menghentikan instans sebelum mengubah atribut ini.

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

**Untuk memperbarui pemetaan perangkat blok dari instance yang sedang berjalan**  
Gunakan perintah [modify-instance-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-attribute.html).

Tambahkan `--block-device-mappings` opsi:

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

Di`mapping.json`, tentukan pembaruan. Misalnya, pembaruan berikut mengubah volume root untuk bertahan.

```
[
  {
    "DeviceName": "/dev/sda1",
    "Ebs": {
      "DeleteOnTermination": false
    }
  }
]
```

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

**Untuk memperbarui pemetaan perangkat blok dari instance yang sedang berjalan**  
Gunakan [Edit-EC2InstanceAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceAttribute.html)cmdlet.

Tambahkan `-BlockDeviceMapping` opsi:

```
-BlockDeviceMapping $bdm
```

Di`bdm`, tentukan pembaruan. Misalnya, pembaruan berikut mengubah volume root untuk bertahan.

```
$ebd = New-Object -TypeName Amazon.EC2.Model.EbsBlockDevice
$ebd.DeleteOnTermination = false
$bdm = New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping
$bdm.DeviceName = "/dev/sda1"
$bdm.Ebs = $ebd
```

------

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

Anda dapat dengan mudah mengenumerasi volume EBS yang dipetakan sebagai instans.

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

**Untuk melihat volume EBS untuk sebuah instance**

1. Buka konsol Amazon EC2.

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

1. Pilih instance dan lihat detail yang ditampilkan di tab **Penyimpanan**. Minimal, informasi berikut tersedia untuk volume root (di mana istilah **perangkat root** setara dengan **volume root**):
   + **Jenis perangkat root** (misalnya, **EBS**)
   + **Nama perangkat root** (misalnya, `/dev/xvda`)
   + **Perangkat blok** (misalnya, `/dev/xvda`, `/dev/sdf`, dan `/dev/sdj`)

   Jika instans diluncurkan dengan volume EBS tambahan menggunakan pemetaan perangkat blok, maka akan muncul di bawah **Perangkat blok**. Volume penyimpanan instans tidak muncul di tab ini.

1. Untuk menampilkan informasi tambahan tentang volume EBS, pilih ID volumenya untuk membuka halaman volume.

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

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

```
aws ec2 describe-instances \
    --instance-ids i-1234567890abcdef0 \
    --query Reservations[*].Instances[0].BlockDeviceMappings
```

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

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

```
(Get-EC2Instance -InstanceId i-0bac57d7472c89bac).Instances.BlockDeviceMappings
```

------

## Lihat pemetaan perangkat blok instans untuk volume penyimpanan instans
<a name="bdm-instance-metadata"></a>

Jenis instance menentukan jumlah dan jenis volume penyimpanan instance yang tersedia untuk instance. Jika jumlah volume penyimpanan instans dalam pemetaan perangkat blok melebihi jumlah volume penyimpanan instans yang tersedia untuk sebuah instans, volume tambahan akan diabaikan. Untuk melihat volume penyimpanan instance untuk instans Anda, jalankan **lsblk** perintah (instance Linux) atau buka **Windows Disk Management** (instance Windows). Untuk mempelajari berapa banyak volume penyimpanan instans yang didukung oleh setiap jenis instans, lihat spesifikasi [jenis instans Amazon EC2](https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-instance-type-specifications.html).

Saat Anda melihat pemetaan perangkat blok untuk instans Anda, Anda hanya dapat melihat volume EBS, bukan volume penyimpanan instans. Metode yang Anda gunakan untuk melihat volume penyimpanan instans untuk instans tergantung pada tipe volume.



### NVMe volume toko contoh
<a name="nvme-instance-store"></a>

#### Instans Linux
<a name="nvme-instance-store-linux"></a>

Anda dapat menggunakan paket baris NVMe perintah, [nvme-cli](https://github.com/linux-nvme/nvme-cli), untuk menanyakan volume penyimpanan NVMe instance dalam pemetaan perangkat blok. Unduh dan instal paket di instans Anda, lalu jalankan perintah berikut.

```
[ec2-user ~]$ sudo nvme list
```

Berikut ini contoh output untuk suatu instans. Teks di kolom Model menunjukkan apakah volume adalah volume EBS atau volume penyimpanan instans. Dalam contoh ini, `/dev/nvme1n1` dan `/dev/nvme2n1` adalah volume penyimpanan instans.

```
Node             SN                   Model                                    Namespace
---------------- -------------------- ---------------------------------------- ---------
/dev/nvme0n1     vol06afc3f8715b7a597 Amazon Elastic Block Store               1        
/dev/nvme1n1     AWS2C1436F5159EB6614 Amazon EC2 NVMe Instance Storage         1         
/dev/nvme2n1     AWSB1F4FF0C0A6C281EA Amazon EC2 NVMe Instance Storage         1         ...
```

#### Instans Windows
<a name="nvme-instance-store-windows"></a>

Anda dapat menggunakan Manajemen Disk atau PowerShell untuk mencantumkan NVMe volume penyimpanan EBS dan instans. Untuk informasi selengkapnya, lihat [Peta disk NVMe di instans Windows Amazon EC2 ke volume](windows-list-disks-nvme.md).

### Volume penyimpanan instans HDD atau SSD
<a name="hdd-ssd-instance-store"></a>

Anda dapat menggunakan metadata instance untuk menanyakan volume penyimpanan instans HDD atau SSD dalam pemetaan perangkat blok. NVMe volume penyimpanan instance tidak disertakan.

URI dasar untuk semua permintaan untuk metadata instans adalah `http://169.254.169.254/latest/`. Untuk informasi selengkapnya, lihat [Gunakan metadata instans untuk mengelola instans EC2](ec2-instance-metadata.md).

#### Instans Linux
<a name="hdd-ssd-instance-store-linux"></a>

Pertama, hubungkan ke instans berjalan Anda. Dari instans, gunakan kueri ini untuk mendapatkan pemetaan perangkat blok.

------
#### [ IMDSv2 ]

```
[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/block-device-mapping/
```

------
#### [ IMDSv1 ]

```
[ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/block-device-mapping/
```

------

Responsnya mencakup nama-nama perangkat blok untuk instans tersebut. Misalnya, output untuk instans yang didukung oleh instans `m1.small` yang didukung penyimpanan instans terlihat seperti ini.

```
ami
ephemeral0
root
swap
```

`ami`Perangkat adalah volume root seperti yang terlihat oleh instance. Volume penyimpanan instans diberi nama `ephemeral[0-23]`. Parameter perangkat `swap` adalah untuk file halaman. Jika Anda juga telah memetakan volume EBS, volume tersebut muncul sebagai `ebs1`, `ebs2`, dan seterusnya.

Untuk mendapatkan detail tentang perangkat blok individu dalam pemetaan perangkat blok, tambahkan namanya ke kueri sebelumnya, seperti yang ditunjukkan di sini.

------
#### [ IMDSv2 ]

```
[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/block-device-mapping/ephemeral0
```

------
#### [ IMDSv1 ]

```
[ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/block-device-mapping/ephemeral0
```

------

#### Instans Windows
<a name="hdd-ssd-instance-store-windows"></a>

Pertama, hubungkan ke instans berjalan Anda. Dari instans, gunakan kueri ini untuk mendapatkan pemetaan perangkat blok.

```
PS C:\> Invoke-RestMethod -uri http://169.254.169.254/latest/meta-data/block-device-mapping/
```

Responsnya mencakup nama-nama perangkat blok untuk instans tersebut. Misalnya, output untuk instans yang didukung oleh instans `m1.small` yang didukung penyimpanan instans terlihat seperti ini.

```
ami
ephemeral0
root
swap
```

`ami`Perangkat adalah volume root seperti yang terlihat oleh instance. Volume penyimpanan instans diberi nama `ephemeral[0-23]`. Parameter perangkat `swap` adalah untuk file halaman. Jika Anda juga telah memetakan volume EBS, volume tersebut muncul sebagai `ebs1`, `ebs2`, dan seterusnya.

Untuk mendapatkan detail tentang perangkat blok individu dalam pemetaan perangkat blok, tambahkan namanya ke kueri sebelumnya, seperti yang ditunjukkan di sini.

```
PS C:\> Invoke-RestMethod -uri http://169.254.169.254/latest/meta-data/block-device-mapping/ephemeral0
```