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

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

    前往 Cloud SQL 備份

  2. 選取執行個體的備份選項：標準級或進階級。

  3. 依序按一下「Filter」(篩選器)、「Instance status」(執行個體狀態)，然後選取「Deleted instance」(已刪除的執行個體)。

    這個頁面會列出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 備份) 頁面。

    前往 Cloud SQL 備份

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

    您會看到所有保留和最終備份的清單，以及已刪除執行個體的詳細資料。

  3. 找到要更新的最終備份，按一下「更多動作」圖示 更多動作圖示。，然後執行下列操作：

    • 如要編輯最終備份的說明，請按一下「Edit description」(編輯說明)。

      在「Describe this backup」(提供這個備份的說明) 欄位中輸入說明，然後按一下「Update」(更新)。

    • 如要編輯最終備份的保留期限，請按一下「Edit retention period」(編輯保留期限)。

      在「Retain backup until」(保留備份至) 欄位中選取日期。保留期限介於 1 到 365 天，從執行個體刪除後算起。選取備份保留日期後，按一下「Update」(更新)。

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 備份) 頁面。

    前往 Cloud SQL 備份

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

    您會看到所有保留和最終備份的清單，以及已刪除執行個體的詳細資料。

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

  4. 在「Edit Backup Description」(編輯備份說明) 視窗中，更新備份說明。

  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 備份) 頁面。

    前往 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 回覆：

後續步驟