Membuat instance

Halaman ini berisi petunjuk untuk membuat instance zona tunggal dan multi-zona di Memorystore for Valkey.

Sebelum memulai

Selesaikan petunjuk sebelum memulai:

  1. Di konsol Google Cloud , pada halaman pemilih project, pilih atau buat project Google Cloud.

    Catatan: Jika Anda tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buat project baru alih-alih memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang akan menghapus semua resource yang terkait dengan project ini.


    Buka pemilih project
  2. Pastikan penagihan diaktifkan untuk project Anda. Pelajari cara memeriksa apakah penagihan telah diaktifkan pada suatu project.

  3. Instal dan lakukan inisialisasi Google Cloud CLI.

    Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update. Anda memerlukan setidaknya gcloud CLI versi 489.0.0 untuk mengakses perintah gcloud CLI Memorystore for Valkey.

  4. Aktifkan Memorystore for Valkey API
    Memorystore for Valkey
  5. Aktifkan Network Connectivity API
    Network Connectivity API
  6. Aktifkan Service Consumer Management API
    Service Consumer Management API

Prasyarat lainnya

  • Anda harus memiliki salah satu peran IAM ini di project Google Cloud yang Anda gunakan:
    • roles/memorystore.admin (peran IAM bawaan Memorystore Admin)
    • roles/owner (peran IAM dasar Pemilik)
    • roles/editor (peran IAM dasar Editor)

Menyiapkan jaringan

Baca halaman Networking untuk menentukan apakah Anda perlu menyiapkan kebijakan koneksi layanan.

Jika kebijakan koneksi layanan belum dibuat untuk jaringan tempat Anda akan membuat instance Valkey, ikuti panduan Networking untuk membuatnya.

Membuat instance multi-zona

Bagian ini memberikan petunjuk tentang cara membuat instance multi-zona.

