管理已刪除執行個體的備份

如果您選擇在刪除執行個體後保留備份，或在刪除執行個體前建立最終備份，即可在刪除執行個體後管理備份。保留的備份包括執行個體運作時執行的自動備份和隨選備份。刪除執行個體後，這些備份會與執行個體脫鉤，並儲存在專案層級。如要進一步瞭解備份作業的運作方式和保留的備份，請參閱「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 Backups」頁面。

    前往 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 Backups」頁面。

    前往 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 Backups」頁面。

    前往 Cloud SQL 備份

  2. 按一下要查看備份的已刪除執行個體名稱。

    畫面上會列出已刪除執行個體的所有保留和最終備份，以及相關詳細資料。

  3. 找出要更新的備份，然後按一下「更多動作」圖示 更多動作圖示。，並選取「編輯說明」。

  4. 在「編輯備份說明」視窗中，更新備份說明。

  5. 按一下「Update」。

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 Backups」頁面。

    前往 Cloud SQL 備份

  2. 按一下要查看備份的已刪除執行個體名稱。

    畫面上會列出已刪除執行個體的所有保留和最終備份，以及相關詳細資料。

  3. 找到要刪除的備份，按一下更多動作圖示 更多動作圖示。，然後選取「刪除」。

  4. 在「Delete backup」(刪除備份) 視窗中，輸入已刪除的執行個體名稱，然後按一下「Delete」(刪除)。

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 回應：

後續步驟