インスタンスを作成する

このページでは、Memorystore for Valkey でシングルゾーン インスタンスとマルチゾーン インスタンスを作成する手順について説明します。

始める前に

開始する前に次の手順を完了してください。

  1. Google Cloud コンソールのプロジェクト セレクタ ページで、Google Cloud プロジェクトを選択または作成します。

    注: この手順で作成するリソースをそのまま保持する予定でない場合は、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。


    プロジェクト セレクタに移動
  2. プロジェクトに対して課金が有効になっていることを確認します。プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
  3. Google Cloud CLI をインストールして初期化します。

    注: すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して、最新バージョンがインストールされていることを確認してください。Memorystore for Valkey の gcloud CLI コマンドを利用するには、少なくとも gcloud CLI バージョン 489.0.0 が必要です。

  4. Memorystore for Valkey API を有効にする
    Memorystore for Valkey
  5. Network Connectivity API を有効にする
    Network Connectivity API
  6. Service Consumer Management API を有効にする
    Service Consumer Management API

その他の前提条件

  • 使用している Google Cloud プロジェクトに、次のいずれかの IAM ロールが必要です。
    • roles/memorystore.admin(Memorystore 管理者の事前定義 IAM ロール)
    • roles/owner(オーナーの IAM 基本ロール)
    • roles/editor(編集者の IAM 基本ロール)

ネットワークを設定する

ネットワーキングのページを参照して、サービス接続ポリシーを設定する必要があるかどうかを判断します。

Valkey インスタンスを作成するネットワークにサービス接続ポリシーが作成されていない場合は、ネットワーキングのガイダンスに沿って作成します。

マルチゾーン インスタンスを作成する

このセクションでは、マルチゾーン インスタンスを作成する手順について説明します。

