删除多个实例

本页面介绍如何删除 Cloud SQL 实例。

如果您计划删除实例，请注意以下事项：

只要实例具有任何副本，您就不能删除该实例。必须先删除所有副本。
您可以通过创建副本来降低意外删除实例的几率；副本必须在其主实例之前删除。
删除某实例后，该实例可能仍然显示在项目中，大小为“未知”，但其状态为“正在删除”。这是正常的，而且在短时间后该实例会完全消失。
完全删除与实例相关的底层资源可能需要长达一周时间，但只读副本除外，通常会在几分钟内删除。
您可以立即重新使用已删除的实例名称来创建新实例。
如果为实例启用了删除保护，则必须先将其停用，然后才能删除该实例。

所需权限

默认情况下，只有具有 Cloud SQL Admin (roles/cloudsql.admin) 或 Owner (roles/owner) 角色的用户或服务账号有权删除 Cloud SQL 实例 (cloudsql.instances.delete)。

您还可以为包含 cloudsql.instances.delete 权限的用户或服务账号定义 IAM 自定义角色。IAM 自定义角色支持此权限。

删除实例

您可以使用 gcloud CLI 或 API 删除 Cloud SQL 实例。

控制台

在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

转到“Cloud SQL 实例”
如需打开实例的概览页面，请点击实例名称。
点击删除。
在删除数据库实例对话框中，点击确定。

gcloud

若要删除实例，请使用 gcloud sql instances delete 命令：

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

进行以下替换：

INSTANCE_NAME：实例的名称
PROJECT_ID：包含待删除实例的 Google Cloud 项目的 ID 或项目编号

REST v1

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：包含待删除实例的 Google Cloud 项目的 ID 或项目编号
INSTANCE_NAME：实例的名称

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": "user@example.com",
  "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：实例的名称

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": "user@example.com",
  "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。