Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola grup subnet Amazon DocumentDB
Virtual Private Cloud (VPC) adalah jaringan virtual yang didedikasikan untuk Anda. Akun AWS Secara logis terisolasi dari jaringan virtual lain di AWS Cloud. Anda dapat meluncurkan AWS sumber daya Anda, seperti cluster Amazon DocumentDB, ke dalam Amazon VPC Anda. Anda dapat menentukan kisaran alamat IP untuk VPC, menambahkan subnet, grup keamanan yang berkaitan, dan mengonfigurasi tabel rute.
Subnet adalah serangkaian alamat IP di Amazon VPC Anda. Anda dapat meluncurkan AWS sumber daya ke subnet tertentu. Gunakan subnet *publik* untuk sumber daya yang harus dihubungkan ke internet. Gunakan subnet *privat* untuk sumber daya yang tidak akan dihubungkan ke internet. Untuk informasi selengkapnya tentang subnet publik dan privat, lihat [Basic VPC dan Subnet](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-subnet-basics) di *Panduan Pengguna Amazon Virtual Private Cloud*.
Grup subnet DB adalah kumpulan subnet yang Anda buat di VPC dan kemudian Anda tetapkan untuk klaster Anda. Grup subnet memungkinkan Anda untuk menentukan VPC tertentu saat membuat klaster. Jika Anda menggunakan grup subnet `default`, ini mencakup semua subnet di VPC.
Setiap grup subnet DB harus memiliki subnet di setidaknya dua Availability Zone di Wilayah tertentu. Saat membuat klaster DB dalam VPC, Anda harus memilih grup subnet DB. Amazon DocumentDB menggunakan grup subnet DB dan Availability Zone pilihan Anda untuk memilih subnet dan alamat IP di dalam subnet tersebut untuk dikaitkan dengan klaster Anda. Jika instans primer gagal, Amazon DocumentDB dapat mempromosikan instans replika yang sesuai menjadi primer baru. Hal ini kemudian dapat membuat instans replika baru menggunakan alamat IP subnet di mana primer sebelumnya terletak.
Saat Amazon DocumentDB membuat instans dalam VPC, jaringan ini menetapkan antarmuka jaringan ke klaster Anda menggunakan alamat IP yang dipilih dari grup subnet DB Anda. Kami sangat menyarankan agar Anda menggunakan nama DNS karena alamat IP dapat berubah selama failover. Untuk informasi selengkapnya, lihat [Titik akhir Amazon DocumentDB](how-it-works.md#how-it-works.endpoints).
Untuk informasi tentang membuat VPC dan subnet Anda sendiri, lihat [Bekerja dengan VPCs dan Subnet](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html) di Panduan Pengguna *Amazon Virtual Private Cloud*.
**Topics**
+ [Membuat grup subnet Amazon DocumentDB](document-db-subnet-group-create.md)
+ [Menjelaskan grup subnet Amazon DocumentDB](document-db-subnet-group-describe.md)
+ [Memodifikasi grup subnet Amazon DocumentDB](document-db-subnet-group-modify.md)
+ [Menghapus grup subnet Amazon DocumentDB](document-db-subnet-group-delete.md)
# Membuat grup subnet Amazon DocumentDB
Saat membuat klaster Amazon DocumentDB, Anda harus memilih Amazon VPC dan grup subnet yang sesuai di dalam Amazon VPC tersebut untuk meluncurkan klaster Anda. Subnet menentukan availability zone dan kisaran IP di dalam availability zone yang ingin Anda gunakan untuk meluncurkan instans.
Grup subnet adalah kumpulan subnet bernama (atau AZs) yang memungkinkan Anda menentukan zona ketersediaan yang ingin Anda gunakan untuk meluncurkan instans Amazon DocumentDB. Misalnya, dalam klaster dengan tiga instance, disarankan agar masing-masing instance tersebut disediakan secara terpisah AZs —melakukannya mengoptimalkan ketersediaan tinggi. Dengan demikian, jika AZ tunggal gagal, maka hanya akan memengaruhi instans tunggal.
Saat ini, instans Amazon DocumentDB dapat disediakan hingga tiga. AZs Bahkan jika grup subnet memiliki lebih dari tiga subnet, Anda hanya akan dapat menggunakan tiga subnet tersebut untuk membuat klaster Amazon DocumentDB. Oleh karena itu, kami menyarankan bahwa ketika Anda membuat grup subnet di mana Anda hanya memilih tiga subnet tempat Anda akan menyebarkan instans Anda.
Misalnya: Cluster dibuat dan Amazon DocumentDB AZs memilih \$11A, 1B, dan 1C\$1. Jika Anda mencoba untuk membuat instans di AZ \$11D\$1 panggilan API akan gagal. Namun demikian, jika Anda memilih untuk membuat instans, tanpa menentukan AZ tertentu, maka Amazon DocumentDB akan memilih AZ atas nama Anda. Amazon DocumentDB menggunakan algoritme untuk memuat keseimbangan instans untuk membantu Anda AZs mencapai ketersediaan tinggi. Jika tiga instance disediakan, secara default, mereka akan disediakan di tiga AZs dan tidak akan disediakan semuanya dalam satu AZ.
Praktik Terbaik
+ Kecuali Anda memiliki alasan tertentu, selalu buat grup subnet dengan tiga subnet. Ini memastikan bahwa cluster dengan tiga atau lebih instance akan dapat mencapai ketersediaan yang lebih tinggi karena instance akan disediakan di tiga. AZs
+ Selalu sebarkan instans di beberapa AZs untuk mencapai ketersediaan tinggi. Jangan pernah menempatkan semua instance untuk cluster dalam satu AZ.
+ Karena peristiwa failover dapat terjadi kapan saja, Anda tidak boleh berasumsi bahwa instance utama atau instance replika akan selalu berada di AZ tertentu.
## Cara untuk membuat grup subnet
Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk membuat grup subnet Amazon DocumentDB:
------
#### [ Using the Konsol Manajemen AWS ]
Gunakan langkah-langkah berikut ini untuk membuat grup subnet Amazon DocumentDB.
**Untuk membuat grup subnet Amazon DocumentDB**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup subnet**, kemudian pilih **Buat**.
**Tip**
Jika Anda tidak melihat panel navigasi pada sisi kiri layar Anda, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di sudut kiri atas halaman.
1. Pada halaman **Buat grup subnet**:
1. Di bagian **Detail grup subnet**:
1. **Nama**—Masukkan nama yang bermakna untuk grup subnet.
1. **Deskripsi**—Masukkan deskripsi untuk grup subnet.
1. Di bagian **Tambahkan subnet**:
1. **VPC**—Dalam daftar, pilih VPC untuk grup subnet ini.
1. Lakukan salah satu hal berikut ini:
+ Untuk memasukkan semua subnet dalam VPC yang dipilih, pilih **Tambahkan semua subnet yang berkaitan dengan VPC ini**.
+ Untuk menentukan subnet untuk grup subnet ini, lakukan hal berikut ini untuk setiap Availability Zone tempat Anda ingin menyertakan subnet. Anda harus menyertakan setidaknya dua Availability Zone.
1. **Availability Zone**—Dalam daftar, pilih Availability Zone.
1. **Subnet**—Dalam daftar, pilih subnet dari Availability Zone yang yang dipilih untuk grup subnet ini.
1. Pilih **Tambahkan subnet**.
1. Pilih **Buat**. Ketika grup subnet dibuat, maka akan dicantumkan dengan grup subnet Anda lainnya.
![\[Tangkapan layar: Menampilkan detail grup subnet.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-subnet-groups-list.png)
------
#### [ Using the AWS CLI ]
Sebelum Anda dapat membuat grup subnet menggunakan AWS CLI, Anda harus terlebih dahulu menentukan subnet mana yang tersedia. Jalankan AWS CLI operasi berikut untuk membuat daftar Availability Zones dan subnetnya.
**Parameter:**
+ **--db-subnet-group**—Opsional. Menentukan grup subnet tertentu akan mencantumkan Availability Zone dan subnet untuk grup tersebut. Menghilangkan parameter ini akan mencantumkan Availability Zone dan subnet untuk semua grup subnet Anda. Menentukan grup subnet `default` akan mencantumkan semua subnet VPC.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-subnet-groups \
--db-subnet-group-name default \
--query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]'
```
Untuk Windows:
```
aws docdb describe-db-subnet-groups ^
--db-subnet-group-name default ^
--query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]'
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
```
[
[
"default",
[
[
"us-east-1a",
"subnet-4e26d263"
],
[
"us-east-1c",
"subnet-afc329f4"
],
[
"us-east-1e",
"subnet-b3806e8f"
],
[
"us-east-1d",
"subnet-53ab3636"
],
[
"us-east-1b",
"subnet-991cb8d0"
],
[
"us-east-1f",
"subnet-29ab1025"
]
]
]
]
```
Dengan menggunakan keluaran dari operasi sebelumnya, Anda dapat membuat grup subnet baru. Grup subnet baru harus mencakup subnet dari setidaknya dua Availability Zone.
**Parameter:**
+ **--db-subnet-group-name**—Wajib. Nama untuk grup subnet ini.
+ **--db-subnet-group-description**—Wajib. Deskripsi dari grup subnet ini.
+ **--subnet-ids**—Wajib. Daftar subnet untuk disertakan dalam grup subnet ini. Contoh:`subnet-53ab3636`.
+ --Tanda****—Opsional. Daftar tanda (pasangan nilai kunci) untuk dilampirkan ke grup subnet ini.
Kode berikut ini membuat `sample-subnet-group` grup subnet dengan tiga subnet, `subnet-4e26d263`, `subnet-afc329f4`, dan `subnet-b3806e8f`.
Untuk Linux, macOS, atau Unix:
```
aws docdb create-db-subnet-group \
--db-subnet-group-name sample-subnet-group \
--db-subnet-group-description "A sample subnet group" \
--subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f \
--tags Key=tag1,Value=One Key=tag2,Value=2
```
Untuk Windows:
```
aws docdb create-db-subnet-group ^
--db-subnet-group-name sample-subnet-group ^
--db-subnet-group-description "A sample subnet group" ^
--subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f ^
--tags Key=tag1,Value=One Key=tag2,Value=2
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
```
{
"DBSubnetGroup": {
"DBSubnetGroupDescription": "A sample subnet group",
"DBSubnetGroupName": "sample-subnet-group",
"Subnets": [
{
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetIdentifier": "subnet-4e26d263",
"SubnetStatus": "Active"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetIdentifier": "subnet-afc329f4",
"SubnetStatus": "Active"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
"SubnetGroupStatus": "Complete"
}
}
```
------
# Menjelaskan grup subnet Amazon DocumentDB
Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk mendapatkan rincian grup subnet Amazon DocumentDB.
------
#### [ Using the Konsol Manajemen AWS ]
Prosedur berikut ini menunjukkan kepada Anda cara untuk mendapatkan detail grup subnet Amazon DocumentDB.
**Untuk menemukan detail grup subnet**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup Subnet**.
**Tip**
Jika Anda tidak melihat panel navigasi pada sisi kiri layar Anda, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di sudut kiri atas halaman.
1. Untuk melihat detail grup subnet, pilih nama grup subnet tersebut.
![\[Tangkapan layar: Menampilkan detail grup subnet.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-subnet-group-details.png)
------
#### [ Using the AWS CLI ]
Untuk menemukan detail grup subnet Amazon DocumentDB, gunakan operasi `describe-db-subnet-groups` dengan parameter berikut ini.
**Parameter**
+ `--db-subnet=group-name`—Opsional. Jika disertakan, detail untuk grup subnet yang diberi nama dicantumkan. Jika dihilangkan, detail untuk hingga 100 grup subnet dicantumkan.
**Example**
Kode berikut ini mencantumkan detail untuk grup subnet `sample-subnet-group` yang kita buat di bagian [Membuat grup subnet Amazon DocumentDB](document-db-subnet-group-create.md).
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-subnet-groups \
--db-subnet-group-name sample-subnet-group
```
Untuk Windows:
```
aws docdb describe-db-subnet-groups ^
--db-subnet-group-name sample-subnet-group
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
```
{
"DBSubnetGroup": {
"DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
"VpcId": "vpc-91280df6",
"SubnetGroupStatus": "Complete",
"DBSubnetGroupName": "sample-subnet-group",
"Subnets": [
{
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-4e26d263"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-afc329f4"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-b3806e8f"
}
],
"DBSubnetGroupDescription": "A sample subnet group"
}
}
```
------
# Memodifikasi grup subnet Amazon DocumentDB
Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk memodifikasi deskripsi grup subnet atau untuk menambah atau menghapus subnet dari grup subnet Amazon DocumentDB. Namun demikian, Anda tidak dapat mengubah grup subnet `default`.
------
#### [ Using the Konsol Manajemen AWS ]
Anda dapat menggunakan Konsol Manajemen AWS untuk mengubah deskripsi grup subnet atau untuk menambah dan menghapus subnet. Ingat bahwa setelah selesai, Anda harus memiliki setidaknya dua Availability Zone yang berkaitan dengan grup subnet Anda.
**Untuk memodifikasi grup subnet Anda**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup Subnet**. Kemudian pilih tombol di sebelah kiri nama grup subnet. Ingat bahwa Anda tidak dapat memodifikasi grup subnet `default`.
**Tip**
Jika Anda tidak melihat panel navigasi pada sisi kiri layar Anda, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di sudut kiri atas halaman.
1. Pilih **Tindakan**, dan kemudian pilih **Modifikasi**.
1. **Deskripsi**—Untuk mengubah deskripsi grup subnet Anda, masukkan deskripsi baru.
1. Untuk mengubah subnet yang berkaitan dengan grup subnet Anda, di bagian **Tambahkan subnet**, lakukan salah satu atau lebih dari hal berikut ini:
+ Untuk menghapus semua subnet dari grup subnet ini, pilih **Hapus semua**.
+ Untuk menghapus subnet tertentu dari grup subnet ini, pilih **Hapus** untuk setiap subnet yang ingin Anda hapus.
+ Untuk menambahkan semua subnet yang berkaitan dengan VPC ini, pilih **Tambahkan semua subnet yang berkaitan dengan VPC ini**.
+ Untuk menambahkan subnet tertentu ke grup subnet ini, lakukan hal berikut ini untuk setiap Availability Zone tempat Anda ingin menambahkan subnet.
1. **Availability zone**—Dalam daftar, pilih Availability Zone baru.
1. **Subnet**—Dalam daftar, pilih subnet dari Availability Zone yang yang dipilih untuk grup subnet ini.
1. Pilih **Tambahkan subnet**.
1. Di kotak dialog konfirmasi:
+ Untuk membuat perubahan tersebut ke grup subnet, pilih **Modifikasi**.
+ Untuk menyimpan grup subnet agar tidak berubah, pilih **Batal**.
------
#### [ Using the AWS CLI ]
Anda dapat menggunakan AWS CLI untuk mengubah deskripsi grup subnet atau untuk menambah dan menghapus subnet. Ingat bahwa setelah selesai, Anda harus memiliki setidaknya dua Availability Zone yang berkaitan dengan grup subnet Anda. Anda tidak dapat memodifikasi grup subnet `default`.
**Parameter:**
+ `--db-subnet-group-name`—Wajib. Nama grup subnet Amazon DocumentDB yang Anda modifikasi.
+ `--subnet-ids`—Wajib. Daftar semua subnet yang Anda inginkan dalam grup subnet setelah perubahan ini dilakukan.
**penting**
Setiap subnet yang saat ini berada dalam grup subnet yang tidak disertakan dalam daftar ini akan dihapus dari grup subnet. Jika Anda ingin menyimpan salah satu subnet yang saat ini dalam grup subnet, Anda harus menyertakannya dalam daftar ini.
+ `--db-subnet-group-description`—Opsional. Deskripsi grup subnet.
**Example**
Kode berikut memodifikasi deskripsi dan menggantikan subnet yang ada dengan subnet `subnet-991cb8d0`, `subnet-53ab3636`, dan `subnet-29ab1025`.
Untuk Linux, macOS, atau Unix:
```
aws docdb modify-db-subnet-group \
--db-subnet-group-name sample-subnet-group \
--subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 \
--db-subnet-group-description "Modified subnet group"
```
Untuk Windows:
```
aws docdb modify-db-subnet-group ^
--db-subnet-group-name sample-subnet-group ^
--subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 ^
--db-subnet-group-description "Modified subnet group"
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). Perhatikan bahwa ini adalah grup subnet yang sama yang dibuat di bagian [Membuat grup subnet Amazon DocumentDB](document-db-subnet-group-create.md). Namun demikian, subnet dalam grup subnet diganti dengan yang tercantum dalam operasi `modify-db-subnet-group`.
```
{
"DBSubnetGroup": {
"DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
"DBSubnetGroupDescription": "Modified subnet group",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-53ab3636"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-991cb8d0"
},
{
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-29ab1025"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupName": "sample-subnet-group"
}
}
```
------
# Menghapus grup subnet Amazon DocumentDB
Anda dapat menggunakan Konsol Manajemen AWS atau menghapus grup AWS CLI subnet Amazon DocumentDB. Namun demikian, Anda tidak dapat menghapus grup subnet `default`.
------
#### [ Using the Konsol Manajemen AWS ]
Anda dapat menggunakan Konsol Manajemen AWS untuk menghapus grup subnet. Namun Anda tidak dapat menghapus grup subnet `default`.
**Untuk menghapus grup subnet**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Di panel navigasi, pilih **Grup Subnet**. Kemudian pilih tombol di sebelah kiri nama grup subnet. Ingat bahwa Anda tidak dapat menghapus grup subnet `default`.
**Tip**
Jika Anda tidak melihat panel navigasi pada sisi kiri layar Anda, pilih ikon menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di sudut kiri atas halaman.
1. Pilih **Tindakan**, lalu pilih **Hapus**.
1. Di kotak dialog konfirmasi:
+ Untuk menghapus grup subnet, pilih **Hapus**.
+ Untuk menyinmpan grup subnet, pilih **Batal**.
------
#### [ Using the AWS CLI ]
Untuk menghapus grup subnet Amazon DocumentDB menggunakan, gunakan operasi AWS CLI dengan parameter `delete-db-subnet-group` berikut.
**Parameter**
+ `--db-subnet-group-name`—Wajib. Nama grup subnet Amazon DocumentDB yang akan dihapus. Ingat bahwa Anda tidak dapat menghapus grup subnet `default`.
**Example**
Kode berikut ini akan menghapus `sample-subnet-group`.
Untuk Linux, macOS, atau Unix:
```
aws docdb delete-db-subnet-group \
--db-subnet-group-name sample-subnet-group
```
Untuk Windows:
```
aws docdb delete-db-subnet-group ^
--db-subnet-group-name sample-subnet-group
```
Operasi ini tidak menghasilkan keluaran.
------