建立執行個體

本頁面說明如何在 Memorystore for Valkey 建立單一可用區和多可用區執行個體。

事前準備

完成「事前準備」操作說明：

1. 在 Google Cloud 控制台的專案選取器頁面，選取或建立 Google Cloud 雲端專案。
   

   注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，而不要選取現有專案。這樣一來，當您完成這些步驟後，就可以直接刪除該專案，並移除相關聯的所有資源。

   
   前往專案選取器
2. 確認專案已啟用計費功能。瞭解如何確認專案是否已啟用計費功能。

3. 安裝並初始化 Google Cloud CLI。

   注意：如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認目前使用的是最新版本。您必須使用 gcloud CLI 489.0.0 以上版本，才能存取 Memorystore for Valkey gcloud CLI 指令。

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 執行個體的網路建立服務連線政策，請按照網路指南建立政策。

建立多可用區執行個體

本節說明如何建立多可用區執行個體。

重要事項：請先完成「事前準備」和「設定網路」章節中的步驟，再按照本程序中的步驟操作。

如果您建立的執行個體含有副本，且要建立執行個體的區域中，有單一可用區無法使用，Memorystore for Valkey 會在該區域的可用區域中建立執行個體。這項可用區分配作業為暫時性。當無法使用的可用區恢復可用狀態後，Memorystore for Valkey 會重新分配執行個體的節點，讓節點平均分布在各個可用區。

如果建立的執行個體沒有副本，且單一可用區無法使用，Memorystore for Valkey 就無法建立執行個體。

控制台

1. 在 Google Cloud 控制台中，前往「Memorystore for Valkey」頁面。

   Memorystore for Valkey

2. 點選「建立執行個體」。

3. 在「Name your instance」(為執行個體命名) 部分，輸入執行個體的 ID。執行個體 ID 只能使用小寫英文字母、數字和連字號。此外，開頭必須是英文字母，且在區域內不得重複。

4. 從「Region」(區域) 選單中，選取執行個體的區域。

5. 在「可用區可用性」部分，選取「多可用區」選項，因為您要建立多可用區執行個體。

6. 在「Cluster Mode」(叢集模式) 區段中，指定要啟用或停用叢集模式。如要進一步瞭解這些類型的執行個體，請參閱「啟用及停用叢集模式」。

   注意：建立啟用或停用叢集模式的執行個體後，就無法變更執行個體的模式。建議您選取「Enabled」(已啟用)，因為這個模式具有更佳的水平擴充特性。

7. 在「Node Type」(節點類型) 部分，選取節點類型。

   注意：shared-core-nano 節點類型沒有服務水準協議，因此建議您僅用於開發或測試。如果您在正式環境中執行 Memorystore for Valkey，建議使用其他節點類型。

8. 在「Instance size」(執行個體大小) 區段中，輸入執行個體的 shard 數量。shard 數量會決定儲存執行個體資料的總記憶體容量。如要進一步瞭解執行個體規格，請參閱「執行個體和節點規格」。

9. 如要建立含有副本的執行個體，請在「副本」部分選取副本數量 (每個 shard)。您可以選取 0 到 5 個副本。預設值為 1 個副本。

10. 在「Set up connection」(設定連線) 專區中，選取應用程式可用來連線至這個執行個體的網路。如要進一步瞭解 Memorystore for Valkey 的私人網路，請參閱「網路」。

11. 如要提高執行個體的安全性，請在「Security」(安全性) 區段中執行下列任一操作：

    • 如要啟用 IAM 驗證，請選取「IAM Auth」選項。Memorystore for Valkey 會使用 IAM 驗證機制限制執行個體的存取權。

    • 如要啟用基本權杖型驗證，請選取「Token Auth」選項。Memorystore for Valkey 會限制執行個體的存取權，用戶端必須使用驗證權杖，在應用程式中驗證身分。

    • 如果不想啟用 IAM 驗證或基本權杖驗證，請選取「Disabled」(已停用) 選項。

    如果選取「IAM Auth」或「Token Auth」選項，Memorystore for Valkey 會自動勾選「啟用傳輸中加密 (TLS)」核取方塊，並顯示「憑證授權單位管理」部分。Memorystore for Valkey 會加密憑證，確保憑證從執行個體傳輸至應用程式時保持機密。

