このページの情報の一部またはすべては、S3NS の Trusted Cloud には適用されない場合があります。
保持されたバックアップを管理する
このページでは、保持された Cloud SQL インスタンスのバックアップを有効化、無効化、管理する方法について説明します。
保持されたバックアップとは、インスタンスの削除後に保持されるバックアップのことです。これらのバックアップには、インスタンスの稼働中に作成されたオンデマンド バックアップと自動バックアップが含まれます。バックアップ保持の仕組みについて詳しくは、保持されたバックアップをご覧ください。
保持されたバックアップは、インスタンスを編集することで、インスタンスでいつでも有効にできます。保持されたバックアップを新しいインスタンスまたは既存のインスタンスに復元することもできます。
始める前に
保持されたバックアップを Trusted Cloud プロジェクトで管理するには、次の権限が必要です。
| タスク |
必要な権限 |
| バックアップを一覧で確認する |
cloudsql.backupRuns.list |
| バックアップを記述する |
cloudsql.backupRuns.get |
| バックアップを更新する |
cloudsql.backupRuns.update |
| バックアップを削除する |
cloudsql.backupRuns.delete |
保持されたバックアップを Trusted Cloud プロジェクトで管理するには、次の権限が必要です。
| アクション |
コマンド |
必要な権限 |
| バックアップを一覧で確認する |
gcloud sql backups list |
cloudsql.backupRuns.list |
| バックアップを記述する |
gcloud sql backups describe |
cloudsql.backupRuns.get |
| バックアップを更新する |
gcloud sql backups patch |
cloudsql.backupRuns.update |
| バックアップを削除する |
gcloud sql backups delete |
cloudsql.backupRuns.delete |
REST
保持されたバックアップを Trusted Cloud プロジェクトで管理するには、次の権限が必要です。
| アクション |
方法 |
必要な権限 |
| バックアップを一覧で確認する |
backups.listBackup |
cloudsql.backupRuns.list |
| バックアップを記述する |
backups.getBackup |
cloudsql.backupRuns.get |
| バックアップを更新する |
backups.updateBackup |
cloudsql.backupRuns.update |
| バックアップを削除する |
backups.deleteBackup |
cloudsql.backupRuns.delete |
インスタンスの保持されたバックアップを有効にする
保持されたバックアップは、インスタンスの作成時または既存のインスタンスの編集時に、インスタンスの [データ保護] 構成オプションで有効にできます。
保持されたすべてのバックアップを一覧で確認する
Trusted Cloud プロジェクトの保持されたすべてのバックアップを一覧で確認するには、Trusted Cloud コンソール、gcloud CLI、または Cloud SQL API を使用します。バックアップには、バックアップの名前、バックアップが属するインスタンス、バックアップのタイプ、インスタンスが削除された時刻などの詳細が含まれます。削除されたインスタンスの名前は再利用できる場合があるため、instance deletion time フィールドを使用して、特定のバックアップがどのインスタンスに属しているかを区別することをおすすめします。ライブ インスタンスの場合、このフィールドは空白です。
コンソール
Trusted Cloud コンソールで、Cloud SQL の [バックアップ] ページに移動します。
Cloud SQL の [バックアップ] に移動
バックアップを表示する削除済みインスタンスの名前をクリックします。
保持されたすべてのバックアップおよび最終バックアップの一覧と、削除されたインスタンスの詳細が表示されます。
gcloud
プロジェクトに関連付けられているすべてのバックアップを一覧で確認するには、gcloud sql backups list コマンドを使用します。 Trusted Cloud
gcloud sql backups list
--project=PROJECT_ID
次のように置き換えます。
PROJECT_ID: Trusted Cloud プロジェクト ID。
保持された特定のバックアップの詳細を確認するには、gcloud sql backups describe コマンドを使用します。
gcloud sql backups describe BACKUP_NAME
--project=PROJECT_ID
次のように置き換えます。
BACKUP_NAME: 保持されたバックアップの名前。PROJECT_ID: Trusted Cloud プロジェクト ID。
REST v1
保持されたすべてのバックアップを一覧で確認する
この例では、Trusted Cloud プロジェクトに関連付けられている、保持されたすべてのバックアップを一覧で確認します。この呼び出しのパラメータの全一覧については、backups.listBackups ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
HTTP メソッドと URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups"
PowerShell（Windows）
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"name": "projects/PROJECT_ID/backups/BACKUP_ID",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
"satisfies_pzs": false,
"satisfies_pzi": false
}
保持されたバックアップの詳細を確認する
この例では、保持されたバックアップの詳細を確認します。この呼び出しのパラメータの全一覧については、backup.getBackup ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
HTTP メソッドと URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID"
PowerShell（Windows）
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"name": "projects/PROJECT_ID/backups/BACKUP_ID",
"kind": "sql#backup",
"status": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
"location": "us"
"description": "final backup",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
"satisfies_pzs": false,
"satisfies_pzi": false
}
REST v1beta4
保持されたすべてのバックアップを一覧で確認する
この例では、Trusted Cloud プロジェクトに関連付けられている、保持されたすべてのバックアップを一覧で確認します。この呼び出しのパラメータの全一覧については、backups.listBackups ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
HTTP メソッドと URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups"
PowerShell（Windows）
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"name": "projects/PROJECT_ID/backups/BACKUP_ID",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
"satisfies_pzs": false,
"satisfies_pzi": false
}
保持されたバックアップの詳細を確認する
この例では、保持されたバックアップの詳細を確認します。この呼び出しのパラメータの全一覧については、backups.getBackup ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
HTTP メソッドと URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID"
PowerShell（Windows）
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"name": "projects/PROJECT_ID/backups/BACKUP_ID",
"kind": "sql#backup",
"status": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
"location": "us"
"description": "final backup",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
"satisfies_pzs": false,
"satisfies_pzi": false
}
保持されたバックアップの説明を更新する
保持されたバックアップの説明はいつでも更新して、バックアップを簡単に識別できるようにできます。
コンソール
Trusted Cloud コンソールで、Cloud SQL の [バックアップ] ページに移動します。
Cloud SQL の [バックアップ] に移動
バックアップを表示する削除済みインスタンスの名前をクリックします。
保持されたすべてのバックアップおよび最終バックアップの一覧と、削除されたインスタンスの詳細が表示されます。
更新する保持されたバックアップのその他の操作アイコン 
をクリックし、[説明を編集] を選択します。
[バックアップの説明の編集] ウィンドウで、バックアップの説明を更新します。
[更新] をクリックします。
gcloud
保持されたバックアップの説明を更新するには、gcloud sql backups patch コマンドを使用します。
gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION
次のように置き換えます。
BACKUP_NAME: 保持されたバックアップの名前。BACKUP_DESCRIPTION: 保持されたバックアップに追加する新しい説明。
REST v1
保持されたすべてのバックアップを一覧で確認する
この例では、Trusted Cloud プロジェクトに関連付けられている、保持されたすべてのバックアップを一覧で確認します。この呼び出しのパラメータの全一覧については、backups.listBackups ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
HTTP メソッドと URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups"
PowerShell（Windows）
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"name": "projects/PROJECT_ID/backups/BACKUP_ID",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
"satisfies_pzs": false,
"satisfies_pzi": false
}
説明を更新する
この例では、最終バックアップの説明を更新します。この呼び出しのパラメータの全一覧については、backups.updateBackup ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
- DESCRIPTION: 最終バックアップの更新された説明。
HTTP メソッドと URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description
リクエストの本文（JSON）:
{
"backup": {
"description": DESCRIPTION,
},
}
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description"
PowerShell（Windows）
リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID",
"targetId": "BACKUP_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
REST v1beta4
保持されたすべてのバックアップを一覧で確認する
この例では、Trusted Cloud プロジェクトに関連付けられている、保持されたすべてのバックアップを一覧で確認します。この呼び出しのパラメータの全一覧については、backups.listBackups ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
HTTP メソッドと URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups"
PowerShell（Windows）
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"name": "projects/PROJECT_ID/backups/BACKUP_ID",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
"satisfies_pzs": false,
"satisfies_pzi": false
}
説明を更新する
この例では、最終バックアップの説明を更新します。この呼び出しのパラメータの全一覧については、backups.updateBackup ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
- DESCRIPTION: 最終バックアップの更新された説明。
HTTP メソッドと URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description
リクエストの本文（JSON）:
{
"backup": {
"description": DESCRIPTION,
},
}
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description"
PowerShell（Windows）
リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID",
"targetId": "BACKUP_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
保持されたバックアップを削除する
保持されたバックアップは、 Trusted Cloud コンソール、gcloud CLI、または Cloud SQL API を使用して削除できます。
コンソール
Trusted Cloud コンソールで、Cloud SQL の [バックアップ] ページに移動します。
Cloud SQL の [バックアップ] に移動
バックアップを表示する削除済みインスタンスの名前をクリックします。
保持されたすべてのバックアップおよび最終バックアップの一覧と、削除されたインスタンスの詳細が表示されます。
削除する保持されたバックアップのその他の操作アイコン をクリックし、[削除] を選択します。
[バックアップの削除] ウィンドウで、削除するインスタンスの名前を入力し、[削除] をクリックします。
gcloud
保持されたバックアップを削除するには、gcloud sql backups delete コマンドを使用します。
gcloud sql backups delete BACKUP_NAME
次のように置き換えます。
BACKUP_NAME: 保持されたバックアップの名前。
REST v1
保持されたすべてのバックアップを一覧で確認する
この例では、Trusted Cloud プロジェクトに関連付けられている、保持されたすべてのバックアップを一覧で確認します。この呼び出しのパラメータの全一覧については、backups.listBackups ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
HTTP メソッドと URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups"
PowerShell（Windows）
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"name": "projects/PROJECT_ID/backups/BACKUP_ID",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
"satisfies_pzs": false,
"satisfies_pzi": false
}
保持されたバックアップを削除する
保持されたバックアップを削除するには、次の例を使用します。この呼び出しのパラメータの全一覧については、backups.deleteBackup ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
HTTP メソッドと URL:
DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
次のコマンドを実行します。
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_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/backups/BACKUP_ID" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "DELETE_BACKUP",
"name": "OPERATION_ID",
"targetId": "BACKUP_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
REST v1beta4
保持されたすべてのバックアップを一覧で確認する
この例では、Trusted Cloud プロジェクトに関連付けられている、保持されたすべてのバックアップを一覧で確認します。この呼び出しのパラメータの全一覧については、backups.listBackups ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
HTTP メソッドと URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups
リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups"
PowerShell（Windows）
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"name": "projects/PROJECT_ID/backups/BACKUP_ID",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
"satisfies_pzs": false,
"satisfies_pzi": false
}
保持されたバックアップを削除する
保持されたバックアップを削除するには、次の例を使用します。この呼び出しのパラメータの全一覧については、backups.deleteBackup ページをご覧ください。
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
HTTP メソッドと URL:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_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/backups/BACKUP_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/backups/BACKUP_ID" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "DELETE_BACKUP",
"name": "OPERATION_ID",
"targetId": "BACKUP_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-02 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-07-02 UTC。"],[],[]]
