保持されたバックアップを管理する

このページでは、Cloud SQL インスタンスの保持バックアップを有効、無効、管理する方法について説明します。

保持バックアップは、インスタンスの削除後に保持されるバックアップです。これらのバックアップには、インスタンスが稼働中に作成されたオンデマンド バックアップと自動バックアップが含まれます。保持バックアップの仕組みについて詳しくは、保持バックアップをご覧ください。

保持バックアップは、インスタンスを編集することで、インスタンスでいつでも有効にできます。保持されたバックアップを新しいインスタンスまたは既存のインスタンスに復元することもできます。

始める前に

Google Cloud プロジェクトで保持バックアップを管理するには、次の権限が必要です。

タスク 必要な権限
バックアップを一覧表示する cloudsql.backupRuns.list
バックアップを記述する cloudsql.backupRuns.get
バックアップを更新する cloudsql.backupRuns.update
バックアップを削除する cloudsql.backupRuns.delete

gcloud CLI

Google 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

Google Cloud プロジェクトで保持バックアップを管理するには、次の権限が必要です。

アクション 方法 必要な権限
バックアップを一覧表示する backups.listBackup cloudsql.backupRuns.list
バックアップを記述する backups.getBackup cloudsql.backupRuns.get
バックアップを更新する backups.updateBackup cloudsql.backupRuns.update
バックアップを削除する backups.deleteBackup cloudsql.backupRuns.delete

インスタンスの保持バックアップを有効にする

保持バックアップは、インスタンスの作成時または既存のインスタンスの編集時に、インスタンスの [データ保護] 構成オプションで有効にできます。

保持されているすべてのバックアップのリストを表示する

Google Cloud プロジェクトの保持されているすべてのバックアップのリストを表示するには、Google Cloud コンソール、gcloud CLI、または Cloud SQL API を使用します。バックアップには、バックアップの名前、バックアップが属するインスタンス、バックアップのタイプ、インスタンスが削除された時刻などの詳細が含まれます。削除されたインスタンスの名前は再利用できる可能性があるため、instance deletion time フィールドを使用して、特定のバックアップがどのインスタンスに属しているかを区別することをおすすめします。ライブ インスタンスの場合、このフィールドは空白です。

コンソール

  1. Google Cloud コンソールで Cloud SQL の [バックアップ] ページに移動します。

    Cloud SQL の [バックアップ] に移動

  2. バックアップを表示する削除済みインスタンスの名前をクリックします。

    保持されたすべてのバックアップと最終バックアップのリストと、削除されたインスタンスの詳細が表示されます。

gcloud

  1. Google Cloud プロジェクトに関連付けられているすべてのバックアップのリストを取得するには、gcloud sql backups list コマンドを使用します。

    gcloud sql backups list
    --project=PROJECT_ID
    

    次のように置き換えます。

    • PROJECT_ID: Google Cloud プロジェクトの ID。
  2. 特定の保持バックアップの詳細を表示するには、gcloud sql backups describe コマンドを使用します。

    gcloud sql backups describe BACKUP_NAME
    --project=PROJECT_ID
    

    次のように置き換えます。

    • BACKUP_NAME: 保持するバックアップの名前。
    • PROJECT_ID: Google Cloud プロジェクトの ID。

REST v1

保持されているすべてのバックのリストを取得する

この例では、Google Cloud プロジェクトに関連付けられているすべての保持バックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、backups.listBackups ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

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

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

保持されたバックアップの詳細を表示する

この例では、保持されたバックアップの詳細を表示します。この呼び出しのパラメータの完全なリストについては、backup.getBackup ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID。
  • BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

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

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

REST v1beta4

保持されているすべてのバックのリストを取得する

この例では、Google Cloud プロジェクトに関連付けられているすべての保持バックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、backups.listBackups ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups

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

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

保持されたバックアップの詳細を表示する

この例では、保持されたバックアップの詳細を表示します。この呼び出しのパラメータの完全なリストについては、backups.getBackup ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID。
  • BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

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

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

保持バックアップの説明を更新する

保持されたバックアップの説明はいつでも更新して、バックアップを簡単に識別できるようにできます。

コンソール

  1. Google Cloud コンソールで Cloud SQL の [バックアップ] ページに移動します。

    Cloud SQL の [バックアップ] に移動

  2. バックアップを表示する削除済みインスタンスの名前をクリックします。

    保持されたすべてのバックアップと最終バックアップのリストと、削除されたインスタンスの詳細が表示されます。

  3. 更新する保持バックアップのその他の操作アイコン その他アイコン をクリックし、[説明を編集] を選択します。

  4. [バックアップの説明を編集] ウィンドウで、バックアップの説明を更新します。

  5. [更新] をクリックします。

gcloud

保持バックアップの説明を更新するには、gcloud sql backups patch コマンドを使用します。

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION

次のように置き換えます。

  • BACKUP_NAME: 保持するバックアップの名前。
  • BACKUP_DESCRIPTION: 保持するバックアップに追加する新しい説明。

REST v1

保持されているすべてのバックのリストを取得する

この例では、Google Cloud プロジェクトに関連付けられているすべての保持バックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、backups.listBackups ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

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

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

説明を更新する

この例では、保持バックアップの説明を更新します。この呼び出しのパラメータの一覧については、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,
         },
}

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

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

REST v1beta4

保持されているすべてのバックのリストを取得する

この例では、Google Cloud プロジェクトに関連付けられているすべての保持バックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、backups.listBackups ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups

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

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

説明を更新する

この例では、保持バックアップの説明を更新します。この呼び出しのパラメータの一覧については、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,
         },
}

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

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

保持されたバックアップを削除する

保持バックアップは、Google Cloud コンソール、gcloud CLI、または Cloud SQL API を使用して削除できます。

コンソール

  1. Google Cloud コンソールで Cloud SQL の [バックアップ] ページに移動します。

    Cloud SQL の [バックアップ] に移動

  2. バックアップを表示する削除済みインスタンスの名前をクリックします。

    保持されたすべてのバックアップと最終バックアップのリストと、削除されたインスタンスの詳細が表示されます。

  3. 削除する保持バックアップのその他の操作アイコン その他アイコン をクリックし、[削除] を選択します。

  4. [バックアップの削除] ウィンドウで、削除するインスタンスの名前を入力し、[削除] をクリックします。

gcloud

保持されたバックアップを削除するには、gcloud sql backups delete コマンドを使用します。

gcloud sql backups delete BACKUP_NAME

次のように置き換えます。

  • BACKUP_NAME: 保持するバックアップの名前。

REST v1

保持されているすべてのバックのリストを取得する

この例では、Google Cloud プロジェクトに関連付けられているすべての保持バックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、backups.listBackups ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

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

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

保持されたバックアップを削除する

この例では、保持されたバックアップを削除します。この呼び出しのパラメータの一覧については、backups.deleteBackup ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID。
  • BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。

HTTP メソッドと URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

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

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

REST v1beta4

保持されているすべてのバックのリストを取得する

この例では、Google Cloud プロジェクトに関連付けられているすべての保持バックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、backups.listBackups ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups

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

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

保持されたバックアップを削除する

この例では、保持されたバックアップを削除します。この呼び出しのパラメータの完全なリストについては、backups.deleteBackup ページをご覧ください。

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

  • PROJECT_ID: プロジェクト ID。
  • BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。

HTTP メソッドと URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

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

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

次のステップ