Method: projects.locations.instances.backup

• HTTP 请求
• 路径参数
• 请求正文
  • JSON 表示法
• 响应正文
• 授权范围
• IAM 权限

备份实例。如果这是首次创建备份，系统会在后端创建一个备份集合，而此备份属于该集合。集合和备份都将具有资源名称。系统将为每个分片执行备份。系统将选择一个副本（如果是非 HA，则选择主副本）来执行。如果当前有备份或更新操作正在进行，系统会拒绝备份调用。请注意，在预览期间，如果实例的内部软件版本过旧，系统会在实际备份之前执行关键更新。将内部软件版本更新为备份功能所需的最低版本后，后续备份将不再需要关键更新。预览结束后，备份将不再需要关键更新。

HTTP 请求

选择端点：

全局 africa-south1 asia-east1 asia-east2 asia-northeast1 asia-northeast2 asia-northeast3 asia-south1 asia-south2 asia-southeast1 asia-southeast2 asia-southeast3 australia-southeast1 australia-southeast2 europe-central2 europe-north1 europe-north2 europe-southwest1 europe-west1 europe-west10 europe-west12 europe-west15 europe-west2 europe-west3 europe-west4 europe-west6 europe-west8 europe-west9 me-central1 me-central2 me_west1 northamerica-northeast1 northamerica-northeast2 northamerica-south1 southamerica-east1 southamerica-west1 us-central1 us-central2 us-east1 us-east4 us-east5 us-east7 us-south1 us-west1 us-west2 us-west3 us-west4 us-west8

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

网址使用 gRPC 转码语法。

路径参数

参数
name	string 必需。实例资源名称，格式为：projects/{projectId}/locations/{locationId}/instances/{instanceId}，其中 locationId 是指 Google Cloud 区域。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法
{ "ttl": string, "backupId": string }

字段
ttl	string (Duration format) 可选。备份的过期 TTL。值范围为 1 天到 100 年。如果未指定，则默认值为 100 年。 该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
backupId	string 可选。要创建的备份的 ID。如果未指定，则使用默认值 ([YYYYMMDDHHMMSS]_[缩短的实例 UID])。

响应正文

如果成功，则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围之一：

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

IAM 权限

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

• memorystore.instances.backup

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