12. 在「Certificate authority management」(憑證授權單位管理) 部分，選取「Per-instance CA」(每個執行個體的 CA)、「Customer-managed CA」(客戶自行管理的 CA) 或「Shared CA」(共用 CA) 選項。這些選項代表執行個體的憑證授權單位 (CA) 模式。CA 模式會決定要使用哪個 CA 階層，為執行個體核發數位憑證。

    如果選取「Customer-managed CA」(客戶自行管理的 CA) 選項，則必須新增 CA 集區。CA 集區內含多個 CA，這些 CA 採用相同的憑證核發政策和 Identity and Access Management (IAM) 政策。CA 集區可簡化 CA 輪替管理作業，並提高每秒查詢次數 (QPS)。

    如要新增 CA 集區，請執行下列任一操作：

    1. 如要新增其他 Google Cloud 專案的 CA 集區，請勾選「Add CA from another project」(新增其他專案的 CA) 核取方塊，然後在文字欄位中輸入集區的資源 ID。

    2. 如要新增 CA 集區，且該集區與您用來建立執行個體的專案位於相同 Google Cloud 專案，請從「CA pool」(CA 集區) 選單中選取該集區。

13. 在「加密」部分，選取下列其中一個選項：

    • Google 代管的加密金鑰：您希望 Google 使用金鑰加密執行個體中的資料。這是 Google 預設加密機制。

    • Cloud KMS 金鑰：您想在 Cloud Key Management Service (Cloud KMS) 中，使用客戶自行管理的加密金鑰 (CMEK)，搭配整合 CMEK 的服務 (例如 Memorystore for Valkey)，管理資料加密。

      如果選取這個選項，請執行下列操作：

      1. 在「Key management type」(金鑰管理類型) 選單中，選取「Cloud KMS」。
      2. 從「Select a Cloud KMS key」(選取 Cloud KMS 金鑰) 選單中選取 CMEK。

14. 如要將 ACL 政策指派給執行個體，請在「ACL policy」(ACL 政策) 區段的「Policy」(政策) 選單中選取政策。

    重要事項：如果找不到要指派的 ACL 政策，請確認政策和執行個體位於相同區域。ACL 政策只能指派給與政策位於相同區域的執行個體。舉例來說，如果您在 us-central1 區域建立 ACL 政策，則只能將該政策指派給同樣位於 us-central1 的執行個體。此外，ACL 政策建立後即無法變更區域。

15. 在「Data persistence strategy」(資料持久性策略) 部分，指定 Memorystore for Valkey 如何保留執行個體中的資料。可接受的值為「No persistence」(不持續)、「Append Only File (AOF) persistence」(僅附加檔案 (AOF) 持續性) 和「Memory Snapshot persistence」(記憶體快照持續性)。

16. 如要為執行個體啟用自動備份功能，請按照下列步驟操作：

    1. 勾選「每日自動備份」核取方塊。
    2. 在「Days to retain backups」(備份保留天數) 欄位中，輸入 Memorystore for Valkey 應保留備份的天數，超過這個天數後，備份就會自動刪除。您可以指定 1 到 365 天。預設值為 35 天。
    3. 在「Time window」(時間範圍) 選單中，選取每日備份的時間。

17. 在「Maintenance」(維護) 部分，選取下列其中一個選項：

    • 預設：Memorystore for Valkey 會定期更新執行個體，確保服務穩定、高效能、安全無虞，且為最新版本。
    • 自訂：您想自訂執行個體的維護排程，配合應用程式需求，盡可能減少中斷情形。如果選取這個選項，請指定要執行維護作業的日期，以及維護期間的開始時間。

18. 在「Choose version」(選擇版本) 部分，選取 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 是要放置執行個體的區域。

注意：您只能在 Memorystore for Valkey 支援的區域建立執行個體。

• PROJECT_ID 是您要建立執行個體的專案 ID。

• NETWORK_ID 是要用來建立執行個體的網路 ID。

