このページは Cloud Translation API によって翻訳されました。

インスタンスの削除

MySQL | PostgreSQL | SQL Server

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

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

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

必要な権限

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

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

インスタンスの削除

Cloud SQL のインスタンスは、 Google Cloud コンソール、gcloud CLI、API を使って削除できます。削除する前にインスタンスのバックアップを保存する場合は、保持されたバックアップを管理するをご覧ください。

注: インスタンスを削除する前に、削除しても問題ないことを確認してください。次に、そのインスタンスの削除保護が無効になっていることを確認してください。また、インスタンスを削除する前に、インスタンスの最終バックアップを取得することを強くおすすめします。

Cloud Key Management Service を使用してインスタンスを暗号化したが、KMS 鍵にアクセスできない場合、インスタンスを削除した後の最終バックアップのステータスは FAILED になります。この場合、インスタンスを削除してから 4 日以内に Cloud カスタマーケアに問い合わせ、インスタンスの復元をリクエストしてください。

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

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

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

コンソール

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

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

テキストフィールドに、表示されたインスタンス 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: バックアップの有効期限のタイムスタンプ（UTC）。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: バックアップの有効期限のタイムスタンプ（UTC）。1 年を超えて設定することはできません。保持期間を指定する場合は、このパラメータまたは final_backup_ttl_days を使用します。

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: インスタンスの名前

注: インスタンスの最終バックアップを取得する場合は、次のクエリパラメータを使用します。

enable_final_backup: 最終バックアップを取得するには、このパラメータの値を true に設定します。最終バックアップを取得せずにインスタンスを削除する場合は、値を false に設定します。
final_backup_description: 最終バックアップの詳細を入手できます。デフォルト値は空です。
final_backup_ttl_days: 最終バックアップを保持する日数を指定します。これは有効期間（TTL）と呼ばれます。デフォルト値は 30 日です。許可される保持期間は 1～365 日です。保持期間を指定する場合は、このパラメータまたは final_backup_expiry_time を使用します。
final_backup_expiry_time: バックアップの有効期限のタイムスタンプ（UTC）。1 年を超えて設定することはできません。保持期間を指定する場合は、このパラメータまたは final_backup_ttl_days を使用します。

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 をご覧ください。

削除したインスタンスを復元する

Cloud SQL でインスタンスを削除すると、オンデマンドバックアップや自動バックアップなど、インスタンスのすべてのリソースが削除されます。

インスタンスの削除時に最終バックアップを取得した場合は、このバックアップを使用してインスタンスを復元できます。最終バックアップからインスタンスを作成するか、最終バックアップを既存のインスタンスに復元することで復旧が可能です。

最終バックアップを使用してインスタンスを復元すると、インスタンスの IP アドレスが、削除された元のインスタンスの IP アドレスと異なる場合があります。

最終バックアップを取得せずにインスタンスを誤って削除した場合は、インスタンスの削除から 4 日以内に Cloud カスタマーケアにお問い合わせいただくと、インスタンスの復元をリクエストできます。インスタンスを復元できる場合は、削除前に使用されていた IP アドレスを含むインスタンス構成が復元されます。削除時に使用可能だったバックアップもすべて復元されます。

インスタンスの削除 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

必要な権限

インスタンスの削除

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

削除したインスタンスを復元する

インスタンスの削除