Konsol

  1. Di konsol Google Cloud , buka halaman Memorystore for Valkey.

    Memorystore for Valkey

  2. Klik Create instance.

  3. Di bagian Name your instance, masukkan ID untuk instance. ID instance hanya boleh menggunakan huruf kecil, angka, dan tanda hubung. Nama ini juga harus diawali dengan huruf dan unik di region-nya.

  4. Dari menu Region, pilih region untuk instance Anda.

  5. Di bagian Zonal availability, pilih opsi Multi-zone karena Anda ingin membuat instance multi-zona.

  6. Di bagian Cluster Mode, tentukan apakah Anda menginginkan instance Cluster Mode Enabled atau Cluster Mode Disabled. Untuk mengetahui informasi selengkapnya tentang jenis instance ini, lihat Mengaktifkan dan menonaktifkan mode cluster.

  7. Di bagian Node Type, pilih jenis node.

  8. Di bagian Instance size, masukkan jumlah shard untuk instance Anda. Jumlah shard menentukan total kapasitas memori untuk menyimpan data instance. Untuk mengetahui informasi selengkapnya tentang spesifikasi instance, lihat Spesifikasi instance dan node.

  9. Jika Anda ingin membuat instance dengan replika, di bagian Replicas, pilih jumlah replika (per shard). Anda dapat memilih 0-5 replika. Nilai defaultnya adalah 1 replika.

  10. Di bagian Set up connection, pilih jaringan yang dapat digunakan aplikasi Anda untuk terhubung ke instance ini. Untuk mengetahui informasi selengkapnya tentang jaringan pribadi untuk Memorystore for Valkey, lihat Jaringan.

  11. Jika Anda ingin meningkatkan keamanan instance, di bagian Security, lakukan salah satu tindakan berikut:

    • Jika Anda ingin mengaktifkan autentikasi IAM, pilih opsi IAM Auth. Memorystore for Valkey menggunakan autentikasi IAM untuk membatasi akses ke instance.

    • Jika Anda ingin mengaktifkan autentikasi berbasis token dasar, pilih opsi Token Auth. Memorystore for Valkey membatasi akses ke instance dengan meminta klien menggunakan token autentikasi mereka untuk memverifikasi identitas mereka dalam aplikasi Anda.

    • Jika Anda tidak ingin mengaktifkan autentikasi IAM atau autentikasi berbasis token dasar, pilih opsi Disabled.

    Jika Anda memilih opsi IAM Auth atau Token Auth, Memorystore for Valkey akan otomatis mencentang kotak Enable In-Transit Encryption (TLS), dan bagian Certificate authority management akan ditampilkan. Memorystore for Valkey mengenkripsi kredensial Anda sehingga bersifat rahasia saat dikirim dari instance ke aplikasi.

  12. Di bagian Certificate authority management, pilih opsi Per-instance CA, Customer-managed CA, atau Shared CA. Opsi ini mewakili mode Certificate Authority (CA) untuk instance Anda. Mode CA menentukan hierarki CA yang digunakan untuk menerbitkan sertifikat digital untuk instance.

    Jika memilih opsi Customer-managed CA, Anda harus menambahkan kumpulan CA. Kumpulan CA adalah kumpulan beberapa CA dengan kebijakan penerbitan sertifikat dan kebijakan Identity and Access Management (IAM) yang sama. Kumpulan CA mempermudah pengelolaan rotasi CA dan memungkinkan Anda mencapai total kueri per detik (QPS) efektif yang lebih tinggi.

    Untuk menambahkan kumpulan CA, lakukan salah satu hal berikut:

    1. Untuk menambahkan kumpulan CA dari project Google Cloud lain, pilih kotak centang Add CA from another project, lalu masukkan ID resource untuk kumpulan tersebut di kolom teks.

    2. Untuk menambahkan kumpulan CA yang berada di project Google Cloud yang sama dengan project yang Anda gunakan untuk membuat instance, pilih kumpulan dari menu CA pool.

  13. Di bagian Encryption, pilih salah satu opsi berikut:

    • Kunci enkripsi yang dikelola Google: Anda ingin Google menggunakan kunci untuk mengenkripsi data dalam instance. Opsi ini adalah Enkripsi default Google.

    • Kunci Cloud KMS: Anda ingin mengelola enkripsi data Anda menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) di Cloud Key Management Service (Cloud KMS) dengan layanan yang terintegrasi dengan CMEK, seperti Memorystore untuk Valkey.

      Jika Anda memilih opsi ini, lakukan hal berikut:

      1. Dari menu Key management type, pilih Cloud KMS.
      2. Dari menu kunci Select a Cloud KMS, pilih CMEK.

  14. Untuk menetapkan kebijakan ACL ke instance, pilih kebijakan dari menu Policy di bagian ACL policy.

  15. Di bagian Data persistence strategy, tentukan cara Memorystore for Valkey mempertahankan data di instance Anda. Nilai yang dapat diterima adalah No persistence, Append Only File (AOF) persistence, dan Memory Snapshot persistence.

  16. Jika Anda ingin mengaktifkan pencadangan otomatis untuk instance, lakukan hal berikut:

    1. Centang kotak Automated daily backups.
    2. Di kolom Days to retain backups, masukkan jumlah hari yang Anda inginkan agar Memorystore for Valkey menyimpan cadangan sebelum dihapus secara otomatis. Anda dapat menentukan dari 1 hingga 365 hari. Nilai defaultnya adalah 35 hari.
    3. Dari menu Rentang waktu, pilih waktu untuk pencadangan harian.

  17. Di bagian Maintenance, pilih salah satu opsi berikut:

    • Default: Memorystore for Valkey mengupdate instance Anda secara rutin untuk memastikan layanan dapat diandalkan, berperforma tinggi, aman, dan selalu diupdate.
    • Kustom: Anda ingin menyesuaikan jadwal pemeliharaan untuk instance agar selaras dengan kebutuhan aplikasi dan meminimalkan gangguan. Jika Anda memilih opsi ini, tentukan hari yang Anda inginkan untuk melakukan pemeliharaan dan jam yang Anda inginkan untuk memulai masa pemeliharaan.

  18. Di bagian Choose version, pilih Valkey version. Versi yang tersedia adalah 7.2, 8.0, 9.0, dan 9.1. Versi defaultnya adalah versi 9.1.

  19. Klik Create instance.

gcloud

Untuk membuat instance Memorystore for Valkey, jalankan perintah create:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--acl-policy=ACL_POLICY_NAME \
--mode=MODE

