本頁面由 Cloud Translation API 翻譯而成。

建立及管理隨選和自動備份

MySQL | PostgreSQL | SQL Server

此頁面說明如何排定自動備份時程與關閉自動備份、建立及管理隨選備份，以及查看 Cloud SQL 執行個體的備份。

如想深入瞭解備份的運作方式，請參閱備份總覽一文。

建立按照需求執行的備份

建立隨選備份：

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
在 SQL 導覽選單中選取「備份」。
按一下「Create backup」(建立備份)。
在「建立備份」頁面上，視需要新增說明，然後按一下「建立」。

gcloud

建立備份：

gcloud sql backups create \ --async \ --instance=INSTANCE_NAME

你可以使用 --description 參數提供備份說明。

如要在自訂位置建立備份，請按照下列步驟操作：

gcloud sql backups create \ --async \ --instance=INSTANCE_NAME \ --location=BACKUP_LOCATION

REST v1

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或使用 Cloud Shell，自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "BACKUP_VOLUME",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

REST v1beta4

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "BACKUP_VOLUME",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

排定自動備份時間

為執行個體排定自動備份時程：

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
在 SQL 導覽選單中選取「備份」。
按一下「設定」旁的「編輯」。
選擇自動備份資料的時間範圍。
按一下 [儲存]。

gcloud

編輯執行個體，指定備份開始時間：
```
gcloud sql instances patch INSTANCE_NAME --backup-start-time=HH:MM
```
backup-start-time 參數會以 24 小時制指定在 UTC±00 時區中，並指定 4 小時備份時間的開始。備份作業會在備份期間開始。
確認變更：
```
gcloud sql instances describe INSTANCE_NAME
```
在 backupConfiguration 部分中，確認您看到 enabled: true 和您指定的時間。

Terraform

如要建立資料庫備份，請使用 Terraform 資源。

