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

このページでは、保持されている 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 レスポンスが返されます。

次のステップ