• REPLICA_COUNT 是副本數量 (每個 shard)。可接受的值為 0-5。

• NODE_TYPE 是要用於執行個體的節點類型。

  注意：shared-core-nano 節點類型沒有服務水準協議，因此建議您僅用於開發或測試。如果您在正式環境中執行 Memorystore for Valkey，建議使用其他節點類型。

• ENGINE_VERSION 是 Memorystore for Valkey 執行個體的版本。這個參數可接受的值為 VALKEY_7_2、VALKEY_8_0、VALKEY_9_0 和 VALKEY_9_1。如未指定值，則預設值為 VALKEY_9_1。

  重要事項：為執行個體指定版本後，就無法將執行個體降級至先前的版本。

• SHARD_COUNT 會決定執行個體中的 shard 數量。shard 數量會決定儲存執行個體資料的總記憶體容量。已停用叢集模式的執行個體只支援一個 shard，詳情請參閱「執行個體和節點規格」。

• ACL_POLICY_NAME 是要指派給所建立執行個體的存取控制清單 (ACL) 政策名稱。使用 ACL 政策，即可保護執行個體的存取權。您可以限制使用者和服務存取特定金鑰、指令和 Pub/Sub 管道，啟用精細的安全防護機制。詳情請參閱「使用 ACL 政策保護執行個體存取權」。

  重要事項：您只能將 ACL 政策指派給與政策位於相同區域的執行個體。舉例來說，如果您在 us-central1 區域建立 ACL 政策，則只能將該政策指派給同樣位於 us-central1 的執行個體。此外，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：執行個體中的 shard 數量。shard 數量會決定用於儲存執行個體資料的記憶體總容量。已停用叢集模式的執行個體只支援一個 shard。詳情請參閱「執行個體和節點規格」。
• REPLICA_COUNT：副本數量 (每個 shard)。可接受的值為 0 至 5。

• NODE_TYPE：要用於執行個體的節點類型。詳情請參閱「選擇節點類型」。

  注意：shared-core-nano 節點類型沒有服務水準協議，因此建議您僅用於開發或測試。如果您在正式環境中執行 Memorystore for Valkey，建議使用其他節點類型。

• 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 政策保護執行個體的存取權」。
  重要事項：您只能將 ACL 政策指派給與政策位於相同區域的執行個體。舉例來說，如果您在 us-central1 區域建立 ACL 政策，就只能將該政策指派給同樣位於 us-central1 的執行個體。此外，ACL 政策建立後即無法變更區域。
• NETWORK_ID：執行個體的網路 ID。

HTTP 方法和網址：

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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID" | Select-Object -Expand Content

您應該會收到如下的 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. 在「Name your instance」(為執行個體命名) 部分，輸入執行個體的 ID。執行個體 ID 只能使用小寫英文字母、數字和連字號。此外，開頭必須是英文字母，且在區域內不得重複。

4. 從「Region」(區域) 選單中，選取執行個體的區域。

5. 在「可用區可用性」部分，執行下列操作：

   1. 選取「單一可用區」選項。

   2. 從「Zone」(可用區) 選單，選取要 Memorystore for Valkey 建立執行個體的可用區。

6. 在「Cluster Mode」(叢集模式) 區段中，指定要啟用或停用叢集模式。如要進一步瞭解這些類型的執行個體，請參閱「啟用及停用叢集模式」。

   注意：建立已啟用或停用叢集模式的執行個體後，就無法變更執行個體的模式。建議您選取「Enabled」(已啟用)，因為這個模式具有更佳的水平擴充特性。

7. 在「Node Type」(節點類型) 部分，選取節點類型。

   注意：shared-core-nano 節點類型沒有服務水準協議，因此建議您僅用於開發或測試。如果您在正式環境中執行 Memorystore for Valkey，建議使用其他節點類型。

8. 在「Instance size」(執行個體大小) 區段中，輸入執行個體的 shard 數量。shard 數量會決定儲存執行個體資料的總記憶體容量。如要進一步瞭解執行個體規格，請參閱「執行個體和節點規格」。

9. 如要建立含有副本的執行個體，請在「副本」部分選取副本數量 (每個 shard)。您可以選取 0 到 5 個副本。預設值為 1 個副本。

