

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

# Mengelola cluster di ElastiCache
<a name="Clusters"></a>

*Cluster* adalah kumpulan dari satu atau lebih node cache, yang semuanya menjalankan instance perangkat lunak mesin Valkey, Memcached, dan Redis OSS. Saat membuat klaster, Anda menentukan mesin dan versi yang akan digunakan oleh semua simpul.

**Cluster Valkey dan Redis OSS**

Diagram berikut menggambarkan cluster Valkey atau Redis OSS yang khas. Cluster ini dapat berisi satu node atau hingga enam node di dalam shard (API/CLI: grup node), cluster Valkey atau Redis OSS simpul tunggal (mode cluster dinonaktifkan) tidak memiliki pecahan, dan cluster Valkey multi-node atau Redis OSS (mode cluster dinonaktifkan) memiliki pecahan tunggal. Cluster Valkey atau Redis OSS (mode cluster enabled) dapat memiliki hingga 500 pecahan, dengan data Anda dipartisi di seluruh pecahan. Batas node atau shard dapat ditingkatkan hingga maksimum 500 per cluster jika versi mesin Valkey 7.2 dan lebih tinggi atau Redis OSS 5.0.6 dan lebih tinggi. Sebagai contoh, Anda dapat memilih untuk mengonfigurasi sebuah klaster dengan 500 simpul yang berkisar antara 83 serpihan (satu primer dan 5 replika per serpihan) dan 500 serpihan (satu primer dan tanpa replika). Pastikan alamat IP yang tersedia mencukupi untuk mengakomodasi peningkatan tersebut. Kesalahan umumnya termasuk subnet dalam grup subnet memiliki rentang CIDR yang terlalu kecil atau subnet dibagikan dan banyak digunakan oleh klaster lainnya. Untuk informasi selengkapnya, lihat [Membuat grup subnet](SubnetGroups.Creating.md). Untuk versi di bawah 5.0.6, batasnya adalah 250 per klaster.

Untuk meminta penambahan batas, lihat [Batas Layanan AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) dan pilih jenis batas **Simpul per klaster per jenis instans**. 

 Ketika Anda memiliki beberapa node dalam pecahan Valkey atau Redis OSS, salah satu node adalah simpul utama. read/write Semua simpul lain dalam serpihan adalah replika hanya-baca.

Cluster Valkey atau Redis OSS yang khas terlihat sebagai berikut.

