インスタンスを削除する

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

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

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

必要な権限

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

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

インスタンスを削除する

Cloud SQL のインスタンスを削除するには、gcloud CLI または API を使用します。

注: インスタンスを削除する前に、削除しても問題ないことを確認してください。次に、そのインスタンスの削除保護が無効になっていることを確認してください。

Private Service Connect が有効になっているインスタンスを削除すると、次の処理が行われます。

サービスアタッチメントが自動的に削除されます。ただし、サービスアタッチメントを指す Private Service Connect エンドポイントが自動的に削除されることはありません。エンドポイントに関連付けられている転送ルールを一覧表示すると、ルールのステータスが CLOSED であることを確認できます。このステータスを受け取った後は、エンドポイントを削除できます。
エンドポイントへの接続がタイムアウトします。

追加費用の発生を防ぐために、対応する DNS ゾーンと DNS レコードも削除することを強くおすすめします。

コンソール

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

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

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 メソッドと URL:

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 のページの API Explorer をご覧ください。

REST v1beta4

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

PROJECT_ID: 削除するインスタンスが含まれている Google Cloud プロジェクトの ID またはプロジェクト番号
INSTANCE_NAME: インスタンスの名前

HTTP メソッドと URL:

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）

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

$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 のページの API Explorer をご覧ください。