Method: projects.locations.instances.create

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

HTTP 要求


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

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

路徑參數

參數
parent

string

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

查詢參數

參數
instanceId

string

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

這個值須符合下列限制：

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

string

選用。用於識別要求的選用要求 ID。指定專屬要求 ID，這樣一來，如果必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證自第一次要求起至少 60 分鐘內，

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

要求 ID 必須是有效的 UUID，但零 UUID (00000000-0000-0000-0000-000000000000) 不受支援。

要求主體

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

回應主體

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

授權範圍

需要下列其中一種 OAuth 範圍：

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

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • memorystore.instances.create

詳情請參閱 IAM 說明文件。