Ganti kode berikut:

  • INSTANCE adalah ID instance Memorystore for Valkey yang Anda buat. ID instance Anda harus terdiri dari 1 hingga 63 karakter dan hanya menggunakan huruf kecil, angka, atau tanda hubung. ID ini harus dimulai dengan huruf kecil dan diakhiri dengan huruf kecil atau angka.

  • REGION_ID adalah region tempat Anda ingin menempatkan instance.

  • PROJECT_ID adalah ID project tempat Anda ingin membuat instance.

  • NETWORK_ID adalah ID jaringan yang ingin Anda gunakan untuk membuat instance.

  • REPLICA_COUNT adalah jumlah replika (per shard). Nilai yang diterima adalah 0-5.

  • NODE_TYPE adalah jenis node yang ingin Anda gunakan untuk instance.

  • ENGINE_VERSION adalah versi instance Memorystore for Valkey Anda. Nilai yang diterima untuk parameter ini adalah VALKEY_7_2, VALKEY_8_0, VALKEY_9_0, dan VALKEY_9_1. Jika Anda tidak menentukan nilai, VALKEY_9_1 adalah nilai default.

  • SHARD_COUNT menentukan jumlah shard dalam instance Anda. Jumlah shard menentukan total kapasitas memori untuk menyimpan data instance. Instance Cluster Mode Disabled hanya mendukung satu shard. Untuk mengetahui informasi selengkapnya, lihat Spesifikasi instance dan node.

  • ACL_POLICY_NAME adalah nama kebijakan daftar kontrol akses (ACL) yang Anda tetapkan ke instance yang Anda buat. Dengan menggunakan kebijakan ACL, Anda dapat mengamankan akses ke instance. Anda dapat mengaktifkan keamanan terperinci dengan membatasi akses pengguna dan layanan ke kunci, perintah, dan saluran Pub/Sub tertentu. Untuk mengetahui informasi selengkapnya, lihat Mengamankan akses ke instance Anda menggunakan kebijakan ACL.

  • MODE menentukan apakah Anda membuat instance Cluster Mode Enabled atau Cluster Mode Disabled. Jika kolom ini dihilangkan, instance akan ditetapkan secara default ke Cluster Mode Enabled. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan dan menonaktifkan Mode Cluster.

Contoh:

Contoh Mode Cluster Diaktifkan


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--replica-count=2 \
--node-type=highmem-medium \
--shard-count=8 \
--acl-policy=my-acl-policy \
--mode=cluster

Contoh Cluster Mode Disabled


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--shard-count=1 \
--replica-count=2 \
--node-type=highmem-medium \
--acl-policy=my-acl-policy \
--mode=cluster-disabled

Secara default, enkripsi dalam pengiriman dinonaktifkan dan jaringan yang diizinkan adalah default.

REST

Untuk membuat instance multi-zona, gunakan perintah REST API berikut.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project tempat Anda ingin membuat instance.

  • REGION_ID: region tempat Anda ingin menempatkan instance.

    Anda hanya dapat membuat instance di region yang didukung untuk Memorystore for Valkey.

  • INSTANCE_ID: ID instance yang Anda buat. ID instance harus terdiri dari 1 hingga 63 karakter dan hanya menggunakan huruf kecil, angka, atau tanda hubung. ID ini harus dimulai dengan huruf kecil dan diakhiri dengan huruf kecil atau angka.
  • SHARD_COUNT: jumlah shard dalam instance. Jumlah shard menentukan total kapasitas memori untuk menyimpan data instance. Instance Mode Cluster Dinonaktifkan hanya mendukung satu shard. Untuk mengetahui informasi selengkapnya, lihat Spesifikasi instance dan node.
  • REPLICA_COUNT: jumlah replika (per shard). Nilai yang diterima adalah 0 hingga 5.

  • NODE_TYPE: jenis node yang ingin Anda gunakan untuk instance. Untuk mengetahui informasi selengkapnya, lihat Memilih jenis node.

  • ENGINE_VERSION: versi instance. Nilai yang diterima adalah VALKEY_7_2, VALKEY_8_0, VALKEY_9_0, dan VALKEY_9_1. Jika Anda tidak menentukan nilai, VALKEY_9_1 adalah nilai default.

  • MODE: mode instance. Nilai ini menentukan apakah Anda membuat instance Cluster Mode Enabled atau Cluster Mode Disabled. Jika Anda menghapus nilai ini, instance akan ditetapkan secara default ke Cluster Mode Enabled. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan dan menonaktifkan mode cluster.
  • ACL_POLICY_NAME: nama kebijakan daftar kontrol akses (ACL) yang Anda tetapkan ke instance yang sedang Anda buat. Dengan menggunakan kebijakan ACL, Anda dapat mengamankan akses ke instance. Anda dapat mengaktifkan keamanan terperinci dengan membatasi akses pengguna dan layanan ke kunci, perintah, dan saluran Pub/Sub tertentu. Untuk mengetahui informasi selengkapnya, lihat Mengamankan akses ke instance Anda menggunakan kebijakan ACL.
  • NETWORK_ID: ID jaringan untuk instance.

