Method: projects.locations.clusters.backup

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

HTTP 请求

POST https://redis.googleapis.com/v1alpha1/{name=projects/*/locations/*/clusters/*}:backup

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。Redis 集群资源名称，格式为 projects/{projectId}/locations/{locationId}/clusters/{clusterId}，其中 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

如需了解详情，请参阅 Authentication Overview。