このページでは、Cloud SQL インスタンスとプロジェクトで拡張バックアップを有効にして管理する方法について説明します。
拡張バックアップを使用すると、Cloud SQL インスタンスで Backup and DR サービスを使用してバックアップを管理できます。詳細については、拡張バックアップをご覧ください。Cloud SQL でのバックアップの仕組みと、インスタンスで使用可能なオプションの詳細については、Cloud SQL バックアップについてをご覧ください。
始める前に
Cloud SQL インスタンスの拡張バックアップを管理するには、次の操作を行う必要があります。
- Backup and DR API を有効にする
- 必要な権限があることを確認する
Backup and DR API を有効にする
Cloud SQL インスタンスで拡張バックアップを使用するには、まず Backup and DR API を有効にする必要があります。
必要な権限
Cloud SQL インスタンスの拡張バックアップを構成するには、次の権限が必要です。
backupdr.backupPlans.list
backupdr.backupPlanAssociations.createForCloudSqlInstance
backupdr.backupPlanAssociations.fetchForCloudSqlInstance
backupdr.backupPlanAssociations.list
backupdr.backupPlanAssociations.getForCloudSqlInstance
backupdr.backupPlanAssociations.triggerBackupForCloudSqlInstance
backupdr.backupPlanAssociations.deleteForCloudSqlInstance
backupdr.backupPlans.useForCloudSqlInstance
backupdr.bvdataSources.get
backupdr.bvdataSources.list
これらの権限の詳細については、Backup and DR のロールと権限をご覧ください。
拡張バックアップを有効にする
インスタンスの拡張バックアップを有効にするには、次の操作を行います。
拡張バックアップの詳細については、Cloud SQL バックアップについてをご覧ください。
使用するバックアップ プランを特定する
バックアップ プランは、拡張バックアップでインスタンスのバックアップ スケジュールと保持の設定を定義するために使用されます。Cloud SQL インスタンスをバックアップ プランに関連付けるには、まず使用するバックアップ プランを特定する必要があります。詳細については、バックアップ プランを作成、管理するをご覧ください。
関連付けるバックアップ プランを特定したら、バックアップ プラン名を使用して Cloud SQL インスタンスに関連付けます。
バックアップ プランを Cloud SQL インスタンスに関連付ける
バックアップ プランを Cloud SQL インスタンスに関連付けるには、使用するバックアップ プランの名前が必要です。バックアップ プラン名を確認する方法については、バックアップ プランを作成、管理するをご覧ください。
コンソール
バックアップ プランを Cloud SQL インスタンスに関連付けるには、次の操作を行います。
Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。
バックアップ プランを関連付けるインスタンスを見つけます。インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[編集] をクリックします。
[データ保護] セクションの [バックアップ ティア] で、[拡張バックアップ ティア] を選択します。
[バックアップ プラン] セクションで、[選択] をクリックします。
[バックアップ プランの選択] ウィンドウで、次の操作を行います。
[プロジェクト] で [参照] をクリックし、バックアップ プランを含む Backup and DR プロジェクトを検索して選択します。
プロジェクトを選択すると、使用可能なすべてのバックアップ プランのリストが表示されます。使用するバックアップ プランを見つけて、[選択] をクリックします。
[保存] をクリックします。
インスタンスで拡張バックアップが有効になっており、関連付けられたバックアップ プランのバックアップと保持の設定が使用されています。
gcloud
バックアップ プランを Cloud SQL インスタンスに関連付けるには、次のコマンドを実行します。
gcloud backup-dr backup-plan-associations create BACKUP_PLAN_ASSOCIATION_NAME
--project=PROJECT_ID
--resource=INSTANCE_ID
--backup-plan=BACKUP_PLAN_NAME
--resource-type=sqladmin.googleapis.com/Instance
--location=REGION_ID
次のように置き換えます。
- BACKUP_PLAN_ASSOCIATION_NAME: バックアップ プランの関連付けの名前。
- PROJECT_ID: インスタンスのプロジェクト ID。
- INSTANCE_ID: バックアップ プランを関連付けるインスタンスの ID。
- BACKUP_PLAN_NAME: 使用するバックアップ プランの名前。詳細については、使用するバックアップ プランを特定するをご覧ください。
- REGION_ID: インスタンスのリージョン。
REST v1
バックアップ プランの関連付けを作成するには、Backup and DR API の backupPlanAssociations
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
- backup-plan-association-id: バックアップ プランの関連付け ID
- resource-name: Cloud SQL インスタンスの完全名(
projects/project-id/locations/location/instances/instance-name
形式) - backup-plan-name: バックアップ プランの名前(
projects/project-id/backupPlans/backup-plan-name
形式)
HTTP メソッドと URL:
POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations
リクエストの本文(JSON):
{ "name": "backup-plan-association-id", "resourceType": "sql.googleapis.com/Instance", "resource": "resource-name", "backupPlan": "backup-plan-name" }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
拡張バックアップを管理する
インスタンスで拡張バックアップが有効になり、バックアップ プランがインスタンスに関連付けられると、オンデマンド バックアップを実行したり、Backup Vault 内のすべてのバックアップを表示したり、関連付けられているバックアップ プランを変更したりできます。
バックアップ プランを管理するには、バックアップ プランを作成して管理するをご覧ください。バックアップ ボルトを管理するには、バックアップ ボルトを作成して管理するをご覧ください。
インスタンスに関連付けられているバックアップ プランを変更する
Cloud SQL インスタンスに関連付けられているバックアップ プランを変更できます。Cloud SQL インスタンスに適用されるバックアップ プランを変更するには、新しいプランが現在のバックアップ プランと同じバックアップ Vault にあり、Cloud SQL インスタンスと同じリージョンにある必要があります。
関連付けられているバックアップ プランを変更するには、次の操作を行う必要があります。
関連付けられているバックアップ プランを削除する
新しいバックアップ プランに変更するには、まず Cloud SQL インスタンスから既存のバックアップ プランの関連付けを削除する必要があります。バックアップ プランを削除する手順は次のとおりです。
コンソール
Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。
バックアップ オプションを変更するインスタンスを見つけます。インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[編集] をクリックします。
[データ保護] セクションの [バックアップ階層] で、[標準バックアップ階層] を選択します。必要に応じて、インスタンスの標準バックアップ設定を更新します。
[保存] をクリックします。
インスタンスに関連付けられているバックアップ プランが削除され、インスタンスは標準バックアップ オプションで管理されるようになります。これで、インスタンスに新しいバックアップ プランを関連付けることができます。
gcloud
新しいバックアップ プランに変更するには、まず Cloud SQL インスタンスから既存のバックアップ プランの関連付けを削除する必要があります。バックアップ プランを削除する手順は次のとおりです。
gcloud backup-dr backup-plan-associations delete BACKUP_PLAN_ASSOCIATION_NAME
--location=BACKUP_VAULT_LOCATION
次のように置き換えます。
- BACKUP_PLAN_ASSOCIATION_NAME: 削除するバックアップ プランの関連付けの名前。
- BACKUP_VAULT_LOCATION: バックアップ ボルトのロケーション。
インスタンスに関連付けられているバックアップ プランが削除され、インスタンスは標準バックアップ オプションで管理されるようになります。これで、インスタンスに新しいバックアップ プランを関連付けることができます。
REST v1
バックアップ プランの関連付けを変更するには、まず既存のバックアップ プランの関連付けを削除する必要があります。Backup and DR API の backupPlanAssociations
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
- backup-plan-association-id: バックアップ プランの関連付け ID(
projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id
形式)
HTTP メソッドと URL:
POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete
リクエストの本文(JSON):
{ "name": "backup-plan-association-id", }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
新しいバックアップ プランをインスタンスに関連付ける
既存のバックアップ プランを削除したら、新しいバックアップ プランを Cloud SQL インスタンスに関連付けることができます。
コンソール
新しいバックアップ プランをインスタンスに関連付けるには、次の操作を行います。
Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。
バックアップ プランを変更するインスタンスを見つけます。インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[編集] をクリックします。
[データ保護] セクションの [バックアップ ティア] で、[拡張バックアップ ティア] を選択します。
[バックアップ プランの選択] ウィンドウで、次のいずれかを行います。
[プロジェクト] で [参照] をクリックし、使用するバックアップ プランを含む Backup and DR プロジェクトを検索して選択します。
プロジェクトを選択すると、使用可能なすべてのバックアップ プランのリストが表示されます。使用するバックアップ プランを見つけて、[選択] をクリックします。
[保存] をクリックします。
インスタンスで拡張バックアップが有効になり、選択した新しいバックアップ プランが使用されています。
gcloud
新しいバックアップ プランをインスタンスに関連付けるには、次の操作を行います。
gcloud backup-dr backup-plan-associations create BACKUP_PLAN_ASSOCIATION_NAME
--project=PROJECT_ID
--resource=INSTANCE_ID
--backup-plan=BACKUP_PLAN_NAME
--resource-type=sqladmin.googleapis.com/Instance
--location=REGION_ID
次のように置き換えます。
- BACKUP_PLAN_ASSOCIATION_NAME: バックアップ プランの関連付けの名前。
- PROJECT_ID: インスタンスのプロジェクト ID。
- INSTANCE_ID: インスタンスの ID。
- BACKUP_PLAN_NAME: バックアップ プランの名前。詳細については、使用するバックアップ プランを特定するをご覧ください。
- REGION_ID: インスタンスのリージョン。
REST v1
既存のバックアップ プランの関連付けを削除したら、Backup and DR API の backupPlanAssociations
メソッドを使用して、新しいバックアップ プランを関連付けます。
リクエストのデータを使用する前に、次のように置き換えます。
- backup-plan-association-id: バックアップ プランの関連付け ID
- resource-name: Cloud SQL インスタンスの完全名(
projects/project-id/locations/location/instances/instance-name
形式) - backup-plan-name: バックアップ プランの名前(
projects/project-id/backupPlans/backup-plan-name
形式)
HTTP メソッドと URL:
POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations
リクエストの本文(JSON):
{ "name": "backup-plan-association-id", "resourceType": "sql.googleapis.com/Instance", "resource": "resource-name", "backupPlan": "backup-plan-name" }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
オンデマンド バックアップを実行する
Google Cloud コンソール、gcloud CLI、または Cloud SQL API を使用して、Cloud SQL インスタンスと関連するバックアップ プランのオンデマンド バックアップを実行できます。
コンソール
拡張バックアップが有効になっているインスタンスのオンデマンド バックアップを実行するには、次の操作を行います。
Google Cloud コンソールで、Cloud SQL の [バックアップ] ページに移動します。
[バックアップを作成] をクリックします。
[オンデマンド バックアップの作成] ウィンドウの [バックアップ ルールを選択] で、作成するオンデマンド バックアップのタイプを選択します。バックアップ ルールは、オンデマンド バックアップの保持期間を定義します。
[作成] をクリックします。
オンデマンド バックアップが作成されます。
gcloud
拡張バックアップが有効になっているインスタンスのオンデマンド バックアップを実行するには、次のコマンドを実行します。
gcloud backup-dr backup-plan-associations trigger-backup BACKUP_PLAN_ASSOCIATION_NAME
--backup-rule-id=BACKUP_RULE_ID
--project=PROJECT_ID
--location=BACKUP_VAULT_LOCATION
[--no-async]
次のように置き換えます。
- BACKUP_PLAN_ASSOCIATION_NAME: Cloud SQL インスタンスのバックアップ プランの関連付けの名前。Cloud SQL インスタンスに関連付けられているすべてのバックアップ プランのリストを確認するには、すべてのバックアップ プランの関連付けを一覧表示するをご覧ください。
- BACKUP_RULE_ID: 取得するオンデマンド バックアップのタイプのバックアップ ルール名(例:
rule-daily
)。 - PROJECT_ID: インスタンスのプロジェクト ID。
- BACKUP_VAULT_LOCATION: バックアップ プランに関連付けられているバックアップ ボルトのロケーション。
REST v1
Cloud SQL インスタンスのオンデマンド バックアップをトリガーするには、Backup and DR API の backupPlanAssociations
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
- backup-rule-id: バックアップをトリガーする必要があるバックアップ ルール ID
HTTP メソッドと URL:
GET https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id:triggerBackup
リクエストの本文(JSON):
{ "ruleId": "backup-rule-id" }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
インスタンスのバックアップ ボルト内のすべてのバックアップを一覧表示する
Cloud SQL インスタンスのバックアップ ボルト内のすべてのバックアップを一覧表示するには、 Google Cloud コンソール、gcloud CLI、または Cloud SQL API を使用します。
コンソール
Google Cloud コンソールで、Cloud SQL の [バックアップ] ページに移動します。
[バックアップ ティア] プルダウンで [拡張ティア] を選択し、使用するバックアップを含むバックアップ ボルトを選択します。
選択したインスタンスの Backup Vault で使用可能なすべてのバックアップが表示されます。
gcloud
バックアップ ボールト内の Cloud SQL インスタンスで使用可能なすべてのバックアップを一覧表示するには、まず Cloud SQL インスタンスの data-source
を見つけてから、gcloud backup-dr backups list
コマンドを実行する必要があります。
インスタンスの data-source
を確認するには、次のコマンドを実行します。
gcloud backup-dr data-source-references
fetch-for-resource-type sqladmin.googleapis.com/Instance
--location=REGION_ID | grep INSTANCE_NAME
次のように置き換えます。
- REGION_ID: Cloud SQL インスタンスのリージョン ID。
- INSTANCE_NAME: Cloud SQL インスタンスの名前。
インスタンスのバックアップ ボルト内のすべてのバックアップを一覧表示するには、次のコマンドを実行します。
gcloud backup-dr backups list
--data-source=DATA_SOURCE
--location=REGION_ID
--backup-vault=BACKUP_VAULT_NAME
次のように置き換えます。
- DATA_SOURCE: Cloud SQL インスタンスの
data-source
。 - REGION_ID: バックアップ ボルトのリージョン ID。
- BACKUP_VAULT_NAME: バックアップ プランに関連付けられているバックアップ ボルトの名前。
REST v1
バックアップ ボルト内の Cloud SQL インスタンスで使用可能なすべてのバックアップを一覧表示するには、まず Cloud SQL インスタンスのデータソースを見つけてから、データソース名を使用してすべてのバックアップを取得する必要があります。
インスタンスのデータソースを見つける
インスタンスのデータソースを確認するには、Backup and DR API の dataSource.References
メソッドを使用します。
HTTP メソッドと URL:
GET https://backupdr.googleapis.com/v1/projects/project-id/locations/location/dataSourceReferences:fetchForResourceType?filter=dataSourceGcpResourceInfo.gcp_resourcename="projects/project-id/instances/instance-id
リクエストの本文(JSON):
{ "resourceType": "sqladmin.googleapis.com/Instance" }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
インスタンスのバックアップを一覧表示する
データソース ID を使用してインスタンスのバックアップを一覧表示するには、Backup and DR API の backupVaults.dataSources.backups
メソッドを使用します。
HTTP メソッドと URL:
GET https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupVaults/backup-vault-id/dataSources/data-source-id/backups
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
拡張バックアップを無効にする
Cloud SQL インスタンスを標準バックアップ オプションに戻すと、拡張バックアップを無効にできます。これにより、バックアップ プランとインスタンスの関連付けが削除されます。
インスタンスを標準バックアップに変更する
コンソール
拡張バックアップを無効にして、インスタンスを標準バックアップ オプションに戻すには、次の操作を行います。
Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。
バックアップ オプションを変更するインスタンスを見つけます。インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[編集] をクリックします。
[データ保護] セクションの [バックアップ ティア] で、[標準バックアップ ティア] を選択します。必要に応じて、インスタンスの Standard バックアップ設定を更新します。
[保存] をクリックします。
インスタンスに関連付けられているバックアップ プランが削除され、インスタンスは Cloud SQL によって管理される標準バックアップ オプションで管理されるようになります。
gcloud
拡張バックアップを無効にして、インスタンスを標準バックアップ オプションに戻すには、次のコマンドを実行します。
gcloud backup-dr backup-plan-associations delete BACKUP_PLAN_ASSOCIATION_NAME
--location=BACKUP_VAULT_LOCATION
次のように置き換えます。
- BACKUP_PLAN_ASSOCIATION_NAME: 削除するバックアップ プランの関連付けの名前。
- BACKUP_VAULT_LOCATION: バックアップ ボルトのロケーション。
REST v1
拡張バックアップを無効にするには、Backup and DR API の backupPlanAssociations
メソッドを使用して、バックアップ プランの関連付けを削除する必要があります。
リクエストのデータを使用する前に、次のように置き換えます。
- backup-plan-association-id: バックアップ プランの関連付け ID(
projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id
形式)
HTTP メソッドと URL:
POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete
リクエストの本文(JSON):
{ "name": "backup-plan-association-id", }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。