Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memanggil API pribadi
Anda hanya dapat menjalankan API pribadi dari dalam VPC menggunakan titik akhir VPC. API pribadi Anda harus memiliki kebijakan sumber daya yang memungkinkan titik akhir spesifik VPCs dan VPC menjalankan API Anda.
Jika Anda menjalankan API pribadi tanpa menggunakan nama domain khusus atau nama DNS pribadi dan nama domain APIs atau Anda menggunakan kebijakan keamanan yang dimulai`SecurityPolicy_`, Anda harus menyetel mode akses titik akhir. `BASIC` Untuk informasi selengkapnya, lihat [Mode akses titik akhir](apigateway-security-policies.md#apigateway-security-policies-endpoint-access-mode).
## Memanggil API pribadi menggunakan nama domain khusus
Untuk menjalankan API pribadi menggunakan nama domain khusus, titik akhir VPC Anda memerlukan asosiasi akses nama domain dengan nama domain khusus, dan nama domain khusus perlu mengizinkan akses ke titik akhir VPC untuk memanggilnya. Untuk informasi selengkapnya, lihat [Nama domain khusus untuk pribadi APIs di API Gateway](apigateway-private-custom-domains.md).
Tidak ada perbedaan antara memanggil nama domain kustom pribadi di VPC Anda Akun AWS sendiri atau yang berbeda. Akun AWS
### Gunakan nama domain kustom Anda
Di dalam VPC Anda, Anda dapat memanggil API Anda menggunakan nama domain kustom. Contoh berikut adalah perintah curl untuk memanggil nama domain kustom pribadi Anda:
```
curl https://private.example.com
```
### Gunakan nama host DNS pribadi khusus titik akhir
Anda dapat menjalankan API menggunakan nama domain khusus dan nama host DNS pribadi khusus titik akhir.
```
curl https://private-dns-hostname.execute-api.region.vpce.amazonaws.com/basepath -H 'Host:custom-domain-name'
```
Contoh berikut adalah perintah curl untuk memanggil nama domain kustom Anda menggunakan nama host DNS pribadi khusus titik akhir:
```
curl https://vpce-123456-abc000.execute-api.us-east-2.vpce.amazonaws.com/test -H 'Host:private.example.com'
```
## Memanggil API pribadi tanpa menggunakan nama domain khusus
Untuk menjalankan API pribadi Anda tanpa menggunakan nama domain khusus, Anda perlu mengidentifikasi nama DNS untuk API Anda. Prosedur berikut menunjukkan cara menemukan nama DNS Anda.
------
#### [ Konsol Manajemen AWS ]
**Untuk menemukan nama DNS**
1. Masuk ke Konsol Manajemen AWS dan buka konsol VPC Amazon di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)
1. Di panel navigasi utama, pilih **Endpoints lalu pilih endpoint** VPC antarmuka Anda untuk API Gateway.
1. Di panel **Detail**, Anda akan melihat lima nilai di bidang **nama DNS**. Tiga yang pertama adalah nama DNS publik untuk API Anda. Dua lainnya adalah nama DNS pribadi untuk itu.
------
#### [ AWS CLI ]
Gunakan [describe-vpc-endpoints](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html)perintah berikut untuk mencantumkan nilai DNS Anda.
```
aws ec2 describe-vpc-endpoints --vpc-endpoint-ids vpce-01234567abcdef012
```
Tiga yang pertama adalah nama DNS publik untuk API Anda. Dua lainnya adalah nama DNS pribadi untuk itu.
------
### Memanggil API pribadi menggunakan alias Route53
Anda dapat mengaitkan atau memisahkan titik akhir VPC dengan API pribadi Anda. Untuk informasi selengkapnya, lihat [(Opsional) Kaitkan atau lepaskan titik akhir VPC dengan API pribadi](apigateway-private-api-create.md#associate-private-api-with-vpc-endpoint).
Setelah mengaitkan titik akhir VPC dengan API pribadi, Anda dapat menggunakan URL dasar berikut untuk menjalankan API:
```
https://{rest-api-id}-{vpce-id}.execute-api.{region}.amazonaws.com/{stage}
```
Misalnya, jika Anda menyiapkan `GET /pets` metode untuk `test` stage, dan REST API ID Anda`01234567ab`, dan ID titik akhir VPC Anda`vpce-01234567abcdef012`, dan Wilayah Anda, Anda dapat memanggil API Anda sebagai`us-west-2`:
```
curl -v https://01234567ab-vpce-01234567abcdef012.execute-api.us-west-2.amazonaws.com/test/pets
```
### Memanggil API pribadi menggunakan nama DNS pribadi
Jika Anda telah mengaktifkan DNS pribadi, Anda dapat mengakses API pribadi menggunakan nama DNS pribadi berikut:
```
{restapi-id}.execute-api.{region}.amazonaws.com
```
URL dasar untuk menjalankan API adalah dalam format berikut:
```
https://{restapi-id}.execute-api.{region}.amazonaws.com/{stage}
```
Misalnya, jika Anda menyiapkan `GET /pets` metode untuk `test` stage, dan REST API ID adalah `01234567ab` dan Region Anda`us-west-2`, Anda dapat memanggil API pribadi Anda dengan memasukkan URL berikut di browser:
```
https://01234567ab.execute-api.us-west-2.amazonaws.com/test/pets
```
Atau, Anda dapat menggunakan perintah cURL berikut untuk menjalankan API pribadi Anda:
```
curl -X GET https://01234567ab.execute-api.us-west-2.amazonaws.com/test/pets
```
**Awas**
Jika Anda mengaktifkan DNS pribadi untuk titik akhir VPC Anda, Anda tidak akan dapat mengakses titik akhir default untuk publik. APIs Untuk informasi selengkapnya, lihat [Mengapa saya tidak dapat terhubung ke API publik saya dari titik akhir VPC API Gateway](https://repost.aws/knowledge-center/api-gateway-vpc-connections)? .
### Memanggil API pribadi menggunakan Direct Connect
Anda dapat menggunakan Direct Connect untuk membuat koneksi pribadi khusus dari jaringan lokal ke Amazon VPC dan mengakses titik akhir API pribadi Anda melalui koneksi tersebut dengan menggunakan nama DNS publik.
Anda juga dapat menggunakan nama DNS pribadi untuk mengakses API pribadi Anda dari jaringan lokal dengan menyiapkan titik akhir Amazon Route 53 Resolver masuk dan meneruskan semua kueri DNS DNS pribadi dari jaringan jarak jauh Anda. Untuk informasi selengkapnya, lihat [Meneruskan kueri DNS masuk](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-forwarding-inbound-queries.html) ke Panduan VPCs Pengembang *Amazon* Route 53.
### Memanggil API pribadi menggunakan nama host DNS publik khusus titik akhir
Anda dapat mengakses API pribadi menggunakan nama host DNS khusus titik akhir. Ini adalah nama host DNS publik yang berisi ID titik akhir VPC atau ID API untuk API pribadi Anda.
URL dasar yang dihasilkan dalam format berikut:
```
https://{public-dns-hostname}.execute-api.{region}.vpce.amazonaws.com/{stage}
```
Misalnya, jika Anda menyiapkan `GET /pets` metode untuk `test` stage, dan REST API ID Anda`abc1234`, nama host DNS publiknya adalah`vpce-def-01234567`, dan Region Anda`us-west-2`, Anda dapat memanggil API pribadi menggunakan VPCe IDnya dengan menggunakan `Host` header dalam perintah cURL:
```
curl -v https://vpce-def-01234567.execute-api.us-west-2.vpce.amazonaws.com/test/pets -H 'Host: abc1234.execute-api.us-west-2.amazonaws.com'
```
Atau, Anda dapat memanggil API pribadi Anda melalui ID API-nya dengan menggunakan `x-apigw-api-id` header dalam perintah cURL dalam format berikut:
```
curl -v https://{public-dns-hostname}.execute-api.{region}.vpce.amazonaws.com/{stage} -H 'x-apigw-api-id:{api-id}'
```