resource "google_sql_database_instance" "instance" {   name             = "postgres-instance-backup"   region           = "us-central1"   database_version = "POSTGRES_14"   settings {     tier = "db-custom-2-7680"     backup_configuration {       enabled    = true       start_time = "20:55"     }   }   # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by   # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.   deletion_protection = false }

套用變更

如要在 Google Cloud 專案中套用 Terraform 設定，請完成下列各節的步驟。

準備 Cloud Shell

啟動 Cloud Shell。
設定要套用 Terraform 設定的預設 Google Cloud 專案。

每項專案只需要執行一次這個指令，且可以在任何目錄中執行。
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
如果您在 Terraform 設定檔中設定明確值，環境變數就會遭到覆寫。

準備目錄

每個 Terraform 設定檔都必須有自己的目錄 (也稱為根模組)。

在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱的副檔名必須是 .tf，例如 main.tf。在本教學課程中，這個檔案稱為 main.tf。
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
如果您正在學習教學課程，可以複製每個章節或步驟中的範例程式碼。

將範例程式碼複製到新建立的 main.tf。

視需要從 GitHub 複製程式碼。如果 Terraform 程式碼片段是端對端解決方案的一部分，建議您使用這個方法。
查看並修改範例參數，套用至您的環境。
儲存變更。
初始化 Terraform。每個目錄只需執行一次這項操作。
```
terraform init
```
如要使用最新版 Google 供應商，請加入 -upgrade 選項：
```
terraform init -upgrade
```

套用變更

檢查設定，確認 Terraform 即將建立或更新的資源符合您的預期：
```
terraform plan
```
視需要修正設定。
執行下列指令，並在提示中輸入 yes，即可套用 Terraform 設定：
```
terraform apply
```
等待 Terraform 顯示「Apply complete!」訊息。
開啟 Google Cloud 專案即可查看結果。在 Google Cloud 控制台中，前往 UI 中的資源，確認 Terraform 已建立或更新這些資源。

刪除變更

如要刪除變更，請按照下列步驟操作：

如要停用防刪除功能，請在 Terraform 設定檔中將 deletion_protection 引數設為 false。
```
deletion_protection =  "false"
```
執行下列指令，並在提示中輸入 yes，套用更新的 Terraform 設定：
```
terraform apply
```

執行下列指令，並在提示中輸入 yes，移除先前透過 Terraform 設定套用的資源：
```
terraform destroy
```

REST v1

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：包含執行個體的專案 ID 或專案編號 Google Cloud
INSTANCE_NAME：您要設定高可用性的主要或讀取備用資源執行個體名稱
START_TIME：時間 (以小時和分鐘為單位)

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 要求主體：

 {   "settings":   {     "backupConfiguration":     {       "startTime": "START_TIME",       "enabled": true,       "binaryLogEnabled": true     }   } }

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "UPDATE",   "name": "OPERATION_ID",   "targetId": "INSTANCE_NAME",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",   "targetProject": "PROJECT_ID" }

REST v1beta4

您可以在 backupConfiguration 物件中將 pointInTimeRecoveryEnabled 設為 true，同時啟用時間點復原功能。

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：包含執行個體的專案 ID 或專案編號 Google Cloud
INSTANCE_NAME：您要設定高可用性的主要或讀取備用資源執行個體名稱
START_TIME：時間 (以小時和分鐘為單位)

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 要求主體：

 {   "settings":   {     "backupConfiguration":     {       "startTime": "START_TIME",       "enabled": true,       "pointInTimeRecoveryEnabled": true     }   } }

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "UPDATE",   "name": "OPERATION_ID",   "targetId": "INSTANCE_NAME",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",   "targetProject": "PROJECT_ID" }

設定自訂備份位置

只有在法規要求時，才使用自訂備份位置。如無必要，請使用預設的多地區備份位置。

您可以為隨選備份和自動備份使用自訂位置。如需有效位置值的完整清單，請參閱執行個體位置。

如要使用自訂位置更新執行個體，請按照下列步驟操作：

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
在 SQL 導覽選單中，選取「備份」。
按一下「設定」旁邊的「編輯」。
在「Automated Backups」(自動備份) 區段中，展開「Advanced Options」(進階選項)。
按一下「多區域 (預設)」或「區域」。
從「位置」下拉式選單中選取位置。
按一下 [儲存]。

gcloud

如需參考資訊，請參閱 gcloud sql instances patch。

gcloud sql instances patch INSTANCE_NAME \ --backup-location=BACKUP_LOCATION

Terraform

如要為資料庫執行個體備份指定自訂位置，請使用 Terraform 資源。

resource "google_sql_database_instance" "default" {   name             = "postgres-instance-with-backup-location"   region           = "us-central1"   database_version = "POSTGRES_14"   settings {     tier = "db-custom-2-7680"     backup_configuration {       enabled  = true       location = "us-central1"     }   } }

REST v1

使用執行個體的 settings.backupConfiguration.location 參數設定備份位置。

使用任何要求資料之前，請先替換以下項目：

region：專案區域
backup-region：備份區域
project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON 要求主體：

 {   "region": "region"   "settings":   {     "backupConfiguration":     {       "location": "backup-region",       "enabled": true,     }   } }

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "UPDATE",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

REST v1beta4

使用執行個體的 settings.backupConfiguration.location 參數設定備份位置。

使用任何要求資料之前，請先替換以下項目：

region：專案區域
backup-region：備份區域
project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 要求主體：

 {   "region": "region"   "settings":   {     "backupConfiguration":     {       "location": "backup-region",       "enabled": true,     }   } }

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "UPDATE",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

查看備份清單

如要查看備份清單和備份詳細資料，請使用下列選項。

Google Cloud 控制台不會在備份記錄中顯示略過或失敗的備份。如要查看略過的備份，請使用 gcloud 或 API。

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
從 SQL 導覽選單中選取「備份」，即可查看最近的備份，以及備份的建立時間和類型。

gcloud

列出執行個體的備份：
```
gcloud sql backups list \ --instance INSTANCE_NAME
```
您可以使用標準清單參數篩選及控制結果。如需完整清單，請參閱 gcloud sql backups list 指令參考頁面。
指定 backups list 指令的輸出內容中的備份 ID，即可查看備份詳細資料。
```
gcloud sql backups describe BACKUP_ID \ --instance INSTANCE_NAME     
```

REST v1

您也可以使用 BackupRuns:list 頁面上的 APIs Explorer 傳送 REST API 要求。

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }

REST v1beta4

您也可以使用 BackupRuns:list 頁面上的 APIs Explorer 傳送 REST API 要求。

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }

在服務中斷期間查看備份清單

如果執行個體位於發生中斷的區域，您只能使用 backupRuns.list API 搭配萬用字元 (-) 查看該執行個體的備份。萬用字元會傳回專案中的所有備份。請參閱「還原至其他執行個體」。

