管理已删除实例的备份

如果您选择在删除实例后保留备份，或者在删除实例之前进行最终备份，则可以在删除实例后管理备份。保留的备份包括实例处于有效状态时进行的自动备份和按需备份。删除实例后，这些备份将独立于您的实例，并存储在项目级。如需详细了解备份的工作原理以及系统会保留哪些备份，请参阅 Cloud SQL 备份概览。

您可以使用这些备份在实例被删除后恢复实例。

准备工作

如需管理 Google Cloud 项目中的保留备份，您需要拥有以下权限：

控制台

任务 所需权限
列出备份 cloudsql.backupRuns.list
描述备份 cloudsql.backupRuns.get
更新备份 cloudsql.backupRuns.update
删除备份 cloudsql.backupRuns.delete

gcloud

操作 命令 所需权限
列出备份 gcloud sql backups list cloudsql.backupRuns.list
描述备份 gcloud sql backups describe cloudsql.backupRuns.get
更新备份 gcloud sql backups patch cloudsql.backupRuns.update
删除备份 gcloud sql backups delete cloudsql.backupRuns.delete

REST

操作 方法 所需权限
列出备份 backups.listBackup cloudsql.backupRuns.list
描述备份 backups.getBackup cloudsql.backupRuns.get
更新备份 backups.updateBackup cloudsql.backupRuns.update
删除备份 backups.deleteBackup cloudsql.backupRuns.delete

列出已删除实例的所有备份

您可以查看 Google Cloud 控制台项目中已删除实例的所有保留备份和最终备份的列表。备份包含备份名称、所属实例、备份类型和实例删除时间等详细信息。由于已删除实例的名称可以在删除后重复使用，因此我们建议使用 instance deletion time 字段来区分特定备份所属的实例。对于有效实例，此字段为空白。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud SQL 备份页面。

    前往“Cloud SQL 备份”

  2. 选择实例的备份选项：标准层级或增强型层级。

  3. 依次点击过滤条件和实例状态，然后选择已删除的实例。

    此页面列出了Google Cloud 控制台项目中的所有已删除实例。

  4. 点击要查看其备份的已删除实例的名称。

    本页面列出了已删除实例的所有保留的自动备份和按需备份，以及最终备份（如有）。

gcloud

  1. 如需获取与 Google Cloud 项目关联的所有备份的列表，请使用 gcloud sql backups list 命令：

    gcloud sql backups list
--project=PROJECT_ID

    替换以下内容：

    • PROJECT_ID：您的 Google Cloud 项目的 ID。

  2. 如需查看有关特定保留备份的详细信息，请使用 gcloud sql backups describe 命令：

    gcloud sql backups describe BACKUP_NAME
--project=PROJECT_ID

    替换以下内容：

    • BACKUP_NAME：保留的备份的名称。
    • PROJECT_ID：您的 Google Cloud 项目的 ID。

REST v1

获取所有备份的列表

使用此示例可获取与 Google Cloud 项目关联的所有保留备份和最终备份的列表。如需查看此调用的完整参数列表，请参阅 backups.listBackups 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID

HTTP 方法和网址：

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

查看备份的详细信息

使用此示例查看保留备份或最终备份的详细信息。如需查看此调用的完整参数列表，请参阅 backup.getBackup 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。

HTTP 方法和网址：

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

REST v1beta4

获取所有保留备份的列表

使用此示例可获取与Google Cloud 项目关联的所有保留备份和最终备份的列表。如需查看此调用的完整参数列表，请参阅 backups.listBackups 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID

HTTP 方法和网址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

查看保留备份的详细信息

使用此示例查看保留备份或最终备份的详细信息。如需查看此调用的完整参数列表，请参阅 backups.getBackup 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。

HTTP 方法和网址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

在删除实例后更新保留的备份或最终备份

删除实例后，您可以更新与该实例关联的任何保留的备份或最终备份的设置，这些备份存储在项目级。根据备份类型，您可以更新的详细信息可能有所不同。

您可以更新在删除实例之前进行的最终备份的说明和保留设置。不过，对于在实例删除后保留的按需备份或自动备份，您只能更新这些备份的说明。对于保留的备份，保留设置是根据实例处于有效状态时备份的保留设置来确定的。如需了解详情，请参阅在删除实例后保留备份。

更新最终备份

您可以更新在删除实例之前进行的最终备份的保留设置和说明。如需更新备份，请执行以下操作：

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud SQL 备份页面。

    前往“Cloud SQL 备份”

  2. 点击要查看其备份的已删除实例的名称。

    您将看到已删除实例的所有保留备份和最终备份的列表及其详细信息。

  3. 对于要更新的最终备份，请点击“更多操作”图标 “更多操作”图标。，然后执行以下操作：

    • 如果您想修改最终备份的说明，请点击修改说明。

      在描述此备份字段中输入说明，然后点击更新。

    • 如果您想修改最终备份的保留期限，请点击修改保留期限。

      在保留备份至字段中选择日期。保留期限可以从实例删除后的 1 天到 365 天不等。选择备份的保留截止日期后，点击更新。

gcloud

您需要要更新的最终备份的 backup-name。 如需获取 backup-name，请参阅列出已删除实例的备份。

如需更新最终备份的保留期限或说明，请使用 gcloud sql backups patch 命令，并为备份指定 expiry-time 或 ttl-days：

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION
--expiry-time=EXPIRY_TIME | --ttl-days=TTL_DAYS

替换以下内容：

  • BACKUP_NAME：最终备份的名称。
  • BACKUP_DESCRIPTION：您要添加到最终备份中的新说明。

  • 以下项之一：

    • EXPIRY_TIME：您希望删除最终备份的新日期和时间。最长时间为自实例删除之日起 365 天。
    • TTL_DAYS：您希望保留最终备份的天数。此值可以介于 1 到 365 天之间，默认值为 30 天。

