Method: projects.locations.instances.create

在指定專案和位置中建立新執行個體。

HTTP 要求

POST https://memorystore.googleapis.com/v1alpha/{parent=projects/*/locations/*}/instances

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

這是必要旗標,表示將建立這個執行個體的父項資源。格式:projects/{project}/locations/{location}

查詢參數

參數
instanceId

string

這是必要旗標,要用於執行個體的 ID,這會成為執行個體資源名稱的最終元件。

這個值有下列限制:

  • 長度必須介於 4 至 63 個半形字元
  • 開頭必須是英文字母或數字
  • 只能使用小寫英文字母、數字和連字號
  • 結尾不得為連字號
  • 在位置中不得重複
requestId

string

(非必要) 用於識別要求的選用要求 ID。請指定專屬的請求 ID,這樣一來,如果您必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器會保證在首次要求後的至少 60 分鐘內。

舉例來說,假設您提出初始要求,但要求逾時,如果您再次使用相同的要求 ID 提出要求,伺服器會檢查是否已收到使用相同要求 ID 的原始作業,如果是的話,就會忽略第二項要求。這可避免客戶不小心建立重複的承諾。

要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-0000000000000)。

要求主體

要求主體包含 Instance 的執行個體。

回應主體

如果成功,回應主體會包含新建立的 Operation 執行個體。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/cloud-platform

IAM 權限

需要在 parent 資源上具備下列 IAM 權限:

  • memorystore.instances.create

詳情請參閱 身分與存取權管理說明文件