Method: projects.locations.instances.backup

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

HTTP 请求

POST https://memorystore.googleapis.com/v1beta/{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

IAM 权限

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

  • memorystore.instances.backup

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