コンソール

  1. Google Cloud コンソールで、[Memorystore for Valkey] ページに移動します。

    Memorystore for Valkey

  2. [インスタンスを作成] をクリックします。

  3. [インスタンスの名前を指定] セクションで、インスタンスの ID を入力します。インスタンス ID に使用できるのは、小文字、数字、ハイフンのみです。先頭は英字で、そのリージョンで一意である必要があります。

  4. [リージョン] メニューから、インスタンスのリージョンを選択します。

  5. マルチゾーン インスタンスを作成するため、[ゾーンの可用性] セクションで [マルチゾーン] オプションを選択します。

  6. [クラスタモード] セクションで、クラスタモードが有効なインスタンスとクラスタモードが無効なインスタンスのどちらを使用するかを指定します。これらのタイプのインスタンスの詳細については、クラスタモードを有効または無効にするをご覧ください。

  7. [ノードタイプ] セクションで、ノードタイプを選択します。

  8. [インスタンス サイズ] セクションで、インスタンスのシャード数を入力します。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。インスタンス仕様の詳細については、インスタンスとノードの仕様をご覧ください。

  9. レプリカを使用してインスタンスを作成する場合は、[レプリカ] セクションでレプリカ数(シャードあたり)を選択します。0 ~ 5 個のレプリカを選択できます。デフォルト値は 1 レプリカです。

  10. [接続の設定] セクションで、アプリケーションがこのインスタンスへの接続に使用できるネットワークを選択します。Memorystore for Valkey のプライベート ネットワーキングの詳細については、ネットワーキングをご覧ください。

  11. インスタンスのセキュリティを強化する場合は、[セキュリティ] セクションで次のいずれかを行います。

    • IAM 認証を有効にする場合は、[IAM Auth] オプションを選択します。Memorystore for Valkey は、IAM 認証を使用してインスタンスへのアクセスを制限します。

    • 基本的なトークンベースの認証を有効にする場合は、[トークン認証] オプションを選択します。Memorystore for Valkey では、クライアントが認証トークンを使用してアプリケーション内で ID を確認することで、インスタンスへのアクセスを制限します。

    • IAM 認証または基本的なトークンベースの認証を有効にしない場合は、[無効] オプションを選択します。

    [IAM 認証] または [トークン認証] オプションを選択すると、Memorystore for Valkey は [転送中の暗号化(TLS)を有効にする] チェックボックスを自動的に選択し、[認証局の管理] セクションが表示されます。Memorystore for Valkey は、認証情報を暗号化して、インスタンスからアプリケーションに送信されるときに機密性が保たれるようにします。

  12. [認証局の管理] セクションで、[インスタンスごとの CA]、[顧客管理の CA]、または [共有 CA] オプションを選択します。これらのオプションは、インスタンスの認証局(CA)モードを表します。CA モードによって、インスタンスのデジタル証明書の発行に使用される CA 階層が決まります。

    [顧客管理の CA] オプションを選択した場合は、CA プールを追加する必要があります。CA プールは、共通の証明書発行ポリシーと Identity and Access Management(IAM)ポリシーを持つ複数の CA の集合です。CA プールを使用すると、CA ローテーション管理が容易になり、より高い有効な合計秒間クエリ数(QPS)を実現できます。

    CA プールを追加するには、次のいずれかを行います。

    1. 別の Google Cloud プロジェクトから CA プールを追加するには、[別のプロジェクトから CA を追加] チェックボックスをオンにして、テキスト フィールドにプールのリソース ID を入力します。

    2. インスタンスの作成に使用しているプロジェクトと同じ Google Cloud プロジェクトにある CA プールを追加するには、[CA プール] メニューからプールを選択します。

  13. [暗号化] セクションで、次のいずれかのオプションを選択します。

    • Google が管理する暗号鍵: Google が鍵を使用してインスタンス内のデータを暗号化します。これは Google のデフォルトの暗号化です。
    • Cloud KMS 鍵: Cloud Key Management Service(Cloud KMS)の顧客管理の暗号鍵(CMEK)を、Memorystore for Valkey などの CMEK 統合サービスで使用して、データの暗号化を管理します。

      このオプションを選択した場合は、次の操作を行います。

      1. [鍵管理タイプ] メニューで、[Cloud KMS] を選択します。
      2. [Cloud KMS 鍵の選択] メニューから CMEK を選択します。
  14. インスタンスに ACL ポリシーを割り当てるには、[ACL ポリシー] セクションの [ポリシー] メニューからポリシーを選択します。

  15. [データ永続性戦略] セクションで、Memorystore for Valkey がインスタンスにデータを永続化する方法を指定します。有効な値は、[永続性なし]、[追加専用ファイル(AOF)の永続性]、[メモリ スナップショットの永続性] です。

  16. インスタンスの自動バックアップを有効にするには、次の操作を行います。

    1. [自動日次バックアップ] チェックボックスをオンにします。
    2. [バックアップを保持する日数] フィールドに、Memorystore for Valkey でバックアップが自動的に削除されるまでの保持日数を入力します。1~365 日の範囲で指定できます。デフォルト値は 35 日です。
    3. [時間枠] メニューから、毎日のバックアップの時間を選択します。
  17. [メンテナンス] セクションで、次のいずれかのオプションを選択します。

    • デフォルト: Memorystore for Valkey はインスタンスを定期的に更新し、サービスの信頼性、パフォーマンス、セキュリティ、最新性を確保します。
    • カスタム: アプリケーションのニーズに合わせてインスタンスのメンテナンス スケジュールをカスタマイズし、中断を最小限に抑えます。このオプションを選択した場合は、メンテナンスを実行する曜日と、メンテナンスの時間枠を開始する時間を指定します。
  18. [バージョンを選択] セクションで、Valkey のバージョンを選択します。利用可能なバージョンは 7.2、8.0、9.0、9.1 です。デフォルトのバージョンはバージョン 9.1 です。

  19. [インスタンスを作成] をクリックします。

gcloud

Memorystore for Valkey インスタンスを作成するには、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

以下を置き換えます。

  • INSTANCE は、作成する Memorystore for Valkey インスタンスの ID です。インスタンス ID は 1〜63 文字にする必要があり、小文字、数字、ハイフンのみ使用できます。先頭は英小文字に、末尾は英小文字または数字にする必要があります。

  • REGION_ID は、インスタンスを配置するリージョンです。

  • PROJECT_ID は、インスタンスを作成するプロジェクトの ID です。

  • NETWORK_ID は、インスタンスの作成に使用するネットワークの ID です。

  • REPLICA_COUNT は、レプリカの数(シャードあたり)です。利用できる値は 0~5 です。

  • NODE_TYPE は、インスタンスに使用するノードタイプです。

  • ENGINE_VERSION は、Memorystore for Valkey インスタンスのバージョンです。このパラメータに指定できる値は、VALKEY_7_2、VALKEY_8_0、VALKEY_9_0、VALKEY_9_1 です。値を指定しない場合、デフォルト値は VALKEY_9_1 です。

  • SHARD_COUNT によってインスタンス内のシャードの数が決定されます。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。クラスタモードが無効になっているインスタンスでサポートされるシャードは 1 つのみです。詳細については、インスタンスとノードの仕様をご覧ください。

  • ACL_POLICY_NAME は、作成するインスタンスに割り当てるアクセス制御リスト(ACL)ポリシーの名前です。ACL ポリシーを使用すると、インスタンスへのアクセスを保護できます。特定のキー、コマンド、Pub/Sub チャネルへのユーザーとサービスのアクセスを制限することで、きめ細かいセキュリティを有効にできます。詳細については、ACL ポリシーを使用してインスタンスへのアクセスを保護するをご覧ください。

  • MODE は、クラスタモードが有効なインスタンスとクラスタモードが無効なインスタンスのどちらを作成するかを決定します。このフィールドを省略すると、インスタンスはデフォルトでクラスタモードが有効になります。詳細については、クラスタモードを有効または無効にするをご覧ください。

