Method: projects.locations.instances.create

在给定的项目和位置中创建一个新实例。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。将在其中创建此实例的父级资源。格式：projects/{project}/locations/{location}

查询参数

参数
instanceId

string

必需。要用于实例的 ID，该 ID 将成为实例资源名称的最后一个组成部分。

此值受以下限制：

  • 长度必须为 4-63 个字符
  • 必须以字母或数字开头
  • 只能包含小写字母、数字和连字符
  • 不得以连字符结尾
  • 在相应位置中必须是唯一的
requestId

string

可选。可选的请求 ID，用于标识请求。您可以指定一个唯一的请求 ID，这样，在您必须重试请求时，服务器就会知道忽略该请求（如果该请求已完成）。服务器将保证自第一次请求起至少 60 分钟。

例如，假设在您最初发出一个请求后，该请求超时，然后您使用相同的请求 ID 再次发出该请求，那么服务器便可检查是否收到了最初那个具有该请求 ID 的操作。如果收到了，服务器便会忽略这第二个请求。这样可以防止客户端意外创建重复的承诺。

请求 ID 必须是有效的 UUID，且不支持全部由零组成的 UUID（即 00000000-0000-0000-0000-000000000000）。

请求正文

请求正文包含一个 Instance 实例。

响应正文

如果成功，响应正文将包含一个新创建的 Operation 实例。

授权范围

需要以下 OAuth 范围：

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

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • memorystore.instances.create

如需了解详情，请参阅 IAM 文档。