刪除執行個體

MySQL   |  PostgreSQL   |  SQL Server

本頁說明如何刪除 Cloud SQL 執行個體。

警告： 刪除執行個體會一併永久刪除該執行個體上的所有資料，包括備份。如要保存資料，請在刪除之前將其匯出至 Cloud Storage。Cloud SQL 管理員角色具備刪除執行個體的權限。為避免誤刪，請視需要授予這個角色。 此外，也請考慮防刪除功能。

計畫刪除執行個體時，請注意下列事項：

• 刪除執行個體後，該執行個體可能仍會以「不明」大小出現在專案中，但狀態為「刪除中」。這是正常現象，過一段時間後，執行個體就會完全消失。
• 執行個體相關的基礎資源最多可能需要四天才能完全刪除，但唯讀副本通常會在幾分鐘內刪除。
• 刪除的執行個體名稱可立即重複使用，建立新的執行個體。
• 如果執行個體已啟用 防刪除功能，您必須先停用這項功能，才能刪除執行個體。
• 如果發生緊急狀況，請進行最終備份，以便還原已刪除的執行個體。

所需權限

根據預設，只有具備 Cloud SQL Admin (roles/cloudsql.admin) 或 Owner (roles/owner) 角色的使用者或服務帳戶，才有權刪除 Cloud SQL 執行個體 (cloudsql.instances.delete)。

您也可以為使用者或服務帳戶定義 IAM 自訂角色，其中包含 cloudsql.instances.delete 權限。這項權限支援身分與存取權管理自訂角色。

刪除執行個體

您可以使用 Google Cloud 控制台、gcloud CLI 或 API 刪除 Cloud SQL 執行個體。如要在刪除執行個體前保留備份，請參閱「管理保留的備份」。

注意： 刪除執行個體前，請先確認刪除作業是否安全，然後確認執行個體的刪除保護功能已停用。此外，強烈建議您在刪除執行個體前建立最終備份。

如果您使用 Cloud Key Management Service 加密執行個體，但無法存取 KMS 金鑰，則在刪除執行個體後，最終備份的狀態會顯示為 FAILED。如果發生這種情況，請在刪除執行個體後的 4 天內，與 Cloud Customer Care 聯絡，要求復原執行個體。

如果刪除已啟用 Private Service Connect 的執行個體，會發生下列情況：

• 系統會自動移除服務連結。不過，指向服務連結的 Private Service Connect 端點不會自動刪除。列出與端點相關聯的轉送規則後，您會發現該規則的狀態為 CLOSED。收到這個狀態後，您就可以刪除端點。
• 您會看到連線至端點逾時。

為避免產生額外費用，強烈建議您一併刪除對應的 DNS 區域和 DNS 記錄。

控制台

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

   前往 Cloud SQL 執行個體

2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
3. 點選「刪除」。
4. 在「刪除執行個體」對話方塊中，完成下列動作：
1. 在文字欄位中輸入顯示的執行個體 ID。

2. 如要對執行個體進行最終備份，請勾選「進行最終備份」核取方塊，展開「保留選項」選單，然後在「保留期限」欄位中，輸入最終備份的保留天數。可指定 1 到 365 天。

   如要刪除執行個體，但不進行最終備份，請取消勾選核取方塊。

3. 在「為這個備份提供說明」文字區域中，你可以提供備份的說明。
4. 點選「刪除」。

gcloud

如要刪除執行個體，請使用 gcloud sql instances delete 指令：

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

請將下列項目改為對應的值：

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

注意： 如要對執行個體進行最終備份，請使用下列標記：

• --enable-final-backup：將這個旗標的值設為 true，即可進行最終備份。如要刪除執行個體，但不進行最終備份，請將值設為 false。
• --final-backup-description：提供最終備份的詳細資料。預設值為空白。
• --final-backup-ttl-days：指定最終備份的保留天數。這就是所謂的存留時間 (TTL)。預設值為 30 天。保留期限可從 1 天到 365 天不等。如要提供保留期限，請使用這個旗標或 --final-backup-expiry-time。
• --final-backup-expiry-time：備份到期時間的時間戳記 (世界協調時間)。不得超過 1 年。如要提供保留期限，請使用這個旗標或 --final-backup-ttl-days。

REST v1

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

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

注意： 如要對執行個體進行最終備份，請使用下列查詢參數：

• enable_final_backup：將此參數的值設為 true，即可進行最終備份。如要刪除執行個體，但不進行最終備份，請將值設為 false。
• final_backup_description：提供最終備份的詳細資料。預設值為空白。
• final_backup_ttl_days：指定最終備份的保留天數。這就是所謂的存留時間 (TTL)。預設值為 30 天。保留期限可從 1 天到 365 天不等。如要提供保留期限，請使用這個參數或 final_backup_expiry_time。
• final_backup_expiry_time：備份到期時間的時間戳記 (世界協調時間)。不得超過 1 年。如要提供保留期限，請使用這個參數或 final_backup_ttl_days。

HTTP 方法和網址：

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

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

curl (Linux、macOS 或 Cloud Shell)

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

執行下列指令：

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

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_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

如要瞭解如何建立該工作的基礎 REST API 要求，請參閱 instances:delete 頁面中的 APIs Explorer。

REST v1beta4

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

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

注意： 如要對執行個體進行最終備份，請使用下列查詢參數：

• enable_final_backup：將此參數的值設為 true，即可進行最終備份。如要刪除執行個體，但不進行最終備份，請將值設為 false。
• final_backup_description：提供最終備份的詳細資料。預設值為空白。
• final_backup_ttl_days：指定最終備份的保留天數。這就是所謂的存留時間 (TTL)。預設值為 30 天。保留期限可從 1 天到 365 天不等。如要提供保留期限，請使用這個參數或 final_backup_expiry_time。
• final_backup_expiry_time：備份到期時間的時間戳記 (世界協調時間)。不得超過 1 年。如要提供保留期限，請使用這個參數或 final_backup_ttl_days。

HTTP 方法和網址：

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

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

curl (Linux、macOS 或 Cloud Shell)

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

執行下列指令：

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

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_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": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

如要瞭解如何建立該工作的基礎 REST API 要求，請參閱 instances:delete 頁面中的 APIs Explorer。

還原已刪除的執行個體

刪除執行個體時，Cloud SQL 會刪除該執行個體的所有資源，包括隨選備份和自動備份。

如果您在刪除執行個體時進行最終備份，則可使用這項備份還原執行個體，方法是從最終備份建立執行個體，或是將最終備份還原至現有執行個體。

如果您使用最終備份還原執行個體，則執行個體的 IP 位址可能與原始已刪除的執行個體不同。

如果您不小心刪除執行個體，且未進行最終備份，可以在執行個體刪除後的 4 天內，聯絡 Cloud 客戶服務要求復原執行個體。如果可以復原執行個體，系統會還原執行個體設定，包括刪除前使用的 IP 位址。系統也會還原刪除時的所有備份。