削除されたインスタンスのバックアップを管理する

インスタンスの削除後にバックアップを保持するか、インスタンスを削除する前に最終バックアップを作成した場合は、インスタンスの削除後にバックアップを管理できます。保持されるバックアップには、インスタンスが稼働中に作成された自動バックアップとオンデマンド バックアップが含まれます。インスタンスを削除すると、これらのバックアップはインスタンスから独立し、プロジェクト レベルで保存されます。バックアップの仕組みと保持されるバックアップの詳細については、Cloud SQL バックアップの概要をご覧ください。

これらのバックアップを使用して、インスタンスの削除後にインスタンスを復元できます。

始める前に

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

コンソール

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

gcloud

アクション コマンド 必要な権限
バックアップを一覧表示する 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

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

削除されたインスタンスのすべてのバックアップを一覧表示する

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

コンソール

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

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

  2. インスタンスのバックアップ オプション（標準ティアまたは拡張ティア）を選択します。

  3. [フィルタ]、[インスタンスのステータス] の順にクリックし、[削除済みインスタンス] を選択します。

    このページには、Cloud de Confiance コンソール プロジェクトで削除されたすべてのインスタンスが一覧表示されます。

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

    このページには、削除されたインスタンスの保持された自動バックアップとオンデマンド バックアップ、および利用可能な場合は最後のバックアップが一覧表示されます。

gcloud

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

    gcloud sql backups list
--project=PROJECT_ID

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

    • PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。

  2. 保持されている特定のバックアップの詳細を確認するには、gcloud sql backups describe コマンドを使用します。

    gcloud sql backups describe BACKUP_NAME
--project=PROJECT_ID

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

    • BACKUP_NAME: 保持されているバックアップの名前。
    • PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。

REST v1

すべてのバックアップのリストを取得する

この例では、 Cloud de Confiance プロジェクトに関連付けられている、保持されているすべてのバックアップと最終バックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、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

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

この例では、Cloud de Confiance プロジェクトに関連付けられている、保持されているすべてのバックアップと最終バックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、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. Cloud de Confiance コンソールで、Cloud SQL の [バックアップ] ページに移動します。

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

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

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

  3. 更新する最終バックアップのその他の操作アイコン その他アイコン をクリックし、次の操作を行います。

    • 最終バックアップの説明を編集する場合は、[説明を編集] をクリックします。

      [このバックアップの説明] フィールドに説明を入力し、[更新] をクリックします。

    • 最終バックアップの保持期間を編集する場合は、[保持期間を編集] をクリックします。

      [バックアップの保持期間] フィールドで日付を選択します。保持期間は、インスタンスの削除後 1 ～ 365 日の範囲で設定できます。バックアップの保持期間を選択したら、[更新] をクリックします。

gcloud

更新する最終バックアップの backup-name が必要です。backup-name を取得するには、削除されたインスタンスのバックアップを一覧表示するをご覧ください。

最終バックアップの保持期間または説明を更新するには、gcloud sql backups patch コマンドを使用し、バックアップの expiry-time または ttl-days のいずれかを指定します。

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION
--expiry-time=EXPIRY_TIME | --ttl-days=TTL_DAYS

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

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

  • 次のいずれかになります。

    • EXPIRY_TIME: 最終バックアップを削除する新しい日時。最大期間は、インスタンスの削除から 365 日です。
    • TTL_DAYS: 最終バックアップを保持する日数。1 ～ 365 日の範囲で指定できます。デフォルトは 30 日です。

REST v1

更新する最終バックアップの backup-name が必要です。backup-name を取得するには、削除されたインスタンスのバックアップを一覧表示するをご覧ください。

最終バックアップの説明と保持設定を更新できます。保持設定は、次のいずれかの方法で更新できます。

  • 最終バックアップの保持日数を更新する
  • 最終バックアップの有効期限を更新する

保持日数を使用して保持期間を更新する

この例では、保持日数パラメータを使用して最終バックアップの保持設定を更新します。

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

  • PROJECT_ID: プロジェクト ID。
  • BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
  • TTL_DAYS: 最終バックアップの保持期間（1～365 日）。これは有効期間（TTL）と呼ばれます。保持期間は現在の日時から開始され、Cloud SQL で許可される最大保持期間は 1 年（365 日）です。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

リクエストの本文（JSON）: 

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

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

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

有効期限を使用して保持期間を更新する

この例では、有効期限パラメータを使用して最終バックアップの保持設定を更新します。

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

  • PROJECT_ID: プロジェクト ID。
  • BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
  • DATE_AND_TIME_STAMP: Cloud SQL が最終バックアップを自動的に削除した日時スタンプ。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

リクエストの本文（JSON）: 

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

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

次のような 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

更新する最終バックアップの backup-name が必要です。backup-name を取得するには、削除されたインスタンスのバックアップを一覧表示するをご覧ください。

最終バックアップの説明と保持設定を更新できます。保持設定は、次のいずれかの方法で更新できます。

  • 最終バックアップの保持日数を更新する
  • 最終バックアップの有効期限を更新する

保持日数を使用して保持期間を更新する

この例では、保持日数パラメータを使用して最終バックアップの保持設定を更新します。

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

  • PROJECT_ID: プロジェクト ID。
  • BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
  • TTL_DAYS: 最終バックアップの保持期間（1～365 日）。これは有効期間（TTL）と呼ばれます。保持期間は現在の日時から開始され、Cloud SQL で許可される最大保持期間は 1 年（365 日）です。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

リクエストの本文（JSON）: 

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

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

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

有効期限を使用して保持期間を更新する

この例では、有効期限パラメータを使用して最終バックアップの保持設定を更新します。

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

  • PROJECT_ID: プロジェクト ID。
  • BACKUP_ID: バックアップ ID。この ID は、前の呼び出しの実行の出力から取得します。
  • DATE_AND_TIME_STAMP: Cloud SQL が最終バックアップを自動的に削除した日時スタンプ。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

リクエストの本文（JSON）: 

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

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

次のような 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 レスポンスが返されます。

保持されているバックアップを更新する

保持されているオンデマンド バックアップと自動バックアップの説明を更新できます。バックアップを更新する手順は次のとおりです。

コンソール

  1. Cloud de Confiance コンソールで、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

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

この例では、Cloud de Confiance プロジェクトに関連付けられた、保持されているすべてのバックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、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

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

この例では、Cloud de Confiance プロジェクトに関連付けられた、保持されているすべてのバックアップのリストを取得します。この呼び出しのパラメータの完全なリストについては、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 レスポンスが返されます。

削除されたインスタンスに関連付けられているバックアップを削除する

削除されたインスタンスの最終バックアップまたは保持されたオンデマンド バックアップと自動バックアップは、いつでも削除できます。

コンソール

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

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

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

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

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

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

gcloud

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

gcloud sql backups delete BACKUP_NAME

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

  • BACKUP_NAME: 保持されているバックアップの名前。

REST v1

最終バックアップまたは保持されているバックアップを削除するには、次の例を使用します。この呼び出しのパラメータの完全なリストについては、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

最終バックアップまたは保持されているバックアップを削除するには、次の例を使用します。この呼び出しのパラメータの完全なリストについては、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 レスポンスが返されます。

次のステップ