![\[Gambar: Khas Valkey dan Redis OSS Cluster\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/ElastiCache-Cluster-Redis.png)


**Cluster memcache**

Cluster Memcached yang khas terlihat sebagai berikut. Cluster memcache berisi dari 1 hingga 60 node, di mana Anda secara horizontal mempartisi data Anda.

![\[Gambar: Klaster Memcached Secara Umum\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/ElastiCache-Cluster-Memcached.png)


**Operasi elasticache untuk Valkey, Memcached, dan Redis OSS**

Sebagian besar ElastiCache operasi dilakukan di tingkat cluster. Anda dapat menyiapkan klaster dengan jumlah simpul tertentu dan grup parameter yang mengontrol properti untuk setiap simpul. Semua simpul dalam klaster dirancang agar berupa jenis simpul yang sama serta memiliki parameter dan pengaturan grup keamanan yang sama. 

Setiap klaster harus memiliki pengidentifikasi klaster. Pengidentifikasi klaster adalah nama yang diberikan pelanggan untuk klaster. Identifier ini menentukan cluster tertentu ketika berinteraksi dengan ElastiCache API dan perintah. AWS CLI Pengidentifikasi cluster harus unik untuk pelanggan tersebut di suatu AWS Wilayah.

ElastiCache mendukung beberapa versi mesin. Kecuali jika Anda memiliki alasan tertentu, kami menyarankan menggunakan versi terbaru.

ElastiCache cluster dirancang untuk diakses menggunakan EC2 instance Amazon. Jika Anda meluncurkan klaster Anda di cloud privat virtual (VPC) berdasarkan layanan Amazon VPC, Anda dapat mengaksesnya dari luar AWS. Untuk informasi selengkapnya, lihat [Mengakses ElastiCache sumber daya dari luar AWS](accessing-elasticache.md#access-from-outside-aws).

Untuk daftar versi yang didukung, lihat[Mesin dan versi yang didukung](VersionManagement.md#supported-engine-versions),[Versi mesin Redis OSS yang didukung](engine-versions.md#supported-engine-versions.redis), dan[Didukung ElastiCache untuk versi Memcached](engine-versions.md#supported-engine-versions-mc).

# Memilih jenis jaringan di ElastiCache
<a name="network-type"></a>

ElastiCache mendukung Internet Protocol versi 4 dan 6 (IPv4 dan IPv6), memungkinkan Anda untuk mengkonfigurasi cluster Anda untuk menerima:
+ hanya IPv4 koneksi,
+ hanya IPv6 koneksi,
+ keduanya IPv4 dan IPv6 koneksi (dual-stack)

IPv6 [didukung untuk beban kerja menggunakan Valkey 7.2 dan seterusnya, atau Redis OSS 6.2 dan seterusnya, pada semua instance yang dibangun di atas sistem Nitro.](https://aws.amazon.com/ec2/nitro/) Tidak ada biaya tambahan untuk mengakses ElastiCache lebih IPv6. 

**catatan**  
Migrasi cluster yang dibuat sebelum ketersediaan IPV6 /dual-stack tidak didukung. Beralih antarjenis jaringan pada klaster yang baru dibuat juga tidak didukung.

IPv6 [didukung untuk beban kerja menggunakan Memcached 1.6.6 dan seterusnya pada semua instance yang dibangun di sistem Nitro.](https://aws.amazon.com/ec2/nitro/) Tidak ada biaya tambahan untuk mengakses ElastiCache lebih IPv6. 

## Mengonfigurasi subnet untuk jenis jaringan
<a name="network-type-subnets"></a>

Jika Anda membuat cluster di VPC Amazon, Anda harus menentukan grup subnet. ElastiCache menggunakan grup subnet itu untuk memilih subnet dan alamat IP dalam subnet itu untuk dikaitkan dengan node Anda. ElastiCache cluster memerlukan subnet dual-stack dengan keduanya IPv4 dan IPv6 alamat yang ditetapkan untuk beroperasi dalam mode dual-stack dan subnet -only untuk beroperasi sebagai IPv6 -only. IPv6

## Menggunakan tumpukan ganda
<a name="network-type-dual-stack"></a>

Saat menggunakan ElastiCache untuk Redis OSS dalam mode cluster diaktifkan, dari perspektif aplikasi, menghubungkan ke semua node cluster melalui titik akhir konfigurasi tidak berbeda dengan menghubungkan langsung ke node cache individu. Untuk mencapai hal ini, klien yang sadar klaster harus terlibat dalam proses penemuan klaster dan meminta informasi konfigurasi untuk semua simpul. Protokol penemuan Redis hanya mendukung satu IP per simpul. 

Saat Anda membuat cluster dengan ElastiCache untuk Memcacheddan memilih dual-stack sebagai jenis jaringan, Anda kemudian perlu menunjuk jenis penemuan IP — salah satu atau. IPv4 IPv6 ElastiCache akan default jenis jaringan dan penemuan IP ke IPv6, tetapi itu dapat diubah. Jika Anda menggunakan Penemuan Otomatis, hanya alamat IP dari jenis IP yang Anda pilih yang dikembalikan ke klien Memcached. Untuk informasi selengkapnya, lihat [Secara otomatis mengidentifikasi node di cluster Anda (Memcached)](AutoDiscovery.md).

Untuk mempertahankan kompatibilitas mundur dengan semua klien yang ada, penemuan IP diperkenalkan, yang memungkinkan Anda memilih jenis IP (yaitu, IPv4 atau IPv6) untuk beriklan di protokol penemuan. Meskipun ini membatasi penemuan otomatis hanya pada satu jenis IP, dual-stack masih bermanfaat untuk beban kerja yang diaktifkan mode cluster, karena memungkinkan migrasi (atau rollback) dari tipe IP IPv6 Discovery IPv4 ke tanpa downtime.

## TLS mengaktifkan cluster tumpukan ElastiCache ganda
<a name="configuring-tls-enabled-dual-stack"></a>

Ketika TLS diaktifkan untuk cluster fungsi penemuan cluster seperti`cluster slots`,`cluster shards`, dan `cluster nodes` dengan Valkey atau Redis OSS dan `config get cluster` dengan Memcached mengembalikan ElastiCache nama host alih-alih. IPs Nama host kemudian digunakan sebagai pengganti IPs untuk terhubung ke ElastiCache cluster dan melakukan jabat tangan TLS. Ini berarti bahwa klien tidak akan terpengaruh oleh parameter Penemuan IP. *Untuk klaster dengan TLS diaktifkan, parameter Penemuan IP tidak berpengaruh pada protokol IP yang disukai.* Sebagai gantinya, protokol IP yang digunakan akan ditentukan oleh protokol IP mana yang lebih dipilih klien saat meresolusi nama host DNS.

Untuk contoh tentang cara mengonfigurasi preferensi protokol IP saat meresolusi nama host DNS, lihat [TLS mengaktifkan cluster tumpukan ElastiCache ganda](BestPractices.md#network-type-configuring-tls-enabled-dual-stack).

## Menggunakan Konsol Manajemen AWS(Valkey dan Redis OSS)
<a name="network-type-console"></a>

Saat membuat cluster menggunakan Konsol Manajemen AWS, di bawah **Konektivitas**, pilih jenis jaringan, baik **IPv4**, **IPv6**atau **tumpukan ganda**. Jika Anda membuat cluster Valkey atau Redis OSS (mode cluster enabled) dan memilih tumpukan ganda, Anda kemudian harus memilih **jenis IP Discovery**, salah satu atau. IPv6 IPv4

Untuk informasi selengkapnya, lihat [Membuat cluster Valkey atau Redis OSS (mode cluster diaktifkan) (Konsol)](Clusters.Create.md#Clusters.Create.CON.RedisCluster) atau [Membuat Valkey atau Redis OSS (mode cluster dinonaktifkan) (Konsol)](Clusters.Create.md#Clusters.Create.CON.Redis).

Saat membuat grup replikasi menggunakan Konsol Manajemen AWS, pilih jenis jaringan, baik **IPv4**, **IPv6**atau **Dual stack**. Jika Anda memilih tumpukan ganda, Anda harus memilih **jenis IP Discovery**, salah satu IPv6 atau IPv4.

Untuk informasi selengkapnya, lihat [Membuat grup replikasi Valkey atau Redis OSS (Cluster Mode Disabled) dari awal](Replication.CreatingReplGroup.NoExistingCluster.Classic.md) atau [Membuat grup replikasi di Valkey atau Redis OSS (Mode Cluster Diaktifkan) dari awal](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md).

## Menggunakan Konsol Manajemen AWS(Memcached)
<a name="network-type-console-mem"></a>

Saat membuat cluster menggunakan Konsol Manajemen AWS, di bawah **Konektivitas**, pilih jenis jaringan, baik **IPv4**, **IPv6**atau **tumpukan ganda**. Jika Anda memilih tumpukan ganda, Anda harus memilih **jenis IP Discovery**, salah satu IPv6 atau IPv4.

Untuk informasi selengkapnya, lihat [Membuat klaster Memcached (konsol)](Clusters.Create-mc.md#Clusters.Create.CON.Memcached).

## Menggunakan CLI dengan Valkey, Memcached, atau Redis OSS.
<a name="network-type-cli"></a>

**Redis OSS**

Saat membuat cluster dengan Valkey atau Redis OSS menggunakan CLI, Anda menggunakan [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html)perintah dan menentukan parameter dan: `NetworkType` `IPDiscovery`

Untuk Linux, macOS, atau Unix:

```
aws elasticache create-cache-cluster \
    --cache-cluster-id "cluster-test" \
    --engine redis \
    --cache-node-type cache.m5.large \
    --num-cache-nodes 1 \
    --network-type dual_stack \
    --ip-discovery ipv4
```

Untuk Windows:

```
aws elasticache create-cache-cluster ^
    --cache-cluster-id "cluster-test" ^
    --engine redis ^
    --cache-node-type cache.m5.large ^
    --num-cache-nodes 1 ^
    --network-type dual_stack ^
    --ip-discovery ipv4
```

Saat membuat grup replikasi dengan mode cluster dinonaktifkan menggunakan CLI, Anda menggunakan [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)perintah dan menentukan `NetworkType` parameter dan: `IPDiscovery`

Untuk Linux, macOS, atau Unix:

```
aws elasticache create-replication-group \
   --replication-group-id sample-repl-group \
   --replication-group-description "demo cluster with replicas" \
   --num-cache-clusters 3 \
   --primary-cluster-id redis01 \
   --network-type dual_stack \
   --ip-discovery ipv4
```

Untuk Windows:

```
aws elasticache create-replication-group ^
   --replication-group-id sample-repl-group ^
   --replication-group-description "demo cluster with replicas" ^
   --num-cache-clusters 3 ^
   --primary-cluster-id redis01 ^
   --network-type dual_stack ^
   --ip-discovery ipv4
```

Saat membuat grup replikasi dengan mode cluster diaktifkan dan digunakan IPv4 untuk penemuan IP menggunakan CLI, Anda menggunakan [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)perintah dan menentukan `NetworkType` parameter dan: `IPDiscovery`

Untuk Linux, macOS, atau Unix:

```
aws elasticache create-replication-group \
  --replication-group-id demo-cluster \
  --replication-group-description "demo cluster" \
  --cache-node-type cache.m5.large \
  --num-node-groups 2 \
  --engine redis \
  --cache-subnet-group-name xyz \
  --network-type dual_stack \
  --ip-discovery ipv4 \
  --region us-east-1
```

Untuk Windows:

```
aws elasticache create-replication-group ^
  --replication-group-id demo-cluster ^
  --replication-group-description "demo cluster" ^
  --cache-node-type cache.m5.large ^
  --num-node-groups 2 ^
  --engine redis ^
  --cache-subnet-group-name xyz ^
  --network-type dual_stack ^
  --ip-discovery ipv4 ^
  --region us-east-1
```

Saat membuat grup replikasi dengan mode cluster diaktifkan dan digunakan IPv6 untuk penemuan IP menggunakan CLI, Anda menggunakan [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)perintah dan menentukan `NetworkType` parameter dan: `IPDiscovery`

Untuk Linux, macOS, atau Unix:

```
aws elasticache create-replication-group \
  --replication-group-id demo-cluster \
  --replication-group-description "demo cluster" \
  --cache-node-type cache.m5.large \
  --num-node-groups 2 \
  --engine redis \
  --cache-subnet-group-name xyz \
  --network-type dual_stack \
  --ip-discovery ipv6 \
  --region us-east-1
```

Untuk Windows:

```
aws elasticache create-replication-group ^
  --replication-group-id demo-cluster ^
  --replication-group-description "demo cluster" ^
  --cache-node-type cache.m5.large ^
  --num-node-groups 2 ^
  --engine redis ^
  --cache-subnet-group-name xyz ^
  --network-type dual_stack ^
  --ip-discovery ipv6 ^
  --region us-east-1
```

**Memcache**

Saat membuat cluster dengan Memcached menggunakan CLI, Anda menggunakan [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html)perintah dan menentukan parameter dan: `NetworkType` `IPDiscovery`

Untuk Linux, macOS, atau Unix:

```
aws elasticache create-cache-cluster \
    --cache-cluster-id "cluster-test" \
    --engine memcached \
    --cache-node-type cache.m5.large \
    --num-cache-nodes 1 \
    --network-type dual_stack \
    --ip-discovery ipv4
```

Untuk Windows:

```
aws elasticache create-cache-cluster ^
    --cache-cluster-id "cluster-test" ^
    --engine memcached ^
    --cache-node-type cache.m5.large ^
    --num-cache-nodes 1 ^
    --network-type dual_stack ^
    --ip-discovery ipv4
```

# Secara otomatis mengidentifikasi node di cluster Anda (Memcached)
<a name="AutoDiscovery"></a>

Untuk cluster yang menjalankan mesin Memcached, ElastiCache mendukung *Auto Discovery* — kemampuan program klien untuk secara otomatis mengidentifikasi semua node dalam sebuah cluster, dan untuk memulai dan memelihara koneksi ke semua node ini. 

**catatan**  
Auto Discovery ditambahkan untuk cluster yang berjalan di Amazon ElastiCache Memcached. Auto Discovery tidak tersedia untuk mesin Valkey atau Redis OSS.

Dengan Penemuan Otomatis, aplikasi Anda tidak perlu secara manual terhubung ke tiap-tiap simpul cache; sebagai gantinya, aplikasi Anda terhubung ke satu simpul Memcached dan mengambil daftar simpul. Dari daftar tersebut, aplikasi Anda akan mengetahui simpul yang tersisa di klaster dan dapat terhubung ke simpul yang mana pun. Anda tidak perlu melakukan hardcoding setiap titik akhir simpul cache ke dalam kode aplikasi Anda.

Jika Anda menggunakan tipe jaringan tumpukan ganda pada cluster Anda, Auto Discovery hanya akan mengembalikan IPv4 atau IPv6 alamat, tergantung pada mana yang Anda pilih. Untuk informasi selengkapnya, lihat [Memilih jenis jaringan di ElastiCache](network-type.md).

Semua simpul cache di klaster memelihara daftar metadata tentang semua simpul lainnya. Metadata ini diperbarui setiap kali simpul ditambahkan atau dihapus dari klaster.

**Topics**
+ [

# Manfaat Penemuan Otomatis dengan Memcached
](AutoDiscovery.Benefits.md)
+ [

# Cara Kerja Penemuan Otomatis
](AutoDiscovery.HowAutoDiscoveryWorks.md)
+ [

# Menggunakan Penemuan Otomatis
](AutoDiscovery.Using.md)
+ [

# Menghubungkan ke Memcached Cache Node Secara Manual
](AutoDiscovery.Manual.md)
+ [

# Menambahkan Penemuan Otomatis ke pustaka klien Memcached Anda
](AutoDiscovery.AddingToYourClientLibrary.md)
+ [

# ElastiCache klien dengan penemuan otomatis
](Clients.md)

# Manfaat Penemuan Otomatis dengan Memcached
<a name="AutoDiscovery.Benefits"></a>

Saat menggunakan Memcached, Auto Discovery menawarkan manfaat berikut:
+ Ketika Anda meningkatkan jumlah node dalam sebuah cluster, node baru mendaftarkan diri dengan titik akhir konfigurasi dan dengan semua node lainnya. Ketika Anda menghapus simpul dari klaster cache, simpul yang dihapus tersebut akan menghapus pendaftarannya sendiri. Dalam kedua kasus, semua simpul lain di klaster diperbarui dengan metadata simpul cache yang terbaru.
+ Kegagalan simpul cache akan terdeteksi secara otomatis; simpul yang gagal diganti secara otomatis.
**catatan**  
Hingga penggantian simpul selesai, simpul akan terus gagal.
+ Program klien hanya perlu terhubung ke titik akhir konfigurasi. Setelah itu, pustaka Penemuan Otomatis terhubung ke semua simpul lain di klaster.
+ Program klien melakukan polling klaster sekali setiap menit (interval ini dapat disesuaikan jika diperlukan). Jika ada perubahan pada konfigurasi klaster, seperti simpul yang baru atau dihapus, klien menerima daftar metadata yang diperbarui. Kemudian klien terhubung ke, atau memutuskan koneksi dari, simpul ini sesuai kebutuhan.

Auto Discovery diaktifkan pada semua cluster ElastiCache Memcached. Anda tidak perlu memulai ulang simpul cache Anda yang mana pun untuk menggunakan fitur ini.

# Cara Kerja Penemuan Otomatis
<a name="AutoDiscovery.HowAutoDiscoveryWorks"></a>

**Topics**
+ [

## Menyambung ke Simpul Cache
](#AutoDiscovery.HowAutoDiscoveryWorks.Connecting)
+ [

## Operasi Klaster Normal
](#AutoDiscovery.HowAutoDiscoveryWorks.NormalOps)
+ [

## Operasi Lainnya
](#AutoDiscovery.HowAutoDiscoveryWorks.OtherOps)

Bagian ini menjelaskan bagaimana aplikasi klien menggunakan Klien ElastiCache Cluster untuk mengelola koneksi node cache, dan berinteraksi dengan item data dalam cache.

## Menyambung ke Simpul Cache
<a name="AutoDiscovery.HowAutoDiscoveryWorks.Connecting"></a>

Dari sudut pandang aplikasi, terhubung ke titik akhir konfigurasi klaster tidak berbeda dengan terhubung secara langsung ke tiap-tiap simpul cache. Diagram urutan berikut menunjukkan proses menghubungkan ke simpul cache. 

![\[Menghubungkan ke Simpul Cache\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/autodiscovery_cluster_membership_refresh-diagram.png)



**Proses Menghubungkan ke Simpul Cache**  

|  |  | 
| --- |--- |
|  ![\[1\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/callouts/1.png) | Aplikasi meresolusi nama DNS dari titik akhir konfigurasi. Karena titik akhir konfigurasi memelihara entri CNAME untuk semua simpul cache, nama DNS diresolusi ke salah satu simpul; klien kemudian dapat terhubung ke simpul tersebut. | 
|  ![\[2\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/callouts/2.png) | Klien meminta informasi konfigurasi untuk semua simpul lainnya. Karena setiap simpul memelihara informasi konfigurasi untuk semua simpul di klaster, simpul mana pun dapat meneruskan informasi konfigurasi ke klien jika diminta. | 
|  ![\[3\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/callouts/3.png) | Klien menerima daftar terkini yang berisi nama host simpul cache dan alamat IP. Klien kemudian dapat terhubung ke semua simpul lain dalam klaster. | 



**catatan**  
Program klien menyegarkan daftar nama host simpul cache dan alamat IP sekali setiap menit. Interval polling ini dapat disesuaikan jika perlu.

## Operasi Klaster Normal
<a name="AutoDiscovery.HowAutoDiscoveryWorks.NormalOps"></a>

Ketika aplikasi telah terhubung ke semua node cache, ElastiCache Cluster Client menentukan node mana yang harus menyimpan item data individual, dan node mana yang harus ditanyakan untuk item data tersebut nanti. Diagram urutan berikut menunjukkan proses operasi klaster normal.

![\[Operasi Klaster Normal\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/autodiscovery_normal_cache_usage-diagram.png)



**Proses Operasi Klaster Normal**  

|  |  | 
| --- |--- |
|  ![\[1\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/callouts/1.png) | Aplikasi ini mengeluarkan permintaan get untuk item data tertentu, yang teridentifikasi oleh kuncinya. | 
|  ![\[2\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/callouts/2.png) | Klien menggunakan algoritma hashing terhadap kunci untuk menentukan simpul cache yang berisi item data. | 
|  ![\[3\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/callouts/3.png) | Item data diminta dari simpul yang sesuai. | 
|  ![\[4\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/callouts/4.png) | Item data ditampilkan ke aplikasi. | 

## Operasi Lainnya
<a name="AutoDiscovery.HowAutoDiscoveryWorks.OtherOps"></a>

Dalam beberapa situasi, Anda mungkin melakukan perubahan pada simpul klaster. Misalnya, Anda mungkin menambahkan simpul tambahan untuk mengakomodasi permintaan tambahan, atau menghapus simpul untuk menghemat uang selama periode berkurangnya permintaan. Atau Anda mungkin mengganti simpul karena kegagalan simpul atau hal lainnya.

Ketika ada perubahan dalam klaster yang memerlukan pembaruan metadata ke titik akhir klaster, perubahan tersebut dilakukan pada semua simpul secara bersamaan. Dengan demikian, metadata di simpul mana pun menjadi konsisten dengan metadata di semua simpul lain di klaster.

Dalam setiap kasus ini, metadata menjadi konsisten di antara semua simpul setiap saat karena metadata diperbarui pada saat yang sama untuk semua simpul dalam klaster. Anda harus selalu menggunakan titik akhir konfigurasi untuk memperoleh titik akhir dari berbagai simpul di klaster. Dengan titik akhir konfigurasi, Anda memastikan bahwa Anda tidak akan memperoleh data titik akhir dari simpul yang "menghilang".

### Menambahkan Simpul
<a name="AutoDiscovery.HowAutoDiscoveryWorks.OtherOps.AddNode"></a>

Pada saat simpul sedang dibuat, titik akhirnya tidak disertakan ke dalam metadata. Begitu sudah tersedia, simpul akan ditambahkan ke metadata dari setiap simpul klaster. Dalam skenario ini, metadata bersifat konsisten di antara semua simpul dan Anda akan dapat berinteraksi dengan simpul baru hanya setelah simpul itu tersedia. Sebelum simpul tersedia, Anda tidak akan mengetahuinya dan akan berinteraksi dengan simpul di klaster Anda seakan-akan simpul baru tersebut tidak ada.

### Menghapus Simpul
<a name="AutoDiscovery.HowAutoDiscoveryWorks.OtherOps.DelNode"></a>

Ketika simpul dihapus, pertama-tama titik akhirnya dihapus dari metadata lalu simpul tersebut dihapus dari klaster. Dalam skenario ini metadata di semua simpul bersifat konsisten dan tidak ada situasi saat metadata berisi titik akhir untuk simpul yang akan dihapus sementara simpul tersebut tidak tersedia. Selama waktu penghapusannya, simpul tidak dilaporkan dalam metadata dan aplikasi Anda hanya akan berinteraksi dengan simpul n-1 yang tersisa, seolah-olah simpul tersebut tidak ada.

### Mengganti simpul
<a name="AutoDiscovery.HowAutoDiscoveryWorks.OtherOps.ReplaceNode"></a>

Jika sebuah node gagal ElastiCache , hapus node itu dan putar penggantinya. Proses penggantian membutuhkan waktu beberapa menit. Selama waktu itu, metadata di semua simpul masih menunjukkan titik akhir untuk simpul yang gagal, tetapi setiap percobaan untuk berinteraksi dengan simpul tersebut akan gagal. Oleh karena itu, logika Anda harus selalu menyertakan logika percobaan ulang.

# Menggunakan Penemuan Otomatis
<a name="AutoDiscovery.Using"></a>

Untuk mulai menggunakan Auto Discovery with ElastiCache for Memcached, ikuti langkah-langkah berikut:
+ [Dapatkan Endpoint Konfigurasi](#AutoDiscovery.Using.ConfigEndpoint)
+ [Unduh Klien ElastiCache Cluster](#AutoDiscovery.Using.ClusterClient)
+ [Ubah Program Aplikasi Anda](#AutoDiscovery.Using.ModifyApp)

## Dapatkan Endpoint Konfigurasi
<a name="AutoDiscovery.Using.ConfigEndpoint"></a>

Untuk terhubung ke klaster, program klien harus mengetahui titik akhir konfigurasi klaster. Lihat topik [Menemukan Titik Akhir Cluster (Konsol) (Memcached)](Endpoints.md#Endpoints.Find.Memcached).

Anda juga dapat menggunakan perintah `aws elasticache describe-cache-clusters` dengan parameter `--show-cache-node-info`:

Apa pun metode yang Anda gunakan untuk menemukan titik akhir klaster, titik akhir konfigurasi akan selalu memiliki **.cfg** pada alamatnya.

**Example Menemukan titik akhir menggunakan for AWS CLI ElastiCache**  
Untuk Linux, macOS, atau Unix:  

```
aws elasticache describe-cache-clusters \
    --cache-cluster-id mycluster \
    --show-cache-node-info
```
Untuk Windows:  

```
aws elasticache describe-cache-clusters ^
    --cache-cluster-id mycluster ^
    --show-cache-node-info
```
Operasi ini menghasilkan output seperti yang berikut ini (format JSON):  

```
{
    "CacheClusters": [
        {
            "Engine": "memcached", 
            "CacheNodes": [
                {
                    "CacheNodeId": "0001", 
                    "Endpoint": {
                        "Port": 11211, 
                        "Address": "mycluster.fnjyzo.cfg.0001.use1.cache.amazonaws.com"
                    }, 
                    "CacheNodeStatus": "available", 
                    "ParameterGroupStatus": "in-sync", 
                    "CacheNodeCreateTime": "2016-10-12T21:39:28.001Z", 
                    "CustomerAvailabilityZone": "us-east-1e"
                }, 
                {
                    "CacheNodeId": "0002", 
                    "Endpoint": {
                        "Port": 11211, 
                        "Address": "mycluster.fnjyzo.cfg.0002.use1.cache.amazonaws.com"
                    }, 
                    "CacheNodeStatus": "available", 
                    "ParameterGroupStatus": "in-sync", 
                    "CacheNodeCreateTime": "2016-10-12T21:39:28.001Z", 
                    "CustomerAvailabilityZone": "us-east-1a"
                }
            ], 
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [], 
                "CacheParameterGroupName": "default.memcached1.4", 
                "ParameterApplyStatus": "in-sync"
            }, 
            "CacheClusterId": "mycluster", 
            "PreferredAvailabilityZone": "Multiple", 
            "ConfigurationEndpoint": {
                "Port": 11211, 
                "Address": "mycluster.fnjyzo.cfg.use1.cache.amazonaws.com"
            }, 
            "CacheSecurityGroups": [], 
            "CacheClusterCreateTime": "2016-10-12T21:39:28.001Z", 
            "AutoMinorVersionUpgrade": true, 
            "CacheClusterStatus": "available", 
            "NumCacheNodes": 2, 
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", 
            "CacheSubnetGroupName": "default", 
            "EngineVersion": "1.4.24", 
            "PendingModifiedValues": {}, 
            "PreferredMaintenanceWindow": "sat:06:00-sat:07:00", 
            "CacheNodeType": "cache.r3.large"
        }
    ]
}
```

## Unduh Klien ElastiCache Cluster
<a name="AutoDiscovery.Using.ClusterClient"></a>

Untuk memanfaatkan Penemuan Otomatis, program klien harus menggunakan *Klien Klaster ElastiCache*. ElastiCache Cluster Client tersedia untuk Java, PHP, dan .NET dan berisi semua logika yang diperlukan untuk menemukan dan menghubungkan ke semua node cache Anda.

**Untuk mengunduh Klien ElastiCache Cluster**

1. Masuk ke Konsol AWS Manajemen dan buka ElastiCache konsol di [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari ElastiCache konsol, pilih **ElastiCache Cluster Client** lalu pilih **Download**.

Kode sumber untuk Klien ElastiCache Cluster untuk Java tersedia di [https://github.com/amazonwebservices/aws-elasticache-cluster-client- memcached-for-java](https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java). Pustaka ini didasarkan pada klien Spymemcached yang populer. Klien ElastiCache Cluster dirilis di bawah Lisensi Perangkat Lunak [https://aws.amazon.com.rproxy.govskope.caAmazon/asl](https://aws.amazon.com/asl). Anda bebas mengubah kode sumber sesuai kebutuhan Anda. Anda bahkan dapat memasukkan kode ke pustaka Memcached sumber terbuka lainnya, atau ke kode klien Anda sendiri.

**catatan**  
Untuk menggunakan ElastiCache Cluster Client untuk PHP, pertama-tama Anda harus menginstalnya di EC2 instans Amazon Anda. Untuk informasi selengkapnya, lihat [Menginstal klien ElastiCache cluster untuk PHP](Appendix.PHPAutoDiscoverySetup.md).  
Untuk klien yang didukung TLS, unduh biner dengan PHP versi 7.4 atau lebih tinggi.  
Untuk menggunakan ElastiCache Cluster Client untuk.NET, pertama-tama Anda harus menginstalnya di EC2 instans Amazon Anda. Untuk informasi selengkapnya, lihat [Menginstal klien ElastiCache cluster untuk.NET](Appendix.DotNETAutoDiscoverySetup.md).

## Ubah Program Aplikasi Anda
<a name="AutoDiscovery.Using.ModifyApp"></a>

Perubahan program aplikasi Anda sehingga menggunakan Penemuan Otomatis. Bagian berikut menunjukkan cara menggunakan ElastiCache Cluster Client untuk Java, PHP, dan .NET. 

**penting**  
Saat menentukan titik akhir konfigurasi klaster, pastikan bahwa titik akhir memiliki ".cfg" di alamatnya, seperti ditunjukkan di sini. Jangan menggunakan CNAME atau titik akhir tanpa ".cfg" dalamnya.   

```
"mycluster.fnjyzo.cfg.use1.cache.amazonaws.com";
```
 Kegagalan untuk secara eksplisit menentukan titik akhir konfigurasi klaster akan mengakibatkan konfigurasi yang dibuat ke simpul tertentu.

# Menggunakan ElastiCache Cluster Client untuk Java
<a name="AutoDiscovery.Using.ModifyApp.Java"></a>

Program di bawah ini menunjukkan cara menggunakan ElastiCache Cluster Client untuk terhubung ke endpoint konfigurasi cluster dan menambahkan item data ke cache. Dengan Penemuan Otomatis, program ini terhubung ke semua simpul dalam klaster tanpa intervensi lebih lanjut.

```
package com.amazon.elasticache;

import java.io.IOException;
import java.net.InetSocketAddress;

// Import the &AWS;-provided library with Auto Discovery support 
import net.spy.memcached.MemcachedClient;  

public class AutoDiscoveryDemo {

    public static void main(String[] args) throws IOException {
            
        String configEndpoint = "mycluster.fnjyzo.cfg.use1.cache.amazonaws.com";
        Integer clusterPort = 11211;

        MemcachedClient client = new MemcachedClient(
                                 new InetSocketAddress(configEndpoint, 
                                                       clusterPort));       
        // The client will connect to the other cache nodes automatically.

        // Store a data item for an hour.  
        // The client will decide which cache host will store this item. 
        client.set("theKey", 3600, "This is the data value");
    }
}
```

# Menggunakan ElastiCache Cluster Client untuk PHP
<a name="AutoDiscovery.Using.ModifyApp.PHP"></a>

Program di bawah ini menunjukkan cara menggunakan ElastiCache Cluster Client untuk terhubung ke endpoint konfigurasi cluster dan menambahkan item data ke cache. Dengan Penemuan Otomatis, program ini akan terhubung ke semua simpul di klaster tanpa intervensi lebih lanjut.

Untuk menggunakan ElastiCache Cluster Client untuk PHP, pertama-tama Anda harus menginstalnya di EC2 instance Amazon Anda. Untuk informasi selengkapnya, lihat [Menginstal klien ElastiCache cluster untuk PHP](Appendix.PHPAutoDiscoverySetup.md)

```
<?php
	
 /**
  * Sample PHP code to show how to integrate with the Amazon ElastiCache
  * Auto Discovery feature.
  */

  /* Configuration endpoint to use to initialize memcached client. 
   * This is only an example. 	*/
  $server_endpoint = "mycluster.fnjyzo.cfg.use1.cache.amazonaws.com";
  
  /* Port for connecting to the ElastiCache cluster. 
   * This is only an example 	*/
  $server_port = 11211;

 /**
  * The following will initialize a Memcached client to utilize the Auto Discovery feature.
  * 
  * By configuring the client with the Dynamic client mode with single endpoint, the
  * client will periodically use the configuration endpoint to retrieve the current cache
  * cluster configuration. This allows scaling the cluster up or down in number of nodes
  * without requiring any changes to the PHP application. 
  *
  * By default the Memcached instances are destroyed at the end of the request. 
  * To create an instance that persists between requests, 
  *    use persistent_id to specify a unique ID for the instance. 
  * All instances created with the same persistent_id will share the same connection. 
  * See [http://php.net/manual/en/memcached.construct.php](http://php.net/manual/en/memcached.construct.php) for more information.
  */
  $dynamic_client = new Memcached('persistent-id');
  $dynamic_client->setOption(Memcached::OPT_CLIENT_MODE, Memcached::DYNAMIC_CLIENT_MODE);
  $dynamic_client->addServer($server_endpoint, $server_port);
  
  /**
  * Store the data for 60 seconds in the cluster. 
  * The client will decide which cache host will store this item.
  */  
  $dynamic_client->set('key', 'value', 60);  


 /**
  * Configuring the client with Static client mode disables the usage of Auto Discovery
  * and the client operates as it did before the introduction of Auto Discovery. 
  * The user can then add a list of server endpoints.
  */
  $static_client = new Memcached('persistent-id');
  $static_client->setOption(Memcached::OPT_CLIENT_MODE, Memcached::STATIC_CLIENT_MODE);
  $static_client->addServer($server_endpoint, $server_port);

 /**
  * Store the data without expiration. 
  * The client will decide which cache host will store this item.
  */  
  $static_client->set('key', 'value');  
  ?>
```

Untuk contoh tentang cara menggunakan Klien ElastiCache Cluster dengan TLS diaktifkan, lihat [Menggunakan enkripsi transit dengan PHP dan Memcached](in-transit-encryption.md#in-transit-encryption-connect-php-mc).

# Menggunakan ElastiCache Cluster Client untuk.NET
<a name="AutoDiscovery.Using.ModifyApp.DotNET"></a>

**catatan**  
Klien klaster ElastiCache .NET telah tidak digunakan lagi per Mei 2022.

Klien.NET untuk ElastiCache adalah open source di [https://github.com/awslabs/elasticache-cluster-config-net](https://github.com/awslabs/elasticache-cluster-config-net).

 Aplikasi .NET biasanya mendapatkan konfigurasi dari file config yang dimilikinya. Berikut ini adalah contoh file config aplikasi.

```
<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <configSections>
        <section 
            name="clusterclient" 
            type="Amazon.ElastiCacheCluster.ClusterConfigSettings, Amazon.ElastiCacheCluster" />
    </configSections>

    <clusterclient>
        <!-- the hostname and port values are from step 1 above -->
        <endpoint hostname="mycluster.fnjyzo.cfg.use1.cache.amazonaws.com" port="11211" />
    </clusterclient>
</configuration>
```

Program C\$1 di bawah ini menunjukkan cara menggunakan Klien ElastiCache Cluster untuk terhubung ke titik akhir konfigurasi cluster dan menambahkan item data ke cache. Dengan Penemuan Otomatis, program ini akan terhubung ke semua simpul di klaster tanpa intervensi lebih lanjut.

```
// *****************
// Sample C# code to show how to integrate with the Amazon ElastiCcache Auto Discovery feature.

using System;

using Amazon.ElastiCacheCluster;

using Enyim.Caching;
using Enyim.Caching.Memcached;

public class DotNetAutoDiscoveryDemo  {

    public static void Main(String[] args)  {
    
        // instantiate a new client.
        ElastiCacheClusterConfig config = new ElastiCacheClusterConfig();
        MemcachedClient memClient = new MemcachedClient(config);
        
        // Store the data for 3600 seconds (1hour) in the cluster. 
        // The client will decide which cache host will store this item.
        memClient.Store(StoreMode.Set, 3600, "This is the data value.");
        
    }  // end Main
    
}  // end class DotNetAutoDiscoverDemo
```

# Menghubungkan ke Memcached Cache Node Secara Manual
<a name="AutoDiscovery.Manual"></a>

Jika program klien Anda tidak menggunakan Auto Discovery, program ini dapat terhubung secara manual ke masing-masing node cache Memcached. Ini adalah perilaku default untuk klien Memcached.

Anda dapat memperoleh daftar nama host dan nomor port simpul cache dari [Konsol Manajemen AWS](https://aws.amazon.com/console/). Anda juga dapat menggunakan AWS CLI`aws elasticache describe-cache-clusters` perintah dengan `--show-cache-node-info` parameter.

**Example**  
Cuplikan kode Java berikut menunjukkan cara menghubungkan ke semua node dalam cluster empat simpul:  

```
...

ArrayList<String> cacheNodes = new ArrayList<String>(
	Arrays.asList(
	    "mycachecluster.fnjyzo.0001.use1.cache.amazonaws.com:11211",
	    "mycachecluster.fnjyzo.0002.use1.cache.amazonaws.com:11211",
	    "mycachecluster.fnjyzo.0003.use1.cache.amazonaws.com:11211",
	    "mycachecluster.fnjyzo.0004.use1.cache.amazonaws.com:11211"));
	      
MemcachedClient cache = new MemcachedClient(AddrUtil.getAddresses(cacheNodes));

...
```

**penting**  
Jika Anda meningkatkan atau memperkecil klaster Anda dengan menambahkan atau menghapus node, Anda perlu memperbarui daftar node dalam kode klien.

# Menambahkan Penemuan Otomatis ke pustaka klien Memcached Anda
<a name="AutoDiscovery.AddingToYourClientLibrary"></a>

Informasi konfigurasi untuk Auto Discovery disimpan secara berlebihan di setiap node cluster Memcached. Aplikasi klien dapat mengueri simpul cache apa pun dan memperoleh informasi konfigurasi untuk semua simpul di klaster tersebut.

Cara sebuah aplikasi melakukannya akan tergantung pada versi mesin cache:
+ Jika versi mesin cache adalah **1.4.14 atau lebih tinggi**, gunakan perintah `config`.
+ Jika versi mesin cache **lebih rendah dari 1.4.14**, gunakan perintah `get AmazonElastiCache:cluster`.

Output dari kedua perintah ini identik, dan dijelaskan pada bagian [Format Output](#AutoDiscovery.AddingToYourClientLibrary.OutputFormat) di bawah ini.

## Cache engine versi 1.4.14 atau lebih tinggi
<a name="AutoDiscovery.AddingToYourClientLibrary.1-4-14-plus"></a>

Untuk versi mesin cache 1.4.14 atau lebih tinggi, gunakan perintah `config`. Perintah ini telah ditambahkan ke ASCII Memcached dan protokol biner oleh ElastiCache, dan diimplementasikan di Cluster Client. ElastiCache Jika Anda ingin menggunakan Penemuan Otomatis dengan pustaka klien lain, maka pustaka itu akan perlu diperluas untuk mendukung perintah `config`.

**catatan**  
Dokumentasi berikut berkaitan dengan protokol ASCII; namun, perintah `config` mendukung baik ASCII maupun biner. Jika Anda ingin menambahkan dukungan Auto Discovery menggunakan protokol biner, lihat [kode sumber untuk Klien ElastiCache Cluster](https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java/tree/master/src/main/java/net/spy/memcached/protocol/binary).

**Sintaksis**

`config [sub-command] [key]`

### Opsi
<a name="AutoDiscovery.AddingToYourClientLibrary.1-4-14-plus.Options"></a>


| Nama | Deskripsi | Wajib | 
| --- | --- | --- | 
| sub-command |  Sub-perintah yang digunakan untuk berinteraksi dengan simpul cache. Untuk Penemuan Otomatis, sub-perintah ini adalah `get`.  | Ya | 
| key |  Kunci yang digunakan untuk menyimpan konfigurasi klaster. Untuk Penemuan Otomatis, kunci ini disebut `cluster`.  | Ya | 

Untuk mendapatkan informasi konfigurasi klaster, gunakan perintah berikut: 

```
config get cluster
```

## Cache engine versi 1.4.14 atau lebih rendah
<a name="AutoDiscovery.AddingToYourClientLibrary.pre-1-4-14"></a>

Untuk mendapatkan informasi konfigurasi klaster, gunakan perintah berikut: 

```
get AmazonElastiCache:cluster
```

**catatan**  
Jangan mengutak-atik tombol “: clusterAmazonElastiCache”, karena di sinilah informasi konfigurasi cluster berada. Jika Anda menimpa kunci ini, maka klien mungkin salah dikonfigurasi untuk jangka waktu singkat (tidak lebih dari 15 detik) sebelum memperbarui informasi konfigurasi ElastiCache secara otomatis dan benar.

## Format Output
<a name="AutoDiscovery.AddingToYourClientLibrary.OutputFormat"></a>

Tergantung pada Anda menggunakan `config get cluster` atau `get AmazonElastiCache:cluster`, balasannya terdiri dari dua baris:
+ Nomor versi informasi konfigurasi. Setiap kali node ditambahkan atau dihapus dari cluster, nomor versi bertambah satu. 
+ Daftar simpul cache. Setiap simpul dalam daftar dinyatakan dengan grup *hostname\$1ip-address\$1port*, dan setiap simpul dibatasi dengan spasi. 

Karakter carriage return dan linefeed (CR\$1LF) muncul di akhir setiap baris. Baris data mengandung karakter linefeed (LF) di bagian akhir, tempat CR \$1 LF ditambahkan. Baris versi konfigurasi diakhiri dengan LF tanpa CR. 

Sebuah cluster yang berisi tiga node akan direpresentasikan sebagai berikut:

```
configversion\n
hostname|ip-address|port hostname|ip-address|port hostname|ip-address|port\n\r\n
```

Setiap simpul ditampilkan dengan CNAME dan alamat IP privat. CNAME akan selalu ada; jika alamat IP privat tidak tersedia, maka tidak akan ditampilkan; namun, karakter pipa "`|`" akan tetap dicetak.

**Example**  
Berikut adalah contoh payload yang ditampilkan ketika Anda membuat kueri informasi konfigurasi:  

```
CONFIG cluster 0 136\r\n
12\n
myCluster.pc4ldq.0001.use1.cache.amazonaws.com|10.82.235.120|11211 myCluster.pc4ldq.0002.use1.cache.amazonaws.com|10.80.249.27|11211\n\r\n 
END\r\n
```

**catatan**  
Baris kedua menunjukkan bahwa informasi konfigurasi telah diubah dua belas kali sampai saat ini.
Pada baris ketiga, daftar simpul ditampilkan dalam urutan abjad berdasarkan nama host. Pengurutan ini mungkin berbeda dengan yang Anda gunakan saat ini pada aplikasi klien Anda.

# ElastiCache klien dengan penemuan otomatis
<a name="Clients"></a>

Program klien cluster dapat secara otomatis mengidentifikasi dan terhubung ke semua node cluster yang menjalankan mesin Memcached.

Bagian ini membahas menginstal dan mengkonfigurasi klien ElastiCache PHP dan .NET untuk digunakan dengan auto discovery.

**Topics**
+ [

# Menginstal & mengompilasi klien klaster
](Appendix.InstallingClients.md)
+ [

# Mengkonfigurasi klien ElastiCache
](ClientConfig.md)

# Menginstal & mengompilasi klien klaster
<a name="Appendix.InstallingClients"></a>

Bagian ini mencakup penginstalan, konfigurasi, dan kompilasi klien cluster penemuan otomatis PHP dan .NET Amazon ElastiCache auto. 

**Topics**
+ [

# Menginstal klien ElastiCache cluster untuk.NET
](Appendix.DotNETAutoDiscoverySetup.md)
+ [

# Menginstal klien ElastiCache cluster untuk PHP
](Appendix.PHPAutoDiscoverySetup.md)
+ [

# Mengompilasi kode sumber untuk klien ElastiCache cluster untuk PHP
](Appendix.PHPAutoDiscoveryCompile.md)

# Menginstal klien ElastiCache cluster untuk.NET
<a name="Appendix.DotNETAutoDiscoverySetup"></a>

Anda dapat menemukan kode ElastiCache Klien.NET Cluster sebagai open source di [https://github.com/awslabs/elasticache-cluster-config-net](https://github.com/awslabs/elasticache-cluster-config-net).

Bagian ini menjelaskan cara menginstal, memperbarui, dan menghapus komponen.NET untuk Klien ElastiCache Cluster di EC2 instans Amazon. Untuk informasi lain mengenai penemuan otomatis, lihat [Secara otomatis mengidentifikasi node di cluster Anda (Memcached)](AutoDiscovery.md). Untuk contoh kode .NET untuk menggunakan klien tersebut, lihat [Menggunakan ElastiCache Cluster Client untuk.NET](AutoDiscovery.Using.ModifyApp.DotNET.md).

**Topics**
+ [

## Menginstal .NET
](#Appendix.DotNETAutoDiscoverySetup.DotNET)
+ [

## Unduh ElastiCache klien.NET cluster untuk ElastiCache
](#Appendix.DotNETAutoDiscoverySetup.Downloading)
+ [

## Instal AWS rakitan dengan NuGet
](#Appendix.DotNETAutoDiscoverySetup.Installing)

## Menginstal .NET
<a name="Appendix.DotNETAutoDiscoverySetup.DotNET"></a>

Anda harus memiliki .NET 3.5 atau yang lebih baru diinstal untuk menggunakan AWS .NET SDK untuk ElastiCache. Jika Anda tidak memiliki .NET 3.5 atau yang lebih baru, Anda dapat mengunduh dan menginstal versi terbaru dari [http://www.microsoft.com/net](http://www.microsoft.com/net).

## Unduh ElastiCache klien.NET cluster untuk ElastiCache
<a name="Appendix.DotNETAutoDiscoverySetup.Downloading"></a>

**Untuk mengunduh klien klaster ElastiCache .NET**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Pada panel navigasi, klik **Klien ElastiCache Cluster**.

1. **Dalam daftar **Download ElastiCache Memcached Cluster Client**, pilih **.NET**, dan kemudian klik Download.**

## Instal AWS rakitan dengan NuGet
<a name="Appendix.DotNETAutoDiscoverySetup.Installing"></a>

NuGet adalah sistem manajemen paket untuk platform.NET. NuGet mengetahui dependensi perakitan dan menginstal semua file yang diperlukan secara otomatis. NuGet rakitan terinstal disimpan dengan solusi Anda, bukan di lokasi pusat seperti`Program Files`, sehingga Anda dapat menginstal versi khusus untuk aplikasi tanpa membuat masalah kompatibilitas.

### Instalasi NuGet
<a name="Appendix.DotNETAutoDiscoverySetup.Installing.NuGet"></a>

NuGet [dapat diinstal dari Galeri Instalasi di MSDN; lihat https://visualstudiogallery.msdn.microsoft.com /27077b70-9dad-4c64-adcf-c7cf6bc9970c.](https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c) Jika Anda menggunakan Visual Studio 2010 atau yang lebih baru, NuGet secara otomatis diinstal.

Anda dapat menggunakan NuGet dari **Solution Explorer atau Package** **Manager Console**.

### Menggunakan NuGet dari Solution Explorer
<a name="Appendix.DotNETAutoDiscoverySetup.NuGet.SolutionExplorer"></a>

**Untuk menggunakan NuGet dari Solution Explorer di Visual Studio 2010**

1. Dari menu **Tools**, pilih **Library Package Manager**.

1. Klik **Package Manager Console**.

**Untuk menggunakan NuGet dari Solution Explorer di Visual Studio 2012 atau Visual Studio 2013**

1. Dari menu **Tools**, pilih **NuGet Package Manager**.

1. Klik **Package Manager Console**.

Dari baris perintah, Anda bisa menginstal kompilasi menggunakan `Install-Package`, seperti yang ditunjukkan berikut ini.

```
Install-Package Amazon.ElastiCacheCluster
```

[Untuk melihat halaman untuk setiap paket yang tersedia NuGet, seperti rakitan AWS SDK dan AWS.Extensions, lihat situs web di NuGet http://www.nuget.org.](http://www.nuget.org) Halaman untuk setiap paket menyertakan contoh baris perintah untuk menginstal paket menggunakan konsol dan daftar versi paket sebelumnya yang tersedia melaluiNuGet.

Untuk informasi selengkapnya tentang perintah **Package Manager Console**, lihat [http://nuget.codeplex.com/wikipage?title=Package%20Manager%20Console%20Command%20Reference%20%28v1.3%29](http://nuget.codeplex.com/wikipage?title=Package%20Manager%20Console%20Command%20Reference%20%28v1.3%29).

# Menginstal klien ElastiCache cluster untuk PHP
<a name="Appendix.PHPAutoDiscoverySetup"></a>

Bagian ini menjelaskan cara menginstal, memperbarui, dan menghapus komponen PHP untuk Klien ElastiCache Cluster di EC2 instance Amazon. Untuk informasi selengkapnya tentang Penemuan Otomatis, lihat [Secara otomatis mengidentifikasi node di cluster Anda (Memcached)](AutoDiscovery.md). Untuk contoh kode PHP untuk menggunakan klien, lihat [Menggunakan ElastiCache Cluster Client untuk PHP](AutoDiscovery.Using.ModifyApp.PHP.md).

**Topics**
+ [

# Mengunduh paket penginstalan
](Appendix.PHPAutoDiscoverySetup.Downloading.md)
+ [

## Bagi pengguna yang sudah memiliki ekstensi *php-memcached* terinstal
](#Appendix.PHPAutoDiscoverySetup.InstallingExisting)
+ [

# Langkah penginstalan untuk pengguna baru
](Appendix.PHPAutoDiscoverySetup.Installing.md)
+ [

# Menghapus klien klaster PHP
](Appendix.PHPAutoDiscoverySetup.Removing.md)

# Mengunduh paket penginstalan
<a name="Appendix.PHPAutoDiscoverySetup.Downloading"></a>

Untuk memastikan bahwa Anda menggunakan versi ElastiCache Cluster Client yang benar untuk PHP, Anda perlu mengetahui versi PHP apa yang diinstal pada EC2 instans Amazon Anda. Anda juga perlu mengetahui apakah EC2 instans Amazon Anda menjalankan Linux versi 64-bit atau 32-bit.

**Untuk menentukan versi PHP yang diinstal pada EC2 instans Amazon Anda**
+ Pada jendela perintah, jalankan perintah berikut:

  ```
  php -v
  ```

  Versi PHP akan ditampilkan pada output, seperti pada contoh ini:

  ```
  PHP 5.4.10 (cli) (built: Jan 11 2013 14:48:57) 
  Copyright (c) 1997-2012 The PHP Group
  Zend Engine v2.4.0, Copyright (c) 1998-2012 Zend Technologies
  ```
**catatan**  
Jika versi PHP dan Memcached Anda tidak kompatibel, Anda akan mendapatkan pesan kesalahan seperti berikut:  

  ```
  PHP Warning: PHP Startup: memcached: Unable to initialize module
  Module compiled with module API=20100525
  PHP compiled with module API=20131226
  These options need to match
  in Unknown on line 0
  ```
Jika ini terjadi, Anda perlu mengompilasi modul dari kode sumber. Untuk informasi selengkapnya, lihat [Mengompilasi kode sumber untuk klien ElastiCache cluster untuk PHP](Appendix.PHPAutoDiscoveryCompile.md).

**Untuk menentukan arsitektur Amazon EC2 AMI Anda (64-bit atau 32-bit)**

1. Masuk ke Konsol Manajemen AWS dan buka EC2 konsol Amazon di [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Dalam daftar **Instans**, klik EC2 instans Amazon Anda.

1. Pada tab **Deskripsi**, cari bidang **AMI:**. Instans 64-bit seharusnya memiliki `x86_64` sebagai bagian dari deskripsinya; untuk instans 32-bit, cari `i386` atau `i686` pada bidang ini.

Anda sekarang siap untuk mengunduh ElastiCache Cluster Client.

**Untuk mengunduh klien ElastiCache cluster untuk PHP**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari ElastiCache konsol, pilih **ElastiCache Cluster Client**.

1. Dari daftar **Download ElastiCache Memcached Cluster Client**, pilih ElastiCache Cluster Client yang cocok dengan versi PHP dan arsitektur AMI Anda, lalu pilih tombol **Download**.

## Bagi pengguna yang sudah memiliki ekstensi *php-memcached* terinstal
<a name="Appendix.PHPAutoDiscoverySetup.InstallingExisting"></a>

**Untuk memperbarui instalan `php-memcached`**

1. Hapus instalasi sebelumnya dari ekstensi Memcached untuk PHP seperti yang dijelaskan pada topik [Menghapus klien klaster PHP](Appendix.PHPAutoDiscoverySetup.Removing.md).

1. Instal ElastiCache `php-memcached` ekstensi baru seperti yang dijelaskan sebelumnya di[Langkah penginstalan untuk pengguna baru](Appendix.PHPAutoDiscoverySetup.Installing.md). 

# Langkah penginstalan untuk pengguna baru
<a name="Appendix.PHPAutoDiscoverySetup.Installing"></a>

**Topics**
+ [

## Menginstal PHP 7.x untuk pengguna baru
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP7x)
+ [

## Menginstal PHP 5.x untuk pengguna baru
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP5x)

## Menginstal PHP 7.x untuk pengguna baru
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP7x"></a>

**Topics**
+ [

### Untuk menginstal PHP 7 pada server Ubuntu 14.04 LTS AMI (64-bit dan 32-bit)
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP7x.Ubuntu)
+ [

### Untuk menginstal PHP 7 pada AMI Amazon Linux 201609
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP7x.AmznLinux)
+ [

### Untuk menginstal PHP 7 pada AMI SUSE Linux
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP7x.SuseLinux)

### Untuk menginstal PHP 7 pada server Ubuntu 14.04 LTS AMI (64-bit dan 32-bit)
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP7x.Ubuntu"></a>

1. Luncurkan instans baru dari AMI.

1. Jalankan perintah berikut:

   ```
   sudo apt-get update
   sudo apt-get install gcc g++
   ```

1. Instal PHP.7.

   ```
   sudo yum install php70
   ```

1. Unduh Klien ElastiCache Cluster Amazon.

   ```
   wget https://elasticache-downloads.s3.amazonaws.com/ClusterClient/PHP-7.0/latest-64bit
   ```

1. Ekstrak file `latest-64bit`.

   ```
   tar -zxvf latest-64bit
   ```

1. Dengan izin root, salin file artefak `amazon-elasticache-cluster-client.so` yang diekstrak ke `/usr/lib/php/20151012`.

   ```
   sudo mv artifact/amazon-elasticache-cluster-client.so /usr/lib/php/20151012
   ```

1. Sisipkan baris `extension=amazon-elasticache-cluster-client.so` ke file `/etc/php/7.0/cli/php.ini`.

   ```
   echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php/7.0/cli/php.ini
   ```

1. Mulai atau mulai ulang server Apache Anda.

   ```
   sudo /etc/init.d/httpd start
   ```

 

### Untuk menginstal PHP 7 pada AMI Amazon Linux 201609
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP7x.AmznLinux"></a>

1. Luncurkan instans baru dari AMI tersebut.

1. Jalankan perintah berikut:

   ```
   sudo yum install gcc-c++
   ```

1. Instal PHP.7.

   ```
   sudo yum install php70
   ```

1. Unduh Klien ElastiCache Cluster Amazon.

   ```
   wget https://elasticache-downloads.s3.amazonaws.com/ClusterClient/PHP-7.0/latest-64bit
   ```

1. Ekstrak file `latest-64bit`.

   ```
   tar -zxvf latest-64bit
   ```

1. Dengan izin root, salin file artefak `amazon-elasticache-cluster-client.so` yang diekstrak ke `/usr/lib64/php/7.0/modules/`.

   ```
   sudo mv artifact/amazon-elasticache-cluster-client.so /usr/lib64/php/7.0/modules/
   ```

1. Buat file `50-memcached.ini`.

   ```
   echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php-7.0.d/50-memcached.ini
   ```

1. Mulai atau mulai ulang server Apache Anda.

   ```
   sudo /etc/init.d/httpd start
   ```

 

### Untuk menginstal PHP 7 pada AMI SUSE Linux
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP7x.SuseLinux"></a>

1. Luncurkan instans baru dari AMI tersebut.

1. Jalankan perintah berikut:

   ```
   sudo zypper install gcc
   ```

1. Instal PHP.7.

   ```
   sudo yum install php70
   ```

1. Unduh Klien ElastiCache Cluster Amazon.

   ```
   wget https://elasticache-downloads.s3.amazonaws.com/ClusterClient/PHP-7.0/latest-64bit
   ```

1. Ekstrak file `latest-64bit`.

   ```
   tar -zxvf latest-64bit
   ```

1. Dengan izin root, salin file artefak `amazon-elasticache-cluster-client.so` yang diekstrak ke `/usr/lib64/php7/extensions/`.

   ```
   sudo mv artifact/amazon-elasticache-cluster-client.so /usr/lib64/php7/extensions/
   ```

1. Sisipkan baris `extension=amazon-elasticache-cluster-client.so` ke file `/etc/php7/cli/php.ini`.

   ```
   echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php7/cli/php.ini
   ```

1. Mulai atau mulai ulang server Apache Anda.

   ```
   sudo /etc/init.d/httpd start
   ```

 

## Menginstal PHP 5.x untuk pengguna baru
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP5x"></a>

**Topics**
+ [

### Untuk menginstal PHP 5 pada AMI Amazon Linux 2014.03 (64-bit and 32-bit)
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.AmznLinux)
+ [

### Untuk menginstal PHP 5 pada AMI Red Hat Enterprise Linux 7.0 (64-bit dan 32-bit)
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.RHEL)
+ [

### Untuk menginstal PHP 5 pada AMI server Ubuntu 14.04 LTS (64-bit dan 32-bit)
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.Ubuntu)
+ [

### Untuk menginstal PHP 5 untuk AMI SUSE Linux enterprise server 11 (64-bit o 32-bit)
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.SuseLinux)
+ [

### Distribusi Linux lainnya
](#Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.Other)

### Untuk menginstal PHP 5 pada AMI Amazon Linux 2014.03 (64-bit and 32-bit)
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.AmznLinux"></a>

1. Luncurkan instans Amazon Linux (baik 64-bit maupun 32-bit) dan login ke dalamnya.

1. Instal dependensi PHP:

   ```
   sudo yum install gcc-c++ php php-pear
   ```

1. Unduh `php-memcached` paket yang benar untuk EC2 instans Amazon dan versi PHP Anda. Untuk informasi selengkapnya, lihat [Mengunduh paket penginstalan](Appendix.PHPAutoDiscoverySetup.Downloading.md).

1. Instal `php-memcached`. URI tersebut seharusnya adalah jalur pengunduhan untuk paket penginstalan:

   ```
   sudo pecl install <package download path>
   ```

   Berikut adalah contoh perintah penginstalan untuk PHP 5.4, 64-bit Linux. Dalam contoh ini, ganti *X.Y.Z* dengan nomor versi sebenarnya:

   ```
   sudo pecl install /home/AmazonElastiCacheClusterClient-X.Y.Z-PHP54-64bit.tgz
   ```
**catatan**  
Pastikan untuk menggunakan versi terbaru artefak penginstalan.

1. Dengan root/sudo izin, tambahkan file baru bernama `memcached.ini` dalam `/etc/php.d` direktori, dan masukkan “amazon-elasticache-cluster-clientextension=.so” dalam file: 

   ```
   echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php.d/memcached.ini
   ```

1. Mulai atau mulai ulang server Apache Anda.

   ```
   sudo /etc/init.d/httpd start
   ```

 

### Untuk menginstal PHP 5 pada AMI Red Hat Enterprise Linux 7.0 (64-bit dan 32-bit)
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.RHEL"></a>

1. Luncurkan instans Red Hat Enterprise Linux (baik 64-bit maupun 32-bit) dan login ke dalamnya.

1. Instal dependensi PHP:

   ```
   sudo yum install gcc-c++ php php-pear
   ```

1. Unduh `php-memcached` paket yang benar untuk EC2 instans Amazon dan versi PHP Anda. Untuk informasi selengkapnya, lihat [Mengunduh paket penginstalan](Appendix.PHPAutoDiscoverySetup.Downloading.md).

1. Instal `php-memcached`. URI tersebut seharusnya adalah jalur pengunduhan untuk paket penginstalan:

   ```
   sudo pecl install <package download path>
   ```

1. Dengan root/sudo izin, tambahkan file baru bernama `memcached.ini` dalam `/etc/php.d` direktori, dan masukkan `extension=amazon-elasticache-cluster-client.so` dalam file.

   ```
   echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php.d/memcached.ini
   ```

1. Mulai atau mulai ulang server Apache Anda.

   ```
   sudo /etc/init.d/httpd start
   ```

 

### Untuk menginstal PHP 5 pada AMI server Ubuntu 14.04 LTS (64-bit dan 32-bit)
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.Ubuntu"></a>

1. Luncurkan instans Ubuntu Linux (baik 64-bit maupun 32-bit) dan login ke dalamnya.

1. Instal dependensi PHP:

   ```
   sudo apt-get update 
   sudo apt-get install gcc g++ php5 php-pear
   ```

1. Unduh `php-memcached` paket yang benar untuk EC2 instans Amazon dan versi PHP Anda. Untuk informasi selengkapnya, lihat [Mengunduh paket penginstalan](Appendix.PHPAutoDiscoverySetup.Downloading.md). 

1. Instal `php-memcached`. URI tersebut seharusnya adalah jalur pengunduhan untuk paket penginstalan. 

   ```
   sudo pecl install <package download path>
   ```
**catatan**  
Langkah penginstalan ini menginstal artefak build `amazon-elasticache-cluster-client.so` ke dalam direktori `/usr/lib/php5/20121212*`. Verifikasikan jalur absolut artefak build karena Anda membutuhkannya pada langkah berikutnya. 

   Jika perintah sebelumnya tidak berfungsi, Anda perlu secara manual mengekstrak artefak klien PHP `amazon-elasticache-cluster-client.so` dari file `*.tgz` unduhan, dan menyalinnya ke direktori `/usr/lib/php5/20121212*`.

   ```
   tar -xvf <package download path>
   cp amazon-elasticache-cluster-client.so /usr/lib/php5/20121212/
   ```

1. Dengan root/sudo izin, tambahkan file baru bernama `memcached.ini` di `/etc/php5/cli/conf.d` direktori, dan masukkan “extension=<absolute path amazon-elasticache-cluster-client ke.so>” dalam file.

   ```
   echo "extension=<absolute path to amazon-elasticache-cluster-client.so>" | sudo tee --append /etc/php5/cli/conf.d/memcached.ini
   ```

1. Mulai atau mulai ulang server Apache Anda.

   ```
   sudo /etc/init.d/httpd start
   ```

 

### Untuk menginstal PHP 5 untuk AMI SUSE Linux enterprise server 11 (64-bit o 32-bit)
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.SuseLinux"></a>

1. Luncurkan instans SUSE Linux (baik 64-bit maupun 32-bit) dan login ke dalamnya. 

1. Instal dependensi PHP:

   ```
   sudo zypper install gcc php53-devel
   ```

1. Unduh `php-memcached` paket yang benar untuk EC2 instans Amazon dan versi PHP Anda. Untuk informasi selengkapnya, lihat [Mengunduh paket penginstalan](Appendix.PHPAutoDiscoverySetup.Downloading.md). 

1. Instal `php-memcached`. URI tersebut seharusnya adalah jalur pengunduhan untuk paket penginstalan. 

   ```
   sudo pecl install <package download path>
   ```

1. Dengan root/sudo izin, tambahkan file baru bernama `memcached.ini` dalam `/etc/php5/conf.d` direktori, dan masukkan **extension=`amazon-elasticache-cluster-client.so`** dalam file.

   ```
   echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php5/conf.d/memcached.ini
   ```

1. Mulai atau mulai ulang server Apache Anda.

   ```
   sudo /etc/init.d/httpd start
   ```

**catatan**  
Jika Langkah 5 tidak berfungsi untuk platform apa pun sebelumnya, verifikasi jalur penginstalan untuk `amazon-elasticache-cluster-client.so`. Juga, tentukan jalur lengkap biner dalam ekstensi. Selain itu, verifikasikan bahwa PHP yang digunakan adalah versi yang didukung. Kami mendukung versi 5.3 hingga 5.5. 

 

### Distribusi Linux lainnya
<a name="Appendix.PHPAutoDiscoverySetup.Installing.PHP5x.Other"></a>

Pada beberapa sistem, terutama Cent OS7 dan Red Hat Enterprise Linux (RHEL) 7.1, `libsasl2.so.3` telah diganti. `libsasl2.so.2` Pada sistem tersebut, ketika Anda memuat klien ElastiCache cluster, ia mencoba dan gagal menemukan dan memuat`libsasl2.so.2`. Untuk mengatasi masalah ini, buat tautan simbolis ke `libsasl2.so.3` sehingga ketika klien mencoba memuat libsasl2.so.2, sistem diarahkan ke `libsasl2.so.3`. Kode berikut membuat tautan simbolis ini.

```
cd /usr/lib64
sudo ln libsasl2.so.3 libsasl2.so.2
```

# Menghapus klien klaster PHP
<a name="Appendix.PHPAutoDiscoverySetup.Removing"></a>

**Topics**
+ [

## Menghapus versi sebelumnya dari PHP 7
](#Appendix.PHPAutoDiscoverySetup.Removing.PHP7x)
+ [

## Menghapus versi lama PHP 5
](#Appendix.PHPAutoDiscoverySetup.Removing.PHP5x)

## Menghapus versi sebelumnya dari PHP 7
<a name="Appendix.PHPAutoDiscoverySetup.Removing.PHP7x"></a>

**Untuk menghapus versi sebelumnya dari PHP 7**

1. Hapus file `amazon-elasticache-cluster-client.so` dari direktori pustaka PHP yang sesuai seperti yang ditunjukkan sebelumnya pada petunjuk instalasi. Lihat bagian untuk penginstalan Anda di [Bagi pengguna yang sudah memiliki ekstensi *php-memcached* terinstal](Appendix.PHPAutoDiscoverySetup.md#Appendix.PHPAutoDiscoverySetup.InstallingExisting).

1. Hapus baris `extension=amazon-elasticache-cluster-client.so` dari file `php.ini`.

1. Mulai atau mulai ulang server Apache Anda.

   ```
   sudo /etc/init.d/httpd start
   ```

## Menghapus versi lama PHP 5
<a name="Appendix.PHPAutoDiscoverySetup.Removing.PHP5x"></a>

**Untuk menghapus versi lama PHP 5**

1. Hapus ekstensi `php-memcached`:

   ```
   sudo pecl uninstall __uri/AmazonElastiCacheClusterClient
   ```

1.  Hapus file `memcached.ini` yang ditambahkan pada direktori yang sesuai seperti yang ditunjukkan pada langkah penginstalan sebelumnya. 

# Mengompilasi kode sumber untuk klien ElastiCache cluster untuk PHP
<a name="Appendix.PHPAutoDiscoveryCompile"></a>

Bagian ini mencakup cara mendapatkan dan mengkompilasi kode sumber untuk ElastiCache Cluster Client untuk PHP.

[Ada dua paket yang perlu Anda tarik GitHub dan kompilasi; [aws-elasticache-cluster-client-libmemcached](https://github.com/awslabs/aws-elasticache-cluster-client-libmemcached) dan -. aws-elasticache-cluster-client memcached-for-php](https://github.com/awslabs/aws-elasticache-cluster-client-memcached-for-php)

**Topics**
+ [

## Mengompilasi pustaka libmemcached
](#Appendix.PHPAutoDiscoveryCompile.Libmemcached)
+ [

## Mengompilasi klien penemuan otomatis ElastiCache Memcached untuk PHP
](#Appendix.PHPAutoDiscoveryCompile.Client)

## Mengompilasi pustaka libmemcached
<a name="Appendix.PHPAutoDiscoveryCompile.Libmemcached"></a>

**Untuk mengkompilasi perpustakaan aws-elasticache-cluster-client -libmemcached**

1. Luncurkan EC2 instance Amazon.

1. Instal pustaka dependensi.
   + Pada AMI Amazon Linux 201509

     ```
     sudo yum install gcc gcc-c++ autoconf libevent-devel
     ```
   + Pada AMI Ubuntu 14.04

     ```
     sudo apt-get update
     sudo apt-get install libevent-dev gcc g++ make autoconf libsasl2-dev
     ```

1. Tarik repositori dan kompilasikan kode.

   ```
   Download and install [ https://github.com/awslabs/aws-elasticache-cluster-client-libmemcached/archive/v1.0.18.tar.gz]( https://github.com/awslabs/aws-elasticache-cluster-client-libmemcached/archive/v1.0.18.tar.gz)
   ```

## Mengompilasi klien penemuan otomatis ElastiCache Memcached untuk PHP
<a name="Appendix.PHPAutoDiscoveryCompile.Client"></a>

Bagian berikut menjelaskan cara mengkompilasi ElastiCache Memcached Auto Discovery Client

**Topics**
+ [

### Mengompilasi klien ElastiCache Memcached untuk PHP 7
](#Appendix.PHPAudiscoveryCompile.Client.PHP7)
+ [

### Mengompilasi klien ElastiCache Memcached untuk PHP 5
](#Appendix.PHPAudiscoveryCompile.PHP5)

### Mengompilasi klien ElastiCache Memcached untuk PHP 7
<a name="Appendix.PHPAudiscoveryCompile.Client.PHP7"></a>

Jalankan kelompok perintah berikut di bawah direktori kode.

```
git clone https://github.com/awslabs/aws-elasticache-cluster-client-memcached-for-php.git
cd aws-elasticache-cluster-client-memcached-for-php 
git checkout php7
sudo yum install php70-devel
phpize
./configure --with-libmemcached-dir=<libmemcached-install-directory> --disable-memcached-sasl
make
make install
```

**catatan**  
Anda secara statis dapat menghubungkan pustaka libmemcached ke biner PHP sehingga dapat diporting di berbagai platform Linux. Untuk melakukan hal itu, jalankan dahulu perintah berikut `make`:  

```
sed -i "s#-lmemcached#<libmemcached-install-directory>/lib/libmemcached.a -lcrypt -lpthread -lm -lstdc++ -lsasl2#" Makefile 
```

### Mengompilasi klien ElastiCache Memcached untuk PHP 5
<a name="Appendix.PHPAudiscoveryCompile.PHP5"></a>

Kompilasikan `aws-elasticache-cluster-client-memcached-for-php` dengan menjalankan perintah berikut dalam folder `aws-elasticache-cluster-client-memcached-for-php/`.

```
git clone https://github.com/awslabs/aws-elasticache-cluster-client-memcached-for-php.git
cd aws-elasticache-cluster-client-memcached-for-php 
sudo yum install zlib-devel
phpize
./configure --with-libmemcached-dir=<libmemcached-install-directory>
make
make install
```

# Mengkonfigurasi klien ElastiCache
<a name="ClientConfig"></a>

 ElastiCache Cluster sesuai dengan protokol dengan Valkey, Memcached, dan Redis OSS. Kode, aplikasi, dan alat paling populer yang Anda gunakan saat ini dengan lingkungan yang ada akan bekerja dengan mulus dengan layanan ini.

Bagian ini membahas pertimbangan khusus untuk menyambung ke simpul cache di ElastiCache.

**Topics**
+ [

# Perintah terbatas
](ClientConfig.RestrictedCommands.md)
+ [

# Menemukan titik akhir dan nomor port simpul
](ClientConfig.FindingEndpointsAndPorts.md)
+ [

# Menghubungkan untuk menggunakan penemuan otomatis
](ClientConfig.AutoDiscovery.md)
+ [

# Menghubungkan ke node di cluster Valkey atau Redis OSS
](ClientConfig.ReplicationGroup.md)
+ [

# Nama DNS dan IP yang mendasari
](ClientConfig.DNS.md)

# Perintah terbatas
<a name="ClientConfig.RestrictedCommands"></a>

Untuk memberikan pengalaman layanan terkelola, ElastiCache batasi akses ke perintah khusus mesin cache tertentu yang memerlukan hak istimewa lanjutan. Untuk cluster yang menjalankan Redis OSS, perintah berikut tidak tersedia:
+ `bgrewriteaof`
+ `bgsave`
+ `config`
+ `debug`
+ `migrate`
+ `replicaof`
+ `save`
+ `slaveof`
+ `shutdown`
+ `sync`

# Menemukan titik akhir dan nomor port simpul
<a name="ClientConfig.FindingEndpointsAndPorts"></a>

Untuk terhubung ke simpul cache, aplikasi Anda perlu mengetahui titik akhir dan nomor port untuk simpul tersebut.

## Menemukan titik akhir dan nomor port simpul (Konsol)
<a name="ClientConfig.FindingEndpointsAndPorts.CON"></a>

 **Untuk menentukan titik akhir dan nomor port simpul** 

1. Masuk ke [konsol ElastiCache manajemen Amazon](https://aws.amazon.com/elasticache) dan pilih mesin yang berjalan di cluster Anda.

   Daftar klaster yang menjalankan mesin yang dipilih akan muncul.

1. Lanjutkan di bawah ini untuk mesin dan konfigurasi yang sedang Anda jalankan.

1. Pilih nama klaster yang diinginkan.

1. Temukan kolom **Port** dan **Titik akhir** untuk simpul yang diinginkan.

## Menemukan titik akhir dan nomor port simpul cache (AWS CLI)
<a name="ClientConfig.FindingEndpointsAndPorts.CLI"></a>

Untuk menentukan titik akhir dan nomor port simpul cache, gunakan perintah `describe-cache-clusters` dengan parameter `--show-cache-node-info`.

```
aws elasticache describe-cache-clusters --show-cache-node-info 
```

Nama DNS dan nomor port yang sepenuhnya memenuhi syarat terdapat di bagian Titik Akhir dari output.

## Menemukan titik akhir node cache dan nomor port (ElastiCache API)
<a name="ClientConfig.FindingEndpointsAndPorts.API"></a>

Untuk menentukan titik akhir dan nomor port simpul cache, gunakan tindakan `DescribeCacheClusters` dengan parameter `ShowCacheNodeInfo=true`.

**Example**  

```
 1. https://elasticache.us-west-2.amazonaws.com /
 2.     ?Action=DescribeCacheClusters
 3.     &ShowCacheNodeInfo=true
 4.     &SignatureVersion=4
 5.     &SignatureMethod=HmacSHA256
 6.     &Timestamp=20140421T220302Z
 7.     &Version=2014-09-30   
 8.     &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
 9.     &X-Amz-Credential=<credential>
10.     &X-Amz-Date=20140421T220302Z
11.     &X-Amz-Expires=20140421T220302Z
12.     &X-Amz-Signature=<signature>
13.     &X-Amz-SignedHeaders=Host
```

# Menghubungkan untuk menggunakan penemuan otomatis
<a name="ClientConfig.AutoDiscovery"></a>

Jika aplikasi Anda menggunakan Penemuan Otomatis, Anda hanya perlu mengetahui titik akhir konfigurasi untuk klaster, bukan titik akhir individual untuk setiap simpul cache. Untuk informasi selengkapnya, lihat [Secara otomatis mengidentifikasi node di cluster Anda (Memcached)](AutoDiscovery.md).

**catatan**  
Saat ini, Auto Discovery hanya tersedia untuk cluster yang menjalankan Memcached.

# Menghubungkan ke node di cluster Valkey atau Redis OSS
<a name="ClientConfig.ReplicationGroup"></a>

**catatan**  
Pada saat ini, cluster (API/CLI: grup replikasi) yang mendukung replikasi dan replika baca hanya didukung untuk cluster yang menjalankan Valkey atau Redis OSS.

Untuk cluster, ElastiCache menyediakan antarmuka konsol, CLI, dan API untuk mendapatkan informasi koneksi untuk masing-masing node.

Untuk aktivitas hanya baca, aplikasi juga dapat terhubung ke simpul apa pun di klaster. Namun, untuk aktivitas tulis, kami menyarankan agar aplikasi Anda terhubung ke titik akhir utama (Valkey atau Redis OSS (mode cluster dinonaktifkan)) atau titik akhir konfigurasi (Valkey atau Redis OSS (mode cluster diaktifkan)) untuk cluster alih-alih menghubungkan langsung ke node. Hal ini akan memastikan bahwa aplikasi Anda selalu dapat menemukan simpul yang benar, bahkan jika Anda memutuskan untuk mengonfigurasi ulang klaster Anda dengan mempromosikan replika baca menjadi peran primer.

## Menghubungkan ke klaster dalam grup replikasi (Konsol)
<a name="ClientConfig.ReplicationGroup.CON"></a>

**Untuk menentukan titik akhir dan nomor port**
+ Lihat topik [Menemukan Titik Akhir Cluster Valkey atau Redis OSS (Mode Cluster Dinonaktifkan) (Konsol)](Endpoints.md#Endpoints.Find.Redis).

## Menghubungkan ke klaster dalam grup replikasi AWS CLI
<a name="ClientConfig.ReplicationGroup.CLI"></a>

 **Untuk menentukan titik akhir dan nomor port simpul cache**

Gunakan perintah `describe-replication-groups` dengan nama grup replikasi Anda:

```
aws elasticache describe-replication-groups redis2x2
```

Perintah ini seharusnya menghasilkan output yang serupa dengan yang berikut:

```
{
    "ReplicationGroups": [
        {
            "Status": "available", 
            "Description": "2 shards, 2 nodes (1 + 1 replica)", 
            "NodeGroups": [
                {
                    "Status": "available", 
                    "Slots": "0-8191", 
                    "NodeGroupId": "0001", 
                    "NodeGroupMembers": [
                        {
                            "PreferredAvailabilityZone": "us-west-2c", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "redis2x2-0001-001"
                        }, 
                        {
                            "PreferredAvailabilityZone": "us-west-2a", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "redis2x2-0001-002"
                        }
                    ]
                }, 
                {
                    "Status": "available", 
                    "Slots": "8192-16383", 
                    "NodeGroupId": "0002", 
                    "NodeGroupMembers": [
                        {
                            "PreferredAvailabilityZone": "us-west-2b", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "redis2x2-0002-001"
                        }, 
                        {
                            "PreferredAvailabilityZone": "us-west-2a", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "redis2x2-0002-002"
                        }
                    ]
                }
            ], 
            "ConfigurationEndpoint": {
                "Port": 6379, 
                "Address": "redis2x2.9dcv5r.clustercfg.usw2.cache.amazonaws.com"
            }, 
            "ClusterEnabled": true, 
            "ReplicationGroupId": "redis2x2", 
            "SnapshotRetentionLimit": 1, 
            "AutomaticFailover": "enabled", 
            "SnapshotWindow": "13:00-14:00", 
            "MemberClusters": [
                "redis2x2-0001-001", 
                "redis2x2-0001-002", 
                "redis2x2-0002-001", 
                "redis2x2-0002-002"
            ], 
            "CacheNodeType": "cache.m3.medium", 
            "PendingModifiedValues": {}
        }
    ]
}
```

## Menghubungkan ke cluster dalam grup replikasi (API) ElastiCache
<a name="ClientConfig.ReplicationGroup.API"></a>

 **Untuk menentukan titik akhir dan nomor port simpul cache** 

Panggil `DescribeReplicationGroups` dengan parameter berikut:

`ReplicationGroupId` – nama grup replikasi.

**Example**  

```
 1. https://elasticache.us-west-2.amazonaws.com /
 2.     ?Action=DescribeCacheClusters
 3.     &ReplicationGroupId=repgroup01
 4.     &Version=2014-09-30   
 5.     &SignatureVersion=4
 6.     &SignatureMethod=HmacSHA256
 7.     &Timestamp=20140421T220302Z
 8.     &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
 9.     &X-Amz-Date=20140421T220302Z
10.     &X-Amz-SignedHeaders=Host
11.     &X-Amz-Expires=20140421T220302Z
12.     &X-Amz-Credential=<credential>
13.     &X-Amz-Signature=<signature>
```

# Nama DNS dan IP yang mendasari
<a name="ClientConfig.DNS"></a>

Klien memelihara daftar server yang berisi alamat dan port dari server yang menampung data cache. Saat menggunakan ElastiCache, DescribeCacheClusters API (atau utilitas baris describe-cache-clusters perintah) mengembalikan entri DNS dan nomor port yang sepenuhnya memenuhi syarat yang dapat digunakan untuk daftar server.

**penting**  
Aplikasi klien harus dikonfigurasi untuk sering meresolusi nama DNS simpul cache saat aplikasi ini mencoba terhubung ke titik akhir simpul cache.

ElastiCache memastikan bahwa nama DNS node cache tetap sama ketika node cache dipulihkan jika terjadi kegagalan.

Kebanyakan pustaka klien mendukung koneksi simpul cache persisten secara default. Sebaiknya menggunakan koneksi simpul cache persisten saat menggunakan ElastiCache. Caching DNS sisi klien dapat terjadi di beberapa tempat, termasuk pustaka klien, runtime bahasa, atau sistem operasi klien. Anda harus meninjau konfigurasi aplikasi Anda di setiap lapisan untuk memastikan bahwa Anda sering meresolusi alamat IP untuk simpul cache Anda.

# Tingkatan data di ElastiCache
<a name="data-tiering"></a>

ElastiCache untuk cluster Valkey atau Redis OSS yang terdiri dari grup replikasi dan menggunakan tipe node dari keluarga r6gd memiliki data mereka berjenjang antara memori dan penyimpanan SSD lokal (solid state drive). Tiering data menyediakan opsi harga-kinerja baru untuk beban kerja Valkey atau Redis OSS dengan memanfaatkan solid state drive (SSDs) berbiaya lebih rendah di setiap node cluster selain menyimpan data dalam memori. Hal ini sangat ideal untuk beban kerja yang mengakses hingga 20 persen dari keseluruhan set datanya secara rutin, dan untuk aplikasi yang dapat menoleransi latensi tambahan saat mengakses data di SSD.

Pada ElastiCache cluster dengan tiering data, ElastiCache memantau waktu akses terakhir dari setiap item yang disimpannya. Ketika memori yang tersedia (DRAM) sepenuhnya dikonsumsi, ElastiCache menggunakan algoritma yang paling tidak baru digunakan (LRU) untuk secara otomatis memindahkan item yang jarang diakses dari memori ke SSD. Ketika data pada SSD kemudian diakses, ElastiCache secara otomatis dan asinkron memindahkannya kembali ke memori sebelum memproses permintaan. Jika Anda memiliki beban kerja yang mengakses hanya subset dari datanya secara teratur, tingkatan data adalah cara optimal untuk menskalakan kapasitas Anda dengan hemat biaya.

Perhatikan bahwa saat menggunakan tingkatan data, kunci itu sendiri selalu tetap dalam memori, sedangkan LRU mengatur penempatan nilai pada memori vs disk. Secara umum, sebaiknya buat kunci Anda lebih kecil dari ukuran nilai Anda saat menggunakan tingkatan data.

Tingkatan data dirancang untuk memiliki dampak performa minimal pada beban kerja aplikasi. Misalnya, anggaplah ada nilai String 500-byte, Anda dapat mengalami 300 mikrodetik tambahan latensi rata-rata untuk permintaan terhadap data yang tersimpan di SSD dibandingkan dengan permintaan terhadap data dalam memori.

Dengan ukuran simpul tingkatan data terbesar (cache.r6gd.16xlarge), Anda dapat menyimpan hingga 1 petabyte dalam satu klaster 500 simpul (500 TB saat menggunakan 1 replika baca). Tiering data kompatibel dengan semua perintah Valkey atau Redis OSS dan struktur data yang didukung di. ElastiCache Anda tidak memerlukan perubahan sisi klien untuk menggunakan fitur ini. 

**Topics**
+ [

## Praktik terbaik
](#data-tiering-best-practices)
+ [

## Batasan
](#data-tiering-prerequisites)
+ [

## Harga
](#data-tiering-pricing)
+ [

## Pemantauan
](#data-tiering-monitoring)
+ [

## Menggunakan tingkatan data
](#data-tiering-enabling)
+ [

## Memulihkan data dari cadangan ke dalam klaster dengan tingkatan data diaktifkan
](#data-tiering-enabling-snapshots)

## Praktik terbaik
<a name="data-tiering-best-practices"></a>

Kami merekomendasikan praktik terbaik berikut:
+ Tingkatan data sangat ideal untuk beban kerja yang mengakses hingga 20 persen dari keseluruhan set datanya secara rutin, dan untuk aplikasi yang dapat menoleransi latensi tambahan saat mengakses data di SSD.
+ Saat menggunakan kapasitas SSD yang tersedia pada simpul bertingkatan data, kami menyarankan agar ukuran nilai lebih besar dari ukuran kunci. Ketika item dipindahkan antara DRAM dan SSD, kunci akan selalu tetap dalam memori dan hanya nilai yang dipindahkan ke tingkat SSD. 

## Batasan
<a name="data-tiering-prerequisites"></a>

Tingkatan data memiliki batasan berikut:
+ Anda hanya dapat menggunakan tingkatan data pada klaster yang merupakan bagian dari grup replikasi.
+ Jenis simpul yang Anda gunakan harus berasal dari keluarga r6gd, yang tersedia di wilayah berikut: `us-east-2`, `us-east-1`, `us-west-2`, `us-west-1`, `eu-west-1`, `eu-central-1`, `eu-north-1`, `eu-west-3`, `ap-northeast-1`, `ap-southeast-1`, `ap-southeast-2`, `ap-south-1`, `ca-central-1`, dan `sa-east-1`.
+ Anda harus menggunakan mesin yang Valkey 7.2 atau yang lebih baru, atau Redis OSS 6.2 atau yang lebih baru.
+ Anda tidak dapat memulihkan cadangan klaster r6gd ke klaster lain kecuali klaster lain tersebut menggunakan r6gd juga.
+ Anda tidak dapat mengekspor cadangan ke Amazon S3 untuk klaster tingkatan data.
+ Migrasi online tidak didukung untuk klaster yang berjalan pada jenis simpul r6gd.
+ Penskalaan tidak didukung dari klaster tingkatan data (misalnya, sebuah klaster yang menggunakan jenis simpul r6gd) ke klaster yang tidak menggunakan tingkatan data (misalnya, klaster yang menggunakan jenis simpul r6g). Untuk informasi selengkapnya, lihat [Penskalaan ElastiCache](Scaling.md).
+ Penskalaan otomatis didukung pada cluster menggunakan tiering data untuk Valkey versi 7.2 dan yang lebih baru, dan Redis OSS versi 7.0.7 dan yang lebih baru. Untuk informasi selengkapnya, lihat [Auto Scaling Valkey dan Redis OSS cluster](AutoScaling.md)
+ Tingkatan data hanya mendukung kebijakan maxmemory `volatile-lru`, `allkeys-lru`, `volatile-lfu`, `allkeys-lfu`, dan `noeviction`. 
+ Penyimpanan tanpa garpu didukung untuk Valkey versi 7.2 dan yang lebih baru, dan Redis OSS versi 7.0.7 dan yang lebih baru. Untuk informasi selengkapnya, lihat [Cara penerapan sinkronisasi dan pencadangan](Replication.Redis.Versions.md).
+ Item yang lebih besar dari 128 MiB tidak dipindahkan ke SSD.
+ Mulai dari Valley 8.1 dan yang lebih baru, item yang ukuran nilai kuncinya kurang dari 40 byte tidak akan dipindahkan ke SSD.

## Harga
<a name="data-tiering-pricing"></a>

Simpul R6gd memiliki kapasitas total 4,8x lebih banyak (memori \$1 SSD) dan dapat membantu Anda mencapai lebih dari 60 persen penghematan ketika berjalan pada pemanfaatan maksimum dibandingkan dengan simpul R6g (memori saja). Untuk informasi selengkapnya, lihat [harga ElastiCache ](https://aws.amazon.com/elasticache/pricing/).

## Pemantauan
<a name="data-tiering-monitoring"></a>

ElastiCache menawarkan metrik yang dirancang khusus untuk memantau cluster kinerja yang menggunakan tiering data. Untuk memantau rasio item dalam DRAM dibandingkan dengan SSD, Anda dapat menggunakan `CurrItems` metrik di [Metrik untuk Valkey dan](CacheMetrics.Redis.md) Redis OSS. Anda dapat menghitung persentase sebagai: *(CurrItems dengan Dimensi: Tingkat = Memori\$1 100)/(CurrItems tanpa filter dimensi)*. 

 Jika kebijakan penggusuran yang dikonfigurasi memungkinkan, maka ElastiCache akan mulai mengusir item ketika persentase item dalam memori berkurang di bawah 5 persen. Pada node yang dikonfigurasi dengan kebijakan noeviction, operasi tulis akan menerima kesalahan kehabisan memori. 

 Anda tetap disarankan untuk mempertimbangkan penskalaan untuk cluster yang Diaktifkan Mode Cluster atau penskalaan untuk cluster yang dinonaktifkan Mode Cluster ketika persentase item dalam memori berkurang di bawah 5 persen. Untuk informasi lebih lanjut tentang penskalaan, lihat[Penskalaan klaster Valkey atau Redis OSS (Mode Cluster Diaktifkan)](scaling-redis-cluster-mode-enabled.md). Untuk informasi lebih lanjut tentang metrik untuk klaster Valkey atau Redis OSS yang menggunakan tingkatan data, lihat. [Metrik untuk Valkey dan Redis OSS](CacheMetrics.Redis.md)

## Menggunakan tingkatan data
<a name="data-tiering-enabling"></a>

### Menggunakan data tiering menggunakan Konsol Manajemen AWS
<a name="data-tiering-enabling-console"></a>

Ketika membuat sebuah klaster sebagai bagian dari grup replikasi, Anda menggunakan tingkatan data dengan memilih jenis simpul dari keluarga r6gd, seperti *cache.r6gd.xlarge*. Memilih jenis simpul tersebut secara otomatis mengaktifkan tingkatan data. 

Untuk informasi tentang cara membuat klaster, lihat [Membuat cluster untuk Valkey atau Redis OSS](Clusters.Create.md).

### Mengaktifkan tiering data menggunakan AWS CLI
<a name="data-tiering-enabling-cli"></a>

Saat membuat grup replikasi menggunakan AWS CLI, Anda menggunakan tiering data dengan memilih tipe node dari keluarga r6gd, seperti *cache.r6gd.xlarge* dan menyetel parameternya. `--data-tiering-enabled` 

Anda tidak dapat membatalkan penggunaan tingkatan data ketika memilih jenis simpul dari keluarga r6gd. Jika Anda mengatur parameter `--no-data-tiering-enabled`, operasi akan gagal.

Untuk Linux, macOS, atau Unix:

```
aws elasticache create-replication-group \
   --replication-group-id redis-dt-cluster \
   --replication-group-description "Redis OSS cluster with data tiering" \
   --num-node-groups 1 \
   --replicas-per-node-group 1 \
   --cache-node-type cache.r6gd.xlarge \
   --engine redis \   
   --cache-subnet-group-name default \
   --automatic-failover-enabled \
   --data-tiering-enabled
```

Untuk Windows:

```
aws elasticache create-replication-group ^
   --replication-group-id redis-dt-cluster ^
   --replication-group-description "Redis OSS cluster with data tiering" ^
   --num-node-groups 1 ^
   --replicas-per-node-group 1 ^
   --cache-node-type cache.r6gd.xlarge ^
   --engine redis ^   
   --cache-subnet-group-name default ^
   --automatic-failover-enabled ^
   --data-tiering-enabled
```

Setelah menjalankan operasi ini, Anda akan melihat respons seperti yang berikut ini:

```
{
    "ReplicationGroup": {
        "ReplicationGroupId": "redis-dt-cluster",
        "Description": "Redis OSS cluster with data tiering",
        "Status": "creating",           
        "PendingModifiedValues": {},
        "MemberClusters": [
            "redis-dt-cluster"
        ],
        "AutomaticFailover": "enabled",
        "DataTiering": "enabled",
        "SnapshotRetentionLimit": 0,
        "SnapshotWindow": "06:00-07:00",
        "ClusterEnabled": false,
        "CacheNodeType": "cache.r6gd.xlarge",       
        "TransitEncryptionEnabled": false,
        "AtRestEncryptionEnabled": false
    }
}
```

## Memulihkan data dari cadangan ke dalam klaster dengan tingkatan data diaktifkan
<a name="data-tiering-enabling-snapshots"></a>

Anda dapat memulihkan cadangan ke klaster baru dengan tiering data yang diaktifkan menggunakan (Console), (AWS CLI) atau (ElastiCache API). Ketika Anda membuat sebuah klaster menggunakan jenis simpul dalam keluarga r6gd, tingkatan data diaktifkan. 

### Memulihkan data dari cadangan ke dalam klaster dengan tingkatan data diaktifkan (konsol)
<a name="data-tiering-enabling-snapshots-console"></a>

**Untuk memulihkan cadangan ke klaster baru dengan tingkatan data diaktifkan (konsol)**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari panel navigasi, pilih **Cadangan**.

1. Di daftar cadangan, pilih kotak di sebelah kiri nama cadangan yang ingin Anda pulihkan.

1. Pilih **Pulihkan**.

1. Lengkapi kotak dialog **Pulihkan Klaster**. Pastikan untuk melengkapi semua bidang **Wajib** dan semua bidang yang ingin Anda ubah dari default.

   1. **ID Klaster** – Wajib. Nama klaster baru.

   1. **Mode cluster diaktifkan (skala keluar)** - Pilih ini untuk cluster Valkey atau Redis OSS (mode cluster diaktifkan). 

   1. **Jenis Simpul** – Tentukan **cache.r6gd.xlarge** atau jenis simpul lainnya dari keluarga r6gd.

   1. **Jumlah Serpihan** – Memilih jumlah serpihan yang Anda inginkan di klaster baru (API/CLI: grup simpul).

   1. **Replika per Serpihan** – Pilih jumlah simpul replika baca yang Anda inginkan di setiap serpihan.

   1. **Slot dan ruang kunci** – Pilih cara yang Anda inginkan untuk mendistribusikan kunci di antara serpihan. Jika Anda memilih untuk menentukan distribusi kunci, lengkapi tabel yang menentukan rentang kunci untuk setiap serpihan.

   1. **Zona ketersediaan** – Tentukan cara yang Anda inginkan untuk memilih Zona Ketersediaan dari klaster.

   1. **Port** – Ubah ini hanya jika Anda menginginkan klaster baru menggunakan port yang berbeda.

   1. **Pilih VPC** – Pilih VPC tempat klaster ini akan dibuat.

   1. **Grup Parameter** - Pilih grup parameter yang menyimpan memori yang cukup untuk overhead Valkey atau Redis OSS untuk jenis node yang Anda pilih.

1. Jika pengaturan sudah sesuai keinginan Anda, pilih **Buat**.

Untuk informasi tentang cara membuat klaster, lihat [Membuat cluster untuk Valkey atau Redis OSS](Clusters.Create.md).

### Memulihkan data dari cadangan ke dalam klaster dengan tingkatan data diaktifkan (AWS CLI)
<a name="data-tiering-enabling-snapshots-cli"></a>

Saat membuat grup replikasi menggunakan AWS CLI, tiering data secara default digunakan dengan memilih tipe node dari keluarga r6gd, seperti *cache.r6gd.xlarge* dan mengatur parameter. `--data-tiering-enabled` 

Anda tidak dapat membatalkan penggunaan tingkatan data ketika memilih jenis simpul dari keluarga r6gd. Jika Anda mengatur parameter `--no-data-tiering-enabled`, operasi akan gagal.

Untuk Linux, macOS, atau Unix:

```
aws elasticache create-replication-group \
   --replication-group-id redis-dt-cluster \
   --replication-group-description "Redis OSS cluster with data tiering" \
   --num-node-groups 1 \
   --replicas-per-node-group 1 \
   --cache-node-type cache.r6gd.xlarge \
   --engine redis \   
   --cache-subnet-group-name default \
   --automatic-failover-enabled \
   --data-tiering-enabled \
   --snapshot-name my-snapshot
```

Untuk Linux, macOS, atau Unix:

```
aws elasticache create-replication-group ^
   --replication-group-id redis-dt-cluster ^
   --replication-group-description "Redis OSS cluster with data tiering" ^
   --num-node-groups 1 ^
   --replicas-per-node-group 1 ^
   --cache-node-type cache.r6gd.xlarge ^
   --engine redis ^   
   --cache-subnet-group-name default ^
   --automatic-failover-enabled ^
   --data-tiering-enabled ^
   --snapshot-name my-snapshot
```

Setelah menjalankan operasi ini, Anda akan melihat respons seperti yang berikut ini:

```
{
    "ReplicationGroup": {
        "ReplicationGroupId": "redis-dt-cluster",
        "Description": "Redis OSS cluster with data tiering",
        "Status": "creating",           
        "PendingModifiedValues": {},
        "MemberClusters": [
            "redis-dt-cluster"
        ],
        "AutomaticFailover": "enabled",
        "DataTiering": "enabled",
        "SnapshotRetentionLimit": 0,
        "SnapshotWindow": "06:00-07:00",
        "ClusterEnabled": false,
        "CacheNodeType": "cache.r6gd.xlarge",        
        "TransitEncryptionEnabled": false,
        "AtRestEncryptionEnabled": false
    }
}
```

# Mempersiapkan cluster di ElastiCache
<a name="Clusters.Prepare"></a>

Berikut ini, Anda dapat menemukan petunjuk tentang membuat cluster menggunakan ElastiCache konsol, the AWS CLI, atau ElastiCache API.

Anda juga dapat membuat ElastiCache cluster menggunakan [AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html). Untuk informasi selengkapnya, lihat [AWS ElastiCache::: CacheCluster](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-elasticache-cache-cluster.html) di *Panduan Pengguna AWS Cloud Formation*, yang mencakup panduan tentang cara menerapkan pendekatan tersebut.

Setiap kali Anda membuat klaster atau grup replikasi, sebaiknya lakukan pekerjaan persiapan tertentu agar Anda tidak perlu melakukan peningkatan atau melakukan perubahan.

**Topics**
+ [

# Menentukan persyaratan ElastiCache klaster Anda
](cluster-create-determine-requirements.md)
+ [

# Memilih ukuran simpul Anda
](CacheNodes.SelectSize.md)

# Menentukan persyaratan ElastiCache klaster Anda
<a name="cluster-create-determine-requirements"></a>

**Persiapan**  
Mengetahui jawaban atas pertanyaan-pertanyaan berikut membantu membuat ElastiCache klaster Anda menjadi lebih lancar:
+ Jenis instans simpul apa yang dibutuhkan?

  Untuk panduan terkait cara memilih jenis simpul instans, lihat [Memilih ukuran simpul Anda](CacheNodes.SelectSize.md).
+ Apakah klaster Anda diluncurkan di cloud privat virtual (VPC) berdasarkan Amazon VPC? 
**penting**  
Jika Anda akan meluncurkan klaster di VPC, pastikan untuk membuat grup subnet di VPC yang sama sebelum Anda mulai membuat klaster. Untuk informasi selengkapnya, lihat [Subnet dan grup subnet](SubnetGroups.md).  
ElastiCache dirancang untuk diakses dari dalam AWS menggunakan Amazon EC2. Namun, jika Anda meluncurkannya di VPC berdasarkan Amazon VPC dan klaster Anda berada di sebuah VPC, Anda dapat menyediakan akses dari luar AWS. Untuk informasi selengkapnya, lihat [Mengakses ElastiCache sumber daya dari luar AWS](accessing-elasticache.md#access-from-outside-aws).
+ Apakah Anda perlu menyesuaikan nilai parameter tertentu?

  Jika ya, buat grup parameter kustom. Untuk informasi selengkapnya, lihat [Membuat grup ElastiCache parameter](ParameterGroups.Creating.md).

   Jika Anda menjalankan Valkey atau Redis OSS, pertimbangkan pengaturan atau. `reserved-memory` `reserved-memory-percent` Untuk informasi selengkapnya, lihat [Mengelola memori cadangan untuk Valkey dan Redis OSS](redis-memory-management.md).
+ Apakah Anda perlu membuat *grup keamanan VPC* Anda sendiri? 

  Untuk informasi selengkapnya, lihat [Keamanan di VPC Anda](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Security.html).
+ Bagaimana Anda akan menerapkan toleransi kesalahan?

  Untuk informasi selengkapnya, lihat [Mitigasi Kegagalan](disaster-recovery-resiliency.md#FaultTolerance).

**Topics**
+ [

## ElastiCache persyaratan memori dan prosesor
](#cluster-create-determine-requirements-memory)
+ [

## Konfigurasi klaster Memcached
](#memcached-cluster-configuration)
+ [

## Konfigurasi cluster Valkey dan Redis OSS
](#redis-cluster-configuration)
+ [

## ElastiCache persyaratan penskalaan
](#cluster-create-determine-requirements-scaling)
+ [

## ElastiCache persyaratan akses
](#cluster-create-determine-requirements-access)
+ [

## Persyaratan Wilayah, Zona Ketersediaan, dan Zona Lokal untuk ElastiCache
](#cluster-create-determine-requirements-region)

## ElastiCache persyaratan memori dan prosesor
<a name="cluster-create-determine-requirements-memory"></a>

Blok bangunan dasar Amazon ElastiCache adalah simpul. Simpul dikonfigurasi secara tunggal atau dalam grup untuk membentuk klaster. Saat menentukan jenis simpul yang akan digunakan untuk klaster Anda, pertimbangkan konfigurasi simpul klaster dan jumlah data yang harus disimpan.

Mesin Memcached adalah multi-thread. Jadi, jumlah inti dari simpul akan berdampak pada daya komputasi yang tersedia untuk klaster.

## Konfigurasi klaster Memcached
<a name="memcached-cluster-configuration"></a>

ElastiCache untuk cluster Memcached terdiri dari 1 hingga 60 node. Data dalam klaster Memcached dipartisi di seluruh simpul di klaster. Aplikasi Anda terhubung dengan klaster Memcached menggunakan alamat jaringan yang disebut Titik Akhir. Setiap simpul dalam klaster Memcached memiliki titik akhir sendiri yang digunakan oleh aplikasi Anda untuk membaca dari atau menulis ke simpul tertentu. Selain titik akhir simpul, klaster Memcached itu sendiri memiliki titik akhir yang disebut *titik akhir konfigurasi*. Aplikasi Anda dapat menggunakan titik akhir ini untuk membaca dari atau menulis ke klaster, dan membiarkan penemuan otomatis menentukan simpul yang akan melakukan operasi baca atau operasi tulis. 

![\[Gambar yang menunjukkan bagaimana cluster Memcached dipartisi di seluruh node di cluster.\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/ElastiCache-Cluster-Memcached.png)


Untuk informasi selengkapnya, lihat [Mengelola cluster di ElastiCache](Clusters.md).

## Konfigurasi cluster Valkey dan Redis OSS
<a name="redis-cluster-configuration"></a>

ElastiCache untuk cluster Valkey dan Redis OSS terdiri dari 0 hingga 500 pecahan (juga disebut grup simpul). Data dalam cluster Valkey atau Redis OSS dipartisi di seluruh pecahan di cluster. Aplikasi Anda terhubung dengan cluster Valkey atau Redis OSS menggunakan alamat jaringan yang disebut Endpoint. Node dalam pecahan Valkey atau Redis OSS memenuhi salah satu dari dua peran: satu read/write primer dan semua node sekunder hanya-baca lainnya (juga disebut replika baca). *Selain titik akhir node, cluster Valkey atau Redis OSS itu sendiri memiliki titik akhir yang disebut titik akhir konfigurasi.* Aplikasi Anda dapat menggunakan endpoint ini untuk membaca dari atau menulis ke cluster, meninggalkan penentuan node mana yang akan dibaca atau ditulis hingga ElastiCache Redis OSS. 

![\[Gambar membandingkan cluster Valkey atau Redis OSS dalam mode dinonaktifkan vs. mode diaktifkan.\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-Redis-ClustersRGs.png)


Untuk informasi selengkapnya, lihat [Mengelola cluster di ElastiCache](Clusters.md).

## ElastiCache persyaratan penskalaan
<a name="cluster-create-determine-requirements-scaling"></a>

Semua klaster dapat dinaikkan skalanya dengan membuat klaster baru yang memiliki jenis simpul baru yang lebih besar. Saat Anda meningkatkan kluster Memcached, cluster baru mulai kosong. Saat Anda meningkatkan klaster Valkey atau Redis OSS, Anda dapat menyemainya dari cadangan dan menghindari cluster baru mulai kosong.

Amazon ElastiCache untuk cluster Memcached dapat diskalakan atau masuk. Untuk menskalakan klaster Memcached ke luar atau ke dalam, Anda cukup menambahkan atau menghapus simpul dari klaster. Jika Anda telah mengaktifkan Penemuan Otomatis dan aplikasi Anda terhubung ke titik akhir konfigurasi dari klaster, Anda tidak perlu membuat perubahan apa pun dalam aplikasi saat Anda menambahkan atau menghapus simpul.

Untuk informasi selengkapnya, lihat [Penskalaan ElastiCache](Scaling.md) dalam panduan ini.

## ElastiCache persyaratan akses
<a name="cluster-create-determine-requirements-access"></a>

Secara desain, ElastiCache kluster Amazon diakses dari EC2 instans Amazon. Akses jaringan ke ElastiCache cluster terbatas pada akun yang membuat cluster. Oleh karena itu, sebelum Anda dapat mengakses klaster dari EC2 instans Amazon, Anda harus mengotorisasi EC2 instans Amazon untuk mengakses klaster. Langkah-langkah untuk melakukan ini bervariasi, tergantung pada apakah Anda meluncurkan ke EC2 -VPC atau EC2 -Classic.

Jika Anda meluncurkan cluster Anda ke EC2 -VPC, Anda perlu memberikan masuknya jaringan ke cluster. Jika meluncurkan klaster ke EC2 -Classic, Anda harus memberikan grup keamanan Amazon Elastic Compute Cloud yang terkait dengan instans akses ke grup ElastiCache keamanan Anda. Untuk petunjuk yang lebih mendetail, lihat [Langkah 3. Otorisasi akses ke cluster](SubnetGroups.designing-cluster-pre.valkey.md#GettingStarted.AuthorizeAccess.valkey) dalam panduan ini.

## Persyaratan Wilayah, Zona Ketersediaan, dan Zona Lokal untuk ElastiCache
<a name="cluster-create-determine-requirements-region"></a>

Amazon ElastiCache mendukung semua AWS wilayah. Dengan menempatkan ElastiCache kluster Anda di AWS Wilayah yang dekat dengan aplikasi Anda, Anda dapat mengurangi latensi. Jika klaster Anda memiliki beberapa simpul, menempatkan simpul Anda di berbagai Zona Ketersediaan atau Zona Lokal dapat mengurangi dampak kegagalan pada klaster Anda.

Untuk informasi selengkapnya, lihat berikut ini:
+ [Memilih wilayah dan zona ketersediaan untuk ElastiCache](RegionsAndAZs.md)
+ [Menggunakan zona lokal dengan ElastiCache](Local_zones.md)
+ [Mitigasi Kegagalan](disaster-recovery-resiliency.md#FaultTolerance)

# Memilih ukuran simpul Anda
<a name="CacheNodes.SelectSize"></a>

Ukuran node yang Anda pilih untuk ElastiCache klaster memengaruhi biaya, kinerja, dan toleransi kesalahan. 

## Ukuran simpul (Valkey dan Redis OSS)
<a name="CacheNodes.SelectSize.redis"></a>

Untuk informasi tentang manfaat prosesor Graviton, lihat [Prosesor AWS Graviton](https://aws.amazon.com/pm/ec2-graviton/).

Menjawab pertanyaan-pertanyaan berikut dapat membantu Anda menentukan jenis node minimum yang Anda butuhkan untuk implementasi Valkey atau Redis OSS Anda:
+ Apakah Anda mengharapkan beban kerja terikat throughput dengan beberapa koneksi klien?

  Jika ini masalahnya dan Anda menjalankan Redis OSS versi 5.0.6 atau lebih tinggi, Anda bisa mendapatkan throughput dan latensi yang lebih baik dengan I/O fitur kami yang disempurnakan, jika CPUs tersedia digunakan untuk membongkar koneksi klien, atas nama mesin Redis OSS. Jika Anda menjalankan Redis OSS versi 7.0.4 atau lebih tinggi, di atas I/O, you will get additional acceleration with enhanced I/O multiplexing, where each dedicated network IO thread pipelines commands from multiple clients into the Redis OSS engine, taking advantage of Redis OSS' ability to efficiently process commands in batches. In ElastiCache for Redis OSS v7.1 and above, we extended the enhanced I/O threads functionality to also handle the presentation layer logic. By presentation layer, what we mean is that Enhanced I/O utas yang disempurnakan sekarang tidak hanya membaca input klien, tetapi juga mengurai input ke dalam format perintah biner Redis OSS, yang kemudian diteruskan ke utas utama untuk dieksekusi, memberikan peningkatan kinerja. Lihat [postingan blog](https://aws.amazon.com/blogs/database/achieve-over-500-million-requests-per-second-per-cluster-with-amazon-elasticache-for-redis-7-1/) dan halaman [versi yang didukung](VersionManagement.md#supported-engine-versions) untuk detail tambahan. 
+ Apakah Anda memiliki beban kerja yang mengakses sebagian kecil dari datanya secara berkala?

  Jika ini masalahnya dan Anda menjalankan mesin Redis OSS versi 6.2 atau yang lebih baru, Anda dapat memanfaatkan tiering data dengan memilih tipe node r6gd. Dengan tingkatan data, data yang sudah lama tidak digunakan akan disimpan di SSD. Ketika data ini diambil, ada sedikit latensi, tetapi diimbangi dengan penghematan biaya. Untuk informasi selengkapnya, lihat [Tingkatan data di ElastiCache](data-tiering.md).

  Untuk informasi selengkapnya, lihat [Jenis simpul yang didukung](CacheNodes.SupportedTypes.md).
+ Berapa banyak memori total yang dibutuhkan untuk data Anda?

  Untuk mendapatkan estimasi umum, cari tahu ukuran item yang ingin Anda simpan dalam cache. Kalikan ukuran ini dengan jumlah item yang ingin Anda simpan dalam cache pada waktu yang sama. Untuk mendapatkan estimasi yang wajar dari ukuran item, pertama-tama serialisasikan item cache Anda, kemudian hitung karakternya. Kemudian bagi jumlah karakter dengan jumlah serpihan dalam klaster Anda.

  Untuk informasi selengkapnya, lihat [Jenis simpul yang didukung](CacheNodes.SupportedTypes.md).
+ Versi Redis OSS apa yang Anda jalankan?

  Versi Redis OSS sebelum 2.8.22 mengharuskan Anda untuk menyimpan lebih banyak memori untuk failover, snapshot, sinkronisasi, dan mempromosikan replika ke operasi utama. Persyaratan ini muncul karena Anda harus memiliki cukup memori tersedia untuk semua penulisan yang terjadi selama proses. 

  Redis OSS versi 2.8.22 dan yang lebih baru menggunakan proses penyimpanan tanpa garpu yang membutuhkan lebih sedikit memori yang tersedia daripada proses sebelumnya.

  Untuk informasi selengkapnya, lihat berikut ini:
  + [Cara penerapan sinkronisasi dan pencadangan](Replication.Redis.Versions.md)
  + [Memastikan Anda memiliki cukup memori untuk membuat snapshot Valkey atau Redis OSS](BestPractices.BGSAVE.md)
+ Seberapa berat operasi tulis aplikasi Anda?

  Aplikasi dengan operasi tulis berat dapat membutuhkan ketersediaan memori yang jauh lebih banyak, memori yang tidak digunakan oleh data, saat mengambil snapshot atau failover. Setiap kali proses `BGSAVE` dilakukan, Anda harus memiliki cukup memori yang tidak digunakan oleh data untuk mengakomodasi semua operasi tulis yang berlangsung selama proses `BGSAVE`. Contohnya adalah ketika mengambil snapshot, ketika menyinkronkan klaster primer dengan replika dalam klaster, dan ketika mengaktifkan fitur append-only file (AOF). Contoh lainnya adalah saat mempromosikan replika ke primer (jika Anda memiliki Multi-AZ yang aktif). Kemungkinan terburuknya adalah ketika semua data Anda ditulis ulang selama proses berlangsung. Dalam hal ini, Anda memerlukan ukuran instans simpul dengan memori dua kali lebih banyak dari yang diperlukan untuk data saja.

  Untuk informasi selengkapnya, lihat [Memastikan Anda memiliki cukup memori untuk membuat snapshot Valkey atau Redis OSS](BestPractices.BGSAVE.md).
+ Apakah implementasi Anda akan menjadi cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) mandiri, atau cluster Valkey atau Redis OSS (mode cluster enabled) dengan beberapa pecahan?

**Valkey atau Redis OSS (mode cluster dinonaktifkan) cluster**  
Jika Anda menerapkan cluster Valkey atau Redis OSS (mode cluster disabled), tipe node Anda harus dapat mengakomodasi semua data Anda ditambah overhead yang diperlukan seperti yang dijelaskan dalam bullet sebelumnya.

  Sebagai contoh, misalnya Anda memperkirakan bahwa total ukuran semua item Anda adalah 12 GB. Dalam kasus ini, Anda dapat menggunakan simpul `cache.m3.xlarge` dengan memori 13,3 GB atau simpul `cache.r3.large` dengan memori 13,5 GB. Namun, Anda mungkin memerlukan lebih banyak memori untuk operasi `BGSAVE`. Jika aplikasi Anda memiliki operasi tulis berat, gandakan persyaratan memori ke setidaknya 24 GB. Dengan demikian, gunakan `cache.m3.2xlarge` dengan memori 27,9 GB atau `cache.r3.xlarge` dengan memori 30,5 GB.

**Valkey atau Redis OSS (mode cluster diaktifkan) dengan beberapa pecahan**  
Jika Anda menerapkan cluster Valkey atau Redis OSS (mode cluster enabled) dengan beberapa pecahan, maka tipe node harus dapat mengakomodasi `bytes-for-data-and-overhead / number-of-shards` byte data.

  Sebagai contoh, misalnya Anda memperkirakan bahwa total ukuran semua item Anda adalah 12 GB dan Anda memiliki dua serpihan. Dalam kasus ini, Anda dapat menggunakan simpul `cache.m3.large` dengan memori 6,05 GB (12 GB / 2). Namun, Anda mungkin memerlukan lebih banyak memori untuk operasi `BGSAVE`. Jika aplikasi Anda memiliki operasi tulis berat, gandakan persyaratan memori ke setidaknya 12 GB per serpihan. Dengan demikian, gunakan `cache.m3.xlarge` dengan memori 13,3 GB atau `cache.r3.large` dengan memori 13,5 GB.
+ Apakah Anda menggunakan Zona Lokal?

[Local Zones](Local_zones.md) memungkinkan Anda menempatkan sumber daya seperti ElastiCache klaster di beberapa lokasi yang dekat dengan pengguna Anda. Namun, ketika Anda memilih ukuran simpul Anda, perhatikan bahwa ukuran simpul yang tersedia saat ini terbatas seperti yang tertera berikut ini, terlepas dari persyaratan kapasitas:
  + Generasi saat ini: 

    **Jenis simpul M5:** `cache.m5.large`, `cache.m5.xlarge`, `cache.m5.2xlarge`, `cache.m5.4xlarge`, `cache.m5.12xlarge`, `cache.m5.24xlarge` 

    **Jenis simpul R5:** `cache.r5.large`, `cache.r5.xlarge`, `cache.r5.2xlarge`, `cache.r5.4xlarge`, `cache.r5.12xlarge`, `cache.r5.24xlarge`

    **Jenis simpul T3:** `cache.t3.micro`, `cache.t3.small`, `cache.t3.medium`

Saat cluster Anda berjalan, Anda dapat memantau penggunaan memori, pemanfaatan prosesor, klik cache, dan metrik cache misses yang dipublikasikan. CloudWatch Anda mungkin memperhatikan bahwa klaster Anda tidak memiliki laju hit yang Anda inginkan atau bahwa kunci terlalu sering dikosongkan. Dalam kasus ini, Anda dapat memilih ukuran simpul yang berbeda dengan spesifikasi CPU dan memori yang lebih besar.

Saat memantau penggunaan CPU, ingat Valkey dan Redis OSS adalah single-threaded. Dengan demikian, kalikan penggunaan CPU yang dilaporkan dengan jumlah inti CPU untuk mengetahui penggunaan yang sebenarnya. Misalnya, CPU empat inti yang melaporkan tingkat penggunaan 20 persen sebenarnya adalah satu inti Redis OSS berjalan pada pemanfaatan 80 persen.

## Ukuran node (Memcached)
<a name="CacheNodes.SelectSize.Mem"></a>

Klaster Memcached berisi satu atau beberapa simpul dengan data klaster yang dipartisi di seluruh simpul. Oleh karena itu, kebutuhan memori klaster dan memori simpul berkaitan, tetapi tidak sama. Anda dapat mencapai kapasitas memori klaster yang Anda butuhkan dengan memiliki simpul yang berjumlah sedikit namun berukuran besar atau beberapa simpul yang lebih kecil. Seiring waktu, ketika kebutuhan Anda berubah, Anda dapat menambahkan simpul ke atau menghapus simpul dari klaster dan dengan demikian membayar hanya untuk apa yang Anda butuhkan.

Kapasitas memori total klaster Anda dihitung dengan mengalikan jumlah simpul dalam klaster dengan kapasitas RAM setiap simpul setelah dikurangi sistem overhead. Kapasitas setiap simpul bergantung pada jenis simpul.

```
cluster_capacity = number_of_nodes * (node_capacity - system_overhead)
```

Jumlah simpul dalam klaster merupakan faktor utama dalam ketersediaan klaster Anda yang menjalankan Memcached. Kegagalan dari satu simpul dapat berdampak pada ketersediaan aplikasi Anda dan beban pada basis data backend Anda. Dalam kasus seperti itu, ElastiCache menyediakan pengganti untuk simpul yang gagal dan akan direpopulasi. Untuk mengurangi dampak ketersediaan ini, sebarkan memori dan kapasitas komputasi Anda pada lebih banyak simpul dengan kapasitas yang lebih kecil, daripada menggunakan simpul berkapasitas tinggi yang lebih sedikit.

Dalam skenario di mana Anda ingin memiliki 35 GB memori cache, Anda dapat mengatur salah satu konfigurasi berikut:
+ 11 simpul `cache.t2.medium` dengan memori 3,22 GB dengan masing-masing 2 thread = 35,42 GB dan 22 thread.
+ 6 simpul `cache.m4.large` dengan memori 6,42 GB dengan masing-masing 2 thread = 38,52 GB dan 12 thread.
+ 3 simpul `cache.r4.large` dengan memori 12,3 GB dengan masing-masing 2 thread = 36,90 GB dan 6 thread.
+ 3 simpul `cache.m4.xlarge` dengan memori 14,28 GB dengan masing-masing 4 thread = 42,84 GB dan 12 thread.


**Membandingkan opsi simpul**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/CacheNodes.SelectSize.html)

Opsi ini masing-masing menyediakan kapasitas memori yang sama namun kapasitas komputasi dan biaya yang berbeda. Untuk membandingkan biaya opsi spesifik Anda, lihat [ ElastiCache Harga Amazon](https://aws.amazon.com/elasticache/pricing/).

Untuk klaster yang menjalankan Memcached, beberapa memori yang tersedia pada setiap simpul digunakan untuk overhead koneksi. Untuk informasi selengkapnya, lihat [Overhead koneksi Memcached](ParameterGroups.Engine.md#ParameterGroups.Memcached.Overhead)

Menggunakan beberapa simpul membutuhkan penyebaran kunci di seluruh simpul. Setiap simpul memiliki titik akhir sendiri. Untuk manajemen endpoint yang mudah, Anda dapat menggunakan fitur Auto Discovery, yang memungkinkan program klien untuk secara otomatis mengidentifikasi semua node dalam sebuah cluster. ElastiCache Untuk informasi selengkapnya, lihat [Secara otomatis mengidentifikasi node di cluster Anda (Memcached)](AutoDiscovery.md).

Dalam beberapa kasus, Anda mungkin tidak yakin berapa banyak kapasitas yang Anda butuhkan. Jika demikian, untuk pengujian sebaiknya mulai dengan satu simpul `cache.m5.large`. Kemudian pantau penggunaan memori, pemanfaatan CPU, dan laju hit cache dengan ElastiCache metrik yang dipublikasikan ke Amazon. CloudWatch Untuk informasi selengkapnya tentang CloudWatch metrik ElastiCache, lihat[Pemantauan penggunaan dengan CloudWatch Metrik](CacheMetrics.md). Untuk produksi dan beban kerja yang lebih besar, simpul R5 memberikan performa dan nilai biaya RAM yang terbaik.

Jika klaster Anda tidak memiliki laju hit yang Anda inginkan, Anda dapat dengan mudah menambahkan lebih banyak simpul untuk meningkatkan total memori yang tersedia di klaster Anda.

Jika klaster Anda terikat oleh CPU tetapi memiliki laju hit yang mencukupi, atur klaster yang baru dengan jenis simpul yang memiliki daya komputasi lebih besar.

# Membuat cluster untuk Valkey atau Redis OSS
<a name="Clusters.Create"></a>

Contoh berikut menunjukkan cara membuat cluster Valkey atau Redis OSS menggunakan Konsol Manajemen AWS,AWS CLI dan API. ElastiCache 

## Membuat Valkey atau Redis OSS (mode cluster dinonaktifkan) (Konsol)
<a name="Clusters.Create.CON.Redis"></a>

ElastiCache mendukung replikasi ketika Anda menggunakan mesin Valkey atau Redis OSS. Untuk memantau latensi antara saat data ditulis ke cluster read/write primer Valkey atau Redis OSS dan ketika disebarkan ke cluster sekunder hanya-baca, ElastiCache tambahkan ke cluster kunci khusus,. `ElastiCacheMasterReplicationTimestamp` Kunci ini adalah waktu saat ini dalam Waktu Terkoordinasi Universal (UTC). Karena cluster Valkey atau Redis OSS dapat ditambahkan ke grup replikasi di lain waktu, kunci ini termasuk dalam semua cluster Valkey atau Redis OSS, bahkan jika awalnya mereka bukan anggota grup replikasi. Untuk informasi selengkapnya tentang grup replikasi, lihat [Ketersediaan tinggi menggunakan grup replikasi](Replication.md).

Untuk membuat cluster Valkey atau Redis OSS (mode cluster dinonaktifkan), ikuti langkah-langkah di. [Membuat cluster Valkey (mode cluster dinonaktifkan) (Konsol)](SubnetGroups.designing-cluster-pre.valkey.md#Clusters.Create.CON.valkey-gs)

Segera setelah status klaster Anda *tersedia*, Anda dapat memberikan Amazon EC2 akses ke sana, terhubung ke sana, dan mulai menggunakannya. Untuk informasi selengkapnya, lihat [Langkah 3. Otorisasi akses ke cluster](SubnetGroups.designing-cluster-pre.valkey.md#GettingStarted.AuthorizeAccess.valkey) dan [Langkah 4. Connect ke node cluster](SubnetGroups.designing-cluster-pre.valkey.md#GettingStarted.ConnectToCacheNode.valkey).

**penting**  
Setelah klaster Anda tersedia, Anda akan ditagih untuk setiap jam atau jam parsial saat klaster aktif, meskipun Anda tidak sedang aktif menggunakannya. Untuk menghentikan tagihan untuk klaster ini, Anda harus menghapusnya. Lihat [Menghapus cluster di ElastiCache](Clusters.Delete.md). 

## Membuat cluster Valkey atau Redis OSS (mode cluster diaktifkan) (Konsol)
<a name="Clusters.Create.CON.RedisCluster"></a>

Jika Anda menjalankan Redis OSS 3.2.4 atau yang lebih baru, Anda dapat membuat cluster Valkey atau Redis OSS (mode cluster diaktifkan). Cluster Valkey atau Redis OSS (mode cluster enabled) mendukung partisi data Anda di 1 hingga 500 pecahan (API/CLI: grup node) tetapi dengan beberapa batasan. Untuk perbandingan Valkey atau Redis OSS (mode cluster dinonaktifkan) dan Valkey atau Redis OSS (mode cluster diaktifkan), lihat. [Mesin dan versi yang didukung](VersionManagement.md#supported-engine-versions)

**Untuk membuat cluster Valkey atau Redis OSS (mode cluster enabled) menggunakan konsol ElastiCache**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol Amazon di [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari daftar di sudut kanan atas, pilih AWS Wilayah tempat Anda ingin meluncurkan cluster ini.

1. Pilih **Mulai** di panel navigasi.

1. Pilih **Buat VPC** dan ikuti langkah-langkah yang telah dijelaskan dalam [Membuat Cloud Privat Virtual (VPC)](VPCs.CreatingVPC.md).

1. Pada halaman ElastiCache dashboard, pilih **Create cluster** dan kemudian pilih **Create Valkey cluster** atau **Create Redis OSS** cluster.

1. Di bagian **Pengaturan klaster**, lakukan hal berikut:

   1. Pilih **Konfigurasi dan buat klaster baru**.

   1. Untuk **Mode klaster**, pilih **Diaktifkan**.

   1. Untuk **Info klaster**, masukkan nilai untuk **Nama**. 

   1. (Opsional) Masukkan nilai untuk **Deskripsi**.

1. Di bagian **Lokasi**:

------
#### [ AWS Cloud  ]

   1. Untuk **AWS Cloud**, sebaiknya terima pengaturan default untuk **Multi-AZ** dan **Failover otomatis**. Untuk informasi selengkapnya, lihat [Meminimalkan waktu henti ElastiCache untuk Redis OSS](AutoFailover.md) dengan Multi-AZ.

   1. Pada **Pengaturan klaster**

      1. Untuk **Versi mesin**, pilih versi yang tersedia.

      1. Untuk **Port**, gunakan port default, 6379. Jika Anda memiliki alasan untuk menggunakan port lain, masukkan nomor port tersebut.

      1. Untuk **Grup parameter**, pilih grup parameter atau buat yang baru. Grup parameter mengontrol parameter runtime dari klaster Anda. Untuk informasi selengkapnya tentang grup parameter, lihat [Parameter Valkey dan Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis) dan [Membuat grup ElastiCache parameter](ParameterGroups.Creating.md).
**catatan**  
Saat Anda memilih grup parameter untuk menetapkan nilai konfigurasi mesin, grup parameter tersebut diterapkan ke semua klaster di penyimpanan data global. Pada halaman **Grup Parameter**, atribut **Global** ya/tidak menunjukkan apakah grup parameter adalah bagian dari penyimpanan data global.

      1. Untuk **Jenis simpul**, pilih panah bawah (![\[Downward-pointing triangle icon, typically used to indicate a dropdown menu.\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/ElastiCache-DnArrow.png)). Pada kotak dialog **Ubah jenis simpul**, pilih nilai untuk **Keluarga instans** untuk jenis simpul yang Anda inginkan. Kemudian pilih jenis simpul yang ingin Anda gunakan untuk klaster ini, lalu pilih **Simpan**.

         Untuk informasi selengkapnya, lihat [Memilih ukuran simpul Anda](CacheNodes.SelectSize.md).

         Jika Anda memilih jenis simpul r6gd, tingkatan data akan diaktifkan secara otomatis. Untuk informasi selengkapnya, lihat [Tingkatan data di ElastiCache](data-tiering.md).

      1. Untuk **Jumlah pecahan**, pilih jumlah pecahan (partisi/grup simpul) yang Anda inginkan untuk cluster Valkey atau Redis OSS (mode cluster diaktifkan) ini.

         Untuk beberapa versi Valkey atau Redis OSS (mode cluster diaktifkan), Anda dapat mengubah jumlah pecahan di cluster Anda secara dinamis:
         + **Redis OSS 3.2.10 dan yang lebih baru** - Jika cluster Anda menjalankan Redis OSS 3.2.10 atau versi yang lebih baru, Anda dapat mengubah jumlah pecahan di cluster Anda secara dinamis. Untuk informasi selengkapnya, lihat [Penskalaan klaster Valkey atau Redis OSS (Mode Cluster Diaktifkan)](scaling-redis-cluster-mode-enabled.md).
         + **Versi Redis OSS lainnya** - Jika cluster Anda menjalankan versi Redis OSS sebelum versi 3.2.10, ada pendekatan lain. Untuk mengubah jumlah serpihan di klaster Anda, buat klaster baru dengan jumlah serpihan baru. Untuk informasi selengkapnya, lihat [Melakukan pemulihan dari cadangan ke dalam cache baru](backups-restoring.md).

      1. Untuk **Replika per serpihan**, pilih jumlah simpul replika baca yang Anda inginkan dalam setiap serpihan.

         Pembatasan berikut ada untuk Valkey atau Redis OSS (mode cluster diaktifkan).
         + Jika Multi-AZ diaktifkan, pastikan bahwa Anda memiliki setidaknya satu replika per serpihan.
         + Replika akan berjumlah sama untuk setiap serpihan saat membuat klaster menggunakan konsol.
         + Jumlah replika baca per serpihan bersifat tetap dan tidak dapat diubah. Jika Anda membutuhkan lebih banyak atau lebih sedikit replika per serpihan (API/CLI: grup simpul), Anda harus membuat klaster baru dengan jumlah replika yang baru. Untuk informasi selengkapnya, lihat [Tutorial: Menyemai cluster berbasis node baru dengan cadangan yang dibuat secara eksternal](backups-seeding-redis.md).

   1. Di bagian **Konektivitas**

      1. Untuk **Jenis jaringan**, pilih versi IP yang akan didukung oleh klaster ini. 

      1. Untuk **grup Subnet**, pilih subnet yang ingin Anda terapkan ke cluster ini. ElastiCache menggunakan grup subnet itu untuk memilih subnet dan alamat IP dalam subnet itu untuk dikaitkan dengan node Anda. ElastiCache cluster memerlukan subnet dual-stack dengan keduanya IPv4 dan IPv6 alamat yang ditetapkan untuk beroperasi dalam mode dual-stack dan subnet -only untuk beroperasi sebagai IPv6 -only. IPv6

         Saat membuat grup subnet baru, masukkan **ID VPC** yang menaungi grup subnet tersebut.

         Pilih **Tipe IP Penemuan**. Hanya alamat IP protokol yang Anda pilih yang dikembalikan. 

         Untuk informasi selengkapnya, lihat:
         + [Memilih jenis jaringan di ElastiCache](network-type.md).
         + [Membuat subnet di VPC Anda](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#AddaSubnet).

         Jika Anda adalah [Menggunakan zona lokal dengan ElastiCache](Local_zones.md), Anda harus membuat atau memilih subnet yang berada di zona lokal. 

         Untuk informasi selengkapnya, lihat [Subnet dan grup subnet](SubnetGroups.md).

   1. Untuk **Penempatan zona ketersediaan**, Anda memiliki dua opsi:
      + **Tidak ada preferensi** — ElastiCache memilih Availability Zone.
      + **Tentukan zona ketersediaan** – Anda menentukan Zona Ketersediaan untuk setiap klaster.

        Jika Anda memilih untuk menentukan Zona Ketersediaan, untuk setiap klaster di setiap serpihan, pilih Zona Ketersediaan dari daftar.

      Untuk informasi selengkapnya, lihat [Memilih wilayah dan zona ketersediaan untuk ElastiCache](RegionsAndAZs.md).

   1. Pilih **Berikutnya**

   1. Di bawah pengaturan **Advanced Valkey atau pengaturan** **Advanced Redis OSS** atau 

      1. Untuk **Keamanan**: 

        1. Untuk mengenkripsi data Anda, Anda memiliki opsi berikut:
           + **Enkripsi diam** – Mengaktifkan enkripsi pada data yang disimpan di disk. Untuk informasi selengkapnya, lihat [Enkripsi Diam](at-rest-encryption.md).
**catatan**  
Anda memiliki opsi untuk menyediakan kunci enkripsi yang berbeda dengan memilih kunci **AWS KMS yang Dikelola Pelanggan** dan memilih kunci. Untuk informasi selengkapnya, lihat [Menggunakan kunci yang dikelola pelanggan dari AWS KMS](at-rest-encryption.md#using-customer-managed-keys-for-elasticache-security).
           + **Enkripsi bergerak** – Mengaktifkan enkripsi data selama pengiriman. Untuk informasi selengkapnya, lihat [Enkripsi bergerak](in-transit-encryption.md). **Untuk Valkey 7.2 dan di atasnya atau Redis OSS 6.0 ke atas, jika Anda mengaktifkan Enkripsi dalam perjalanan, Anda akan diminta untuk menentukan salah satu opsi Kontrol Akses berikut:**
             + **Tanpa Kontrol Akses** – Ini adalah pengaturan default. Opsi ini menunjukkan bahwa tidak ada batasan akses pengguna ke klaster.
             + **Daftar Kontrol Akses Grup Pengguna** – Pilih grup pengguna dengan kumpulan pengguna tertentu yang dapat mengakses klaster. Untuk informasi selengkapnya, lihat [Mengelola Grup Pengguna dengan Konsol dan CLI](Clusters.RBAC.md#User-Groups).
             + **AUTH Default User** - Mekanisme otentikasi untuk server Valkey atau Redis OSS. Untuk informasi lebih lanjut, lihat [AUTH](auth.md).
           + **AUTH** — Mekanisme otentikasi untuk server Valkey atau Redis OSS. Untuk informasi lebih lanjut, lihat [AUTH](auth.md).
**catatan**  
Untuk versi Redis OSS antara 3.2.6 dan seterusnya, tidak termasuk versi 3.2.10, AUTH adalah satu-satunya pilihan.

        1. Untuk **Grup keamanan**, pilih grup keamanan yang Anda inginkan untuk klaster ini. *Grup keamanan* bertindak sebagai firewall untuk mengontrol akses jaringan ke klaster Anda. Anda dapat menggunakan grup keamanan default untuk VPC Anda atau membuat yang baru.

           Untuk informasi selengkapnya tentang grup keamanan, lihat [Grup Keamanan untuk VPC Anda](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html) dalam *Panduan Pengguna Amazon VPC.*

   1. Untuk pencadangan otomatis terjadwal secara berkala, pilih **Aktifkan pencadangan otomatis**, lalu masukkan jumlah hari yang diinginkan untuk mempertahankan cadangan otomatis sebelum dihapus secara otomatis. Jika Anda tidak ingin melakukan pencadangan otomatis terjadwal secara berkala, hapus kotak centang **Aktifkan pencadangan otomatis**. Apa pun pilihannya, Anda dapat membuat pencadangan secara manual kapan saja.

      Untuk informasi selengkapnya tentang pencadangan dan pemulihan, lihat[Melakukan snapshot dan pemulihan](backups.md).

   1. (Opsional) Tentukan periode pemeliharaan. *Jendela pemeliharaan* adalah waktu yang biasanya satu jam setiap minggu saat ElastiCache menjadwalkan pemeliharaan sistem untuk klaster Anda. Anda dapat mengizinkan ElastiCache untuk memilih hari dan waktu untuk jendela pemeliharaan Anda (*Tidak ada preferensi*), atau Anda dapat memilih hari, waktu, dan durasi sendiri (*Tentukan jendela pemeliharaan*). Jika Anda memilih *Tentukan periode pemeliharaan* dari daftar, pilih *Hari mulai*, *Waktu mulai*, dan *Durasi* (dalam jam) untuk periode pemeliharaan. Semua waktu menggunakan zona waktu UTC.

      Untuk informasi selengkapnya, lihat [Mengelola pemeliharaan ElastiCache cluster](maintenance-window.md).

   1. (Opsional) Untuk **Log**:
      + Di bagian **Format log**, pilih **Teks** atau **JSON**.
      + Di bawah **Jenis Tujuan**, pilih **CloudWatch Log** atau **Kinesis Firehose**.
      + Di bawah **Tujuan log**, pilih **Buat baru** dan masukkan nama grup CloudWatch log Log atau nama aliran Firehose Anda, atau **pilih Pilih yang ada, lalu pilih** nama grup CloudWatch log Log atau nama aliran Firehose Anda,

   1. Untuk **Tag**, untuk membantu mengelola cluster dan ElastiCache sumber daya lainnya, Anda dapat menetapkan metadata Anda sendiri ke setiap sumber daya dalam bentuk tag. Untuk informasi selengkapnya, lihat [Menandai sumber daya Anda ElastiCache](Tagging-Resources.md).

   1. Pilih **Berikutnya**.

   1. Tinjau semua entri dan pilihan Anda, lalu lakukan koreksi yang diperlukan. Saat Anda siap, pilih **Buat**.

------
#### [ On premises ]

   1. Untuk **On-premise**, sebaiknya Anda membiarkan **Failover otomatis** tetap aktif. Untuk informasi selengkapnya, lihat [Meminimalkan waktu henti ElastiCache untuk Redis OSS](AutoFailover.md) dengan Multi-AZ

   1. Ikuti langkah-langkahnya dalam [Menggunakan Outposts](ElastiCache-Outposts.md).

------

Untuk membuat ekuivalen menggunakan ElastiCache API atau AWS CLI bukan ElastiCache konsol, lihat yang berikut ini: 
+ API: [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ CLI: [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)

Segera setelah status klaster Anda *tersedia*, Anda dapat memberikan EC2 akses ke sana, terhubung ke sana, dan mulai menggunakannya. Untuk informasi selengkapnya, lihat [Langkah 3. Otorisasi akses ke cluster](SubnetGroups.designing-cluster-pre.valkey.md#GettingStarted.AuthorizeAccess.valkey) dan [Langkah 4. Connect ke node cluster](SubnetGroups.designing-cluster-pre.valkey.md#GettingStarted.ConnectToCacheNode.valkey).

**penting**  
Setelah klaster Anda tersedia, Anda akan ditagih untuk setiap jam atau jam parsial saat klaster aktif, meskipun Anda tidak sedang aktif menggunakannya. Untuk menghentikan tagihan untuk klaster ini, Anda harus menghapusnya. Lihat [Menghapus cluster di ElastiCache](Clusters.Delete.md). 

## Membuat klaster (AWS CLI)
<a name="Clusters.Create.CLI"></a>

Untuk membuat cluster menggunakan AWS CLI, gunakan `create-cache-cluster` perintah.

**penting**  
Setelah klaster Anda tersedia, Anda akan ditagih untuk setiap jam atau jam parsial saat klaster aktif, meskipun Anda tidak sedang aktif menggunakannya. Untuk menghentikan tagihan untuk klaster ini, Anda harus menghapusnya. Lihat [Menghapus cluster di ElastiCache](Clusters.Delete.md). 

### Membuat cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) (CLI)
<a name="Clusters.Create.CLI.Redis"></a>

**Example — Cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) tanpa replika baca**  
Kode CLI berikut membuat cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) tanpa replika.  
Ketika membuat klaster menggunakan jenis simpul dari keluarga r6gd, Anda harus meneruskan parameter `data-tiering-enabled`.
Untuk Linux, macOS, atau Unix:  

```
aws elasticache create-cache-cluster \
--cache-cluster-id my-cluster \
--cache-node-type cache.r4.large \
--engine redis \
--num-cache-nodes 1 \
--cache-parameter-group default.redis6.x \
--snapshot-arns arn:aws:s3:::amzn-s3-demo-bucket/snapshot.rdb
```
Untuk Windows:  

```
aws elasticache create-cache-cluster ^
--cache-cluster-id my-cluster ^
--cache-node-type cache.r4.large ^
--engine redis ^
--num-cache-nodes 1 ^
--cache-parameter-group default.redis6.x ^
--snapshot-arns arn:aws:s3:::amzn-s3-demo-bucket/snapshot.rdb
```

### Membuat cluster Valkey atau Redis OSS (mode cluster diaktifkan) ()AWS CLI
<a name="Clusters.Create.CLI.RedisCluster"></a>

Cluster Valkey atau Redis OSS (mode cluster enabled) (API/CLI: grup replikasi) tidak dapat dibuat menggunakan operasi. `create-cache-cluster` Untuk membuat cluster Valkey atau Redis OSS (mode cluster enabled) (API/CLI: grup replikasi), lihat. [Membuat grup replikasi Valkey atau Redis OSS (Cluster Mode Enabled) dari awal ()AWS CLI](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CLI)

Untuk informasi selengkapnya, lihat topik ElastiCache referensi AWS CLI untuk [https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).

## Membuat cluster untuk Valkey atau Redis OSS (API) ElastiCache
<a name="Clusters.Create.API.red-heading"></a>

Untuk membuat cluster menggunakan ElastiCache API, gunakan `CreateCacheCluster` tindakan. 

**penting**  
Setelah klaster Anda tersedia, Anda akan ditagih untuk setiap jam atau jam parsial saat klaster aktif, meskipun Anda tidak menggunakannya. Untuk menghentikan tagihan untuk klaster ini, Anda harus menghapusnya. Lihat [Menghapus cluster di ElastiCache](Clusters.Delete.md). 

**Topics**
+ [

### Membuat cluster (API) Valkey atau Redis OSS (mode cluster dinonaktifkan) ElastiCache
](#Clusters.Create.API.Redis)
+ [

### Membuat cluster di Valkey atau Redis OSS (mode cluster diaktifkan) (API) ElastiCache
](#Clusters.Create.API.RedisCluster)

### Membuat cluster (API) Valkey atau Redis OSS (mode cluster dinonaktifkan) ElastiCache
<a name="Clusters.Create.API.Redis"></a>

Kode berikut membuat Valkey atau Redis OSS (mode cluster dinonaktifkan) cluster (ElastiCache API).

Jeda baris ditambahkan agar dapat lebih mudah dibaca.

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=CreateCacheCluster
    &CacheClusterId=my-cluster
    &CacheNodeType=cache.r4.large
    &CacheParameterGroup=default.redis3.2
    &Engine=redis
    &EngineVersion=3.2.4
    &NumCacheNodes=1
    &SignatureVersion=4       
    &SignatureMethod=HmacSHA256
    &SnapshotArns.member.1=arn%3Aaws%3As3%3A%3A%3AmyS3Bucket%2Fdump.rdb
    &Timestamp=20150508T220302Z
    &Version=2015-02-02
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Credential=<credential>
    &X-Amz-Date=20150508T220302Z
    &X-Amz-Expires=20150508T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Signature=<signature>
```

### Membuat cluster di Valkey atau Redis OSS (mode cluster diaktifkan) (API) ElastiCache
<a name="Clusters.Create.API.RedisCluster"></a>

Cluster Valkey atau Redis OSS (mode cluster enabled) (API/CLI: grup replikasi) tidak dapat dibuat menggunakan operasi. `CreateCacheCluster` Untuk membuat cluster Valkey atau Redis OSS (mode cluster enabled) (API/CLI: grup replikasi), lihat. [Membuat grup replikasi di Valkey atau Redis OSS (Mode Cluster Diaktifkan) dari awal (API) ElastiCache](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md#Replication.CreatingReplGroup.NoExistingCluster.Cluster.API)

Untuk informasi selengkapnya, lihat topik referensi ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html).

# Membuat cluster untuk Memcached
<a name="Clusters.Create-mc"></a>

Contoh berikut menunjukkan cara membuat cluster menggunakan Konsol Manajemen AWS,AWS CLI dan ElastiCache API.

## Membuat klaster Memcached (konsol)
<a name="Clusters.Create.CON.Memcached"></a>

Saat Anda menggunakan mesin Memcached, Amazon ElastiCache mendukung partisi data Anda secara horizontal melalui beberapa node. Memcached memungkinkan penemuan otomatis agar Anda tidak perlu melacak titik akhir untuk setiap simpul. Memcached melacak titik akhir setiap simpul, dengan memperbarui daftar titik akhir seiring penambahan dan penghapusan simpul. Aplikasi Anda hanya memerlukan titik akhir konfigurasi agar dapat berinteraksi dengan klaster. 

Untuk membuat cluster Memcached melalui konsol, ikuti langkah-langkah di [Membuat klaster Valkey (mode cluster dinonaktifkan) (Konsol)](Clusters.Create.md#Clusters.Create.CON.RedisCluster). Saat Anda mencapai langkah lima, pilih **Buat cache Memcached**.

Segera setelah status klaster Anda *tersedia*, Anda dapat memberikan Amazon EC2 akses ke sana, menghubungkannya, dan mulai menggunakannya. Untuk informasi selengkapnya, lihat langkah-langkah serupa [Langkah 3. Otorisasi akses ke cluster](SubnetGroups.designing-cluster-pre.valkey.md#GettingStarted.AuthorizeAccess.valkey) dan[Langkah 4. Connect ke node cluster](SubnetGroups.designing-cluster-pre.valkey.md#GettingStarted.ConnectToCacheNode.valkey).

**penting**  
Setelah klaster Anda tersedia, Anda akan ditagih untuk setiap jam atau jam parsial saat klaster aktif, meskipun Anda tidak sedang aktif menggunakannya. Untuk menghentikan tagihan untuk klaster ini, Anda harus menghapusnya. Lihat [Menghapus cluster di ElastiCache](Clusters.Delete.md). 

## Membuat klaster (AWS CLI)
<a name="Clusters.Create.CLI.memcached-intro"></a>

Untuk membuat cluster menggunakan AWS CLI, gunakan `create-cache-cluster` perintah.

**penting**  
Setelah klaster Anda tersedia, Anda akan ditagih untuk setiap jam atau jam parsial saat klaster aktif, meskipun Anda tidak sedang aktif menggunakannya. Untuk menghentikan tagihan untuk klaster ini, Anda harus menghapusnya. Lihat [Menghapus cluster di ElastiCache](Clusters.Delete.md). 

### Membuat Klaster Cache Memcached AWS CLI
<a name="Clusters.Create.CLI.Memcached"></a>

Kode CLI berikut membuat cluster Memcached dengan 3 node.

Untuk Linux, macOS, atau Unix:

```
aws elasticache create-cache-cluster \
--cache-cluster-id my-cluster \
--cache-node-type cache.r4.large \
--engine memcached \
--engine-version 1.4.24 \
--cache-parameter-group default.memcached1.4 \
--num-cache-nodes 3
```

Untuk Windows:

```
aws elasticache create-cache-cluster ^
--cache-cluster-id my-cluster ^
--cache-node-type cache.r4.large ^
--engine memcached ^
--engine-version 1.4.24 ^
--cache-parameter-group default.memcached1.4 ^
--num-cache-nodes 3
```

## Membuat cluster untuk Memcached (API) ElastiCache
<a name="Clusters.Create.API.mem-heading"></a>

Untuk membuat cluster menggunakan ElastiCache API, gunakan `CreateCacheCluster` tindakan. 

**penting**  
Setelah klaster Anda tersedia, Anda akan ditagih untuk setiap jam atau jam parsial saat klaster aktif, meskipun Anda tidak menggunakannya. Untuk menghentikan tagihan untuk klaster ini, Anda harus menghapusnya. Lihat [Menghapus cluster di ElastiCache](Clusters.Delete.md). 

**Topics**
+ [

### Membuat cluster Memcached (API) ElastiCache
](#Clusters.Create.API.Memcached)

### Membuat cluster Memcached (API) ElastiCache
<a name="Clusters.Create.API.Memcached"></a>

Kode berikut membuat cluster Memcached dengan 3 node (ElastiCache API).

Jeda baris ditambahkan agar dapat lebih mudah dibaca.

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=CreateCacheCluster
    &CacheClusterId=my-cluster
    &CacheNodeType=cache.r4.large
    &Engine=memcached
    &NumCacheNodes=3
    &SignatureVersion=4       
    &SignatureMethod=HmacSHA256
    &Timestamp=20150508T220302Z
    &Version=2015-02-02
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Credential=<credential>
    &X-Amz-Date=20150508T220302Z
    &X-Amz-Expires=20150508T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Signature=<signature>
```

# Melihat detail ElastiCache cluster
<a name="Clusters.ViewDetails"></a>

Anda dapat melihat informasi detail tentang satu atau beberapa cluster menggunakan ElastiCache konsol, AWS CLI, atau ElastiCache API.

## Melihat detail klaster Memcached (Konsol)
<a name="Clusters.ViewDetails.CON.Memcached"></a>

Anda dapat melihat detail cluster Memcached menggunakan ElastiCache konsol, AWS CLI for ElastiCache, atau API. ElastiCache 

Prosedur berikut merinci cara melihat detail cluster Memcached menggunakan konsol. ElastiCache 

**Untuk melihat detail klaster Memcached**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol Amazon di [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari daftar di pojok kanan atas, pilih AWS Wilayah yang Anda minati.

1. Di dasbor ElastiCache mesin, pilih **Memcached**. Melakukan hal ini menampilkan daftar semua cluster Anda yang berjalan pada mesin Memcached.

1. Untuk melihat detail klaster, pilih kotak di sebelah kiri nama klaster.

1. Untuk melihat informasi simpul, pilih tab **Simpul**, yang menampilkan informasi tentang status simpul dan titik akhir.

1. Untuk melihat metrik, pilih tab **Metrik**, yang menampilkan metrik yang relevan untuk semua simpul di klaster. Untuk informasi selengkapnya, lihat [Pemantauan penggunaan dengan CloudWatch Metrik](CacheMetrics.md)

1. Pilih tab **Jaringan dan keamanan** untuk melihat detail tentang konektivitas jaringan klaster dan konfigurasi grup subnet dan grup keamanan VPC. Untuk informasi selengkapnya, lihat [Subnet dan grup subnet](SubnetGroups.md).

1. Pilih tab **Pemeliharaan** untuk melihat detail di pengaturan pemeliharaan klaster. Untuk informasi selengkapnya, lihat [Mengelola pemeliharaan ElastiCache cluster](maintenance-window.md).

1. Pilih tab **Tag** untuk melihat detail pada tag apa pun yang diterapkan ke sumber daya klaster. Untuk informasi selengkapnya, lihat [Menandai sumber daya Anda ElastiCache](Tagging-Resources.md).

## Melihat detail Valkey atau Redis OSS (Mode Cluster Dinonaktifkan) (Konsol)
<a name="Clusters.ViewDetails.CON.Redis"></a>

Anda dapat melihat detail cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) menggunakan ElastiCache konsol, AWS CLI for ElastiCache, atau API. ElastiCache 

Prosedur berikut merinci cara melihat detail cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) menggunakan konsol. ElastiCache 

**Untuk melihat detail cluster Valkey atau Redis OSS (mode cluster dinonaktifkan)**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol Amazon di [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Di dasbor ElastiCache mesin, pilih **Valkey** atau **Redis OSS** untuk menampilkan daftar semua cluster Anda yang berjalan di mesin itu.

1. Untuk melihat detail klaster, pilih kotak centang di sebelah kiri nama klaster. Pastikan Anda memilih cluster yang menjalankan mesin Valkey atau Redis OSS, bukan Clustered Valkey atau Clustered Redis OSS. Tindakan ini akan menampilkan detail tentang klaster, termasuk titik akhir primer dari klaster.

1. Untuk melihat informasi simpul:

   1. Pilih nama klaster.

   1. Pilih tab **Serpihan dan Simpul**. Tindakan ini akan menampilkan detail tentang setiap simpul, termasuk titik akhir simpul yang perlu digunakan untuk membaca dari klaster.

1. Untuk melihat metrik, pilih tab **Metrik**, yang menampilkan metrik yang relevan untuk semua simpul di klaster. Untuk informasi selengkapnya, lihat [Pemantauan penggunaan dengan CloudWatch Metrik](CacheMetrics.md)

1. Untuk melihat log, pilih tab **Log**, yang menunjukkan apakah klaster menggunakan log Lambat atau log Mesin dan memberikan detail yang relevan. Untuk informasi selengkapnya, lihat [Pengiriman log](Log_Delivery.md).

1. Pilih tab **Jaringan dan keamanan** untuk melihat detail tentang konektivitas jaringan klaster dan konfigurasi grup subnet. Untuk informasi selengkapnya, lihat [Subnet dan grup subnet](SubnetGroups.md).

1. Pilih tab **Pemeliharaan** untuk melihat detail di pengaturan pemeliharaan klaster. Untuk informasi selengkapnya, lihat [Mengelola pemeliharaan ElastiCache cluster](maintenance-window.md).

1. Pilih tab **Pembaruan layanan** untuk melihat detail tentang pembaruan layanan yang tersedia beserta tanggal penerapan yang direkomendasikan. Untuk informasi selengkapnya, lihat [Pembaruan layanan di ElastiCache](Self-Service-Updates.md).

1. Pilih tab **Tag** untuk melihat detail pada tag apa pun yang diterapkan ke sumber daya klaster. Untuk informasi selengkapnya, lihat [Menandai sumber daya Anda ElastiCache](Tagging-Resources.md).

## Melihat detail untuk cluster Valkey atau Redis OSS (Cluster Mode Enabled) (Konsol)
<a name="Clusters.ViewDetails.CON.RedisCluster"></a>

Anda dapat melihat detail cluster Valkey atau Redis OSS (mode cluster enabled) menggunakan ElastiCache konsol, AWS CLI for ElastiCache, atau API. ElastiCache 

Prosedur berikut merinci cara melihat detail cluster Valkey atau Redis OSS (mode cluster enabled) menggunakan konsol. ElastiCache 

**Untuk melihat detail cluster Valkey atau Redis OSS (mode cluster enabled)**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol Amazon di [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari daftar di pojok kanan atas, pilih AWS Wilayah yang Anda minati.

1. Di dasbor ElastiCache mesin, pilih **Valkey** atau **Redis OSS** untuk menampilkan daftar semua cluster Anda yang berjalan di mesin itu.

1. Untuk melihat detail cluster Valkey atau Redis OSS (mode cluster enabled), pilih kotak di sebelah kiri nama cluster. Pastikan Anda memilih cluster yang menjalankan mesin Valkey atau Clustered Redis OSS.

   Layar akan diperluas di bawah klaster dan menampilkan detail tentang klaster, termasuk titik akhir konfigurasi klaster.

1. Untuk melihat daftar serpihan klaster dan jumlah simpul di setiap serpihan, pilih tab **Serpihan dan simpul**.

1. Untuk melihat informasi spesifik tentang sebuah simpul:

   1. Pilih ID serpihan.

     Tindakan ini akan menampilkan informasi tentang setiap simpul, termasuk titik akhir simpul yang perlu digunakan untuk membaca dari klaster.

1. Untuk melihat metrik, pilih tab **Metrik**, yang menampilkan metrik yang relevan untuk semua simpul di klaster. Untuk informasi selengkapnya, lihat [Pemantauan penggunaan dengan CloudWatch Metrik](CacheMetrics.md)

1. Untuk melihat log, pilih tab **Log**, yang menunjukkan apakah klaster menggunakan log Lambat atau log Mesin dan memberikan detail yang relevan. Untuk informasi selengkapnya, lihat [Pengiriman log](Log_Delivery.md).

1. Pilih tab **Jaringan dan keamanan** untuk melihat detail tentang konektivitas jaringan klaster dan konfigurasi grup subnet, grup keamanan VPC dan metode enkripsi hal yang diaktifkan di klaster, jika ada. Untuk informasi selengkapnya, lihat [Subnet dan grup subnet](SubnetGroups.md) dan [Keamanan data di Amazon ElastiCache](encryption.md).

1. Pilih tab **Pemeliharaan** untuk melihat detail di pengaturan pemeliharaan klaster. Untuk informasi selengkapnya, lihat [Mengelola pemeliharaan ElastiCache cluster](maintenance-window.md).

1. Pilih tab **Pembaruan layanan** untuk melihat detail tentang pembaruan layanan yang tersedia beserta tanggal penerapan yang direkomendasikan. Untuk informasi selengkapnya, lihat [Pembaruan layanan di ElastiCache](Self-Service-Updates.md).

1. Pilih tab **Tag** untuk melihat detail pada tag apa pun yang diterapkan ke sumber daya klaster. Untuk informasi selengkapnya, lihat [Menandai sumber daya Anda ElastiCache](Tagging-Resources.md).

## Melihat detail ElastiCache cluster (AWS CLI)
<a name="Clusters.ViewDetails.CLI"></a>

Kode berikut mencantumkan rincian untuk*my-cluster*:

```
aws elasticache describe-cache-clusters --cache-cluster-id my-cluster
```

Ganti *my-cluster* dengan nama cluster Anda dalam kasus di mana cluster dibuat dengan 1 node cache dan 0 pecahan menggunakan `create-cache-cluster` perintah.

```
{
    "CacheClusters": [
        {
            "CacheClusterStatus": "available",
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "wed:12:00-wed:13:00",
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "08:30-09:30",
            "TransitEncryptionEnabled": false,
            "AtRestEncryptionEnabled": false,
            "CacheClusterId": "my-cluster1",
            "CacheClusterCreateTime": "2018-02-26T21:06:43.420Z",
            "PreferredAvailabilityZone": "us-west-2c",
            "AuthTokenEnabled": false,
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
           "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis3.2"
            },
            "SnapshotRetentionLimit": 0,
            "AutoMinorVersionUpgrade": true,
            "EngineVersion": "3.2.10",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        }
```

```
{
    "CacheClusters": [
        {
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "AuthTokenEnabled": false,
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "12:30-13:30",
            "AutoMinorVersionUpgrade": true,
            "CacheClusterCreateTime": "2018-02-26T21:13:24.250Z",
            "CacheClusterStatus": "available",
            "AtRestEncryptionEnabled": false,
            "PreferredAvailabilityZone": "us-west-2a",
            "TransitEncryptionEnabled": false,
            "ReplicationGroupId": "my-cluster2",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "sun:08:30-sun:09:30",
            "CacheClusterId": "my-cluster2-001",
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
            "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis6.x"
            },
            "SnapshotRetentionLimit": 0,
            "EngineVersion": "6.0",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        },
        {
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "AuthTokenEnabled": false,
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "12:30-13:30",
            "AutoMinorVersionUpgrade": true,
            "CacheClusterCreateTime": "2018-02-26T21:13:24.250Z",
            "CacheClusterStatus": "available",
            "AtRestEncryptionEnabled": false,
            "PreferredAvailabilityZone": "us-west-2b",
            "TransitEncryptionEnabled": false,
            "ReplicationGroupId": "my-cluster2",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "sun:08:30-sun:09:30",
            "CacheClusterId": "my-cluster2-002",
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
            "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis6.x"
            },
            "SnapshotRetentionLimit": 0,
            "EngineVersion": "6.0",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        },
        {
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "AuthTokenEnabled": false,
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "12:30-13:30",
            "AutoMinorVersionUpgrade": true,
            "CacheClusterCreateTime": "2018-02-26T21:13:24.250Z",
            "CacheClusterStatus": "available",
            "AtRestEncryptionEnabled": false,
            "PreferredAvailabilityZone": "us-west-2c",
            "TransitEncryptionEnabled": false,
            "ReplicationGroupId": "my-cluster2",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "sun:08:30-sun:09:30",
            "CacheClusterId": "my-cluster2-003",
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
            "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis3.2"
            },
            "SnapshotRetentionLimit": 0,
            "EngineVersion": "3.2.10",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        }
```

```
{
    "CacheClusters": [
        {
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "AuthTokenEnabled": true,
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "12:30-13:30",
            "AutoMinorVersionUpgrade": true,
            "CacheClusterCreateTime": "2018-02-26T21:17:01.439Z",
            "CacheClusterStatus": "available",
            "AtRestEncryptionEnabled": true,
            "PreferredAvailabilityZone": "us-west-2a",
            "TransitEncryptionEnabled": true,
            "ReplicationGroupId": "my-cluster3",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "thu:11:00-thu:12:00",
            "CacheClusterId": "my-cluster3-0001-001",
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
            "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis6.x.cluster.on"
            },
            "SnapshotRetentionLimit": 0,
            "EngineVersion": "6.0",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        },
        {
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "AuthTokenEnabled": true,
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "12:30-13:30",
            "AutoMinorVersionUpgrade": true,
            "CacheClusterCreateTime": "2018-02-26T21:17:01.439Z",
            "CacheClusterStatus": "available",
            "AtRestEncryptionEnabled": true,
            "PreferredAvailabilityZone": "us-west-2b",
            "TransitEncryptionEnabled": true,
            "ReplicationGroupId": "my-cluster3",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "thu:11:00-thu:12:00",
            "CacheClusterId": "my-cluster3-0001-002",
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
             "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis3.2.cluster.on"
            },
            "SnapshotRetentionLimit": 0,
            "EngineVersion": "3.2.6",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        },
        {
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "AuthTokenEnabled": true,
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "12:30-13:30",
            "AutoMinorVersionUpgrade": true,
            "CacheClusterCreateTime": "2018-02-26T21:17:01.439Z",
            "CacheClusterStatus": "available",
            "AtRestEncryptionEnabled": true,
            "PreferredAvailabilityZone": "us-west-2c",
            "TransitEncryptionEnabled": true,
            "ReplicationGroupId": "my-cluster3",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "thu:11:00-thu:12:00",
            "CacheClusterId": "my-cluster3-0001-003",
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
             "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis6.x.cluster.on"
            },
            "SnapshotRetentionLimit": 0,
            "EngineVersion": "6.0",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        },
        {
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "AuthTokenEnabled": true,
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "12:30-13:30",
            "AutoMinorVersionUpgrade": true,
            "CacheClusterCreateTime": "2018-02-26T21:17:01.439Z",
            "CacheClusterStatus": "available",
            "AtRestEncryptionEnabled": true,
            "PreferredAvailabilityZone": "us-west-2b",
            "TransitEncryptionEnabled": true,
            "ReplicationGroupId": "my-cluster3",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "thu:11:00-thu:12:00",
            "CacheClusterId": "my-cluster3-0002-001",
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
             "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis6.x.cluster.on"
            },
            "SnapshotRetentionLimit": 0,
            "EngineVersion": "6.0",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        },
        {
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "AuthTokenEnabled": true,
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "12:30-13:30",
            "AutoMinorVersionUpgrade": true,
            "CacheClusterCreateTime": "2018-02-26T21:17:01.439Z",
            "CacheClusterStatus": "available",
            "AtRestEncryptionEnabled": true,
            "PreferredAvailabilityZone": "us-west-2c",
            "TransitEncryptionEnabled": true,
            "ReplicationGroupId": "my-cluster3",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "thu:11:00-thu:12:00",
            "CacheClusterId": "my-cluster3-0002-002",
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
             "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis3.2.cluster.on"
            },
            "SnapshotRetentionLimit": 0,
            "EngineVersion": "3.2.6",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        },
        {
            "SecurityGroups": [
                {
                    "Status": "active",
                    "SecurityGroupId": "sg-dbe93fa2"
                }
            ],
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "AuthTokenEnabled": true,
            "CacheSubnetGroupName": "default",
            "SnapshotWindow": "12:30-13:30",
            "AutoMinorVersionUpgrade": true,
            "CacheClusterCreateTime": "2018-02-26T21:17:01.439Z",
            "CacheClusterStatus": "available",
            "AtRestEncryptionEnabled": true,
            "PreferredAvailabilityZone": "us-west-2a",
            "TransitEncryptionEnabled": true,
            "ReplicationGroupId": "my-cluster3",
            "Engine": "redis",
            "PreferredMaintenanceWindow": "thu:11:00-thu:12:00",
            "CacheClusterId": "my-cluster3-0002-003",
            "PendingModifiedValues": {},
            "CacheNodeType": "cache.r4.large",
             "DataTiering": "disabled",
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [],
                "ParameterApplyStatus": "in-sync",
                "CacheParameterGroupName": "default.redis6.x.cluster.on"
            },
            "SnapshotRetentionLimit": 0,
            "EngineVersion": "6.0",
            "CacheSecurityGroups": [],
            "NumCacheNodes": 1
        }
    ]
}
```

Dalam kasus di mana cluster dibuat menggunakan Konsol Manajemen AWS (node cluster diaktifkan atau dinonaktifkan dengan 1 atau lebih pecahan), gunakan perintah berikut untuk menjelaskan detail cluster (ganti *my-cluster* dengan nama grup replikasi (nama cluster Anda):

```
aws elasticache describe-replication-groups --replication-group-id my-cluster 
```

Untuk informasi lebih lanjut, lihat ElastiCache topik AWS CLI untuk [https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-cache-clusters.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-cache-clusters.html).

## Melihat detail ElastiCache klaster (ElastiCache API)
<a name="Clusters.ViewDetails.API"></a>

Anda dapat melihat detail untuk klaster menggunakan `DescribeCacheClusters` tindakan ElastiCache API. Jika parameter `CacheClusterId` disertakan, detail untuk klaster yang ditentukan akan ditampilkan. Jika parameter `CacheClusterId` dihilangkan, detail untuk maksimal `MaxRecords` klaster (default-nya 100) akan ditampilkan. Nilai untuk `MaxRecords` tidak boleh kurang dari 20 atau lebih dari 100.

Kode berikut menampilkan daftar detail untuk `my-cluster`.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DescribeCacheClusters
   &CacheClusterId=my-cluster
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Kode berikut menampilkan daftar detail untuk maksimal 25 klaster.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DescribeCacheClusters
   &MaxRecords=25
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Untuk informasi selengkapnya, lihat topik referensi ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeCacheClusters.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeCacheClusters.html).

# Memodifikasi cluster ElastiCache
<a name="Clusters.Modify"></a>

Selain menambahkan atau menghapus node dari ElastiCache cluster, mungkin ada saat-saat di mana Anda perlu membuat perubahan lain seperti menambahkan grup keamanan, mengubah jendela pemeliharaan atau grup parameter.

Sebaiknya atur periode pemeliharaan Anda pada waktu penggunaan terendah. Jadi, Anda mungkin perlu mengubahnya dari waktu ke waktu.

Saat Anda mengubah parameter klaster, perubahan diterapkan pada klaster secara langsung atau setelah klaster dimulai ulang. Ini berlaku terlepas dari apakah Anda mengubah grup parameter klaster itu sendiri atau nilai parameter di dalam grup parameter klaster. Untuk menentukan kapan perubahan parameter tertentu diterapkan, lihat bagian **Perubahan Berpengaruh** pada kolom **Detail** dalam tabel untuk [Parameter spesifik Memcached](ParameterGroups.Engine.md#ParameterGroups.Memcached)dan [Parameter Valkey dan Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis). Untuk informasi tentang cara melakukan boot ulang simpul klaster, lihat [Mem-boot ulang node](nodes.rebooting.md).

## Menggunakan ElastiCache Konsol Manajemen AWS
<a name="Clusters.Modify.CON"></a>

**Untuk mengubah klaster**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari daftar di sudut kanan atas, pilih AWS Wilayah tempat cluster yang ingin Anda modifikasi berada.

1. Di panel navigasi, pilih mesin yang berjalan pada klaster yang ingin diubah.

   Daftar klaster mesin yang dipilih akan muncul.

1. Dalam daftar klaster tersebut, pilih nama klaster yang ingin Anda ubah. 

1. Pilih **Tindakan**, lalu pilih **Ubah**. 

   Jendela **Ubah Klaster** akan muncul.

1. Di jendela **Ubah Klaster**, lakukan perubahan yang Anda inginkan. Opsinya meliputi:
   + Deskripsi
   + Mode klaster - Untuk mengubah mode klaster dari **Dinonaktifkan** ke **Diaktifkan**, Anda harus terlebih dahulu mengatur mode klaster ke **Kompatibel**.

     Mode yang kompatibel memungkinkan klien Valkey atau Redis OSS Anda terhubung menggunakan mode cluster diaktifkan dan mode cluster dinonaktifkan. **Setelah Anda memigrasikan semua klien Valkey atau Redis OSS untuk menggunakan mode cluster yang diaktifkan, Anda kemudian dapat menyelesaikan konfigurasi mode cluster dan mengatur mode cluster ke Diaktifkan.**
   + Kompatibilitas Versi Mesin
**penting**  
Anda dapat meningkatkan ke versi mesin yang lebih baru. Jika Anda meningkatkan versi utama mesin, misalnya dari 5.0.6 ke 6.0, Anda perlu memilih keluarga grup parameter yang kompatibel dengan versi mesin yang baru. Untuk informasi selengkapnya tentang cara melakukannya, lihat [Manajemen Versi untuk ElastiCache](VersionManagement.md). Namun, Anda tidak dapat menurunkan ke versi mesin yang lebih lama kecuali dengan menghapus klaster yang ada dan membuatnya lagi.
   + Grup Keamanan VPC
   + Grup Parameter
   + Jenis Simpul
**catatan**  
Jika klaster menggunakan jenis simpul dari keluarga r6gd, Anda hanya dapat memilih ukuran simpul yang berbeda dari dalam keluarga tersebut. Jika Anda memilih jenis simpul dari keluarga r6gd, tingkatan data akan diaktifkan secara otomatis. Untuk informasi selengkapnya, lihat [Tingkatan data](data-tiering.md).
   + Multi-AZ
   + Failover otomatis (hanya mode klaster dinonaktifkan)
   + Aktifkan Pencadangan Otomatis
   + ID Simpul Cadangan
   + Periode Retensi Cadangan
   + Periode Pencadangan
   + Topik untuk Notifikasi SNS
   + Kompatibilitas Versi Mesin Memcached
   + Jenis jaringan
**catatan**  
Jika Anda beralih dari IPv4 ke IPv6, Anda harus memilih atau membuat grup subnet yang kompatibel dengannya IPv6. Untuk informasi selengkapnya, lihat [Memilih jenis jaringan di ElastiCache](network-type.md).
   + Grup Keamanan VPC
   + Grup Parameter
   + Periode Pemeliharaan
   + Topik untuk Notifikasi SNS

   Kotak **Terapkan Segera** hanya berlaku untuk versi mesin dan modifikasi tipe node. Untuk menerapkan perubahan secara langsung, pilih kotak centang **Terapkan Segera**. Jika kotak ini tidak dipilih, perubahan versi mesin diterapkan pada periode pemeliharaan berikutnya. Perubahan lain, seperti mengubah jendela pemeliharaan, akan diterapkan segera.

**Untuk enable/disable mencatat pengiriman untuk Redis**

1. Dari daftar klaster, pilih klaster yang ingin diubah. Pilih **Nama klaster**, bukan kotak centang di sampingnya.

1. Pada halaman **detail Cluster**, pilih tab **Log**.

1. Untuk mengaktifkan atau menonaktifkan log lambat, pilih **Aktifkan** atau **Nonaktifkan**.

   Jika Anda memilih Aktifkan:

   1. Di bagian **Format log**, pilih **Teks** atau **JSON**.

   1. Di bawah **Jenis tujuan Log**, pilih **CloudWatch Log** atau **Kinesis Firehose**.

   1. Di bawah **Tujuan log**, Anda dapat memilih **Buat baru** dan masukkan nama grup CloudWatchLogs log atau nama aliran Kinesis Data Firehose Anda. Anda juga dapat memilih **Pilih yang ada** dan kemudian memilih nama grup CloudWatchLogs log atau nama aliran Kinesis Data Firehose Anda.

   1. Pilih **Aktifkan**.

**Untuk mengubah konfigurasi Anda untuk Redis:**

1. Pilih **Ubah**.

1. Di bagian **Format log**, pilih **Teks** atau **JSON**.

1. Di bawah **Jenis Tujuan**, pilih **CloudWatch Log** atau **Kinesis Firehose**.

1. Di bawah **Tujuan log**, pilih **Buat baru** dan masukkan nama grup CloudWatchLogs log Anda atau nama aliran Kinesis Data Firehose Anda. Atau pilih **Pilih yang ada** lalu pilih nama grup CloudWatchLogs log atau nama aliran Kinesis Data Firehose Anda.

## Menggunakan AWS CLI dengan ElastiCache
<a name="Clusters.Modify.CLI"></a>

Anda dapat memodifikasi cluster yang ada menggunakan AWS CLI `modify-cache-cluster` operasi. Untuk mengubah nilai konfigurasi klaster, tentukan ID klaster, parameter yang akan diubah, dan nilai baru parameter. Contoh berikut mengubah periode pemeliharaan untuk klaster bernama `my-cluster` dan menerapkan perubahan tersebut secara langsung.

**penting**  
Anda dapat meningkatkan ke versi mesin Memcached yang lebih baru. Untuk informasi selengkapnya tentang cara melakukannya, lihat [Manajemen Versi untuk ElastiCache](VersionManagement.md). Namun, Anda tidak dapat menurunkan ke versi mesin yang lebih lama kecuali dengan menghapus klaster yang ada dan membuatnya lagi.

**penting**  
Anda dapat meningkatkan ke versi mesin Valkey atau Redis OSS yang lebih baru. Jika Anda meningkatkan versi mesin utama, misalnya dari Redis OSS 5.0.6 ke Redis OSS 6.0, Anda perlu memilih keluarga grup parameter yang kompatibel dengan versi mesin baru. Untuk informasi selengkapnya tentang cara melakukannya, lihat [Manajemen Versi untuk ElastiCache](VersionManagement.md). Namun, Anda tidak dapat menurunkan ke versi mesin yang lebih lama kecuali dengan menghapus klaster yang ada dan membuatnya lagi.

Untuk Linux, macOS, atau Unix:

```
aws elasticache modify-cache-cluster \
    --cache-cluster-id my-cluster \
    --preferred-maintenance-window sun:23:00-mon:02:00
```

Untuk Windows:

```
aws elasticache modify-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --preferred-maintenance-window sun:23:00-mon:02:00
```

Parameter `--apply-immediately` hanya berlaku untuk perubahan pada jenis simpul, versi mesin, dan jumlah simpul di klaster. Jika Anda ingin menerapkan salah satu perubahan ini segera, gunakan parameter `--apply-immediately`. Jika Anda lebih memilih untuk menunda perubahan ini ke periode pemeliharaan berikutnya, gunakan parameter `--no-apply-immediately`. Perubahan lain, seperti perubahan periode pemeliharaan, akan diterapkan segera.

Untuk informasi lebih lanjut, lihat ElastiCache topik AWS CLI untuk [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html).

## Menggunakan ElastiCache API
<a name="Clusters.Modify.API"></a>

Anda dapat memodifikasi cluster yang ada menggunakan `ModifyCacheCluster` operasi ElastiCache API. Untuk mengubah nilai konfigurasi klaster, tentukan ID klaster, parameter yang akan diubah, dan nilai baru parameter. Contoh berikut mengubah periode pemeliharaan untuk klaster bernama `my-cluster` dan menerapkan perubahan tersebut secara langsung.

**penting**  
Anda dapat meningkatkan ke versi mesin Memcached yang lebih baru. Untuk informasi selengkapnya tentang cara melakukannya, lihat [Manajemen Versi untuk ElastiCache](VersionManagement.md). Namun, Anda tidak dapat menurunkan ke versi mesin yang lebih lama kecuali dengan menghapus klaster yang ada dan membuatnya lagi.

**penting**  
Anda dapat meningkatkan ke versi mesin Valkey atau Redis OSS yang lebih baru. Jika Anda meningkatkan versi mesin utama, misalnya dari Redis OSS 5.0.6 ke Redis OSS 6.0, Anda perlu memilih keluarga grup parameter yang kompatibel dengan versi mesin baru. Untuk informasi selengkapnya tentang cara melakukannya, lihat [Manajemen Versi untuk ElastiCache](VersionManagement.md). Namun, Anda tidak dapat menurunkan ke versi mesin yang lebih lama kecuali dengan menghapus klaster yang ada dan membuatnya lagi.

Jeda baris ditambahkan agar dapat lebih mudah dibaca.

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=ModifyCacheCluster
    &CacheClusterId=my-cluster
    &PreferredMaintenanceWindow=sun:23:00-mon:02:00
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20150901T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20150202T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20150901T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>
```

Parameter `ApplyImmediately` hanya berlaku untuk perubahan pada jenis simpul, versi mesin, dan jumlah simpul di klaster. Jika Anda ingin menerapkan salah satu perubahan ini secara langsung, tetapkan parameter `ApplyImmediately` ke `true`. Jika Anda lebih memilih untuk menunda perubahan ini ke periode pemeliharaan berikutnya, tetapkan parameter `ApplyImmediately` ke `false`. Perubahan lain, seperti perubahan periode pemeliharaan, akan diterapkan segera.

Untuk informasi selengkapnya, lihat topik referensi ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html).

# Menambahkan node ke ElastiCache cluster
<a name="Clusters.AddNode"></a>

Penambahan simpul ke klaster Memcached akan meningkatkan jumlah partisi klaster Anda. Saat Anda mengubah jumlah partisi dalam klaster, beberapa ruang kunci Anda perlu dipetakan ulang agar dapat dipetakan ke simpul yang benar. Pemetaan ulang ruang kunci akan sementara waktu meningkatkan jumlah cache miss di klaster. Untuk informasi selengkapnya, lihat [Mengkonfigurasi ElastiCache klien Anda untuk penyeimbangan beban yang efisien (Memcached)](BestPractices.LoadBalancing.md).

Untuk mengkonfigurasi ulang klaster Valkey atau Redis OSS (mode cluster enabled) Anda, lihat [Penskalaan klaster Valkey atau Redis OSS (Mode Cluster Diaktifkan)](scaling-redis-cluster-mode-enabled.md)

Anda dapat menggunakan ElastiCache Management Console,AWS CLI atau ElastiCache API untuk menambahkan node ke cluster Anda.

## Menggunakan ElastiCache Konsol Manajemen AWS
<a name="Clusters.AddNode.CON"></a>

Jika Anda ingin menambahkan node ke cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) (satu tanpa replikasi diaktifkan), ini adalah proses dua langkah: pertama tambahkan replikasi, dan kemudian tambahkan simpul replika.

**Topik**
+ [Untuk menambahkan replikasi ke cluster Valkey atau Redis OSS tanpa pecahan](#AddReplication.CON)
+ [Untuk menambahkan node ke ElastiCache cluster (konsol)](#AddNode.CON)

Prosedur berikut menambahkan replikasi ke satu node Valkey atau Redis OSS yang tidak mengaktifkan replikasi. Saat Anda menambahkan replikasi, simpul yang ada menjadi simpul primer dalam klaster yang mengaktifkan replikasi. Setelah replikasi ditambahkan, Anda dapat menambahkan hingga 5 simpul replika ke klaster.<a name="AddReplication.CON"></a>

**Untuk menambahkan replikasi ke cluster Valkey atau Redis OSS tanpa pecahan**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari panel navigasi, pilih cluster **Valkey atau cluster** **Redis** OSS.

   Daftar cluster yang menjalankan mesin itu ditampilkan.

1. Pilih nama klaster, bukan kotak di sebelah kiri nama klaster, yang ingin ditambahi simpul.

   Berikut ini berlaku untuk cluster Redis OSS yang tidak mengaktifkan replikasi:
   + Ini menjalankan Redis OSS, bukan Clustered Redis OSS.
   + Klaster ini tidak memiliki serpihan.

     Jika klaster memiliki serpihan, artinya replikasi sudah diaktifkan dan Anda dapat melanjutkan ke [Untuk menambahkan node ke ElastiCache cluster (konsol)](#AddNode.CON).

1. Pilih **Tambahkan replikasi**.

1. Di bagian **Tambahkan replikasi**, masukkan deskripsi untuk klaster yang mengaktifkan replikasi ini.

1. Pilih **Tambahkan**.

   Segera setelah status klaster kembali menjadi *tersedia*, Anda dapat melanjutkan ke prosedur berikutnya dan menambahkan replika ke klaster.<a name="AddNode.CON"></a>

**Untuk menambahkan node ke ElastiCache cluster (konsol)**

Prosedur berikut dapat digunakan untuk menambahkan simpul ke klaster.

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Di panel navigasi, pilih mesin yang berjalan pada klaster yang ingin ditambahi simpul.

   Daftar klaster yang menjalankan mesin yang dipilih akan muncul.

1. Dari daftar klaster tersebut, pilih nama klaster yang ingin ditambahi simpul.

   Jika cluster Anda adalah cluster Valkey atau Redis OSS (mode cluster enabled), lihat. [Penskalaan klaster Valkey atau Redis OSS (Mode Cluster Diaktifkan)](scaling-redis-cluster-mode-enabled.md)

   Jika cluster Anda adalah cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) dengan pecahan nol, pertama-tama selesaikan langkah-langkahnya di. [Untuk menambahkan replikasi ke cluster Valkey atau Redis OSS tanpa pecahan](#AddReplication.CON)

1. Pilih **Tambahkan simpul**.

1. Lengkapi informasi yang diminta dalam kotak dialog **Tambahkan Simpul**.

1. Pilih tombol **Terapkan Segera - Ya** untuk menambahkan simpul ini secara langsung, atau pilih **Tidak** untuk menambahkan simpul ini pada periode pemeliharaan berikutnya untuk klaster.  
**Dampak Permintaan Penambahan dan Penghapusan Baru pada Permintaan Tertunda**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/Clusters.AddNode.html)

   Untuk menentukan operasi apa yang tertunda, pilih tab **Deskripsi** dan periksa untuk melihat berapa banyak pembuatan atau penghapusan tertunda yang ditampilkan. Anda tidak dapat memiliki pembuatan tertunda dan penghapusan tertunda sekaligus. 

1. Pilih tombol **Tambahkan**.

    Setelah beberapa saat, simpul baru akan muncul dalam daftar simpul dengan status **membuat**. Jika simpul tersebut tidak muncul, segarkan halaman browser Anda. Saat status simpul berubah menjadi *tersedia*, simpul baru sudah dapat digunakan.

## Menggunakan AWS CLI dengan ElastiCache
<a name="Clusters.AddNode.CLI"></a>

Untuk menambahkan node ke cluster menggunakan AWS CLI, gunakan AWS CLI operasi `modify-cache-cluster` dengan parameter berikut:
+ `--cache-cluster-id` – ID dari klaster yang ingin ditambahi simpul.
+ `--num-cache-nodes` – Parameter `--num-cache-nodes` menentukan jumlah simpul yang diinginkan dalam klaster ini setelah perubahan diterapkan. Untuk menambahkan simpul ke klaster ini, `--num-cache-nodes` harus lebih besar dari jumlah simpul saat ini dalam klaster. Jika nilai ini kurang dari jumlah node saat ini, ElastiCache mengharapkan parameter `cache-node-ids-to-remove` dan daftar node untuk dihapus dari cluster. Untuk informasi selengkapnya, lihat [Menggunakan AWS CLI dengan ElastiCache](Clusters.DeleteNode.md#Clusters.DeleteNode.CLI).
+ `--apply-immediately` atau `--no-apply-immediately` yang menentukan apakah akan menambahkan simpul ini secara langsung atau pada periode pemeliharaan berikutnya.

Untuk Linux, macOS, atau Unix:

```
aws elasticache modify-cache-cluster \
    --cache-cluster-id my-cluster \
    --num-cache-nodes 5 \
    --apply-immediately
```

Untuk Windows:

```
aws elasticache modify-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --num-cache-nodes 5 ^
    --apply-immediately
```

Operasi ini menghasilkan output seperti yang berikut ini (format JSON):

```
{
    "CacheCluster": {
        "Engine": "memcached", 
        "CacheParameterGroup": {
            "CacheNodeIdsToReboot": [], 
            "CacheParameterGroupName": "default.memcached1.4", 
            "ParameterApplyStatus": "in-sync"
        }, 
        "CacheClusterId": "my-cluster", 
        "PreferredAvailabilityZone": "us-west-2b", 
        "ConfigurationEndpoint": {
            "Port": 11211, 
            "Address": "rlh-mem000.7alc7bf-example.cfg.usw2.cache.amazonaws.com"
        }, 
        "CacheSecurityGroups": [], 
        "CacheClusterCreateTime": "2016-09-21T16:28:28.973Z", 
        "AutoMinorVersionUpgrade": true, 
        "CacheClusterStatus": "modifying", 
        "NumCacheNodes": 2, 
        "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", 
        "SecurityGroups": [
            {
                "Status": "active", 
                "SecurityGroupId": "sg-dbe93fa2"
            }
        ], 
        "CacheSubnetGroupName": "default", 
        "EngineVersion": "1.4.24", 
        "PendingModifiedValues": {
            "NumCacheNodes": 5
        }, 
        "PreferredMaintenanceWindow": "sat:09:00-sat:10:00", 
        "CacheNodeType": "cache.m3.medium",
         "DataTiering": "disabled",
    }
}
```

Untuk informasi lebih lanjut, lihat AWS CLI topiknya [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html).

## Menggunakan AWS CLI dengan ElastiCache
<a name="Clusters.AddNode.CLI"></a>

Jika Anda ingin menambahkan node ke cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) yang sudah ada yang tidak mengaktifkan replikasi, Anda harus terlebih dahulu membuat grup replikasi yang menentukan cluster yang ada sebagai primer. Untuk informasi selengkapnya, lihat [Membuat grup replikasi menggunakan cluster Valkey atau Redis OSS yang tersedia ()AWS CLI](Replication.CreatingReplGroup.ExistingCluster.md#Replication.CreatingReplGroup.ExistingCluster.CLI). Setelah grup replikasi menjadi *tersedia*, Anda dapat melanjutkan proses berikut.

Untuk menambahkan node ke cluster menggunakan AWS CLI, gunakan AWS CLI operasi `increase-replica-count` dengan parameter berikut:
+ `--replication-group-id` – ID grup replikasi yang ingin ditambahi simpul.
+ `--new-replica-count` menentukan jumlah simpul yang diinginkan dalam grup replikasi ini setelah perubahan diterapkan. Untuk menambahkan simpul ke klaster ini, `--new-replica-count` harus lebih besar dari jumlah simpul saat ini dalam klaster.
+ `--apply-immediately` atau `--no-apply-immediately` yang menentukan apakah akan menambahkan simpul ini secara langsung atau pada periode pemeliharaan berikutnya.

Untuk Linux, macOS, atau Unix:

```
aws elasticache increase-replica-count \
    --replication-group-id my-replication-group \
    --new-replica-count 4 \
    --apply-immediately
```

Untuk Windows:

```
aws elasticache increase-replica-count ^
    --replication-group-id my-replication-group ^
    --new-replica-count 4 ^
    --apply-immediately
```

Operasi ini menghasilkan output seperti yang berikut ini (format JSON):

```
{
    "ReplicationGroup": {
        "ReplicationGroupId": "node-test",
        "Description": "node-test",       
        "Status": "modifying",
        "PendingModifiedValues": {},
        "MemberClusters": [
            "node-test-001",
            "node-test-002",
            "node-test-003",
            "node-test-004",
            "node-test-005"
        ],
        "NodeGroups": [
            {
                "NodeGroupId": "0001",
                "Status": "modifying",
                "PrimaryEndpoint": {
                    "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                    "Port": 6379
                },
                "ReaderEndpoint": {
                    "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                    "Port": 6379
                },
                "NodeGroupMembers": [
                    {
                        "CacheClusterId": "node-test-001",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "node-test-001.zzzzzz.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2a",
                        "CurrentRole": "primary"
                    },
                    {
                        "CacheClusterId": "node-test-002",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "node-test-002.zzzzzz.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2c",
                        "CurrentRole": "replica"
                    },
                    {
                        "CacheClusterId": "node-test-003",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "node-test-003.zzzzzz.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2b",
                        "CurrentRole": "replica"
                    }
                ]
            }
        ],
        "SnapshottingClusterId": "node-test-002",
        "AutomaticFailover": "enabled",
        "MultiAZ": "enabled",
        "SnapshotRetentionLimit": 1,
        "SnapshotWindow": "07:30-08:30",
        "ClusterEnabled": false,
        "CacheNodeType": "cache.r5.large",
         "DataTiering": "disabled",
        "TransitEncryptionEnabled": false,
        "AtRestEncryptionEnabled": false,
        "ARN": "arn:aws:elasticache:us-west-2:123456789012:replicationgroup:node-test"
    }
}
```

Untuk informasi lebih lanjut, lihat AWS CLI topiknya [https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html).

## Menggunakan ElastiCache API
<a name="Clusters.AddNode.API"></a>

Jika Anda ingin menambahkan node ke cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) yang sudah ada yang tidak mengaktifkan replikasi, Anda harus terlebih dahulu membuat grup replikasi yang menentukan cluster yang ada sebagai Primer. Untuk informasi selengkapnya, lihat [Menambahkan replika ke cluster Valkey atau Redis OSS (Cluster Mode Disabled) mandiri (API) ElastiCache](Replication.CreatingReplGroup.ExistingCluster.md#Replication.CreatingReplGroup.ExistingCluster.API). Setelah grup replikasi menjadi *tersedia*, Anda dapat melanjutkan proses berikut.

**Untuk menambahkan node ke cluster (ElastiCache API)**
+ Panggil operasi API `IncreaseReplicaCount` dengan parameter berikut ini:
  + `ReplicationGroupId` – ID dari klaster yang ingin ditambahi simpul.
  + `NewReplicaCount` – Parameter `NewReplicaCount` menentukan jumlah simpul yang diinginkan dalam klaster ini setelah perubahan diterapkan. Untuk menambahkan simpul ke klaster ini, `NewReplicaCount` harus lebih besar dari jumlah simpul saat ini dalam klaster. Jika nilai ini kurang dari jumlah simpul saat ini, gunakan API `DecreaseReplicaCount` dengan jumlah simpul yang akan dihapus dari klaster.
  + `ApplyImmediately` – Menentukan apakah akan menambahkan simpul ini secara langsung atau pada periode pemeliharaan berikutnya.
  + `Region`Menentukan AWS Wilayah cluster yang ingin Anda tambahkan node ke.

  Contoh berikut menunjukkan panggilan untuk menambahkan simpul ke klaster.  
**Example**  

  ```
  https://elasticache.us-west-2.amazonaws.com/
      ?Action=IncreaseReplicaCount
      &ApplyImmediately=true
      &NumCacheNodes=4
      &ReplicationGroupId=my-replication-group
      &Region=us-east-2
      &Version=2014-12-01
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20141201T220302Z
      &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
      &X-Amz-Date=20141201T220302Z
      &X-Amz-SignedHeaders=Host
      &X-Amz-Expires=20141201T220302Z
      &X-Amz-Credential=<credential>
      &X-Amz-Signature=<signature>
  ```

Untuk informasi selengkapnya, lihat topik ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html).

## Menggunakan ElastiCache API
<a name="Clusters.AddNode.API"></a>

**Untuk menambahkan node ke cluster (ElastiCache API)**
+ Panggil operasi API `ModifyCacheCluster` dengan parameter berikut ini:
  + `CacheClusterId` – ID dari klaster yang ingin ditambahi simpul.
  + `NumCacheNodes` – Parameter `NumCachNodes` menentukan jumlah simpul yang diinginkan dalam klaster ini setelah perubahan diterapkan. Untuk menambahkan simpul ke klaster ini, `NumCacheNodes` harus lebih besar dari jumlah simpul saat ini dalam klaster. Jika nilai ini kurang dari jumlah node saat ini, ElastiCache mengharapkan parameter `CacheNodeIdsToRemove` dengan daftar node untuk dihapus dari cluster (lihat[Menggunakan ElastiCache API dengan Memcached](Clusters.DeleteNode.md#Clusters.DeleteNode.API)).
  + `ApplyImmediately` – Menentukan apakah akan menambahkan simpul ini secara langsung atau pada periode pemeliharaan berikutnya.
  + `Region`Menentukan AWS Wilayah cluster yang ingin Anda tambahkan node ke.

  Contoh berikut menunjukkan panggilan untuk menambahkan simpul ke klaster.  
**Example**  

  ```
  https://elasticache.us-west-2.amazonaws.com/
      ?Action=ModifyCacheCluster
      &ApplyImmediately=true
      &NumCacheNodes=5
  	&CacheClusterId=my-cluster
  	&Region=us-east-2
      &Version=2014-12-01
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20141201T220302Z
      &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
      &X-Amz-Date=20141201T220302Z
      &X-Amz-SignedHeaders=Host
      &X-Amz-Expires=20141201T220302Z
      &X-Amz-Credential=<credential>
      &X-Amz-Signature=<signature>
  ```

Untuk informasi selengkapnya, lihat topik ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html).

# Menghapus node dari ElastiCache cluster
<a name="Clusters.DeleteNode"></a>

Anda dapat menghapus node dari cluster Valkey, Memcached, atau Redis OSS menggunakan Konsol Manajemen AWS, the AWS CLI, atau API. ElastiCache 

**catatan**  
Setiap kali Anda mengubah jumlah simpul dalam klaster Memcached, Anda harus memetakan ulang setidaknya beberapa ruang kunci Anda agar dipetakan ke simpul yang benar. Untuk informasi yang lebih mendetail tentang penyeimbangan beban klaster Memcached, lihat [Mengkonfigurasi ElastiCache klien Anda untuk penyeimbangan beban yang efisien (Memcached)](BestPractices.LoadBalancing.md).

## Menggunakan ElastiCache Konsol Manajemen AWS
<a name="Clusters.DeleteNode.CON"></a>

**Untuk menghapus simpul dari klaster (konsol)**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari daftar di sudut kanan atas, pilih AWS Wilayah cluster yang ingin Anda hapus node.

1. Di panel navigasi, pilih mesin yang berjalan pada klaster yang ingin dihapus simpulnya itu.

   Daftar klaster yang menjalankan mesin yang dipilih akan muncul.

1. Dari daftar klaster, pilih nama klaster yang ingin dihapus simpulnya.

   Daftar simpul klaster akan muncul.

1. Pilih kotak di sebelah kiri ID simpul untuk simpul yang ingin dihapus. Menggunakan konsol ElastiCache , Anda hanya dapat menghapus satu simpul pada satu saat, sehingga memilih beberapa simpul berarti bahwa Anda tidak dapat menggunakan tombol **Hapus Simpul**.

   Halaman *Hapus Simpul* muncul.

1. Untuk menghapus simpul, lengkapi halaman **Hapus Simpul** dan pilih **Hapus Simpul**. Untuk mempertahankan simpul, pilih **Batalkan**.
**penting**  
Dengan Valkey atau Redis OSS, jika Anda menghapus hasil node di cluster yang tidak lagi sesuai dengan Multi-AZ, pastikan untuk terlebih dahulu menghapus kotak centang **Multi-AZ** dan kemudian hapus node. Jika Anda menghapus kotak centang **Multi-AZ**, Anda dapat memilih untuk mengaktifkan **Failover otomatis**.


**Dampak Permintaan Penambahan dan Penghapusan Baru pada Permintaan Tertunda**  

| Skenario | Operasi Tertunda | Permintaan Baru | Hasil | 
| --- | --- | --- | --- | 
|  Skenario 1 |  Hapus | Hapus |  Permintaan penghapusan baru, tertunda atau langsung, akan menggantikan permintaan penghapusan yang tertunda. Misalnya, jika ada penghapusan tertunda untuk simpul 0001, 0003, dan 0007 dan permintaan baru untuk menghapus simpul 0002 dan 0004 dikirimkan, hanya simpul 0002 dan 0004 yang akan dihapus. Simpul 0001, 0003, dan 0007 tidak akan dihapus. | 
|  Skenario 2 |  Hapus |  Buat |  Permintaan pembuatan baru, tertunda atau langsung, akan menggantikan permintaan penghapusan tertunda. Misalnya, jika penghapusan simpul 0001, 0003, dan 0007 tertunda dan permintaan baru untuk membuat simpul dibuat, simpul baru akan dibuat dan simpul 0001, 0003, dan 0007 tidak akan dihapus. | 
|  Skenario 3 |  Buat |  Hapus |  Permintaan penghapusan baru, tertunda atau langsung, akan menggantikan permintaan pembuatan tertunda. Misalnya, jika ada permintaan tertunda untuk membuat dua simpul dan permintaan baru dibuat untuk menghapus simpul 0003, tidak ada simpul baru yang akan dibuat dan simpul 0003 akan dihapus. | 
|  Skenario 4 |  Buat |  Buat |  Permintaan pembuatan baru ditambahkan ke permintaan pembuatan yang tertunda. Misalnya, jika ada permintaan tertunda untuk membuat dua simpul dan permintaan baru dibuat untuk membuat tiga simpul, permintaan baru ditambahkan ke permintaan tertunda dan lima simpul akan dibuat. Jika permintaan pembuatan baru diatur ke **Terapkan Segera - Ya**, semua permintaan pembuatan akan dilakukan segera. Jika permintaan pembuatan baru diatur ke **Terapkan Segera - Tidak**, semua permintaan pembuatan akan ditunda. | 

Untuk menentukan operasi apa yang tertunda, pilih tab **Deskripsi** dan periksa untuk melihat berapa banyak pembuatan atau penghapusan tertunda yang ditampilkan. Anda tidak dapat memiliki pembuatan tertunda dan penghapusan tertunda sekaligus. 

## Menggunakan AWS CLI dengan ElastiCache
<a name="Clusters.DeleteNode.CLI"></a>

1.  IDs Identifikasi node yang ingin Anda hapus. Untuk informasi selengkapnya, lihat [Melihat detail ElastiCache cluster](Clusters.ViewDetails.md).

1. Gunakan operasi CLI `decrease-replica-count` dengan daftar simpul yang akan dihapus, seperti dalam contoh berikut.

   Untuk menghapus simpul dari klaster menggunakan antarmuka baris perintah, gunakan perintah `decrease-replica-count` dengan parameter berikut:
   + `--replication-group-id` – ID grup replikasi yang ingin dihapus simpulnya.
   + `--new-replica-count` – Parameter `--new-replica-count` menentukan jumlah simpul yang diinginkan dalam klaster ini setelah perubahan diterapkan.
   + `--replicas-to-remove`Daftar node IDs yang ingin Anda hapus dari cluster ini.
   + `--apply-immediately` atau `--no-apply-immediately` – Menentukan apakah akan menghapus simpul ini dengan segera atau pada periode pemeliharaan berikutnya.
   + `--region`Menentukan AWS Wilayah cluster yang ingin Anda hapus node dari.
**catatan**  
Anda bisa meneruskan hanya satu parameter `--replicas-to-remove` atau `--new-replica-count` saat memanggil operasi ini.

   Untuk Linux, macOS, atau Unix:

   ```
   aws elasticache decrease-replica-count \
       --replication-group-id my-replication-group \
       --new-replica-count 2 \   
       --region us-east-2 \
       --apply-immediately
   ```

   Untuk Windows:

   ```
   aws elasticache decrease-replica-count ^
       --replication-group-id my-replication-group ^
       --new-replica-count 3 ^   
       --region us-east-2 ^
       --apply-immediately
   ```

   Operasi ini menghasilkan output seperti yang berikut ini (format JSON):

   ```
   {
       "ReplicationGroup": {
           "ReplicationGroupId": "node-test",
           "Description": "node-test"
          },
           "Status": "modifying",
           "PendingModifiedValues": {},
           "MemberClusters": [
               "node-test-001",
               "node-test-002",
               "node-test-003",
               "node-test-004",
               "node-test-005",
               "node-test-006"
           ],
           "NodeGroups": [
               {
                   "NodeGroupId": "0001",
                   "Status": "modifying",
                   "PrimaryEndpoint": {
                       "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                       "Port": 6379
                   },
                   "ReaderEndpoint": {
                       "Address": "node-test-ro.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                       "Port": 6379
                   },
                   "NodeGroupMembers": [
                       {
                           "CacheClusterId": "node-test-001",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-001.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2a",
                           "CurrentRole": "primary"
                       },
                       {
                           "CacheClusterId": "node-test-002",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-002.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2c",
                           "CurrentRole": "replica"
                       },
                       {
                           "CacheClusterId": "node-test-003",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-003.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2b",
                           "CurrentRole": "replica"
                       },
                       {
                           "CacheClusterId": "node-test-004",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-004.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2c",
                           "CurrentRole": "replica"
                       },
                       {
                           "CacheClusterId": "node-test-005",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-005.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2b",
                           "CurrentRole": "replica"
                       },
                       {
                           "CacheClusterId": "node-test-006",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-006.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2b",
                           "CurrentRole": "replica"
                       }
                   ]
               }
           ],
           "SnapshottingClusterId": "node-test-002",
           "AutomaticFailover": "enabled",
           "MultiAZ": "enabled",
           "SnapshotRetentionLimit": 1,
           "SnapshotWindow": "07:30-08:30",
           "ClusterEnabled": false,
           "CacheNodeType": "cache.r5.large",
            "DataTiering": "disabled",
           "TransitEncryptionEnabled": false,
           "AtRestEncryptionEnabled": false,
           "ARN": "arn:aws:elasticache:us-west-2:123456789012:replicationgroup:node-test"
       }
   }
   ```

Cara lainnya, Anda dapat memanggil `decrease-replica-count` dan daripada meneruskan parameter `--new-replica-count`, Anda bisa meneruskan parameter `--replicas-to-remove`, seperti yang ditunjukkan berikut ini:

Untuk Linux, macOS, atau Unix:

```
aws elasticache decrease-replica-count \
    --replication-group-id my-replication-group \
    --replicas-to-remove node-test-003 \   
    --region us-east-2 \
    --apply-immediately
```

Untuk Windows:

```
aws elasticache decrease-replica-count ^
    --replication-group-id my-replication-group ^
    --replicas-to-remove node-test-003 ^   
    --region us-east-2 ^
    --apply-immediately
```

Untuk informasi lebih lanjut, lihat AWS CLI topiknya [https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-replica-count.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-replica-count.html).

## Menggunakan ElastiCache API dengan Valkey atau Redis OSS
<a name="Clusters.DeleteNode.API2"></a>

Untuk menghapus node menggunakan ElastiCache API, panggil operasi `DecreaseReplicaCount` API dengan Id grup replikasi dan daftar node yang akan dihapus, seperti yang ditunjukkan:
+ `ReplicationGroupId` – ID grup replikasi yang ingin dihapus simpulnya.
+ `ReplicasToRemove` – Parameter `ReplicasToRemove` menentukan jumlah simpul yang diinginkan dalam klaster ini setelah perubahan diterapkan.
+ `ApplyImmediately` – Menentukan apakah akan menghapus simpul ini dengan segera atau pada periode pemeliharaan berikutnya.
+ `Region`Menentukan AWS Wilayah cluster yang Anda ingin menghapus node dari.

Contoh berikut segera menghapus simpul 0004 dan 0005 dari klaster my-cluster.

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=DecreaseReplicaCount
    &ReplicationGroupId=my-replication-group
    &ApplyImmediately=true
    &ReplicasToRemove=node-test-003    
    &Region us-east-2
    &Version=2014-12-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20141201T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>
```

Untuk informasi selengkapnya, lihat topik ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DecreaseReplicaCount.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DecreaseReplicaCount.html).

## Menggunakan ElastiCache API dengan Memcached
<a name="Clusters.DeleteNode.API"></a>

Untuk menghapus node menggunakan ElastiCache API, panggil operasi `ModifyCacheCluster` API dengan ID cluster cache dan daftar node yang akan dihapus, seperti yang ditunjukkan:
+ `CacheClusterId`ID dari cluster yang ingin Anda hapus node dari.
+ `NumCacheNodes` – Parameter `NumCacheNodes` menentukan jumlah simpul yang diinginkan dalam klaster ini setelah perubahan diterapkan.
+ `CacheNodeIdsToRemove.member.n`Daftar node IDs untuk menghapus dari cluster.
  + `CacheNodeIdsToRemove.member.1=0004`
  + `CacheNodeIdsToRemove.member.1=0005`
+ `ApplyImmediately` – Menentukan apakah akan menghapus simpul ini dengan segera atau pada periode pemeliharaan berikutnya.
+ `Region`Menentukan AWS Wilayah cluster yang Anda ingin menghapus node dari.

Contoh berikut segera menghapus simpul 0004 dan 0005 dari klaster my-cluster.

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=ModifyCacheCluster
    &CacheClusterId=my-cluster
    &ApplyImmediately=true
    &CacheNodeIdsToRemove.member.1=0004
    &CacheNodeIdsToRemove.member.2=0005
    &NumCacheNodes=3   
    &Region us-east-2
    &Version=2014-12-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20141201T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>
```

Untuk informasi selengkapnya, lihat topik ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html).

# Membatalkan operasi tambah atau hapus node yang tertunda di ElastiCache
<a name="Clusters.CancelPending"></a>

Jika Anda memilih untuk tidak segera menerapkan perubahan ElastiCache klaster, operasi memiliki status **tertunda** hingga dilakukan di jendela pemeliharaan berikutnya. Anda dapat membatalkan operasi tambah atau hapus yang tertunda.

Untuk membatalkan operasi tambah atau hapus node yang tertunda dengan AWS CLI, gunakan `modify-cache-cluster` perintah. Setel `num-cache-nodes` sama dengan jumlah node cache saat ini di cluster, dan kemudian tambahkan `--apply-immediately` bendera. Ini akan mengesampingkan perubahan yang tertunda.

Untuk membatalkan penambahan atau penghapusan node yang tertunda:

```
aws elasticache modify-cache-cluster 
	--cache-cluster-id <your-cluster-id> 
	--num-cache-nodes <current-number-of-nodes> 
	--apply-immediately
```

Jika tidak jelas apakah ada penambahan atau penghapusan node yang tertunda, Anda dapat mengonfirmasi statusnya dengan perintah: `describe-cache-clusters`

```
aws elasticache describe-cache-clusters 
	--cache-cluster-id <your-cluster-id>
```

Setiap node yang tertunda akan muncul di `PendingModifiedValues` output. Misalnya:

```
"PendingModifiedValues": {
	"NumCacheNodes": 3
	},
```

# Menghapus cluster di ElastiCache
<a name="Clusters.Delete"></a>

Selama ElastiCache cluster dalam keadaan *tersedia*, Anda dikenakan biaya untuk itu, apakah Anda aktif menggunakannya atau tidak. Untuk menghentikan biaya, hapus klaster tersebut.

**Awas**  
Saat Anda menghapus ElastiCache klaster, snapshot manual Anda dipertahankan. Anda juga dapat membuat snapshot akhir sebelum klaster dihapus. Snapshot cache otomatis tidak dipertahankan.

## Menggunakan Konsol Manajemen AWS
<a name="Clusters.Delete.CON"></a>

Prosedur berikut menghapus satu klaster dari deployment Anda. Untuk menghapus beberapa klaster, ulangi prosedur untuk setiap klaster yang ingin dihapus. Anda tidak perlu menunggu satu klaster selesai dihapus sebelum memulai prosedur untuk menghapus klaster lain.

**Untuk menghapus klaster**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol Amazon di [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Di dasbor ElastiCache mesin, pilih mesin yang berjalan di cluster yang ingin Anda hapus.

   Daftar semua klaster yang menjalankan mesin tersebut akan muncul.

1. Untuk memilih klaster yang akan dihapus, pilih nama klaster tersebut dari daftar klaster.
**penting**  
Anda hanya dapat menghapus satu cluster pada satu waktu dari ElastiCache konsol. Memilih beberapa klaster akan menonaktifkan operasi penghapusan.

1. Untuk **Tindakan**, pilih **Hapus**.

1. Pada layar konfirmasi **Hapus Klaster**, pilih **Hapus** untuk menghapus klaster, atau **Batal** untuk mempertahankan klaster.

   Jika Anda memilih **Hapus**, status klaster berubah menjadi *menghapus*.

Segera setelah klaster Anda tidak lagi tercantum dalam daftar klaster, Anda berhenti dikenai biaya untuk klaster tersebut.

## Menggunakan AWS CLI untuk menghapus ElastiCache cluster
<a name="Clusters.Delete.CLI"></a>

Kode berikut menghapus ElastiCache cluster`my-cluster`.

```
aws elasticache delete-cache-cluster --cache-cluster-id my-cluster
```

Tindakan `delete-cache-cluster` CLI hanya menghapus satu cluster. Untuk menghapus beberapa cluster, panggil `delete-cache-cluster` setiap cluster cache yang ingin Anda hapus. Anda tidak perlu menunggu satu cluster selesai menghapus sebelum menghapus yang lain.

Untuk Linux, macOS, atau Unix:

```
aws elasticache delete-cache-cluster \
    --cache-cluster-id my-cluster \
    --region us-east-2
```

Untuk Windows:

```
aws elasticache delete-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --region us-east-2
```

Untuk informasi selengkapnya, lihat ElastiCache topik AWS CLI untuk [https://docs.aws.amazon.com/cli/latest/reference/elasticache/delete-cache-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/delete-cache-cluster.html).

## Menggunakan ElastiCache API
<a name="Clusters.Delete.API"></a>

Kode berikut menghapus klaster `my-cluster`.

```
https://elasticache.us-west-2.amazonaws.com/    
    ?Action=DeleteCacheCluster
    &CacheClusterId=my-cluster
    &Region us-east-2
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20150202T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20150202T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20150202T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>
```

Operasi `DeleteCacheCluster` API hanya menghapus satu cluster. Untuk menghapus beberapa cluster, panggil `DeleteCacheCluster` setiap cluster yang ingin Anda hapus. Anda tidak perlu menunggu satu cluster selesai menghapus sebelum menghapus yang lain.

Untuk informasi selengkapnya, lihat topik referensi ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DeleteCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DeleteCacheCluster.html).

# Mengakses ElastiCache klaster atau grup replikasi
<a name="accessing-elasticache"></a>

 ElastiCache Instans Amazon Anda dirancang untuk diakses melalui EC2 instans Amazon.

Jika meluncurkan ElastiCache instans di Amazon Virtual Private Cloud (Amazon VPC), Anda dapat mengakses ElastiCache instans dari instans Amazon EC2 di VPC Amazon yang sama. Atau, dengan menggunakan VPC peering, Anda dapat mengakses ElastiCache instans Anda dari Amazon EC2 di VPC Amazon yang berbeda.

Jika meluncurkan ElastiCache instans di EC2 Classic, Anda mengizinkan EC2 instans mengakses klaster Anda dengan memberikan grup EC2 keamanan Amazon yang terkait dengan akses instans ke grup keamanan cache Anda. Secara default, akses ke klaster dibatasi pada akun yang meluncurkan klaster tersebut.

**Topics**
+ [

## Memberikan akses ke klasteratau grup replikasi Anda
](#grant-access)

## Memberikan akses ke klasteratau grup replikasi Anda
<a name="grant-access"></a>

### Anda meluncurkan cluster Anda ke EC2 -VPC
<a name="authorize-access-vpc"></a>

Jika meluncurkan klaster ke Amazon Virtual Private Cloud (Amazon VPC), Anda dapat terhubung ke ElastiCache klaster hanya dari EC2 instans Amazon yang berjalan di VPC Amazon yang sama. Dalam hal ini, Anda akan perlu memberikan izin masuk jaringan ke klaster.

**catatan**  
Pastikan Anda telah mengaktifkan *Zona Lokal* jika Anda menggunakannya. Untuk informasi selengkapnya, lihat [Mengaktifkan Zona Lokal](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/using-regions-availability-zones.html#opt-in-local-zone). Dengan mengaktifkannya, VPC Anda diperluas ke Zona Lokal dan VPC Anda akan memperlakukan subnet seperti subnet apa pun di Zona Ketersediaan yang lain. Gateway, tabel rute dan pertimbangan grup keamanan lainnya yang berkaitan akan menyesuaikan secara otomatis.

**Untuk memberikan izin masuk jaringan dari grup keamanan Amazon VPC ke klaster**

1. Masuk ke Konsol Manajemen AWS dan buka EC2 konsol Amazon di [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Pada panel navigasi, di bagian **Jaringan & Keamanan**, pilih **Grup Keamanan**.

1. Dari daftar grup keamanan, pilih grup keamanan untuk Amazon VPC Anda. Kecuali Anda membuat grup keamanan untuk ElastiCache digunakan, grup keamanan ini akan diberi nama *default*.

1. Pilih tab **Masuk**, lalu lakukan hal berikut:

   1. Pilih **Edit**.

   1. Pilih **Tambahkan aturan**.

   1. Di kolom **Jenis**, pilih **Aturan TCP kustom**.

   1. Di kotak **Rentang port**, ketik nomor port untuk simpul klaster Anda. Nomor ini harus sama dengan yang Anda tentukan saat meluncurkan klaster. Port default untuk Memcached adalah **11211** Port default untuk Valkey dan Redis OSS adalah. **6379**

   1. Di kotak **Sumber**, pilih **Anywhere** yang memiliki rentang port (0.0.0.0/0) sehingga EC2 instans Amazon apa pun yang Anda luncurkan dalam VPC Amazon Anda dapat terhubung ke node Anda. ElastiCache 
**penting**  
Membuka ElastiCache cluster ke 0.0.0.0/0 tidak mengekspos cluster ke Internet karena tidak memiliki alamat IP publik dan oleh karena itu tidak dapat diakses dari luar VPC. Namun, grup keamanan default dapat diterapkan ke EC2 instans Amazon lainnya di akun pelanggan, dan instans tersebut mungkin memiliki alamat IP publik. Jika instans tersebut menjalankan sesuatu di port default, layanan tersebut dapat terekspos secara tak disengaja. Oleh karena itu, sebaiknya membuat Grup Keamanan VPC yang akan digunakan secara eksklusif oleh ElastiCache. Untuk informasi selengkapnya, lihat [Grup Keamanan Kustom](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html#creating-your-own-security-groups).

   1. Pilih **Simpan**.

Saat Anda meluncurkan EC2 instans Amazon ke VPC Amazon Anda, instance itu akan dapat terhubung ke cluster Anda ElastiCache .

### Mengakses ElastiCache sumber daya dari luar AWS
<a name="access-from-outside-aws"></a>

Amazon ElastiCache adalah AWS layanan yang menyediakan penyimpanan nilai kunci dalam memori berbasis cloud. Layanan ini dirancang untuk diakses secara eksklusif dari dalam AWS. Namun, jika ElastiCache cluster di-host di dalam VPC, Anda dapat menggunakan instance Network Address Translation (NAT) untuk menyediakan akses luar.

#### Persyaratan
<a name="access-from-outside-aws-requirements"></a>

Persyaratan berikut harus dipenuhi agar Anda dapat mengakses ElastiCache sumber daya Anda dari luar AWS:
+ Klaster harus berada dalam VPC dan diakses melalui instans Network Address Translation (NAT). Tidak ada pengecualian untuk persyaratan ini.
+ Instans NAT harus diluncurkan di VPC yang sama dengan klaster.
+ Instans NAT harus diluncurkan di subnet publik yang terpisah dari klaster.
+ Alamat IP Elastis (EIP) harus dikaitkan dengan instans NAT. Fitur penerusan port iptables digunakan untuk meneruskan port di instans NAT ke port simpul cache dalam VPC.

#### Pertimbangan-pertimbangan
<a name="access-from-outside-aws-considerations"></a>

Pertimbangan berikut harus diingat saat mengakses ElastiCache sumber daya Anda dari luar. ElastiCache
+ Klien terhubung ke port EIP dan cache dari instans NAT. Port forwarding pada instance NAT meneruskan lalu lintas ke node cluster yang sesuai.
+ Jika simpul klaster ditambahkan atau diganti, aturan iptables perlu diperbarui untuk mencerminkan perubahan ini.

#### Batasan
<a name="access-from-outside-aws-limitations"></a>

Pendekatan ini harus digunakan untuk tujuan pengujian dan pengembangan saja. Sebaiknya jangan digunakan untuk produksi karena batasan berikut:
+ Instans NAT bertindak sebagai perantara antara klien dan beberapa klaster. Penambahan proxy berdampak pada kinerja cluster. Dampaknya meningkat dengan jumlah cluster yang Anda akses melalui instance NAT.
+ Lalu lintas dari klien ke instans NAT tidak terenkripsi. Oleh karena itu, Anda harus menghindari pengiriman data sensitif melalui instans NAT.
+ Instans NAT menambahkan overhead untuk memelihara instans lain.
+ Instans NAT berfungsi sebagai satu titik kegagalan. Untuk informasi tentang cara mengatur NAT ketersediaan tinggi di VPC, lihat [Ketersediaan Tinggi untuk Instans NAT Amazon VPC: Contoh](https://aws.amazon.com/articles/2781451301784570).

#### Cara mengakses ElastiCache sumber daya dari luar AWS
<a name="access-from-outside-aws-how-to"></a>

Prosedur berikut menunjukkan cara menghubungkan ke ElastiCache sumber daya Anda menggunakan instance NAT.

Langkah-langkah ini mengasumsikan hal berikut:
+ `iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 6380 -j DNAT --to 10.0.1.231:6379`
+ `iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 6381 -j DNAT --to 10.0.1.232:6379`

Selanjutnya Anda membutuhkan NAT ke arah yang berlawanan:

`iptables -t nat -A POSTROUTING -o eth0 -j SNAT --to-source 10.0.0.55`

Anda juga perlu mengaktifkan penerusan IP, yang dinonaktifkan secara default:

`sudo sed -i 's/net.ipv4.ip_forward=0/net.ipv4.ip_forward=1/g' /etc/sysctl.conf sudo sysctl --system`
+ Anda mengakses klaster Memcached dengan:
  + Alamat IP – *10.0.1.230*
  + Port Memcached default – *11211*
  + Grup keamanan – *\$110\$1.0\$1.0\$1.55\$1*
+ Anda mengakses cluster Valkey atau Redis OSS dengan:
  + Alamat IP – *10.0.1.230*
  + Port standar - *6379*
  + Grup keamanan – *sg-bd56b7da*
  + AWS alamat IP instance — *198.99.100.27*
+ Klien tepercaya Anda memiliki alamat IP *198.51.100.27*.
+ Instans NAT Anda memiliki Alamat IP Elastis *203.0.113.73*.
+ Instans NAT Anda memiliki grup keamanan *sg-ce56b7a9*.



**Untuk terhubung ke ElastiCache sumber daya Anda menggunakan instans NAT**

1. Buat instance NAT di VPC yang sama dengan cluster Anda tetapi di subnet publik.

   Secara default, wizard VPC akan meluncurkan jenis simpul *cache.m1.small*. Anda harus memilih ukuran simpul berdasarkan kebutuhan Anda. Anda harus menggunakan EC2 NAT AMI untuk dapat mengakses ElastiCache dari luar AWS.

   Untuk informasi tentang membuat instance NAT, lihat [Instans NAT di Panduan Pengguna](https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_NAT_Instance.html) VPC AWS.

1. Buat aturan grup keamanan untuk cluster dan instance NAT.

   Grup keamanan instans NAT dan instans klaster harus memiliki aturan berikut:
   + Dua aturan masuk
     + Dengan Memcached, aturan pertama adalah mengizinkan koneksi TCP dari klien tepercaya ke setiap port cache yang diteruskan dari instance NAT (11211 - 11213).
     + Dengan Valkey dan Redis OSS, aturan pertama adalah mengizinkan koneksi TCP dari klien tepercaya ke setiap port cache yang diteruskan dari instance NAT (6379 - 6381).
     + Aturan kedua untuk memungkinkan akses SSH ke klien tepercaya.  
**Grup keamanan instance NAT - aturan masuk dengan Memcached**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/accessing-elasticache.html)  
**Grup keamanan instans NAT - aturan masuk dengan Valkey atau Redis OSS**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/accessing-elasticache.html)
   + Dengan Memcached, aturan keluar untuk memungkinkan koneksi TCP ke port cache (11211).  
**Grup keamanan instans NAT - aturan keluar**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/accessing-elasticache.html)
   + Dengan Valkey atau Redis OSS, aturan keluar untuk memungkinkan koneksi TCP ke port cache (6379).  
**Grup keamanan instans NAT - aturan keluar**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/accessing-elasticache.html)
   + Dengan Memcached, aturan masuk untuk grup keamanan cluster yang memungkinkan koneksi TCP dari instance NAT ke port cache (11211).  
**Grup keamanan instans klaster - aturan masuk**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/accessing-elasticache.html)
   + Dengan Valkey atau Redis OSS, aturan masuk untuk grup keamanan cluster yang memungkinkan koneksi TCP dari instance NAT ke port cache (6379).  
**Grup keamanan instans klaster - aturan masuk**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/accessing-elasticache.html)

1. Validasi aturan.
   + Konfirmasikan bahwa klien tepercaya dapat melakukan SSH ke instans NAT.
   + Konfirmasikan bahwa klien tepercaya dapat terhubung ke klaster dari instans NAT.

1. **Memcache**

   Tambahkan aturan iptables ke instans NAT.

   Aturan iptables harus ditambahkan ke tabel NAT untuk setiap simpul di klaster untuk meneruskan port cache dari instans NAT ke simpul klaster. Contohnya mungkin terlihat seperti berikut:

   ```
   iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 11211 -j DNAT --to 10.0.1.230:11211
   ```

   Nomor port harus unik untuk setiap simpul di klaster. Misalnya, jika ada klaster Memcached tiga simpul menggunakan port 11211 - 11213, aturan akan terlihat seperti berikut:

   ```
   iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 11211 -j DNAT --to 10.0.1.230:11211
   iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 11212 -j DNAT --to 10.0.1.231:11211
   iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 11213 -j DNAT --to 10.0.1.232:11211
   ```

   Konfirmasikan bahwa klien tepercaya dapat terhubung ke klaster.

   Klien tepercaya harus terhubung ke EIP yang terkait dengan instans NAT dan port klaster yang sesuai dengan simpul klaster yang sesuai. Misalnya, string koneksi untuk PHP mungkin terlihat seperti berikut:

   ```
   $memcached->connect( '203.0.113.73', 11211 );
   $memcached->connect( '203.0.113.73', 11212 );
   $memcached->connect( '203.0.113.73', 11213 );
   ```

   Klien telnet juga dapat digunakan untuk memverifikasi koneksi. Contoh:

   ```
   telnet 203.0.113.73 11211
   telnet 203.0.113.73 11212
   telnet 203.0.113.73 11213
   ```

   **Valkey atau Redis OSS**

   Tambahkan aturan iptables ke instans NAT.

   Aturan iptables harus ditambahkan ke tabel NAT untuk setiap simpul di klaster untuk meneruskan port cache dari instans NAT ke simpul klaster. Contohnya mungkin terlihat seperti berikut:

   ```
   iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 6379 -j DNAT --to 10.0.1.230:6379
   ```

   Nomor port harus unik untuk setiap simpul di klaster. Misalnya, jika bekerja dengan cluster Redis OSS tiga node menggunakan port 6379 - 6381, aturannya akan terlihat seperti berikut:

   ```
   iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 6379 -j DNAT --to 10.0.1.230:6379
   iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 6380 -j DNAT --to 10.0.1.231:6379
   iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 6381 -j DNAT --to 10.0.1.232:6379
   ```

   Konfirmasikan bahwa klien tepercaya dapat terhubung ke klaster.

   Klien tepercaya harus terhubung ke EIP yang terkait dengan instans NAT dan port klaster yang sesuai dengan simpul klaster yang sesuai. Misalnya, string koneksi untuk PHP mungkin terlihat seperti berikut:

   ```
   redis->connect( '203.0.113.73', 6379 );
   redis->connect( '203.0.113.73', 6380 );
   redis->connect( '203.0.113.73', 6381 );
   ```

   Klien telnet juga dapat digunakan untuk memverifikasi koneksi. Misalnya:

   ```
   telnet 203.0.113.73 6379
   telnet 203.0.113.73 6380
   telnet 203.0.113.73 6381
   ```

1. Simpan konfigurasi iptables.

   Simpan aturan setelah Anda menguji dan memverifikasinya. Jika Anda menggunakan distribusi Linux berbasis Redhat (seperti Amazon Linux), jalankan perintah berikut:

   ```
   service iptables save
   ```

#### Topik terkait
<a name="access-from-outside-aws-see-also"></a>

Topik-topik berikut mungkin menarik bagi Anda.
+ [Pola Akses untuk Mengakses ElastiCache Cache di VPC Amazon](elasticache-vpc-accessing.md)
+ [Mengakses ElastiCache Cache dari Aplikasi yang Berjalan di Pusat Data Pelanggan](elasticache-vpc-accessing.md#elasticache-vpc-accessing-data-center)
+ [Instans NAT](https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_NAT_Instance.html)
+ [Mengkonfigurasi Klien ElastiCache ](ClientConfig.md)
+ [Ketersediaan Tinggi untuk Instans NAT Amazon VPC: Contoh](https://aws.amazon.com/articles/2781451301784570)

# Menemukan titik akhir koneksi di ElastiCache
<a name="Endpoints"></a>

Aplikasi Anda terhubung ke ElastiCache klaster Anda menggunakan endpoint. Titik akhir adalah alamat unik dari simpul atau klaster.

Anda juga dapat membuat koneksi pribadi antara VPC dan titik akhir ElastiCache API Anda dengan membuat titik akhir VPC antarmuka melalui. AWS PrivateLink Untuk informasi selengkapnya, lihat [ElastiCache API dan antarmuka VPC endpoint ()AWS PrivateLink](elasticache-privatelink.md).

**Titik akhir mana yang digunakan dengan Valkey atau Redis OSS.**
+ Untuk **node mandiri**, gunakan titik akhir node untuk operasi baca dan tulis.

   
+ Untuk cluster **Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan), gunakan Endpoint** *Utama* untuk semua operasi penulisan. Gunakan *Titik Akhir Pembaca* untuk membagi koneksi masuk ke titik akhir secara merata di antara semua replika baca. Gunakan *Titik Akhir Simpul* individual untuk operasi baca (Dalam API/CLI, ini disebut sebagai Titik Akhir Baca).

   
+ Untuk cluster **Valkey atau Redis OSS (mode cluster enabled)**, gunakan *Configuration Endpoint* cluster untuk semua operasi yang mendukung perintah yang diaktifkan mode cluster. Anda harus menggunakan klien yang mendukung Valkey Cluster, atau Redis OSS Cluster pada Redis OSS 3.2 dan di atasnya. Anda masih dapat membaca dari titik akhir node individual (Dalam hal API/CLI ini disebut sebagai Read Endpoints).

   

Bagian berikut memandu Anda menemukan titik akhir yang Anda perlukan untuk mesin yang sedang Anda jalankan.

**Titik akhir mana yang akan digunakan dengan Memcached.**

Untuk **cache ElastiCache tanpa server untuk Memcached**, cukup dapatkan DNS dan port titik akhir cluster dari konsol.

Dari AWS CLI, gunakan `describe-serverless-caches` perintah untuk memperoleh informasi Endpoint.

Linux

```
aws elasticache describe-serverless-caches --serverless-cache-name CacheName
```

Windows

```
aws elasticache describe-serverless-caches --serverless-cache-name CacheName
```

Output dari operasi di atas terlihat seperti berikut ini (format JSON):

```
{
    "ServerlessCaches": [
        {
            "ServerlessCacheName": "serverless-memcached",
            "Description": "test",
            "CreateTime": 1697659642.136,
            "Status": "available",
            "Engine": "memcached",
            "MajorEngineVersion": "1.6",
            "FullEngineVersion": "21",
            "SecurityGroupIds": [
                "sg-083eda453e1e51310"
            ],
            "Endpoint": {
                "Address": "serverless-memcached-01.amazonaws.com",
                "Port":11211
            },
            "ARN": "<the ARN>",
            "SubnetIds": [
                "subnet-0cf759df15bd4dc65",
                "subnet-09e1307e8f1560d17"
            ],
            "SnapshotRetentionLimit": 0,
            "DailySnapshotTime": "03:00"
        }
    ]
}
```

Untuk **cluster Memcached berbasis instance**, jika Anda menggunakan Automatic Discovery maka Anda dapat menggunakan *titik akhir konfigurasi cluster untuk mengonfigurasi* klien Memcached Anda. Hal ini berarti Anda harus menggunakan klien yang mendukung Penemuan Otomatis.

Jika tidak menggunakan Penemuan Otomatis, Anda harus mengonfigurasi klien Anda untuk menggunakan titik akhir simpul individual untuk operasi baca dan tulis. Anda juga harus melacak titik akhir saat menambahkan dan menghapus simpul.

## Menemukan Titik Akhir Cluster Valkey atau Redis OSS (Mode Cluster Dinonaktifkan) (Konsol)
<a name="Endpoints.Find.Redis"></a>

Jika cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) hanya memiliki satu node, titik akhir node digunakan untuk membaca dan menulis. *Jika klaster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) memiliki beberapa node, ada tiga jenis titik akhir; titik akhir *primer, titik akhir *pembaca* dan titik akhir* node.*

Titik akhir primer adalah nama DNS yang selalu diresolusi ke simpul primer di klaster. Titik akhir primer tidak terpengaruh oleh perubahan klaster Anda, seperti promosi replika baca ke peran primer. Untuk aktivitas tulis, sebaiknya aplikasi Anda terhubung ke titik akhir primer.

Titik akhir pembaca akan membagi koneksi masuk secara merata ke titik akhir antara semua replika baca di cluster ElastiCache for Redis OSS. Faktor lain seperti saat aplikasi membuat koneksi atau cara aplikasi menggunakan atau menggunakan ulang koneksi akan menentukan distribusi lalu lintas. Titik akhir pembaca tetap mengikuti perubahan klaster dalam waktu nyata saat replika ditambahkan atau dihapus. Anda dapat menempatkan beberapa replika baca klaster Redis OSS Anda ElastiCache di AWS Availability Zones (AZ) yang berbeda untuk memastikan ketersediaan titik akhir pembaca yang tinggi. 

**catatan**  
Titik akhir pembaca bukan penyeimbang beban. Ini adalah catatan DNS yang akan diresolusi sebagai alamat IP dari salah satu simpul replika dengan metode round robin.

Untuk aktivitas baca, aplikasi juga dapat menghubungkan ke simpul mana pun di klaster. Tidak seperti titik akhir primer, titik akhir simpul diresolusi ke titik akhir tertentu. Jika Anda membuat perubahan dalam klaster Anda, seperti menambahkan atau menghapus replika, Anda harus memperbarui titik akhir simpul di aplikasi Anda.

**Untuk menemukan titik akhir cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan)**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari panel navigasi, pilih cluster **Valkey atau cluster** **Redis** OSS.

   Layar cluster akan muncul dengan daftar Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) dan Valkey atau Redis OSS (mode cluster diaktifkan) cluster.

1. Untuk menemukan titik akhir and/or Pembaca Utama klaster, pilih nama cluster (bukan tombol di sebelah kirinya).  
![\[Gambar: Titik akhir utama untuk cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan)\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/Reader-Endpoint.png)

   *Titik akhir Primer dan Pembaca untuk cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan)*

   Jika hanya ada satu simpul dalam klaster, berarti tidak ada titik akhir primer dan Anda dapat melanjutkan ke langkah berikutnya.

1. **Jika cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) memiliki node replika, Anda dapat menemukan titik akhir node replika cluster dengan memilih nama cluster dan kemudian memilih tab Nodes.**

   Layar simpul muncul dengan setiap simpul yang ada di klaster, primer dan replika, yang tercantum dengan titik akhirnya.  
![\[Gambar: Titik akhir node untuk cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan)\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/ElastiCache-Endpoints-Redis-Node.png)

   *Titik akhir node untuk cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan)*

1. Untuk menyalin titik akhir ke clipboard Anda:

   1. Temukan satu per satu titik akhir yang ingin Anda salin.

   1. Pilih ikon salin langsung di depan titik akhir.

   Titik akhir sekarang disalin ke clipboard Anda. Untuk informasi tentang menggunakan titik akhir agar terhubung ke simpul, lihat [Menghubungkan ke node Memcached](nodes-connecting.md#nodes-connecting.mem).

Titik akhir utama Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) terlihat seperti berikut ini. Ada perbedaan yang tergantung pada apakah enkripsi Bergerak aktif atau tidak.

**Enkripsi bergerak tidak diaktifkan**

```
clusterName.xxxxxx.nodeId.regionAndAz.cache.amazonaws.com:port
			
redis-01.7abc2d.0001.usw2.cache.amazonaws.com:6379
```

**Enkripsi bergerak diaktifkan**

```
master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port

master.ncit.ameaqx.use1.cache.amazonaws.com:6379
```

## Menemukan Titik Akhir untuk Cluster Valkey atau Redis OSS (Mode Cluster Diaktifkan) (Konsol)
<a name="Endpoints.Find.RedisCluster"></a>

Cluster Valkey atau Redis OSS (mode cluster enabled) memiliki titik akhir konfigurasi tunggal. Dengan terhubung ke titik akhir konfigurasi, aplikasi Anda mampu menemukan titik akhir primer dan baca untuk setiap serpihan di klaster.

**Untuk menemukan titik akhir cluster Valkey atau Redis OSS (mode cluster enabled)**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Dari panel navigasi, pilih cluster **Valkey atau cluster** **Redis** OSS.

   Layar cluster akan muncul dengan daftar cluster. Pilih cluster yang ingin Anda sambungkan.

1. Untuk menemukan titik akhir Konfigurasi klaster, pilih nama klaster (bukan tombol radio).

1. **Titik akhir konfigurasi** ditampilkan di bagian **Detail klaster**. Untuk menyalinnya, pilih ikon *salin* di sebelah kiri titik akhir. 

## Menemukan Titik Akhir Cluster (Konsol) (Memcached)
<a name="Endpoints.Find.Memcached"></a>

Semua titik akhir Memcached adalah titik akhir. read/write Untuk terhubung ke simpul dalam klaster Memcached, aplikasi Anda dapat menggunakan titik akhir untuk setiap simpul, atau titik akhir konfigurasi dari klaster bersama dengan Penemuan Otomatis. Untuk menggunakan Penemuan Otomatis, Anda harus menggunakan klien yang mendukung Penemuan Otomatis.

Saat menggunakan Penemuan Otomatis, aplikasi klien Anda terhubung ke klaster Memcached Anda menggunakan titik akhir konfigurasi. Begitu Anda menskalakan klaster Anda dengan menambahkan atau menghapus simpul, aplikasi Anda akan secara otomatis "mengetahui" semua simpul dalam klaster dan dapat terhubung ke semua simpul tersebut. Tanpa Penemuan Otomatis, aplikasi Anda harus melakukannya, atau Anda harus secara manual memperbarui titik akhir dalam aplikasi Anda setiap kali Anda menambahkan atau menghapus simpul. 

Untuk menyalin titik akhir, pilih ikon salin secara langsung di depan alamat titik akhir. Untuk informasi tentang menggunakan titik akhir agar terhubung ke simpul, lihat [Menghubungkan ke node Memcached](nodes-connecting.md#nodes-connecting.mem).

Titik akhir konfigurasi dan simpul terlihat sangat mirip. Perbedaannya disorot dengan **cetak tebal** seperti berikut.

```
myclustername.xxxxxx.cfg.usw2.cache.amazonaws.com:port   # configuration endpoint contains "cfg"
myclustername.xxxxxx.0001.usw2.cache.amazonaws.com:port  # node endpoint for node 0001
```

**penting**  
Jika Anda memilih untuk membuat CNAME untuk titik akhir konfigurasi Memcached, agar klien penemuan otomatis Anda mengenali CNAME sebagai titik akhir konfigurasi, Anda harus menyertakan `.cfg.` pada CNAME. 

## Menemukan Titik Akhir (AWS CLI)
<a name="Endpoints.Find.CLI"></a>

Untuk Memcached, Anda dapat menggunakan for AWS CLI Amazon ElastiCache untuk menemukan titik akhir untuk node dan cluster.

Untuk Redis OSS, Anda dapat menggunakan for AWS CLI Amazon ElastiCache untuk menemukan titik akhir untuk node, cluster, dan juga grup replikasi.

**Topics**
+ [

### Menemukan Titik Akhir untuk Simpul dan Klaster (AWS CLI)
](#Endpoints.Find.CLI.Nodes)
+ [

### Menemukan Titik Akhir untuk Grup Replikasi Valkey atau Redis OSS ()AWS CLI
](#Endpoints.Find.CLI.ReplGroups)

### Menemukan Titik Akhir untuk Simpul dan Klaster (AWS CLI)
<a name="Endpoints.Find.CLI.Nodes"></a>

Anda dapat menggunakan AWS CLI untuk menemukan titik akhir untuk cluster dan node dengan `describe-cache-clusters` perintah. Untuk cluster Valkey atau Redis OSS, perintah mengembalikan titik akhir cluster. Untuk klaster Memcached, perintah tersebut akan menampilkan titik akhir konfigurasi. Jika Anda menyertakan parameter opsional `--show-cache-node-info`, perintah tersebut juga akan menampilkan titik akhir simpul individual di klaster.

**Example**  
Perintah berikut mengambil titik akhir konfigurasi (`ConfigurationEndpoint`) dan titik akhir simpul individual (`Endpoint`) untuk klaster Memcached *mycluster*.  
Untuk Linux, macOS, atau Unix:  

```
aws elasticache describe-cache-clusters \
    --cache-cluster-id mycluster \
    --show-cache-node-info
```
Untuk Windows:  

```
aws elasticache describe-cache-clusters ^
    --cache-cluster-id mycluster ^
    --show-cache-node-info
```
Output dari operasi di atas akan terlihat seperti berikut (format JSON).  

```
{
   "CacheClusters": [
   {
       "Engine": "memcached", 
       "CacheNodes": [
          {
             "CacheNodeId": "0001", 
             "Endpoint": {
                "Port": 11211, 
                "Address": "mycluster.amazonaws.com"
             }, 
                "CacheNodeStatus": "available", 
                "ParameterGroupStatus": "in-sync", 
                "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", 
                "CustomerAvailabilityZone": "us-west-2b"
          }, 
          {
             "CacheNodeId": "0002", 
             "Endpoint": {
                "Port": 11211, 
                "Address": "mycluster.amazonaws.com"
             }, 
                "CacheNodeStatus": "available", 
                "ParameterGroupStatus": "in-sync", 
                "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", 
                "CustomerAvailabilityZone": "us-west-2b"
          }, 
          {
                "CacheNodeId": "0003", 
                "Endpoint": {
                   "Port": 11211, 
                   "Address": "mycluster.amazonaws.com"
                }, 
                   "CacheNodeStatus": "available", 
                   "ParameterGroupStatus": "in-sync", 
                   "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", 
                   "CustomerAvailabilityZone": "us-west-2b"
          }
       ], 
       "CacheParameterGroup": {
       "CacheNodeIdsToReboot": [], 
       "CacheParameterGroupName": "default.memcached1.4", 
       "ParameterApplyStatus": "in-sync"
            }, 
            "CacheClusterId": "mycluster", 
            "PreferredAvailabilityZone": "us-west-2b", 
            "ConfigurationEndpoint": {
                "Port": 11211, 
                "Address": "mycluster.amazonaws.com"
            }, 
            "CacheSecurityGroups": [], 
            "CacheClusterCreateTime": "2016-09-22T21:30:29.967Z", 
            "AutoMinorVersionUpgrade": true, 
            "CacheClusterStatus": "available", 
            "NumCacheNodes": 3, 
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", 
            "CacheSubnetGroupName": "default", 
            "EngineVersion": "1.4.24", 
            "PendingModifiedValues": {}, 
            "PreferredMaintenanceWindow": "mon:09:00-mon:10:00", 
            "CacheNodeType": "cache.m4.large",
             "DataTiering": "disabled"
        }
    ]   
}
```
Jika Anda memilih untuk membuat CNAME untuk titik akhir konfigurasi Memcached agar klien penemuan otomatis Anda mengenali CNAME sebagai titik akhir konfigurasi, Anda harus menyertakan `.cfg.` pada CNAME. Misalnya, `mycluster.cfg.local` dalam file php.ini untuk parameter `session.save_path`.

**Example**  
*Untuk Valkey dan Redis OSS, perintah berikut mengambil informasi cluster untuk mycluster single-node cluster.*  
Parameter `--cache-cluster-id` dapat digunakan dengan id cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) node tunggal atau id node tertentu dalam grup replikasi. Kelompok replikasi adalah nilai 4 digit seperti. `--cache-cluster-id` `0001` Jika `--cache-cluster-id` adalah id dari cluster (node) dalam grup replikasi, termasuk dalam output. `replication-group-id`
Untuk Linux, macOS, atau Unix:  

```
aws elasticache describe-cache-clusters \
    --cache-cluster-id redis-cluster \
    --show-cache-node-info
```
Untuk Windows:  

```
aws elasticache describe-cache-clusters ^
    --cache-cluster-id redis-cluster ^
    --show-cache-node-info
```
Output dari operasi di atas akan terlihat seperti berikut (format JSON).  

```
{
    "CacheClusters": [
        {
            "CacheClusterStatus": "available",
            "SecurityGroups": [
                {
                    "SecurityGroupId": "sg-77186e0d",
                    "Status": "active"
                }
            ],
            "CacheNodes": [
                {
                    "CustomerAvailabilityZone": "us-east-1b",
                    "CacheNodeCreateTime": "2018-04-25T18:19:28.241Z",
                    "CacheNodeStatus": "available",
                    "CacheNodeId": "0001",
                    "Endpoint": {
                        "Address": "redis-cluster.amazonaws.com",
                        "Port": 6379
                    },
                    "ParameterGroupStatus": "in-sync"
                }
            ],
            "AtRestEncryptionEnabled": false,
            "CacheClusterId": "redis-cluster",
            "TransitEncryptionEnabled": false,
            "CacheParameterGroup": {
                "ParameterApplyStatus": "in-sync",
                "CacheNodeIdsToReboot": [],
                "CacheParameterGroupName": "default.redis3.2"
            },
            "NumCacheNodes": 1,
            "PreferredAvailabilityZone": "us-east-1b",
            "AutoMinorVersionUpgrade": true,
            "Engine": "redis",
            "AuthTokenEnabled": false,
            "PendingModifiedValues": {},
            "PreferredMaintenanceWindow": "tue:08:30-tue:09:30",
            "CacheSecurityGroups": [],
            "CacheSubnetGroupName": "default",
            "CacheNodeType": "cache.t2.small",
             "DataTiering": "disabled"
            "EngineVersion": "3.2.10",
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "CacheClusterCreateTime": "2018-04-25T18:19:28.241Z"
        }
    ]
}
```

Untuk informasi lebih lanjut, lihat topiknya [describe-cache-clusters](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-cache-clusters.html).

### Menemukan Titik Akhir untuk Grup Replikasi Valkey atau Redis OSS ()AWS CLI
<a name="Endpoints.Find.CLI.ReplGroups"></a>

Anda dapat menggunakan AWS CLI untuk menemukan titik akhir untuk grup replikasi dan klaster dengan perintah. `describe-replication-groups` Perintah ini menampilkan titik akhir primer grup replikasi dan daftar semua klaster (simpul) dalam grup replikasi dengan titik akhirnya, bersama dengan titik akhir pembaca. 

Operasi berikut mengambil titik akhir primer dan titik akhir pembaca untuk grup replikasi `myreplgroup`. Gunakan titik akhir primer untuk semua operasi tulis. 

```
aws elasticache describe-replication-groups \
    --replication-group-id myreplgroup
```

Untuk Windows:

```
aws elasticache describe-replication-groups ^
    --replication-group-id myreplgroup
```

Output dari operasi ini terlihat seperti berikut (format JSON).

```
{
   "ReplicationGroups": [
     {
       "Status": "available", 
       "Description": "test", 
       "NodeGroups": [
         {
            "Status": "available", 
               "NodeGroupMembers": [
                  {
                     "CurrentRole": "primary", 
                     "PreferredAvailabilityZone": "us-west-2a", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "myreplgroup-001.amazonaws.com"
                     }, 
                     "CacheClusterId": "myreplgroup-001"
                  }, 
                  {
                     "CurrentRole": "replica", 
                     "PreferredAvailabilityZone": "us-west-2b", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "myreplgroup-002.amazonaws.com"
                     }, 
                     "CacheClusterId": "myreplgroup-002"
                  }, 
                  {
                     "CurrentRole": "replica", 
                     "PreferredAvailabilityZone": "us-west-2c", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "myreplgroup-003.amazonaws.com"
                     }, 
                     "CacheClusterId": "myreplgroup-003"
                  }
               ], 
               "NodeGroupId": "0001", 
               "PrimaryEndpoint": {
                  "Port": 6379, 
                  "Address": "myreplgroup.amazonaws.com"
               },
               "ReaderEndpoint": {
                  "Port": 6379, 
                  "Address": "myreplgroup-ro.amazonaws.com"
               }
            }
         ], 
         "ReplicationGroupId": "myreplgroup", 
         "AutomaticFailover": "enabled", 
         "SnapshottingClusterId": "myreplgroup-002", 
         "MemberClusters": [
            "myreplgroup-001", 
            "myreplgroup-002", 
            "myreplgroup-003"
         ], 
         "PendingModifiedValues": {}
      }
   ]
}
```

Untuk informasi selengkapnya, lihat [describe-replication-groups](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-replication-groups.html) dalam *AWS CLI Referensi Perintah*.

## Menemukan Titik Akhir (ElastiCache API)
<a name="Endpoints.Find.API"></a>

Untuk Memcached, Anda dapat menggunakan Amazon ElastiCache API untuk menemukan titik akhir untuk node dan cluster.

Untuk Redis OSS, Anda dapat menggunakan Amazon ElastiCache API untuk menemukan titik akhir untuk node, cluster, dan juga grup replikasi.

**Topics**
+ [

### Menemukan Endpoint untuk Node dan Cluster (API) ElastiCache
](#Endpoints.Find.API.Nodes)
+ [

### Menemukan Titik Akhir untuk Grup Replikasi Valkey atau Redis OSS (API) ElastiCache
](#Endpoints.Find.API.ReplGroups)

### Menemukan Endpoint untuk Node dan Cluster (API) ElastiCache
<a name="Endpoints.Find.API.Nodes"></a>

Anda dapat menggunakan ElastiCache API untuk menemukan titik akhir untuk klaster dan node-nya dengan `DescribeCacheClusters` tindakan tersebut. Untuk cluster Valkey atau Redis OSS, perintah mengembalikan titik akhir cluster. Untuk klaster Memcached, perintah tersebut akan menampilkan titik akhir konfigurasi. Jika Anda menyertakan parameter opsional `ShowCacheNodeInfo`, tindakan tersebut juga akan menampilkan titik akhir simpul individual di klaster.

**Example**  
*Untuk Memcached, perintah berikut mengambil konfigurasi endpoint (`ConfigurationEndpoint`) dan titik akhir node individual (`Endpoint`) untuk mycluster Memcached cluster.*  

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=DescribeCacheClusters
    &CacheClusterId=mycluster
    &ShowCacheNodeInfo=true
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20150202T192317Z
    &Version=2015-02-02
    &X-Amz-Credential=<credential>
```
Jika Anda memilih untuk membuat CNAME untuk titik akhir konfigurasi Memcached agar klien penemuan otomatis Anda mengenali CNAME sebagai titik akhir konfigurasi, Anda harus menyertakan `.cfg.` pada CNAME. Misalnya, `mycluster.cfg.local` dalam file php.ini untuk parameter `session.save_path`.

### Menemukan Titik Akhir untuk Grup Replikasi Valkey atau Redis OSS (API) ElastiCache
<a name="Endpoints.Find.API.ReplGroups"></a>

Anda dapat menggunakan ElastiCache API untuk menemukan titik akhir untuk grup replikasi dan klasternya dengan tindakan tersebut. `DescribeReplicationGroups` Perintah ini menampilkan titik akhir primer grup replikasi dan daftar semua klaster dalam grup replikasi dengan titik akhirnya, bersama dengan titik akhir pembaca. 

Operasi berikut mengambil endpoint utama (PrimaryEndpoint), endpoint pembaca () dan titik akhir node individu (ReaderEndpointReadEndpoint) untuk grup replikasi. `myreplgroup` Gunakan titik akhir primer untuk semua operasi tulis.

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=DescribeReplicationGroups
    &ReplicationGroupId=myreplgroup
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20150202T192317Z
    &Version=2015-02-02
    &X-Amz-Credential=<credential>
```

Lihat informasi yang lebih lengkap di [DescribeReplicationGroups](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeReplicationGroups.html). 

# Bekerja dengan pecahan di ElastiCache
<a name="Shards"></a>

Sebuah shard (API/CLI: node group) adalah kumpulan dari satu sampai enam ElastiCache untuk Valkey atau Redis OSS node. Cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) tidak akan pernah memiliki lebih dari satu pecahan. Dengan pecahan, Anda dapat memisahkan database besar menjadi bagian yang lebih kecil, lebih cepat, dan lebih mudah dikelola yang disebut pecahan data. Hal ini dapat meningkatkan efisiensi database dengan mendistribusikan operasi di beberapa bagian terpisah. Menggunakan pecahan dapat menawarkan banyak manfaat termasuk peningkatan kinerja, skalabilitas, dan efisiensi biaya.

Anda dapat membuat klaster dengan jumlah serpihan lebih banyak dan jumlah replika lebih sedikit dengan jumlah total hingga 90 simpul per klaster. Konfigurasi klaster ini dapat berkisar dari 90 serpihan dan 0 replika hingga 15 serpihan dan 5 replika, yang merupakan jumlah replika maksimum yang diizinkan. Data klaster dipartisi di seluruh serpihan klaster. Jika ada lebih dari satu node dalam pecahan, shard mengimplementasikan replikasi dengan satu node menjadi node read/write utama dan node lainnya read-only replika node.

Batas node atau shard dapat ditingkatkan hingga maksimum 500 per cluster jika versi mesin Valkey 7.2 dan lebih tinggi, atau Redis OSS 5.0.6 hingga 7.1. Sebagai contoh, Anda dapat memilih untuk mengonfigurasi sebuah klaster dengan 500 simpul yang berkisar antara 83 serpihan (satu primer dan 5 replika per serpihan) dan 500 serpihan (satu primer dan tanpa replika). Pastikan alamat IP yang tersedia mencukupi untuk mengakomodasi peningkatan tersebut. Kesalahan umumnya termasuk subnet dalam grup subnet memiliki rentang CIDR yang terlalu kecil atau subnet dibagikan dan banyak digunakan oleh klaster lainnya. Untuk informasi selengkapnya, lihat [Membuat grup subnet](SubnetGroups.Creating.md).

 Untuk versi di bawah 5.0.6, batasnya adalah 250 per klaster.

Untuk meminta penambahan batas, lihat [Batas layanan AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) dan pilih jenis batas **Simpul per klaster per jenis instans**. 

Saat Anda membuat cluster Valkey atau Redis OSS (mode cluster enabled) menggunakan ElastiCache konsol, Anda menentukan jumlah pecahan di cluster dan jumlah node dalam pecahan. Untuk informasi selengkapnya, lihat [Membuat cluster Valkey atau Redis OSS (mode cluster diaktifkan) (Konsol)](Clusters.Create.md#Clusters.Create.CON.RedisCluster). Jika Anda menggunakan ElastiCache API atau AWS CLI membuat klaster (disebut grup *replikasi di grup* simpulAPI/CLI), you can configure the number of nodes in a shard (API/CLI:) secara independen. Untuk informasi selengkapnya, lihat berikut ini: 
+ API: [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ CLI: [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)

Setiap simpul dalam serpihan memiliki spesifikasi komputasi, penyimpanan, dan memori yang sama. ElastiCache API memungkinkan Anda mengontrol atribut shard-wide, seperti jumlah node, pengaturan keamanan, dan jendela pemeliharaan sistem.

![\[Gambar: Konfigurasi pecahan Valkey atau Redis OSS.\]](http://docs.aws.amazon.com/id_id/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-RedisShards.png)


*Konfigurasi pecahan Valkey atau Redis OSS*

Untuk informasi selengkapnya, lihat [Resharding offline untuk Valkey atau Redis OSS (mode cluster diaktifkan)](scaling-redis-cluster-mode-enabled.md#redis-cluster-resharding-offline) dan [Resharding online untuk Valkey atau Redis OSS (mode cluster diaktifkan)](scaling-redis-cluster-mode-enabled.md#redis-cluster-resharding-online).

## Menemukan ID serpihan
<a name="shard-find-id"></a>

Anda dapat menemukan ID pecahan menggunakan Konsol Manajemen AWS, the AWS CLI atau ElastiCache API.

### Menggunakan Konsol Manajemen AWS
<a name="shard-find-id-con"></a>



**Topics**
+ [

#### Untuk Valkey atau Redis OSS (Mode Cluster Dinonaktifkan)
](#shard-find-id-con-classic)
+ [

#### Untuk Valkey atau Redis OSS (Mode Cluster Diaktifkan)
](#shard-find-id-con-cluster)

#### Untuk Valkey atau Redis OSS (Mode Cluster Dinonaktifkan)
<a name="shard-find-id-con-classic"></a>

Pecahan grup replikasi Valkey atau Redis OSS (mode cluster dinonaktifkan) selalu ada. IDs `0001`

#### Untuk Valkey atau Redis OSS (Mode Cluster Diaktifkan)
<a name="shard-find-id-con-cluster"></a>

Prosedur berikut menggunakan Konsol Manajemen AWS untuk menemukan ID pecahan grup replikasi Valkey atau Redis OSS (mode cluster enabled).

**Untuk menemukan ID pecahan dalam grup replikasi Valkey atau Redis OSS (mode cluster diaktifkan)**

1. Masuk ke Konsol Manajemen AWS dan buka ElastiCache konsol di [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Pada panel navigasi, pilih **Valkey** atau **Redis OSS**, lalu pilih nama grup replikasi Valkey atau Redis OSS (mode cluster enabled) yang ingin Anda temukan. IDs

1. Pada kolom **Nama Serpihan**, ID serpihan adalah empat digit terakhir dari nama serpihan.

### Menggunakan AWS CLI
<a name="shard-find-id-cli"></a>

Untuk menemukan id pecahan (grup simpul) untuk grup replikasi Valkey atau Redis OSS (mode cluster dinonaktifkan) atau Valkey atau Redis OSS (mode cluster diaktifkan) gunakan operasi dengan parameter opsional berikut. AWS CLI `describe-replication-groups`
+ **`--replication-group-id`**—Parameter opsional yang jika digunakan akan membatasi output pada detail grup replikasi yang ditentukan. Jika parameter ini dihilangkan, detail hingga 100 grup replikasi akan ditampilkan.

**Example**  
Perintah ini akan menampilkan detail untuk `sample-repl-group`.  
Untuk Linux, macOS, atau Unix:  

```
aws elasticache describe-replication-groups \
    --replication-group-id sample-repl-group
```
Untuk Windows:  

```
aws elasticache describe-replication-groups ^
    --replication-group-id sample-repl-group
```
Output dari perintah ini akan terlihat seperti ini. Id shard (grup simpul) ada *highlighted* di sini untuk mempermudah menemukannya.  

```
{
    "ReplicationGroups": [
        {
            "Status": "available", 
            "Description": "2 shards, 2 nodes (1 + 1 replica)", 
            "NodeGroups": [
                {
                    "Status": "available", 
                    "Slots": "0-8191", 
                    "NodeGroupId": "0001", 
                    "NodeGroupMembers": [
                        {
                            "PreferredAvailabilityZone": "us-west-2c", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "sample-repl-group-0001-001"
                        }, 
                        {
                            "PreferredAvailabilityZone": "us-west-2a", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "sample-repl-group-0001-002"
                        }
                    ]
                }, 
                {
                    "Status": "available", 
                    "Slots": "8192-16383", 
                    "NodeGroupId": "0002", 
                    "NodeGroupMembers": [
                        {
                            "PreferredAvailabilityZone": "us-west-2b", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "sample-repl-group-0002-001"
                        }, 
                        {
                            "PreferredAvailabilityZone": "us-west-2a", 
                            "CacheNodeId": "0001", 
                            "CacheClusterId": "sample-repl-group-0002-002"
                        }
                    ]
                }
            ], 
            "ConfigurationEndpoint": {
                "Port": 6379, 
                "Address": "sample-repl-group.9dcv5r.clustercfg.usw2.cache.amazonaws.com"
            }, 
            "ClusterEnabled": true, 
            "ReplicationGroupId": "sample-repl-group", 
            "SnapshotRetentionLimit": 1, 
            "AutomaticFailover": "enabled", 
            "SnapshotWindow": "13:00-14:00", 
            "MemberClusters": [
                "sample-repl-group-0001-001", 
                "sample-repl-group-0001-002", 
                "sample-repl-group-0002-001", 
                "sample-repl-group-0002-002"
            ], 
            "CacheNodeType": "cache.m3.medium", 
            "DataTiering": "disabled",
            "PendingModifiedValues": {}
        }
    ]
}
```

### Menggunakan ElastiCache API
<a name="shard-find-id-api"></a>

Untuk menemukan id pecahan (grup simpul) untuk grup replikasi Valkey atau Redis OSS (mode cluster dinonaktifkan) atau Valkey atau Redis OSS (mode cluster diaktifkan) gunakan operasi dengan parameter opsional berikut. AWS CLI `describe-replication-groups`
+ **`ReplicationGroupId`**—Parameter opsional yang jika digunakan akan membatasi output pada detail grup replikasi yang ditentukan. Jika parameter ini dihilangkan, detail hingga grup *xxx* replikasi dikembalikan.

**Example**  
Perintah ini akan menampilkan detail untuk `sample-repl-group`.  
Untuk Linux, macOS, atau Unix:  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DescribeReplicationGroup
   &ReplicationGroupId=sample-repl-group
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```