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

刪除執行個體
透過集合功能整理內容你可以依據偏好儲存及分類內容。

MySQL | PostgreSQL | SQL Server

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

如要刪除執行個體，請注意下列事項：

您無法刪除具有任何備用資源的執行個體。您必須先刪除所有備用資源。
您可以建立備用資源，減少不小心刪除執行個體的機率；備用資源必須在主要執行個體之前刪除。
在您刪除執行個體之後，其可能仍會以「不明」大小出現在您的專案中，但狀態為「刪除中」。這是正常現象，在一段時間後，執行個體就會完全消失。
與執行個體相關的基礎資源可能需要最多四天才能完全刪除，但讀取複本通常會在幾分鐘內刪除。
刪除的執行個體名稱可立即重複使用，用於建立新的執行個體。
如果執行個體已啟用防刪除功能，您必須先停用這項功能，才能刪除執行個體。
萬一發生意外狀況，請備份最終備份，以便還原已刪除的執行個體。

所需權限

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

您也可以為包含 cloudsql.instances.delete 權限的使用者或服務帳戶定義 IAM 自訂角色。這項權限在 IAM 自訂角色中支援。

刪除執行個體

您可以使用 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 記錄。

控制台

前往 Google Cloud 控制台的「Cloud SQL 執行個體」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
點選「刪除」。
在「Delete instance」對話方塊中，完成下列操作：

在文字欄位中輸入顯示的執行個體 ID。
如果您想為執行個體建立最終備份，請保留「建立最終備份」核取方塊，展開「保留選項」選單，然後在「保留天數」欄位中輸入最終備份的保留天數。您可以指定 1 到 365 天。

如果您想刪除執行個體，但不建立最終備份，請取消勾選核取方塊。
在「為這個備份提供說明」文字方塊中，您可以提供備份的說明。
點選「刪除」。

gcloud

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

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

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

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

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

--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：包含要刪除的執行個體的 Google Cloud 專案 ID 或專案編號
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 CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 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": "[email protected]",
  "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：包含要刪除的執行個體的 Google Cloud 專案 ID 或專案編號
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)

執行下列指令：

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": "[email protected]",
  "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 位址。系統也會一併復原刪除時可用的所有備份。

刪除執行個體 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

所需權限

刪除執行個體

控制台

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

還原已刪除的執行個體

刪除執行個體
透過集合功能整理內容你可以依據偏好儲存及分類內容。