REST v1

您需要要更新的最终备份的 backup-name。 如需获取 backup-name，请参阅列出已删除实例的备份。

您可以更新最终备份的说明和保留设置。您可以使用以下方法之一更新保留设置：

  • 更新最终备份的保留天数
  • 更新最终备份的到期时间

使用保留天数更新保留期限

使用此示例通过保留天数参数更新最终备份的保留设置：

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。
  • TTL_DAYS：最终备份的保留期限（1 到 365 天）。这称为存留时间 (TTL)。保留期限从当前日期和时间开始计算，Cloud SQL 允许的保留期限上限为 1 年（即 365 天）。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

请求 JSON 正文：

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

使用到期时间更新保留期限

使用此示例通过过期时间参数更新最终备份的保留设置：

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。
  • DATE_AND_TIME_STAMP：Cloud SQL 自动删除最终备份的日期和时间戳。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

请求 JSON 正文：

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

更新说明

使用此示例更新最终备份的说明。如需查看此调用的完整参数列表，请参阅 backups.updateBackup 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。
  • DESCRIPTION：最终备份的更新说明。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

请求 JSON 正文：

{
        "backup": {
            "description": DESCRIPTION,
         },
}

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

REST v1beta4

您需要要更新的最终备份的 backup-name。 如需获取 backup-name，请参阅列出已删除实例的备份。

您可以更新最终备份的说明和保留设置。您可以使用以下方法之一更新保留设置：

  • 更新最终备份的保留天数
  • 更新最终备份的到期时间

使用保留天数更新保留期限

使用此示例通过保留天数参数更新最终备份的保留设置：

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。
  • TTL_DAYS：最终备份的保留期限（1 到 365 天）。这称为存留时间 (TTL)。保留期限从当前日期和时间开始计算，Cloud SQL 允许的保留期限上限为 1 年（即 365 天）。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

请求 JSON 正文：

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

使用到期时间更新保留期限

使用此示例通过过期时间参数更新最终备份的保留设置：

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。
  • DATE_AND_TIME_STAMP：Cloud SQL 自动删除最终备份的日期和时间戳。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

请求 JSON 正文：

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

更新说明

使用此示例更新最终备份的说明。如需查看此调用的完整参数列表，请参阅 backups.updateBackup 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。
  • DESCRIPTION：最终备份的更新说明。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

请求 JSON 正文：

{
        "backup": {
            "description": DESCRIPTION,
         },
}

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

更新保留备份

您可以更新保留的按需备份和自动备份的说明。 如需更新备份，请执行以下操作：

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud SQL 备份页面。

    前往“Cloud SQL 备份”

  2. 点击要查看其备份的已删除实例的名称。

    您将看到已删除实例的所有保留备份和最终备份的列表及其详细信息。

  3. 对于要更新的保留备份，请点击“更多操作”图标 “更多操作”图标。，然后选择修改说明。

  4. 在修改备份说明窗口中，更新备份的说明。

  5. 点击更新。

gcloud

如需更新保留备份的说明，请使用 gcloud sql backups patch 命令：

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION

替换以下内容：

  • BACKUP_NAME：保留的备份的名称。
  • BACKUP_DESCRIPTION：您要添加到保留备份中的新说明。

REST v1

获取所有保留备份的列表

使用此示例可获取与Google Cloud 项目关联的所有保留备份的列表。如需查看此调用的完整参数列表，请参阅 backups.listBackups 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID

HTTP 方法和网址：

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

更新说明

使用此示例更新保留备份的说明。如需查看此调用的完整参数列表，请参阅 backups.updateBackup 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。
  • DESCRIPTION：最终备份的更新说明。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

请求 JSON 正文：

{
        "backup": {
            "description": DESCRIPTION,
         },
}

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

REST v1beta4

获取所有保留备份的列表

使用此示例可获取与Google Cloud 项目关联的所有保留备份的列表。如需查看此调用的完整参数列表，请参阅 backups.listBackups 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID

HTTP 方法和网址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

更新说明

使用此示例更新保留备份的说明。如需查看此调用的完整参数列表，请参阅 backups.updateBackup 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。
  • DESCRIPTION：最终备份的更新说明。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

请求 JSON 正文：

{
        "backup": {
            "description": DESCRIPTION,
         },
}

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

删除与已删除的实例关联的备份

您可以随时删除已删除实例的最终按需备份和自动备份或保留的按需备份和自动备份。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud SQL 备份页面。

    前往“Cloud SQL 备份”

  2. 点击要查看其备份的已删除实例的名称。

    您将看到已删除实例的所有保留备份和最终备份的列表及其详细信息。

  3. 对于要删除的备份，请点击“更多操作”图标 “更多操作”图标。，然后选择删除。

  4. 在删除备份窗口中，输入已删除实例的名称，然后点击删除。

gcloud

如需删除保留的备份，请使用 gcloud sql backups delete 命令：

gcloud sql backups delete BACKUP_NAME

替换以下内容：

  • BACKUP_NAME：保留的备份的名称。

REST v1

使用此示例删除最终备份或保留的备份。如需查看此调用的完整参数列表，请参阅 backups.deleteBackup 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。

HTTP 方法和网址：

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

REST v1beta4

使用此示例删除最终备份或保留的备份。如需查看此调用的完整参数列表，请参阅 backups.deleteBackup 页面。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID：项目 ID。
  • BACKUP_ID：备份 ID。您可以从运行上一个调用的输出中获取此 ID。

HTTP 方法和网址：

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

后续步骤