10. 在「Set up connection」(設定連線) 專區中，選取應用程式可用來連線至這個執行個體的網路。如要進一步瞭解 Memorystore for Valkey 的私人網路，請參閱「網路」。

11. 如要提高執行個體的安全性，請在「Security」(安全性) 區段中執行下列任一操作：

    • 如要啟用 IAM 驗證，請選取「IAM Auth」選項。Memorystore for Valkey 會使用 IAM 驗證機制限制執行個體的存取權。

    • 如要啟用基本權杖型驗證，請選取「Token Auth」選項。Memorystore for Valkey 會限制執行個體的存取權，用戶端必須使用驗證權杖，在應用程式中驗證身分。

    • 如果不想啟用 IAM 驗證或基本權杖驗證，請選取「Disabled」(已停用) 選項。

    如果選取「IAM Auth」或「Token Auth」選項，Memorystore for Valkey 會自動勾選「啟用傳輸中加密 (TLS)」核取方塊，並顯示「憑證授權單位管理」部分。Memorystore for Valkey 會加密憑證，確保憑證從執行個體傳輸至應用程式時保持機密。

12. 在「Certificate authority management」(憑證授權單位管理) 區段中，選取「Per-instance CA」(每個執行個體的 CA)、「Customer-managed CA」(客戶自行管理的 CA) 或「Shared CA」(共用 CA) 選項。這些選項代表執行個體的憑證授權單位 (CA) 模式。CA 模式會決定要使用哪個 CA 階層，為執行個體核發數位憑證。

    如果選取「Customer-managed CA」(客戶自行管理的 CA) 選項，則必須新增 CA 集區。CA 集區內含多個 CA，這些 CA 採用相同的憑證核發政策和 Identity and Access Management (IAM) 政策。CA 集區可簡化 CA 輪替管理作業，並提高每秒查詢次數 (QPS)。

    如要新增 CA 集區，請執行下列任一操作：

    1. 如要新增其他 Google Cloud 專案的 CA 集區，請勾選「Add CA from another project」(新增其他專案的 CA) 核取方塊，然後在文字欄位中輸入集區的資源 ID。

    2. 如要新增 CA 集區，且該集區與您用來建立執行個體的專案位於相同 Google Cloud 專案，請從「CA pool」(CA 集區) 選單中選取該集區。

13. 在「加密」部分，選取下列其中一個選項：

    • Google 代管的加密金鑰：您希望 Google 使用金鑰加密執行個體中的資料。這是 Google 預設加密機制。

    • Cloud KMS 金鑰：您想在 Cloud Key Management Service (Cloud KMS) 中，使用客戶自行管理的加密金鑰 (CMEK)，搭配整合 CMEK 的服務 (例如 Memorystore for Valkey)，管理資料加密。

      如果選取這個選項，請執行下列操作：

      1. 在「Key management type」(金鑰管理類型) 選單中，選取「Cloud KMS」。
      2. 從「Select a Cloud KMS key」(選取 Cloud KMS 金鑰) 選單中選取 CMEK。

14. 如要將 ACL 政策指派給執行個體，請在「ACL policy」(ACL 政策) 區段的「Policy」(政策) 選單中選取政策。

    重要事項：如果找不到要指派的 ACL 政策，請確認政策和執行個體位於相同區域。ACL 政策只能指派給與政策位於相同區域的執行個體。舉例來說，如果您在 us-central1 區域建立 ACL 政策，則只能將該政策指派給同樣位於 us-central1 的執行個體。此外，ACL 政策建立後即無法變更區域。

15. 在「Data persistence strategy」(資料持久性策略) 部分，指定 Memorystore for Valkey 如何保留執行個體中的資料。可接受的值為「No persistence」(不持續)、「Append Only File (AOF) persistence」(僅附加檔案 (AOF) 持續性) 和「Memory Snapshot persistence」(記憶體快照持續性)。