次に例を示します。

クラスタモードが有効な場合の例


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

クラスタモードが無効になっている例


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

デフォルトでは、転送中の暗号化は無効になっており、承認済みネットワークは default です。

REST

マルチゾーン インスタンスを作成するには、次の REST API コマンドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT_ID: インスタンスを作成するプロジェクトの ID。
  • REGION_ID: インスタンスを配置するリージョン。

    インスタンスは、Memorystore for Valkey でサポートされているリージョンでのみ作成できます。

  • INSTANCE_ID: 作成するインスタンスの ID。インスタンス ID は 1 ~ 63 文字にする必要があり、小文字、数字、ハイフンのみ使用できます。先頭は英小文字に、末尾は英小文字または数字にする必要があります。
  • SHARD_COUNT: インスタンス内のシャード数。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。クラスタモードが無効になっているインスタンスでサポートされるシャードは 1 つのみです。詳細については、インスタンスとノードの仕様をご覧ください。
  • REPLICA_COUNT: レプリカ数(シャードあたり)。指定できる値は 0~5 です。
  • NODE_TYPE: インスタンスに使用するノードタイプ。詳細については、ノードタイプを選択するをご覧ください。

  • ENGINE_VERSION: インスタンスのバージョン。指定できる値は VALKEY_7_2、VALKEY_8_0、VALKEY_9_0、VALKEY_9_1 です。値を指定しない場合、デフォルト値は VALKEY_9_1 です。

  • MODE: インスタンスのモード。この値によって、クラスタモードが有効なインスタンスを作成するか、クラスタモードが無効なインスタンスを作成するかが決まります。この値を省略すると、インスタンスはデフォルトでクラスタモードが有効になります。詳細については、クラスタモードを有効または無効にするをご覧ください。
  • ACL_POLICY_NAME: 作成するインスタンスに割り当てるアクセス制御リスト(ACL)ポリシーの名前。ACL ポリシーを使用すると、インスタンスへのアクセスを保護できます。特定のキー、コマンド、Pub/Sub チャネルへのユーザーとサービスのアクセスを制限することで、きめ細かいセキュリティを有効にできます。詳細については、ACL ポリシーを使用してインスタンスへのアクセスを保護するをご覧ください。
  • NETWORK_ID: インスタンスのネットワークの ID。

HTTP メソッドと URL:

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

リクエストの本文(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"
          }
        }
      ]
    }
  ]
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "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
}

シングルゾーン インスタンスを作成する

このセクションでは、シングルゾーン インスタンスを作成する手順について説明します。