Metode HTTP dan URL: 

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID

Meminta isi JSON: 

{
  "shardCount": SHARD_COUNT,
  "replicaCount": REPLICA_COUNT,
  "nodeType": "NODE_TYPE",
  "engineVersion": "ENGINE_VERSION",
  "mode": "MODE",
  "aclPolicy": "projects/PROJECT_ID/locations/REGION_ID/aclPolicies/ACL_POLICY_NAME",
  "endpoints": [
    {
      "connections": [
        {
          "pscAutoConnection": {
            "projectId": "PROJECT_ID",
            "network": "projects/PROJECT_ID/global/networks/NETWORK_ID"
          }
        }
      ]
    }
  ]
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Membuat instance satu zona

Bagian ini memberikan petunjuk tentang cara membuat instance zona tunggal.

Konsol

  1. Di konsol Google Cloud , buka halaman Memorystore for Valkey.

    Memorystore for Valkey

  2. Klik Create instance.

  3. Di bagian Name your instance, masukkan ID untuk instance. ID instance hanya boleh menggunakan huruf kecil, angka, dan tanda hubung. Nama ini juga harus diawali dengan huruf dan unik di region-nya.

  4. Dari menu Region, pilih region untuk instance Anda.

  5. Di bagian Zonal availability, lakukan tindakan berikut:

    1. Pilih opsi Single zone.

    2. Dari menu Zone, pilih zona tempat Anda ingin Memorystore for Valkey membuat instance.

  6. Di bagian Cluster Mode, tentukan apakah Anda menginginkan instance Cluster Mode Enabled atau Cluster Mode Disabled. Untuk mengetahui informasi selengkapnya tentang jenis instance ini, lihat Mengaktifkan dan menonaktifkan mode cluster.

  7. Di bagian Node Type, pilih jenis node.

  8. Di bagian Instance size, masukkan jumlah shard untuk instance Anda. Jumlah shard menentukan total kapasitas memori untuk menyimpan data instance. Untuk mengetahui informasi selengkapnya tentang spesifikasi instance, lihat Spesifikasi instance dan node.

  9. Jika Anda ingin membuat instance dengan replika, di bagian Replicas, pilih jumlah replika (per shard). Anda dapat memilih 0-5 replika. Nilai defaultnya adalah 1 replika.

  10. Di bagian Set up connection, pilih jaringan yang dapat digunakan aplikasi Anda untuk terhubung ke instance ini. Untuk mengetahui informasi selengkapnya tentang jaringan pribadi untuk Memorystore for Valkey, lihat Jaringan.

  11. Jika Anda ingin meningkatkan keamanan instance, di bagian Security, lakukan salah satu tindakan berikut:

    • Jika Anda ingin mengaktifkan autentikasi IAM, pilih opsi IAM Auth. Memorystore for Valkey menggunakan autentikasi IAM untuk membatasi akses ke instance.

    • Jika Anda ingin mengaktifkan autentikasi berbasis token dasar, pilih opsi Token Auth. Memorystore for Valkey membatasi akses ke instance dengan meminta klien menggunakan token autentikasi mereka untuk memverifikasi identitas mereka dalam aplikasi Anda.

    • Jika Anda tidak ingin mengaktifkan autentikasi IAM atau autentikasi berbasis token dasar, pilih opsi Disabled.

    Jika Anda memilih opsi IAM Auth atau Token Auth, Memorystore for Valkey akan otomatis mencentang kotak Enable In-Transit Encryption (TLS), dan bagian Certificate authority management akan ditampilkan. Memorystore for Valkey mengenkripsi kredensial Anda sehingga bersifat rahasia saat dikirim dari instance ke aplikasi.

  12. Di bagian Certificate authority management, pilih opsi Per-instance CA, Customer-managed CA, atau Shared CA. Opsi ini mewakili mode Certificate Authority (CA) untuk instance Anda. Mode CA menentukan hierarki CA yang digunakan untuk menerbitkan sertifikat digital untuk instance.

    Jika memilih opsi Customer-managed CA, Anda harus menambahkan kumpulan CA. Kumpulan CA adalah kumpulan beberapa CA dengan kebijakan penerbitan sertifikat dan kebijakan Identity and Access Management (IAM) yang sama. Kumpulan CA mempermudah pengelolaan rotasi CA dan memungkinkan Anda mencapai total kueri per detik (QPS) efektif yang lebih tinggi.

    Untuk menambahkan kumpulan CA, lakukan salah satu hal berikut:

    1. Untuk menambahkan kumpulan CA dari project Google Cloud lain, pilih kotak centang Add CA from another project, lalu masukkan ID resource untuk kumpulan tersebut di kolom teks.

    2. Untuk menambahkan kumpulan CA yang berada di project Google Cloud yang sama dengan project yang Anda gunakan untuk membuat instance, pilih kumpulan dari menu CA pool.

  13. Di bagian Encryption, pilih salah satu opsi berikut:

    • Kunci enkripsi yang dikelola Google: Anda ingin Google menggunakan kunci untuk mengenkripsi data dalam instance. Opsi ini adalah Enkripsi default Google.

    • Kunci Cloud KMS: Anda ingin mengelola enkripsi data Anda menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) di Cloud Key Management Service (Cloud KMS) dengan layanan yang terintegrasi dengan CMEK, seperti Memorystore untuk Valkey.

      Jika Anda memilih opsi ini, lakukan hal berikut:

      1. Dari menu Key management type, pilih Cloud KMS.
      2. Dari menu kunci Select a Cloud KMS, pilih CMEK.

  14. Untuk menetapkan kebijakan ACL ke instance, pilih kebijakan dari menu Policy di bagian ACL policy.

  15. Di bagian Data persistence strategy, tentukan cara Memorystore for Valkey mempertahankan data di instance Anda. Nilai yang dapat diterima adalah No persistence, Append Only File (AOF) persistence, dan Memory Snapshot persistence.

  16. Jika Anda ingin mengaktifkan pencadangan otomatis untuk instance, lakukan hal berikut:

    1. Centang kotak Automated daily backups.
    2. Di kolom Days to retain backups, masukkan jumlah hari yang Anda inginkan agar Memorystore for Valkey menyimpan cadangan sebelum dihapus secara otomatis. Anda dapat menentukan dari 1 hingga 365 hari. Nilai defaultnya adalah 35 hari.
    3. Dari menu Rentang waktu, pilih waktu untuk pencadangan harian.

  17. Di bagian Maintenance, pilih salah satu opsi berikut:

    • Default: Memorystore for Valkey mengupdate instance Anda secara rutin untuk memastikan layanan dapat diandalkan, berperforma tinggi, aman, dan selalu diupdate.
    • Kustom: Anda ingin menyesuaikan jadwal pemeliharaan untuk instance agar selaras dengan kebutuhan aplikasi dan meminimalkan gangguan. Jika Anda memilih opsi ini, tentukan hari yang Anda inginkan untuk melakukan pemeliharaan dan jam yang Anda inginkan untuk memulai masa pemeliharaan.

  18. Di bagian Choose version, pilih Valkey version. Versi yang tersedia adalah 7.2, 8.0, 9.0, dan 9.1. Versi defaultnya adalah versi 9.1.

  19. Klik Create instance.