如果執行個體所在的區域發生中斷，且該執行個體已啟用客戶管理的加密金鑰 (CMEK)，您就無法將該執行個體的備份還原至其他區域。這是因為在執行個體上啟用 CMEK 時，Cloud SQL 會使用區域 Cloud KMS 金鑰進行加密。如要還原 CMEK 執行個體的備份，Cloud SQL 必須有權存取 CMEK 金鑰。如果發生區域性中斷，您就無法存取該區域的 Cloud KMS 金鑰。

gcloud

列出專案中每個執行個體的備份：

gcloud sql backups list --instance -

指令會傳回類似下列的資訊：

{       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"       "backupKind": "SNAPSHOT"     }

找出所需執行個體的備份檔。如要還原這個備份，請參閱「還原至其他執行個體」。

REST v1

列出專案中的所有備份： <

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：專案 ID
INSTANCE_ID：例項 ID，或 - (如要查看專案中的所有備份)

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/-/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/-/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/-/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "BACKUP_ID",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "INSTANCE_ID",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_ID",       "location": "us"       "backupKind": "SNAPSHOT"     }

找出所需執行個體的備份檔。如要還原這個備份，請參閱「還原至其他執行個體」。

REST v1beta4

列出專案中的所有備份： <

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：例項 ID，或 -，用於列出專案中的所有備份

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/-/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/-/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/-/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"       "backupKind": "SNAPSHOT"     }

找出所需執行個體的備份檔。如要還原這個備份，請參閱「還原至其他執行個體」。

查看備份位置

如要查看執行個體使用的備份位置，請使用 backupRuns：

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
在 SQL 導覽選單中選取「備份」。
在備份清單中，「位置」欄會列出位置類型 (多區域或區域)，以及每個備份的特定多區域或區域。

gcloud

如需參考資訊，請參閱 gcloud sql instances describe。

列出執行個體的備份：
```
gcloud sql backups list \ --instance INSTANCE_NAME
```
您可以使用標準清單參數篩選及控制結果。如需完整清單，請參閱 gcloud sql backups list 指令參考頁面。
如要列出單一備份的詳細資料，請使用 ID (來自 backups list 指令的輸出內容)。
```
gcloud sql backups describe BACKUP_ID \ --instance INSTANCE_NAME
```

REST v1

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

在先前的範例中：

REGION 是原始執行個體的所在地區。
BACKUP_LOCATION 是您要 Cloud SQL 儲存備份的所在位置。

REST v1beta4

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

在先前的範例中：

REGION 是原始執行個體的所在地區。
BACKUP_LOCATION 是您要 Cloud SQL 儲存備份的所在位置。

查看備份大小

您可以使用 gcloud CLI 或 API，查看 Cloud SQL 執行個體的備份大小。

gcloud

如要取得與 Google Cloud 專案相關聯的所有備份清單，請使用 gcloud sql backups list 指令：
```
gcloud sql backups list
```
注意：使用這項指令可擷取備份資訊，包括備份 ID。您需要備份 ID 才能查看備份大小。

此外，您也可以使用標準清單參數，篩選及控管執行這項指令的結果。如需完整清單，請參閱 gcloud sql backups list 指令參考頁面。
如要查看備份大小，請使用 gcloud sql backups describe 指令：
```
gcloud sql backups describe BACKUP_ID \ --instance=INSTANCE_NAME \ --project=PROJECT_ID
```
請將下列項目改為對應的值：
- BACKUP_ID：備份 ID。您可以從執行 gcloud sql backups list 指令的輸出內容取得這個 ID。
- INSTANCE_NAME：執行個體的名稱。
- PROJECT_ID：包含執行個體的專案 ID 或專案編號。 Google Cloud
在輸出內容中，maxChargeableBytes 參數會顯示備份大小 (以位元組為單位)。

REST

取得備份清單

使用這個範例，取得與 Google Cloud 專案相關聯的所有備份清單。如需這項呼叫的完整參數清單，請參閱 backupRuns.list 頁面。

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：包含執行個體的專案 ID 或專案編號 Google Cloud
INSTANCE_NAME：執行個體名稱

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {       "name": "projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns",       "kind": "sql#backupRun",       "enqueuedTime": "2024-04-24T22:16:02.208Z",       "id": "INSTANCE_ID",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/instances/INSTANCE_NAME/backupRuns",       "location": "us",       "description": "get a list of backups",       "instance": "INSTANCE_NAME" }

查看備份詳細資料

使用這個範例查看備份詳細資料，包括備份大小。如需這項呼叫的完整參數清單，請參閱 backupRuns.get 頁面。

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：包含執行個體的專案 ID 或專案編號。 Google Cloud
INSTANCE_NAME：執行個體的名稱。
BACKUP_ID：備份 ID。這個 ID 是從執行上一個呼叫的輸出內容取得。

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns/BACKUP_ID

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns/BACKUP_ID"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns/BACKUP_ID" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {       "name": "projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns/BACKUP_ID",       "kind": "sql#backupRun",       "enqueuedTime": "2024-04-24T22:16:02.208Z",       "id": "INSTANCE_ID",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/instances/INSTANCE_NAME/backupRuns/BACKUP_ID",       "location": "us",       "description": "view details about a backup",       "maxChargeableBytes": "BYTE_NUMBER",       "instance": "INSTANCE_NAME" }

設定自動備份保留期限

如要設定要保留的自動備份數量，請按照下列步驟操作：

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
在 SQL 導覽選單中選取「備份」。
按一下 [編輯]。
在「自動備份」部分，展開「進階選項」。
輸入要一次儲存的備份數量。
按一下 [儲存]。

gcloud

編輯執行個體，設定要保留的自動備份數量。不得少於預設值 (七)。

gcloud sql instances patch INSTANCE_NAME \ --retained-backups-count=NUM_TO_RETAIN

Terraform

如要指定資料庫執行個體要保留的自動備份數量，請使用 Terraform 資源。

resource "google_sql_database_instance" "default" {   name             = "postgres-instance-backup-retention"   region           = "us-central1"   database_version = "POSTGRES_14"   settings {     tier = "db-custom-2-7680"     backup_configuration {       enabled = true       backup_retention_settings {         retained_backups = 365         retention_unit   = "COUNT"       }     }   } }

REST v1beta4

使用任何要求資料之前，請先替換以下項目：

unit：選用：保留單位可以是整數或字串。目前支援 (預設) 的值為 1 或「COUNT」。
num-to-retain：要保留的自動備份數量，範圍為 1 到 365。
project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 要求主體：

 {   "settings":   {     "backupConfiguration":     {       "backupRetentionSettings":       {         "retentionUnit": unit,         "retainedBackups": "num-to-retain"       }     }   } }

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "UPDATE",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

刪除備份

您可以刪除自動及隨選備份。

刪除備份所釋放的空間可能無法達到備份的大小。這是因為備份是以增量方式備份，因此刪除較舊備份可能會將其部分內容轉移到更近的備份，以保留較新備份的完整性。

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
在 SQL 導覽選單中選取「備份」。
對您要刪除的備份，按一下更多動作圖示。
選取 [刪除]。
在「Delete backup」(刪除備份) 視窗中，將 Delete 輸入到欄位中，然後按一下「Delete」(刪除)。

gcloud

刪除 Cloud SQL 執行個體的備份：

gcloud beta sql backups delete BACKUP_ID \ --instance INSTANCE_NAME

如需完整參數清單，請參閱 gcloud beta sql backups delete 指令參考頁面。

REST v1

列出備份，取得要刪除的備份 ID：

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }

刪除備份： <0x0A

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID
backup-id：備份 ID

HTTP 方法和網址：

DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "DELETE_BACKUP",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

REST v1beta4

列出備份，取得要刪除的備份 ID：

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }

刪除備份： <0x0A

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID
backup-id：備份 ID

HTTP 方法和網址：

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "DELETE_BACKUP",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

停用自動備份功能

如要停用執行個體的自動備份功能，請按照下列步驟操作：

控制台

前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
在 SQL 導覽選單中選取「備份」。
按一下「管理自動備份」
取消勾選「自動備份」。
按一下 [儲存]。

gcloud

編輯執行個體以停用備份：

gcloud sql instances patch INSTANCE_NAME \ --no-backup

REST v1

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON 要求主體：

 {   "settings":   {     "backupConfiguration":     {       "enabled": false     }   } }

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "UPDATE",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

REST v1beta4

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 要求主體：

 {   "settings":   {     "backupConfiguration":     {       "enabled": false,       "pointInTimeRecoveryEnabled": false     }   } }

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "UPDATE",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

時間點復原

進一步瞭解時間點復原。

建立及管理隨選和自動備份 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

建立按照需求執行的備份

控制台

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

排定自動備份時間

控制台

gcloud

Terraform

套用變更

準備 Cloud Shell

準備目錄

套用變更

刪除變更

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

設定自訂備份位置

控制台

gcloud

Terraform

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

查看備份清單

控制台

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

在服務中斷期間查看備份清單

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

查看備份位置

控制台

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

查看備份大小

gcloud

REST

取得備份清單

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

建立及管理隨選和自動備份