

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

# AWS PrivateLink untuk DynamoDB
<a name="privatelink-interface-endpoints"></a>

Dengan AWS PrivateLink untuk DynamoDB, Anda dapat menyediakan antarmuka titik akhir *Amazon VPC* (titik akhir antarmuka) di cloud pribadi virtual Anda (Amazon VPC). Titik akhir ini dapat diakses langsung dari aplikasi yang ada di tempat melalui VPN dan Direct Connect, atau berbeda dengan peering Wilayah AWS [VPC Amazon](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html). Menggunakan AWS PrivateLink dan antarmuka endpoint, Anda dapat menyederhanakan konektivitas jaringan pribadi dari aplikasi Anda ke DynamoDB.

Aplikasi di VPC Anda tidak memerlukan alamat IP publik untuk berkomunikasi dengan DynamoDB menggunakan titik akhir antarmuka VPC untuk operasi DynamoDB. Titik akhir antarmuka diwakili oleh satu atau lebih antarmuka jaringan elastis (ENIs) yang diberi alamat IP pribadi dari subnet di VPC Amazon Anda. Permintaan ke DynamoDB melalui titik akhir antarmuka tetap berada di jaringan Amazon. Anda juga dapat mengakses titik akhir antarmuka di VPC Amazon dari aplikasi lokal AWS Direct Connect melalui AWS Virtual Private Network atau ().Site-to-Site VPN[Untuk informasi selengkapnya tentang cara menghubungkan VPC Amazon dengan jaringan lokal, lihat [Panduan Direct Connect Pengguna dan Panduan Pengguna](https://docs.aws.amazon.com/directconnect/latest/UserGuide/Welcome.html).AWS Site-to-Site VPN](https://docs.aws.amazon.com/vpn/latest/s2svpn/VPC_VPN.html)

*Untuk informasi umum tentang titik akhir antarmuka, lihat [Antarmuka Amazon VPC endpoints AWS PrivateLink(](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-interface.html)) di Panduan.AWS PrivateLink * AWS PrivateLink juga didukung untuk titik akhir Amazon DynamoDB Streams. Untuk informasi selengkapnya, lihat [AWS PrivateLink untuk DynamoDB Streams](privatelink-streams.md).

**Topics**
+ [Jenis titik akhir Amazon VPC untuk Amazon DynamoDB](#types-of-vpc-endpoints-for-ddb)
+ [Pertimbangan saat menggunakan AWS PrivateLink untuk Amazon DynamoDB](#privatelink-considerations)
+ [Membuat titik akhir Amazon VPC](#ddb-creating-vpc)
+ [Mengakses titik akhir antarmuka Amazon DynamoDB](#accessing-ddb-interface-endpoints)
+ [Mengakses tabel DynamoDB dan mengontrol operasi API dari titik akhir antarmuka DynamoDB](#accessing-tables-apis-from-interface-endpoints)
+ [Memperbarui konfigurasi DNS on-premise](#updating-on-premises-dns-config)
+ [Membuat kebijakan endpoint Amazon VPC untuk DynamoDB](#creating-vpc-endpoint-policy)
+ [Menggunakan titik akhir DynamoDB dengan Akses Pribadi Konsol Manajemen AWS](#ddb-endpoints-private-access)
+ [AWS PrivateLink untuk DynamoDB Streams](privatelink-streams.md)
+ [Menggunakan AWS PrivateLink untuk DynamoDB Accelerator (DAX)](dax-private-link.md)

## Jenis titik akhir Amazon VPC untuk Amazon DynamoDB
<a name="types-of-vpc-endpoints-for-ddb"></a>

*Anda dapat menggunakan dua jenis titik akhir Amazon VPC untuk mengakses Amazon DynamoDB: titik akhir *gateway dan titik akhir* antarmuka (dengan menggunakan).* AWS PrivateLink*Titik akhir gateway* adalah gateway yang Anda tentukan dalam tabel rute untuk mengakses DynamoDB dari VPC Amazon Anda melalui jaringan. AWS *Titik akhir antarmuka memperluas fungsionalitas titik* akhir gateway dengan menggunakan alamat IP pribadi untuk merutekan permintaan ke DynamoDB dari dalam VPC Amazon Anda, di tempat, atau dari VPC Amazon di tempat lain dengan menggunakan peering Amazon VPC atau. Wilayah AWS AWS Transit Gateway Untuk informasi lebih lanjut, lihat [Apa itu peering Amazon VPC?](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html) dan [Transit Gateway vs Pengintip VPC Amazon](https://docs.aws.amazon.com/whitepapers/latest/building-scalable-secure-multi-vpc-network-infrastructure/transit-gateway-vs-vpc-peering.html).

Titik akhir antarmuka kompatibel dengan titik akhir gateway. Jika Anda memiliki titik akhir gateway yang ada di VPC Amazon, Anda dapat menggunakan kedua jenis titik akhir di VPC Amazon yang sama.


|  Titik akhir Gateway untuk DynamoDB  |  Endpoint antarmuka untuk DynamoDB  | 
| --- | --- | 
|  Dalam kedua kasus, lalu lintas jaringan Anda tetap berada di AWS jaringan.  | 
|  Menggunakan alamat IP publik Amazon DynamoDB  |  Gunakan alamat IP pribadi dari Amazon VPC Anda untuk mengakses Amazon DynamoDB  | 
|  Jangan izinkan mengakses dari on-premise  |  Izinkan mengakses dari on-premise  | 
|  Jangan izinkan akses dari yang lain Wilayah AWS  |  Izinkan akses dari titik akhir VPC Amazon di titik lain dengan Wilayah AWS menggunakan peering VPC Amazon atau AWS Transit Gateway  | 
|  Tidak ditagih  |  Ditagih  | 

*Untuk informasi selengkapnya tentang titik akhir gateway, lihat titik akhir [Gateway Amazon VPC](https://docs.aws.amazon.com//vpc/latest/privatelink/vpce-gateway.html) di Panduan.AWS PrivateLink *

## Pertimbangan saat menggunakan AWS PrivateLink untuk Amazon DynamoDB
<a name="privatelink-considerations"></a>

Pertimbangan Amazon VPC berlaku untuk Amazon AWS PrivateLink DynamoDB. Untuk informasi selengkapnya, lihat [Pertimbangan antarmuka titik akhir](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-interface.html#vpce-interface-limitations) dan [AWS PrivateLink kuota](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-limits-endpoints.html) dalam *AWS PrivateLink Panduan*. Selain itu, larangan berikut juga berlaku.

AWS PrivateLink untuk Amazon DynamoDB tidak mendukung hal berikut:
+ Keamanan Lapisan Pengangkutan (TLS) 1.1
+ Layanan Sistem Nama Domain Pribadi dan Hybrid (DNS)

**penting**  
Jangan membuat zona host pribadi untuk mengganti nama DNS titik akhir DynamoDB (`dynamodb.region.amazonaws.com`seperti `*.region.amazonaws.com` atau) untuk merutekan lalu lintas ke titik akhir antarmuka Anda. Konfigurasi DNS DynamoDB dapat berubah seiring waktu.   
 Penggantian DNS khusus tidak kompatibel dengan perubahan ini dan dapat menyebabkan permintaan merutekan secara tak terduga melalui alamat IP publik alih-alih titik akhir antarmuka Anda.   
 Untuk mengakses DynamoDB AWS PrivateLink melalui, konfigurasikan klien Anda untuk menggunakan URL endpoint Amazon VPC secara langsung (misalnya,). `https://vpce-1a2b3c4d-5e6f.dynamodb.region.vpce.amazonaws.com`

Anda dapat mengirimkan hingga 50.000 permintaan per detik untuk setiap AWS PrivateLink titik akhir yang Anda aktifkan.

**catatan**  
Batas waktu konektivitas jaringan ke AWS PrivateLink titik akhir tidak berada dalam lingkup respons kesalahan DynamoDB dan perlu ditangani dengan tepat oleh aplikasi Anda yang terhubung ke titik akhir. PrivateLink 

## Membuat titik akhir Amazon VPC
<a name="ddb-creating-vpc"></a>

*Untuk membuat titik akhir antarmuka VPC Amazon, lihat Membuat titik akhir [VPC Amazon](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws) di Panduan.AWS PrivateLink *

## Mengakses titik akhir antarmuka Amazon DynamoDB
<a name="accessing-ddb-interface-endpoints"></a>

**Saat Anda membuat titik akhir antarmuka, DynamoDB menghasilkan dua jenis nama DNS DynamoDB spesifik titik akhir: Regional dan Zonal.** 
+ Nama DNS *Regional* mencakup ID titik akhir VPC Amazon yang unik, pengenal layanan, Wilayah AWS dan namanya. `vpce.amazonaws.com` Misalnya, untuk ID titik akhir VPC Amazon`vpce-1a2b3c4d`, nama DNS yang dihasilkan mungkin mirip dengan. `vpce-1a2b3c4d-5e6f.dynamodb.us-east-1.vpce.amazonaws.com`
+ Nama DNS *Zonal* mencakup Zona Ketersediaan—misalnya, `vpce-1a2b3c4d-5e6f-us-east-1a.dynamodb.us-east-1.vpce.amazonaws.com`. Anda dapat menggunakan opsi ini jika arsitektur Anda mengisolasi Zona Ketersediaan. Contoh, Anda bisa menggunakannya untuk kontainer kesalahan atau untuk mengurangi biaya transfer data Regional.

**catatan**  
Untuk mencapai keandalan yang optimal, sebaiknya gunakan layanan Anda di minimal tiga zona ketersediaan.

## Mengakses tabel DynamoDB dan mengontrol operasi API dari titik akhir antarmuka DynamoDB
<a name="accessing-tables-apis-from-interface-endpoints"></a>

Anda dapat menggunakan AWS CLI atau AWS SDKs untuk mengakses tabel DynamoDB dan mengontrol operasi API melalui titik akhir antarmuka DynamoDB.

### AWS CLI contoh
<a name="privatelink-ddb-aws-cli-examples"></a>

Untuk mengakses tabel DynamoDB atau operasi API kontrol DynamoDB melalui titik akhir antarmuka DynamoDB dalam perintah, gunakan parameter dan. AWS CLI `--region` `--endpoint-url`

**Contoh: Buat titik akhir VPC**

```
aws ec2 create-vpc-endpoint \
--region us-east-1 \
--service-name com.amazonaws.us-east-1.dynamodb \
--vpc-id client-vpc-id \
--subnet-ids client-subnet-id \
--vpc-endpoint-type Interface \
--security-group-ids client-sg-id
```

**Contoh: Memodifikasi titik akhir VPC**

```
aws ec2 modify-vpc-endpoint \
--region us-east-1 \
--vpc-endpoint-id client-vpc-endpoint-id \
--policy-document policy-document \ #example optional parameter
--add-security-group-ids security-group-ids \ #example optional parameter 
# any additional parameters needed, see Privatelink documentation for more details
```

**Contoh: Daftar tabel menggunakan URL endpoint**

Dalam contoh berikut, ganti Region `us-east-1` dan nama DNS dari `vpce-1a2b3c4d-5e6f.dynamodb.us-east-1.vpce.amazonaws.com` ID endpoint VPC dengan informasi Anda sendiri.

```
aws dynamodb --region us-east-1 --endpoint https://vpce-1a2b3c4d-5e6f.dynamodb.us-east-1.vpce.amazonaws.com list-tables
```

### AWS Contoh SDK
<a name="privatelink-ddb-aws-sdk-examples"></a>

Untuk mengakses tabel DynamoDB atau operasi API kontrol DynamoDB melalui titik akhir antarmuka DynamoDB saat menggunakan, perbarui versi Anda ke versi terbaru. AWS SDKs SDKs Kemudian, konfigurasikan klien Anda untuk menggunakan URL titik akhir untuk mengakses tabel atau operasi API kontrol DynamoDB melalui titik akhir antarmuka DynamoDB.

------
#### [ SDK for Python (Boto3) ]

**Contoh: Gunakan URL endpoint untuk mengakses tabel DynamoDB**  
Dalam contoh berikut, ganti Wilayah `us-east-1` dan ID titik akhir VPC `https://vpce-1a2b3c4d-5e6f.dynamodb.us-east-1.vpce.amazonaws.com` dengan informasi Anda sendiri.

```
ddb_client = session.client(
service_name='dynamodb',
region_name='us-east-1',
endpoint_url='https://vpce-1a2b3c4d-5e6f.dynamodb.us-east-1.vpce.amazonaws.com'
)
```

------
#### [ SDK for Java 1.x ]

**Contoh: Gunakan URL endpoint untuk mengakses tabel DynamoDB**  
Dalam contoh berikut, ganti Wilayah `us-east-1` dan ID titik akhir VPC `https://vpce-1a2b3c4d-5e6f.dynamodb.us-east-1.vpce.amazonaws.com` dengan informasi Anda sendiri.

```
//client build with endpoint config  
final AmazonDynamoDB dynamodb = AmazonDynamoDBClientBuilder.standard().withEndpointConfiguration(
        new AwsClientBuilder.EndpointConfiguration(
                "https://vpce-1a2b3c4d-5e6f.dynamodb.us-east-1.vpce.amazonaws.com",
                Regions.DEFAULT_REGION.getName()
        )
).build();
```

------
#### [ SDK for Java 2.x ]

**Contoh: Gunakan URL endpoint untuk mengakses tabel DynamoDB**  
Dalam contoh berikut, ganti ID endpoint Region us-east-1 dan https://vpce-1a2b3c4d-5e6f.dynamodb.us-east-1.vpce.amazonaws.com VPC dengan informasi Anda sendiri.

```
Region region = Region.US_EAST_1;
dynamoDbClient = DynamoDbClient.builder().region(region)
.endpointOverride(URI.create("https://vpce-1a2b3c4d-5e6f.dynamodb.us-east-1.vpce.amazonaws.com"))
.build()
```

------

## Memperbarui konfigurasi DNS on-premise
<a name="updating-on-premises-dns-config"></a>

 Saat menggunakan nama DNS khusus titik akhir untuk mengakses titik akhir antarmuka DynamoDB, Anda tidak perlu memperbarui penyelesai DNS lokal Anda. Anda dapat menyelesaikan nama DNS spesifik titik akhir dengan alamat IP pribadi titik akhir antarmuka dari domain DNS DynamoDB publik. 

### Menggunakan titik akhir antarmuka untuk mengakses DynamoDB tanpa titik akhir gateway atau gateway internet di Amazon VPC
<a name="using-interface-endpoints"></a>

Titik akhir antarmuka di VPC Amazon Anda dapat merutekan aplikasi VPC di Amazon dan aplikasi lokal ke DynamoDB melalui jaringan Amazon, seperti yang diilustrasikan dalam diagram berikut.

![\[Diagram alir data yang menunjukkan akses dari aplikasi VPC lokal dan di Amazon ke DynamoDB; dengan menggunakan titik akhir antarmuka dan. AWS PrivateLink\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/images/PrivateLink-interfaceEndpoints.png)


Diagram ini menggambarkan hal sebagai berikut: 
+ Jaringan lokal Anda menggunakan Direct Connect atau menyambung Site-to-Site VPN ke Amazon VPC A.
+ Aplikasi Anda lokal dan di Amazon VPC A menggunakan nama DNS khusus titik akhir untuk mengakses DynamoDB melalui titik akhir antarmuka DynamoDB.
+ Aplikasi lokal mengirim data ke titik akhir antarmuka di Amazon VPC melalui Direct Connect (atau). Site-to-Site VPN AWS PrivateLink memindahkan data dari titik akhir antarmuka ke DynamoDB melalui jaringan. AWS 
+ Aplikasi VPC di Amazon juga mengirim lalu lintas ke titik akhir antarmuka. AWS PrivateLink memindahkan data dari titik akhir antarmuka ke DynamoDB melalui jaringan. AWS 

### Menggunakan titik akhir gateway dan titik akhir antarmuka bersama-sama di Amazon VPC yang sama untuk mengakses DynamoDB
<a name="using-gateway-and-interface-endpoints"></a>

Anda dapat membuat titik akhir antarmuka dan mempertahankan titik akhir gateway yang ada di VPC Amazon yang sama, seperti yang ditunjukkan diagram berikut. Dengan mengambil pendekatan ini, Anda mengizinkan aplikasi VPC di Amazon untuk terus mengakses DynamoDB melalui titik akhir gateway, yang tidak ditagih. Kemudian, hanya aplikasi lokal Anda yang akan menggunakan titik akhir antarmuka untuk mengakses DynamoDB. Untuk mengakses DynamoDB dengan cara ini, Anda harus memperbarui aplikasi lokal Anda untuk menggunakan nama DNS khusus titik akhir untuk DynamoDB.

![\[Diagram aliran data yang menunjukkan akses ke DynamoDB dengan menggunakan titik akhir gateway dan titik akhir antarmuka bersama-sama.\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/images/PL-Image2-InterfaceAndGatewayEP.png)


Diagram ini menggambarkan hal sebagai berikut: 
+ Aplikasi lokal menggunakan nama DNS khusus titik akhir untuk mengirim data ke titik akhir antarmuka dalam VPC Amazon melalui (atau). Direct Connect Site-to-Site VPN AWS PrivateLink memindahkan data dari titik akhir antarmuka ke DynamoDB melalui jaringan. AWS 
+ Menggunakan nama DynamoDB Regional default, aplikasi VPC di Amazon mengirim data ke titik akhir gateway yang terhubung ke DynamoDB melalui jaringan. AWS 

Untuk informasi selengkapnya tentang titik akhir gateway, lihat [Gateway titik akhir VPC Amazon](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-gateway.html) di Panduan Pengguna *Amazon VPC*. 

## Membuat kebijakan endpoint Amazon VPC untuk DynamoDB
<a name="creating-vpc-endpoint-policy"></a>

Anda dapat melampirkan kebijakan endpoint ke endpoint Amazon VPC yang mengontrol akses ke DynamoDB. Kebijakan titik akhir menentukan informasi berikut: 
+ Prinsip AWS Identity and Access Management (IAM) yang dapat melakukan tindakan 
+ Tindakan-tindakan yang dapat dilakukan 
+ Sumber daya yang padanya tindakan dapat dilakukan 

**Topics**
+ [Contoh: Membatasi akses ke tabel tertentu dari titik akhir VPC Amazon](#privatelink-example-restrict-access-to-bucket)

### Contoh: Membatasi akses ke tabel tertentu dari titik akhir VPC Amazon
<a name="privatelink-example-restrict-access-to-bucket"></a>

Anda dapat membuat kebijakan endpoint yang membatasi akses hanya ke tabel DynamoDB tertentu. Jenis kebijakan ini berguna jika Anda memiliki kebijakan lain Layanan AWS di VPC Amazon Anda yang menggunakan tabel. Kebijakan tabel berikut membatasi akses hanya ke file. `DOC-EXAMPLE-TABLE` Untuk menggunakan kebijakan endpoint ini, ganti `DOC-EXAMPLE-TABLE` dengan nama tabel Anda.

------
#### [ JSON ]

****  

```
{
"Version":"2012-10-17",		 	 	 
  "Id": "Policy1216114807515",
  "Statement": [
    { "Sid": "Access-to-specific-table-only",
      "Principal": "*",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:PutItem"
      ],
      "Effect": "Allow",
      "Resource": ["arn:aws:dynamodb:us-east-1:111122223333:table/DOC-EXAMPLE-TABLE",
                   "arn:aws:dynamodb:us-east-1:111122223333:table/DOC-EXAMPLE-TABLE/*"]
    }
  ]
}
```

------

## Menggunakan titik akhir DynamoDB dengan Akses Pribadi Konsol Manajemen AWS
<a name="ddb-endpoints-private-access"></a>

[https://console.aws.amazon.com/dynamodb](https://console.aws.amazon.com/dynamodb)

Untuk mengonfigurasi DynamoDB agar dapat diakses Konsol Manajemen AWS di Private Access, Anda harus membuat dua titik akhir VPC berikut:
+ `com.amazonaws.<region>.dynamodb`
+ `com.amazonaws.<region>.dynamodb-streams`

Saat Anda membuat titik akhir VPC, navigasikan ke konsol Route53 dan buat zona host pribadi untuk DynamoDB menggunakan titik akhir regional. `dynamodb.us-east-1.amazonaws.com`

Buat dua catatan alias berikut di zona host pribadi:
+ `dynamodb.<region>.amazonaws.com`yang merutekan lalu lintas ke titik akhir VPC. `com.amazonaws.<region>.dynamodb`
+ `streams.dynamodb.<region>.amazonaws.com`yang merutekan lalu lintas ke titik akhir VPC. `com.amazonaws.<region>.dynamodb-streams`