gcloud

Untuk membuat instance zona tunggal, jalankan perintah create:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \
--zone-distribution-config=ZONE \
--acl-policy=ACL_POLICY_NAME \
--mode=MODE

Ganti kode berikut:

  • INSTANCE adalah ID instance Memorystore for Valkey yang Anda buat. ID instance Anda harus terdiri dari 1 hingga 63 karakter dan hanya menggunakan huruf kecil, angka, atau tanda hubung. ID ini harus dimulai dengan huruf kecil dan diakhiri dengan huruf kecil atau angka.

  • REGION_ID adalah region tempat Anda ingin menempatkan instance.

  • PROJECT_ID adalah ID project tempat Anda ingin membuat instance.

  • NETWORK_ID adalah ID jaringan yang ingin Anda gunakan untuk membuat instance.

  • REPLICA_COUNT adalah jumlah replika (per shard). Nilai yang diterima adalah 0-5.

  • NODE_TYPE adalah jenis node yang ingin Anda gunakan untuk instance.

  • ENGINE_VERSION adalah versi instance Memorystore for Valkey Anda. Nilai yang diterima untuk parameter ini adalah VALKEY_7_2, VALKEY_8_0, VALKEY_9_0, dan VALKEY_9_1. Jika Anda tidak menentukan nilai, VALKEY_9_1 adalah nilai default.

  • SHARD_COUNT menentukan jumlah shard dalam instance Anda. Jumlah shard menentukan total kapasitas memori untuk menyimpan data instance. Jika mode yang Anda pilih adalah Cluster Mode Disabled, Anda hanya dapat menentukan satu shard untuk instance Anda. Untuk mengetahui informasi selengkapnya, lihat Spesifikasi instance dan node.

  • ZONE_DISTRIBUTION_CONFIG_MODE adalah mode yang memungkinkan Anda memilih antara menyediakan instance zona tunggal atau instance multi-zona. Defaultnya adalah multi-zone. Nilai yang diterima adalah single-zone, dan multi-zone.

  • ZONE adalah zona tempat Anda ingin menyediakan node. Flag ini hanya berlaku jika Anda menetapkan --zone-distribution-config-mode ke single-zone.

  • ACL_POLICY_NAME adalah nama kebijakan daftar kontrol akses (ACL) yang Anda tetapkan ke instance yang Anda buat. Dengan menggunakan kebijakan ACL, Anda dapat mengamankan akses ke instance. Anda dapat mengaktifkan keamanan terperinci dengan membatasi akses pengguna dan layanan ke kunci, perintah, dan saluran Pub/Sub tertentu. Untuk mengetahui informasi selengkapnya, lihat Mengamankan akses ke instance Anda menggunakan kebijakan ACL.

  • MODE menentukan apakah Anda membuat instance Cluster Mode Enabled atau Cluster Mode Disabled. Jika Anda menghilangkan kolom ini, mode akan ditetapkan secara default ke Cluster Mode Enabled. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan dan menonaktifkan Mode Cluster.