コンソール

  1. Google Cloud コンソールで、[Memorystore for Valkey] ページに移動します。

    Memorystore for Valkey

  2. [インスタンスを作成] をクリックします。

  3. [インスタンスの名前を指定] セクションで、インスタンスの ID を入力します。インスタンス ID に使用できるのは、小文字、数字、ハイフンのみです。先頭は英字で、そのリージョンで一意である必要があります。

  4. [リージョン] メニューから、インスタンスのリージョンを選択します。

  5. [ゾーンの可用性] セクションで、次の操作を行います。

    1. [シングルゾーン] オプションを選択します。

    2. [ゾーン] メニューから、Memorystore for Valkey でインスタンスを作成するゾーンを選択します。

  6. [クラスタモード] セクションで、クラスタモードが有効なインスタンスとクラスタモードが無効なインスタンスのどちらを使用するかを指定します。これらのタイプのインスタンスの詳細については、クラスタモードを有効または無効にするをご覧ください。

  7. [ノードタイプ] セクションで、ノードタイプを選択します。

  8. [インスタンス サイズ] セクションで、インスタンスのシャード数を入力します。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。インスタンス仕様の詳細については、インスタンスとノードの仕様をご覧ください。

  9. レプリカを使用してインスタンスを作成する場合は、[レプリカ] セクションでレプリカ数(シャードあたり)を選択します。0 ~ 5 個のレプリカを選択できます。デフォルト値は 1 レプリカです。

  10. [接続の設定] セクションで、アプリケーションがこのインスタンスへの接続に使用できるネットワークを選択します。Memorystore for Valkey のプライベート ネットワーキングの詳細については、ネットワーキングをご覧ください。

  11. インスタンスのセキュリティを強化する場合は、[セキュリティ] セクションで次のいずれかを行います。

    • IAM 認証を有効にする場合は、[IAM Auth] オプションを選択します。Memorystore for Valkey は、IAM 認証を使用してインスタンスへのアクセスを制限します。

    • 基本的なトークンベースの認証を有効にする場合は、[トークン認証] オプションを選択します。Memorystore for Valkey では、クライアントが認証トークンを使用してアプリケーション内で ID を確認することで、インスタンスへのアクセスを制限します。

    • IAM 認証または基本的なトークンベースの認証を有効にしない場合は、[無効] オプションを選択します。

    [IAM 認証] または [トークン認証] オプションを選択すると、Memorystore for Valkey は [転送中の暗号化(TLS)を有効にする] チェックボックスを自動的に選択し、[認証局の管理] セクションが表示されます。Memorystore for Valkey は、認証情報を暗号化して、インスタンスからアプリケーションに送信されるときに機密性が保たれるようにします。

  12. [認証局の管理] セクションで、[インスタンスごとの CA]、[顧客管理の CA]、または [共有 CA] オプションを選択します。これらのオプションは、インスタンスの認証局(CA)モードを表します。CA モードによって、インスタンスのデジタル証明書の発行に使用される CA 階層が決まります。

    [顧客管理の CA] オプションを選択した場合は、CA プールを追加する必要があります。CA プールは、共通の証明書発行ポリシーと Identity and Access Management(IAM)ポリシーを持つ複数の CA の集合です。CA プールを使用すると、CA ローテーション管理が容易になり、より高い有効な合計秒間クエリ数(QPS)を実現できます。

    CA プールを追加するには、次のいずれかを行います。

    1. 別の Google Cloud プロジェクトから CA プールを追加するには、[別のプロジェクトから CA を追加] チェックボックスをオンにして、テキスト フィールドにプールのリソース ID を入力します。

    2. インスタンスの作成に使用しているプロジェクトと同じ Google Cloud プロジェクトにある CA プールを追加するには、[CA プール] メニューからプールを選択します。

  13. [暗号化] セクションで、次のいずれかのオプションを選択します。

    • Google が管理する暗号鍵: Google が鍵を使用してインスタンス内のデータを暗号化します。これは Google のデフォルトの暗号化です。
    • Cloud KMS 鍵: Cloud Key Management Service(Cloud KMS)の顧客管理の暗号鍵(CMEK)を、Memorystore for Valkey などの CMEK 統合サービスで使用して、データの暗号化を管理します。

      このオプションを選択した場合は、次の操作を行います。

      1. [鍵管理タイプ] メニューで、[Cloud KMS] を選択します。
      2. [Cloud KMS 鍵の選択] メニューから CMEK を選択します。
  14. インスタンスに ACL ポリシーを割り当てるには、[ACL ポリシー] セクションの [ポリシー] メニューからポリシーを選択します。

  15. [データ永続性戦略] セクションで、Memorystore for Valkey がインスタンスにデータを永続化する方法を指定します。有効な値は、[永続性なし]、[追加専用ファイル(AOF)の永続性]、[メモリ スナップショットの永続性] です。

  16. インスタンスの自動バックアップを有効にするには、次の操作を行います。

    1. [自動日次バックアップ] チェックボックスをオンにします。
    2. [バックアップを保持する日数] フィールドに、Memorystore for Valkey でバックアップが自動的に削除されるまでの保持日数を入力します。1~365 日の範囲で指定できます。デフォルト値は 35 日です。
    3. [時間枠] メニューから、毎日のバックアップの時間を選択します。
  17. [メンテナンス] セクションで、次のいずれかのオプションを選択します。

    • デフォルト: Memorystore for Valkey はインスタンスを定期的に更新し、サービスの信頼性、パフォーマンス、セキュリティ、最新性を確保します。
    • カスタム: アプリケーションのニーズに合わせてインスタンスのメンテナンス スケジュールをカスタマイズし、中断を最小限に抑えます。このオプションを選択した場合は、メンテナンスを実行する曜日と、メンテナンスの時間枠を開始する時間を指定します。
  18. [バージョンを選択] セクションで、Valkey のバージョンを選択します。利用可能なバージョンは 7.2、8.0、9.0、9.1 です。デフォルトのバージョンはバージョン 9.1 です。

  19. [インスタンスを作成] をクリックします。

gcloud

単一ゾーンのインスタンスを作成するには、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

