インスタンスを削除する

このページでは、Cloud SQL インスタンスを削除する方法について説明します。

インスタンスを削除する際には、次の点に注意してください。

レプリカがあるインスタンスは削除できません。最初にすべてのレプリカを削除する必要があります。
レプリカを作成することで、誤ってインスタンスが削除される可能性を減らすことができます。レプリカは、プライマリインスタンスより先に削除する必要があります。
削除したインスタンスがサイズ「不明」、ステータス「削除しています」で依然としてプロジェクトに表示される場合がありますが、これは正常な動作であり、インスタンスはすぐに表示されなくなります。
インスタンスと関連する基盤となるリソースが完全に削除されるまでに最長で 1 週間かかることがあります。ただし、リードレプリカは通常数分以内に削除されます。
削除したインスタンス名は、すぐに再利用して新しいインスタンスを作成できます。
インスタンスで削除保護が有効になっている場合は、インスタンスを削除する前に無効にする必要があります。

必要な権限

デフォルトでは、Cloud SQL Admin（roles/cloudsql.admin）ロールか、Owner（roles/owner）ロールを持つユーザーまたはサービスアカウントにのみ、Cloud SQL インスタンス（cloudsql.instances.delete）の削除権限があります。

また、cloudsql.instances.delete 権限を持つユーザーまたはサービスアカウントの IAM カスタムロールを定義することもできます。この権限は、IAM カスタムロールでサポートされています。

インスタンスを削除する

インスタンスを削除する前に、削除しても安全であることを確認します。その後、削除保護が無効になっていることを確認してください。

コンソール

Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動
インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[削除] をクリックします。
[データベースインスタンスの削除] ダイアログボックスで、[OK] をクリックします。

gcloud

インスタンスを削除します。

gcloud sql instances delete INSTANCE_NAME

REST v1

インスタンスを削除します。

リクエストのデータを使用する前に、次のように置き換えます。

project-id: プロジェクト ID
instance-id: インスタンス ID

HTTP メソッドと URL:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

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-id"

PowerShell（Windows）

次のコマンドを実行します。

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

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/var>instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "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 メソッドと URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-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"

PowerShell（Windows）

次のコマンドを実行します。

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

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/var>instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

基盤となる REST API リクエストがこのタスクでどのように作成されるかについては、インスタンス: delete ページの API Explorer をご覧ください。