REST

Untuk membuat instance zona tunggal, gunakan perintah REST API berikut.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project tempat Anda ingin membuat instance.

  • REGION_ID: region tempat Anda ingin menempatkan instance.

    Anda hanya dapat membuat instance di region yang didukung untuk Memorystore for Valkey.

  • INSTANCE_ID: ID instance yang Anda buat. ID instance harus terdiri dari 1 hingga 63 karakter dan hanya menggunakan huruf kecil, angka, atau tanda hubung. ID ini harus dimulai dengan huruf kecil dan diakhiri dengan huruf kecil atau angka.
  • SHARD_COUNT: jumlah shard dalam instance. Jumlah shard menentukan total kapasitas memori untuk menyimpan data instance. Instance Cluster Mode Disabled hanya mendukung satu shard. Untuk mengetahui informasi selengkapnya, lihat Spesifikasi instance dan node.
  • REPLICA_COUNT: jumlah replika (per shard). Nilai yang diterima adalah 0 hingga 5.

  • NODE_TYPE: jenis node yang ingin Anda gunakan untuk instance. Untuk mengetahui informasi selengkapnya, lihat Memilih jenis node.

  • ENGINE_VERSION: versi instance. Nilai yang diterima adalah VALKEY_7_2, VALKEY_8_0, VALKEY_9_0, dan VALKEY_9_1. Jika Anda tidak menentukan nilai, VALKEY_9_1 adalah nilai default.

  • MODE: mode instance. Nilai ini menentukan apakah Anda membuat instance Cluster Mode Enabled atau Cluster Mode Disabled. Jika Anda menghapus nilai ini, instance akan ditetapkan secara default ke Cluster Mode Enabled. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan dan menonaktifkan mode cluster.
  • ACL_POLICY_NAME: nama kebijakan daftar kontrol akses (ACL) yang Anda tetapkan ke instance yang sedang Anda buat. Dengan menggunakan kebijakan ACL, Anda dapat mengamankan akses ke instance. Anda dapat mengaktifkan keamanan terperinci dengan membatasi akses pengguna dan layanan ke kunci, perintah, dan saluran Pub/Sub tertentu. Untuk mengetahui informasi selengkapnya, lihat Mengamankan akses ke instance Anda menggunakan kebijakan ACL.
  • ZONE: zona tempat Anda ingin membuat instance.
  • NETWORK_ID: ID jaringan untuk instance.

Metode HTTP dan URL: 

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID

Meminta isi JSON: 

{
  "shardCount": SHARD_COUNT,
  "replicaCount": REPLICA_COUNT,
  "nodeType": "NODE_TYPE",
  "engineVersion": "ENGINE_VERSION",
  "mode": "MODE",
  "aclPolicy": "projects/PROJECT_ID/locations/REGION_ID/aclPolicies/ACL_POLICY_NAME",
  "zoneDistributionConfig": {
    "mode": "SINGLE_ZONE",
    "zone": "ZONE"
  },
  "endpoints": [
    {
      "connections": [
        {
          "pscAutoConnection": {
            "projectId": "PROJECT_ID",
            "network": "projects/PROJECT_ID/global/networks/NETWORK_ID"
          }
        }
      ]
    }
  ]
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}