次のように置き換えます。

  • INSTANCE は、作成する Memorystore for Valkey インスタンスの ID です。インスタンス ID は 1〜63 文字にする必要があり、小文字、数字、ハイフンのみ使用できます。先頭は英小文字に、末尾は英小文字または数字にする必要があります。

  • REGION_ID は、インスタンスを配置するリージョンです。

  • PROJECT_ID は、インスタンスを作成するプロジェクトの ID です。

  • NETWORK_ID は、インスタンスの作成に使用するネットワークの ID です。

  • REPLICA_COUNT は、レプリカの数(シャードあたり)です。利用できる値は 0~5 です。

  • NODE_TYPE は、インスタンスに使用するノードタイプです。

  • ENGINE_VERSION は、Memorystore for Valkey インスタンスのバージョンです。このパラメータに指定できる値は、VALKEY_7_2、VALKEY_8_0、VALKEY_9_0、VALKEY_9_1 です。値を指定しない場合、デフォルト値は VALKEY_9_1 です。

  • SHARD_COUNT によってインスタンス内のシャードの数が決定されます。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。選択したモードがクラスタモード無効の場合、インスタンスに指定できるシャードは 1 つのみです。詳細については、インスタンスとノードの仕様をご覧ください。

  • ZONE_DISTRIBUTION_CONFIG_MODE は、シングルゾーン インスタンスまたはマルチゾーン インスタンスのプロビジョニングを選択できるモードです。デフォルトは multi-zone です。指定できる値は single-zone、multi-zone です。

  • ZONE は、ノードをプロビジョニングするゾーンです。このフラグは、--zone-distribution-config-mode を single-zone に設定した場合にのみ適用されます。

  • ACL_POLICY_NAME は、作成するインスタンスに割り当てるアクセス制御リスト(ACL)ポリシーの名前です。ACL ポリシーを使用すると、インスタンスへのアクセスを保護できます。特定のキー、コマンド、Pub/Sub チャネルへのユーザーとサービスのアクセスを制限することで、きめ細かいセキュリティを有効にできます。詳細については、ACL ポリシーを使用してインスタンスへのアクセスを保護するをご覧ください。

  • MODE は、クラスタモードが有効なインスタンスとクラスタモードが無効なインスタンスのどちらを作成するかを決定します。このフィールドを省略すると、デフォルトでクラスタモードが有効になります。詳細については、クラスタモードを有効または無効にするをご覧ください。

REST

単一ゾーンのインスタンスを作成するには、次の REST API コマンドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT_ID: インスタンスを作成するプロジェクトの ID。
  • REGION_ID: インスタンスを配置するリージョン。

    インスタンスは、Memorystore for Valkey でサポートされているリージョンでのみ作成できます。

  • INSTANCE_ID: 作成するインスタンスの ID。インスタンス ID は 1 ~ 63 文字にする必要があり、小文字、数字、ハイフンのみ使用できます。先頭は英小文字に、末尾は英小文字または数字にする必要があります。
  • SHARD_COUNT: インスタンス内のシャード数。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。クラスタモードが無効になっているインスタンスでサポートされるシャードは 1 つのみです。詳細については、インスタンスとノードの仕様をご覧ください。
  • REPLICA_COUNT: レプリカ数(シャードあたり)。指定できる値は 0~5 です。
  • NODE_TYPE: インスタンスに使用するノードタイプ。詳細については、ノードタイプを選択するをご覧ください。

  • ENGINE_VERSION: インスタンスのバージョン。指定できる値は VALKEY_7_2、VALKEY_8_0、VALKEY_9_0、VALKEY_9_1 です。値を指定しない場合、デフォルト値は VALKEY_9_1 です。

  • MODE: インスタンスのモード。この値によって、クラスタモードが有効なインスタンスを作成するか、クラスタモードが無効なインスタンスを作成するかが決まります。この値を省略すると、インスタンスはデフォルトでクラスタモードが有効になります。詳細については、クラスタモードを有効または無効にするをご覧ください。
  • ACL_POLICY_NAME: 作成するインスタンスに割り当てるアクセス制御リスト(ACL)ポリシーの名前。ACL ポリシーを使用すると、インスタンスへのアクセスを保護できます。特定のキー、コマンド、Pub/Sub チャネルへのユーザーとサービスのアクセスを制限することで、きめ細かいセキュリティを有効にできます。詳細については、ACL ポリシーを使用してインスタンスへのアクセスを保護するをご覧ください。
  • ZONE: インスタンスを作成するゾーン。
  • NETWORK_ID: インスタンスのネットワークの ID。

HTTP メソッドと URL:

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

リクエストの本文(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"
          }
        }
      ]
    }
  ]
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "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
}