16. 如要為執行個體啟用自動備份功能，請按照下列步驟操作：

    1. 勾選「每日自動備份」核取方塊。
    2. 在「Days to retain backups」(備份保留天數) 欄位中，輸入 Memorystore for Valkey 應保留備份的天數，超過這個天數後，備份就會自動刪除。您可以指定 1 到 365 天。預設值為 35 天。
    3. 在「Time window」(時間範圍) 選單中，選取每日備份的時間。

17. 在「Maintenance」(維護) 部分，選取下列其中一個選項：

    • 預設：Memorystore for Valkey 會定期更新執行個體，確保服務穩定、高效能、安全無虞，且為最新版本。
    • 自訂：您想自訂執行個體的維護排程，配合應用程式需求，盡可能減少中斷情形。如果選取這個選項，請指定要執行維護作業的日期，以及維護期間的開始時間。

18. 在「Choose version」(選擇版本) 部分，選取 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 是副本數量 (每個 shard)。可接受的值為 0-5。

• NODE_TYPE 是要用於執行個體的節點類型。

  注意：shared-core-nano 節點類型沒有服務水準協議，因此建議您僅用於開發或測試。如果您在正式環境中執行 Memorystore for Valkey，建議使用其他節點類型。

• ENGINE_VERSION 是 Memorystore for Valkey 執行個體的版本。這個參數可接受的值為 VALKEY_7_2、VALKEY_8_0、VALKEY_9_0 和 VALKEY_9_1。如未指定值，則預設值為 VALKEY_9_1。

  重要事項：為執行個體指定版本後，就無法將執行個體降級至先前的版本。

• SHARD_COUNT 會決定執行個體中的 shard 數量。shard 數量會決定用於儲存執行個體資料的記憶體總容量。如果選取的模式是「已停用叢集模式」，則只能為執行個體指定一個 shard。詳情請參閱「執行個體和節點規格」。

• 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 政策安全存取執行個體」。

  重要事項：ACL 政策只能指派給位於相同區域的執行個體。舉例來說，如果您在 us-central1 區域建立 ACL 政策，則只能將該政策指派給同樣位於 us-central1 的執行個體。此外，ACL 政策建立後，就無法變更區域。

• MODE 會決定您要建立已啟用叢集模式或停用叢集模式的執行個體。如果省略這個欄位，模式會預設為啟用叢集模式。詳情請參閱「啟用及停用叢集模式」。

  注意：建立已啟用或停用叢集模式的執行個體後，就無法變更執行個體的模式。建議您建立已啟用叢集模式的執行個體，因為這類執行個體具有更佳的資源調度特性。

REST

如要建立單一可用區執行個體，請使用下列 REST API 指令。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID：要建立執行個體的專案 ID。

• REGION_ID：執行個體所在的區域。

  您只能在 Memorystore for Valkey 支援的區域建立執行個體。

• INSTANCE_ID：要建立的執行個體 ID。執行個體 ID 的長度必須介於 1 至 63 個半形字元之間，且只能使用小寫英文字母、數字或連字號。開頭必須是小寫英文字母，結尾則須為小寫英文字母或數字。
• SHARD_COUNT：執行個體中的 shard 數量。shard 數量會決定用於儲存執行個體資料的記憶體總容量。已停用叢集模式的執行個體只支援一個 shard。詳情請參閱「執行個體和節點規格」。
• REPLICA_COUNT：副本數量 (每個 shard)。可接受的值為 0 至 5。

• NODE_TYPE：要用於執行個體的節點類型。詳情請參閱「選擇節點類型」。

  注意：shared-core-nano 節點類型沒有服務水準協議，因此建議您僅用於開發或測試。如果您在正式環境中執行 Memorystore for Valkey，建議使用其他節點類型。

• 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 政策保護執行個體的存取權」。
  重要事項：您只能將 ACL 政策指派給與政策位於相同區域的執行個體。舉例來說，如果您在 us-central1 區域建立 ACL 政策，就只能將該政策指派給同樣位於 us-central1 的執行個體。此外，ACL 政策建立後即無法變更區域。
• ZONE：要建立執行個體的可用區。
• NETWORK_ID：執行個體的網路 ID。

HTTP 方法和網址：

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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances?instanceId=INSTANCE_ID" | Select-Object -Expand Content

您應該會收到如下的 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
}