Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memahami titik akhir Amazon DocumentDB
Anda dapat menggunakan titik akhir Amazon DocumentDB (dengan kompatibilitas MongoDB) untuk terhubung ke klaster atau instans. Amazon DocumentDB memiliki tiga jenis titik akhir yang berbeda, masing-masing dengan tujuannya sendiri.
**Topics**
+ [Menemukan titik akhir klaster](db-cluster-endpoints-find.md)
+ [Menemukan titik akhir instance](db-instance-endpoint-find.md)
+ [Menghubungkan ke titik akhir](endpoints-connecting.md)
**Titik akhir klaster**
Titik akhir klaster adalah titik akhir untuk klaster Amazon DocumentDB yang tersambung ke instans utama saat ini untuk klaster tersebut. Setiap klaster Amazon DocumentDB memiliki titik akhir klaster tunggal dan satu instans utama. Jika terjadi failover, titik akhir klaster dipetakan ulang ke instans utama baru.
**Reader endpoint**
Reader endpoint adalah titik akhir untuk klaster Amazon DocumentDB yang terhubung ke salah satu replika yang tersedia untuk klaster tersebut. Setiap klaster Amazon DocumentDB memiliki reader endpoint. Jika ada lebih dari satu replika, reader endpoint mengarahkan setiap permintaan koneksi ke salah satu replika Amazon DocumentDB.
**Titik akhir instans**
Titik akhir instans adalah titik akhir yang terhubung ke instans tertentu. Setiap instans dalam sebuah klaster, terlepas dari apakah itu instans primer atau replika, memiliki titik akhir instans uniknya sendiri. Yang terbaik adalah tidak menggunakan titik akhir instans di aplikasi Anda. Ini karena mereka dapat mengubah peran jika terjadi failover, sehingga memerlukan perubahan kode dalam aplikasi Anda.
# Menemukan titik akhir klaster
Anda dapat menemukan titik akhir klaster dan reader endpoint pada suatu klaster dengan menggunakan konsol Amazon DocumentDB atau AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
**Untuk menemukan titik akhir cluster menggunakan konsol:**
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. Pada panel navigasi, silakan pilih **Klaster**.
1. Dari daftar klaster, pilih nama klaster yang Anda minati.
1. Pada halaman detail cluster, pilih tab **Konfigurasi**. Di bagian **Konfigurasi dan status**, Anda akan menemukan **titik akhir Cluster dan titik akhir** **Pembaca**.
![\[Bagian konfigurasi dan status yang menunjukkan titik akhir cluster dan pembaca.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-endpoints.png)
1. Untuk terhubung ke cluster ini, pilih tab **Konektivitas & keamanan**. Temukan string koneksi untuk `mongo` shell dan string koneksi yang dapat digunakan dalam kode aplikasi untuk terhubung ke cluster Anda.
![\[Bagian Connect menunjukkan string untuk terhubung ke instance dengan shell mongo dan string untuk terhubung ke cluster dengan aplikasi.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/cluster-connection-strings.png)
------
#### [ Using the AWS CLI ]
Untuk menemukan titik akhir cluster dan pembaca untuk cluster Anda menggunakan AWS CLI, jalankan `describe-db-clusters` perintah dengan parameter ini.
**Parameter**
+ **--db-cluster-identifier**—Opsional. Menentukan klaster untuk mengembalikan titik akhir. Jika dihilangkan, menampilkan titik akhir hingga 100 klaster Anda.
+ **--query**—Opsional. Menentukan bidang yang akan menampilkan. Bermanfaat dengan mengurangi jumlah data yang Anda butuhkan untuk melihat serta menemukan titik akhir. Jika dihilangkan, semua informasi tentang klaster dikembalikan.
+ **--region**—Opsional. Gunakan parameter `--region` untuk menentukan Wilayah tempat Anda ingin menerapkan perintah. Jika dihilangkan, Wilayah default Anda digunakan.
**Example**
Contoh berikut mengembalikan `DBClusterIdentifier`, titik akhir (titik akhir klaster), dan `ReaderEndpoint` untuk `sample-cluster`.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-clusters \
--region us-east-1 \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Untuk Windows:
```
aws docdb describe-db-clusters ^
--region us-east-1 ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
[
[
"sample-cluster",
27017,
"sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com",
"sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com"
]
]
```
Sekarang setelah Anda memiliki titik akhir klaster, Anda dapat terhubung ke klaster menggunakan salah satu `mongo` atau `mongodb`. Untuk informasi selengkapnya, lihat [Menghubungkan ke titik akhir](endpoints-connecting.md).
------
# Menemukan titik akhir instance
Anda dapat menemukan titik akhir untuk instans dengan menggunakan konsol Amazon DocumentDB atau AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
**Untuk menemukan titik akhir instans dengan menggunakan konsol**
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 **Klaster**.
**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. Di kotak navigasi Klaster, Anda akan melihat kolom **Pengidentifikasi klaster**. Instans Anda tercantum di bawah klaster, mirip dengan tangkapan layar di bawah.
![\[Tabel cluster menunjukkan daftar cluster di bawah kolom pengenal Cluster, dengan instance bersarang di dalam cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/choose-clusters.png)
1. Centang kotak di sebelah kiri instans yang Anda minati.
1. Gulir ke bawah ke bagian **Detail** lalu temukan titik akhir instans.
![\[Cuplikan layar konsol yang menampilkan halaman detail dengan titik akhir instans yang disorot.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-instance-endpoint.png)
1. Untuk terhubung ke instans ini, gulir ke atas ke bagian **Koneksi**. Temukan string koneksi untuk shell `mongo` dan string koneksi yang dapat digunakan dalam kode aplikasi Anda untuk terhubung ke instans Anda.
![\[Tangkapan layar konsol yang menunjukkan bagian Connect dengan shell mongo dan string koneksi aplikasi disorot.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/instance-connection-strings.png)
------
#### [ Using the AWS CLI ]
Untuk menemukan titik akhir instance menggunakan AWS CLI, jalankan perintah berikut dengan argumen ini.
**Pendapat**
+ **--db-instance-identifier**—Opsional. Menentukan instans untuk menampilkan titik akhir. Jika dihilangkan, mengembalikan titik akhir hingga 100 instans Anda.
+ **--query**—Opsional. Menentukan bidang yang akan menampilkan. Bermanfaat dengan mengurangi jumlah data yang Anda butuhkan untuk melihat serta menemukan titik akhir. Jika dihilangkan, semua informasi pada sebuah instans dikembalikan. Bidang `Endpoint` memiliki tiga anggota, jadi mencantumkannya dalam kueri seperti pada contoh berikut mengembalikan ketiga anggota. Jika Anda hanya tertarik pada beberapa anggota `Endpoint`, ganti `Endpoint` pada kueri dengan anggota yang Anda minati, seperti pada contoh kedua.
+ **--region**—Opsional. Gunakan parameter `--region` untuk menentukan Wilayah tempat Anda ingin menerapkan perintah. Jika dihilangkan, Wilayah default Anda digunakan.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Untuk Windows:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
[
[
"sample-cluster-instance",
{
"Port": 27017,
"Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
"HostedZoneId": "Z2R2ITUGPM61AM"
}
]
]
```
Mengurangi output untuk menghilangkan `HostedZoneId` pada titik akhir, Anda dapat memodifikasi kueri Anda dengan menentukan `Endpoint.Port` dan `Endpoint.Address`.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Untuk Windows:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
[
[
"sample-cluster-instance",
27017,
"sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
]
]
```
Sekarang setelah Anda memiliki titik akhir instans, Anda dapat terhubung ke instans dengan menggunakan `mongo` atau `mongodb`. Untuk informasi selengkapnya, lihat [Menghubungkan ke titik akhir](endpoints-connecting.md).
------
# Menghubungkan ke titik akhir
Setelah Anda memiliki titik akhir, baik klaster atau instans, Anda dapat menghubungkannya dengan menggunakan shell `mongo` atau string koneksi.
## Menghubungkan menggunakan cangkang mongo
Gunakan struktur berikut untuk membuat string yang perlu Anda sambungkan ke klaster atau instans Anda dengan menggunakan shell `mongo`:
```
mongo \
--ssl \
--host Endpoint:Port \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
**Contoh shell `mongo`**
Sambungkan ke klaster:
```
mongo \
--ssl \
--host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
Sambungkan ke instans:
```
mongo \
--ssl \
--host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
## Menghubungkan menggunakan string koneksi
Gunakan struktur berikut untuk membuat string koneksi yang Anda perlukan untuk terhubung ke klater atau instans Anda.
```
mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
**Contoh string koneksi**
Sambungkan ke klaster:
```
mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
Sambungkan ke instans:
```
mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```