バックアップ・ポリシーの管理

IBM Cloud のバックアップポリシーおよびプランを管理するには、スケジュールの更新、タグの追加や削除、ステータスの確認、イベントの監査、不要なポリシーの削除を行います。

コンソールでバックアップポリシーを管理する

コンソールで、バックアップ・ポリシーの名前変更、バックアップ・ポリシー内の計画の削除、ポリシーの削除、およびユーザー・タグの編集を行うことができます。

コンソールでバックアップポリシーの名前を変更する

ポリシーの名前変更は、バックアップ・ポリシーのリストから、またはバックアップ・ポリシーの詳細ページから行うことができます。

  • バックアップ・ポリシーのリストから、「アクション」アイコン 「アクション」アイコン をクリックし、 「名前変更」 を選択します。

  • ポリシーの詳細ページで、ポリシー名の横にある 「編集」アイコン 「編集」アイコン をクリックします。

コンソールでターゲットリソースのタグを編集する

「バックアップポリシーの詳細」ページから、対象リソースのタグを編集できます。

  1. バックアップ・ポリシーの詳細ページに移動します。

  2. 「ターゲット・リソースのタグ」 で、 「編集」アイコン 「編集」アイコン をクリックします。

  3. 新しいウィンドウで、ユーザータグ名を入力してください。 ユーザータグを持つ既存のブロックボリュームまたはファイル共有の場合は、ボリュームまたは共有に表示されているタグ名を正確に入力します。 また、ここでユーザータグを追加し、その後戻ってボリュームや共有にそのタグを追加することもできます。 バックアップを作成するために必要なタグは 1 つだけです。

  4. 次へ をクリックします。

  5. 次のウィンドウに表示される情報を確認してください。 内容に問題がなければ、免責事項を確認し、「 変更を保存 」をクリックしてください。

コンソールで整合性グループのメンバーを編集する

「バックアップ・ポリシーの詳細」ページで、バックアップ・ポリシーに Block Storage for VPC ブート・ボリュームを含めたり除外したりすることができます。

  1. バックアップ・ポリシーの詳細ページに移動します。

  2. 「概要」タブで、「ポリシーの詳細」で 「ブート・ボリューム」 を探し、 「編集」アイコン 「編集」アイコン をクリックして値を変更します。

コンソールでバックアッププランを編集する

バックアップポリシーをプロビジョニングし、バックアッププランを作成した後、プランの詳細を編集したり、プランを無効にしたり、削除したりすることができます。 バックアップを作成するポリシーには、少なくとも 1 つのプランが残っている必要があります。

  1. バックアップ計画の詳細 ページから、計画の「アクション」メニューを展開します。

  2. **「編集」**を選択します。 計画の詳細がサイド・パネルに表示されます。 プランステータスのトグルを切り替えることで、プランを有効または無効にすることができます。 また、プラン名やバックアップ頻度など、プランの詳細を変更することもできます。 個々のボリューム・バックアップについて、高速リストアを使用可能または使用不可にしたり、どの領域で高速リストアを使用可能にするかを変更したりすることができます。 また、他のリージョンでのコピーの作成と保存を有効または無効にすることもできます。 高速リストアおよびクロスリージョンコピー機能は、マルチボリュームまたはファイル共有バックアップには対応していません。

  3. 選択が完了したら、選択内容を確認してください。

ポリシー計画の変更は、今後のバックアップに適用されます。 たとえば、リモート地域でのコピーの作成を有効にした場合、変更前に存在していたバックアップのスナップショットはリモートロケーションにコピーされません。 次にこのプランがバックアップスナップショットの作成をトリガーすると、そのスナップショットのコピーがリモートリージョンに作成されます。

CLI からのバックアップポリシーおよび計画の管理

CLI からバックアップポリシーを削除したり、ポリシーの名前を変更したり、ユーザータグを編集したりできます。

開始前に

CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。 詳しくは、CLI の前提条件を参照してください。

IBM Cloud® にログインしてください。

ibmcloud login --sso -a cloud.ibm.com

このコマンドを実行すると、URL が返され、パスコードの入力を求めるプロンプトが表示されます。 ブラウザーでその URL にアクセスしてログインします。 成功すると、ワンタイム・パスコードが表示されます。 そのパスコードをコピーし、プロンプトに応答として貼り付けます。 認証に成功すると、アカウントを選択するように求めるプロンプトが出されます。 複数のアカウントアクセスできる場合は、ログインしたいアカウントを選択してください。 残りのプロンプトにすべて応答して、ログインを完了します。

CLI からバックアップポリシーの名前を変更する

ibmcloud is backup-policy-update コマンドを実行して、ポリシー ID またはポリシー名、およびバックアップ・ポリシーの新しい名前を指定します。

ibmcloud is backup-policy-update POLICY [--name NEW_NAME] [--output JSON] [-q, --quiet]

以下の例では、名前で識別されるバックアップ・ポリシーを名前変更します。

ibmcloud is backup-policy-update backup-policy-v1 --name new-policy-23
Updating backup policy backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID                      r138-0521986d-963c-4c18-992d-d6a7a99d115f
Name                    new-policy-23
CRN                     crn:v1:bluemix:public:is:eu-de:a/a1234567::backup-policy:r138-0521986d-963c-4c18-992d-d6a7a99d115f
Status                  stable
Last job completed at   2023-02-22T20:12:44.000Z
Plans                   ID                                          Name               Resource type
                        r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3   my-policy-plan-a   backup_policy_plan
                        r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9   my-policy-plan-c   backup_policy_plan
Backup tags             dev:test
Match resource type    volume
Resource group          defaults
Created at              2023-02-21T22:42:10+00:00

以下の例では、ID で識別されるエンタープライズ・バックアップ・ポリシーを更新します。

ibmcloud is backup-policy-update r006-0bc533ed-4796-407a-982e-693b418f3de3 --name cli-updated-2
Updating backup policy r006-0bc533ed-4796-407a-982e-693b418f3de3 under account Enterprise Test as user test.user@ibm.com...
ID                     r006-0bc533ed-4796-407a-982e-693b418f3de3
Name                   cli-updated-2
CRN                    crn:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-0bc533ed-4796-407a-982e-693b418f3de3
Status                 stable
Plans                  ID                                          Name           Resource type
                       r006-0741b600-e8d5-41b4-88a7-c19b6fbf89ca   scope-plan-2   backup_policy_plan
Backup tags            dev:test
Match resource type   volume
Resource group         ID                                 Name
                       e579217258f74f42974e6ec4da287fc5   Default
Scope                  ID                                 CRN                                                                                                                 Resource type
                       7e44cb4667ba4b88b1b1f8dcc15e33b3   crn:v1:bluemix:public:enterprise::a/a1234567::enterprise:7e44cb4667ba4b88b1b1f8dcc15e33b3   -
Health State           ok
Created at             2023-08-30T13:39:10+05:30

使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is backup-policy-update」を参照してください。

CLI からのターゲット・リソースのタグの編集

ibmcloud is backup-policy-update コマンドを実行して、ポリシー ID またはポリシー名、および変更するタグを指定します。

ibmcloud is backup-policy-update POLICY [--match-tags MATCH_TAGS] [--output JSON] [-q, --quiet]

以下の例では、ID で識別されるポリシーのバックアップ・ポリシー・ユーザー・タグを更新します。

ibmcloud is backup-policy-update r138-0521986d-963c-4c18-992d-d6a7a99d115f --match-tags dev:env,bck:test
Updating backup policy r138-0521986d-963c-4c18-992d-d6a7a99d115f under account Test Account as user test.user@ibm.com...
ID                      r138-0521986d-963c-4c18-992d-d6a7a99d115f
Name                    new-policy-23
CRN                     crn:v1:bluemix:public:is:eu-de:a/a1234567::backup-policy:r138-0521986d-963c-4c18-992d-d6a7a99d115f
Status                  stable
Last job completed at   2023-02-22T20:12:44.000Z
Plans                   ID                                          Name               Resource type
                        r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3   my-policy-plan-a   backup_policy_plan
                        r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9   my-policy-plan-c   backup_policy_plan
Backup tags             dev:env,bck:test
Match resource type    volume
Resource group          ID                                 Name
                        11caaa983d9c4beb82690daab08717e9   Default
Scope                   ID                                 Resource type
                        a1234567   account
Health State            ok
Created at              2023-02-21T22:42:10+00:00

使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is backup-policy-update」を参照してください。

CLI からの整合性グループ・メンバーの編集

ibmcloud is backup-policy-update コマンドを実行して、ポリシー ID またはポリシー名、および変更するタグを指定します。

ibmcloud is backup-policy-update POLICY [--included_content data_volumes|boot_volume ] [--output JSON] [-q, --quiet]

以下の例では、一致するタグを持つ仮想サーバー・インスタンスに接続されているデータ・ボリュームにのみ適用されるように、バックアップ・ポリシーを更新します。

ibmcloud is backup-policy-create --match-tags dev:test --name my-cr-backup-policy-v1 --match-resource-type instance --included-content data_volumes
Updating backup policy my-cr-backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID                    r006-e0713176-37b6-4168-88ab-ad92f8a544f9
Name                  my-cr-backup-policy-v1
CRN                   crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-e0713176-37b6-4168-88ab-ad92f8a544f9
Status                stable
Plans                 ID   Name   Resource type
Backup tags           dev:test
Match resource type   instance
Included Content      data_volumes
Resource group        ID                                 Name
                      11caaa983d9c4beb82690daab08717e9   Default
Scope                 ID                                 Resource type
                      a1234567                           account
Health State          ok
Created at            2023-12-05T19:29:35+05:30

使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is backup-policy-update」を参照してください。

CLI からのバックアップ計画の更新

ibmcloud is backup-policy-plan-update コマンドを実行して、バックアップ計画を更新します。 コマンド・ラインで、ID または名前によってポリシーとプランを識別します。 計画名の更新、 cron-spec バックアップ・スケジュール、ユーザー・タグの付加、バックアップ保存期間の更新、高速リストア・ゾーンの追加または削除を行うことができます。

以下のコード・スニペットは、コマンド構文を示しています。

ibmcloud is backup-policy-plan-update POLICY PLAN [--name NAME] [--active] [--attach-tags ATTACH_TAGS] [--copy-tags true | false] [--cron-spec CRON_SPEC] [[--delete-after DELETE_AFTER] [--delete-over-count DELETE_OVER_COUNT]] [--reset-delete-over-count] [[--clone-policy-zones  ZONE1,ZONE2,...] [--clone-policy-max-snapshots CLONE_POLICY_MAX_SNAPSHOTS]] [--remote-region-policies REMOTE_REGION_POLICY_JSON | @REMOTE_REGION_POLICY_JSON] [--output JSON] [-q, --quiet]

バックアップ計画の名前を変更するには、以下の例のようなコマンドを実行します。 バックアップ・ポリシーと計画を名前で指定し、計画の名前を my-policy-plan-c から my-policy-plan-b に変更します。

ibmcloud is backup-policy-plan-update new-policy-23 my-policy-plan-c --name my-policy-plan-b
Updating plan my-policy-plan-c of the backup policy r138-0521986d-963c-4c18-992d-d6a7a99d115f under account Test Account as user test.user@ibm.com...
ID                   r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9
Name                 my-policy-plan-b
Active               true
Lifecycle state      updating
Clone policy         Max snapshots   Zones
                     3               eu-de-1,eu-de-2
Deletion trigger     Delete after   Delete over count
                     20             20
Attached tags        daily-backup-plan
Copy tags            true
Cron specification   10 20 * * *
Created at           2023-02-21T22:42:32+00:00
Resource type        backup_policy_plan

バックアップ・スナップショットの高速リストア・クローンのロケーションを更新するには、以下の例のようなコマンドを実行します。 これは、バックアップ・ポリシーと計画をその ID で指定します。 --clone-policy-zones オプションで eu-de-1 のみが指定されているため、高速リストア・スナップショット・クローンは eu-de-2 に保持されなくなりました。 また、この更新により、作成されてそのゾーンに保管されるバックアップ・クローンの数が 3 から 5 に変更されます。

ibmcloud is backup-policy-plan-update r138-0521986d-963c-4c18-992d-d6a7a99d115f r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9  --clone-policy-max-snapshots 5 --clone-policy-zones eu-de-1
Updating plan r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9 of the backup policy r138-0521986d-963c-4c18-992d-d6a7a99d115f under account Test Account as user test.user@ibm.com...
ID                   r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9
Name                 my-policy-plan-b
Active               true
Lifecycle state      updating
Clone policy         Max snapshots   Zones
                     5               eu-de-1
Deletion trigger     Delete after   Delete over count
                     20             20
Attached tags        daily-backup-plan
Copy tags            true
Cron specification   10 20 * * *
Created at           2023-02-21T22:42:32+00:00
Resource type        backup_policy_plan

バックアップ・スナップショットのリモート・コピーの作成を別のリージョンに組み込むようにバックアップ計画を更新するには、 --remote-region-policies オプションを指定して backup-policy-plan-update コマンドを実行します。 以下の例では、 _new-policy-23_の一部である my-policy-plan-b プランを更新します。 これは、リモート領域コピーの宛先として us-east 領域を指定します。 オプションで、 --encryption-key オプションを追加して、リモート領域でスナップショットを暗号化解除するために使用するルート鍵の CRN を指定できます。

ibmcloud is backup-policy-plan-update new-policy-23 my-policy-plan-b --remote-region-policies '[
  {"delete_over_count": 99,"region": {"name": "us-east"}}
]'
Updating plan r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9 of the backup policy r138-0521986d-963c-4c18-992d-d6a7a99d115f under account Test Account as user test.user@ibm.com...
ID                   r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9
Name                 my-policy-plan-b
Active               true
Lifecycle state      updating
Clone policy         Max snapshots   Zones
                     5               eu-de-1
Deletion trigger     Delete after   Delete over count
                     20             20
Remote Region Policies   Region    Encryption Key   Delete over count
                         us-east   -                99
Attached tags        daily-backup-plan
Copy tags            true
Cron specification   10 20 * * *
Created at           2023-05-05T22:42:32+00:00
Resource type        backup_policy_plan

ポリシープランがバックアップの作成をトリガーする次回以降、バックアップのスナップショットは指定のリモートリージョンにコピーされます。 バックアップポリシー計画の変更前に存在していたバックアップスナップショットは、リモートロケーションにコピーされません。

使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is backup-policy-plan-update」を参照してください。

高速リストアおよびクロスリージョンコピー機能は、マルチボリュームまたはファイル共有バックアップには対応していません。

API を使用したバックアップポリシーと計画の管理

API を使用して、ポリシーの名前変更と更新、ユーザー・タグの編集、およびバックアップ・ポリシーの削除をプログラマチックに行うことができます。

API を使用してバックアップポリシーの名前を変更する

バックアップ・ポリシーの名前を変更するには、 PATCH /backup_policies/{backup_policies_id} 要求を行い、バックアップ・ポリシーの新しい名前を指定します。 以下の例は、ポリシー 5063bfe5-c16f-4606-ba26-fba0f099b97dmy-backup-policy に名前変更する方法を示しています。

curl -X PATCH\
"$vpc_api_endpoint/v1/backup_policies/5063bfe5-c16f-4606-ba26-fba0f099b97d?version=2022-06-28&generation=2"\
  -H "Authorization: Bearer $iam_token"\
  -d {"name": "my-backup-policy"}

API を使用した対象リソースのタグの編集

ターゲット・リソースのユーザー・タグを更新するには、 PATCH /backup_policies/{backup_policies_id} 要求を行い、以下の例のように新しいタグを指定します。

curl -X PATCH\
"$vpc_api_endpoint/v1/backup_policies/5063bfe5-c16f-4606-ba26-fba0f099b97d?version=2022-06-28&generation=2"\
  -H "Authorization: Bearer $iam_token"\
  -d {"match_user_tags": ["my-daily-backup-policy"]}

API を使用した整合性グループ・メンバーの編集

マルチボリューム・バックアップ・ポリシーを更新して、整合性グループにブート・ボリュームを含めたり、整合性グループからブート・ボリュームを除外したりする場合は、 PATCH /backup_policies/{backup_policies_id} 要求を行い、 included-content プロパティーの値を data_volumesboot_volume、または単に data_volumes のいずれかとして指定することができます。

curl -X PATCH\
"$vpc_api_endpoint/v1/backup_policies/5063bfe5-c16f-4606-ba26-fba0f099b97d?version=2022-06-28&generation=2"\
  -H "Authorization: Bearer $iam_token"\
  -d {"included_content": ["data_volumes"]}

API を使用したバックアップ計画の更新

以下のプロパティーを指定して、バックアップ計画を更新するための PATCH /backup_policies/{backup_policy_id}/plans/{plan_id} 要求を行います。

  • attach_user_tags このプランによって作成されるバックアップに付与される、バックアップポリシーからのユーザータグを指定します。 この値を更新しても、このプランによってすでに作成されたバックアップのユーザータグは変更されません。

  • copy_user_tags は、ソース・タグをバックアップ・スナップショットにコピーするかどうかを指定します。 値はブール値で、 true または false のいずれかです。

  • deletion_trigger には 2 つのプロパティーがあります。 delete_after プロパティーは、バックアップを保持する日数を設定します。 delete_over_count プロパティは、保持する直近のバックアップの最大数を設定します。 最大数に達すると、新しいバックアップの保存スペースを確保するために、最も古いバックアップが削除されます。 既存の最大値を削除するには、null を指定します。

curl -X PATCH\
"$vpc_api_endpoint/v1/backup_policies/5063bfe5-c16f-4606-ba26-fba0f099b97d/plans/78bb42ae-b82e-4560-861b-5bc4bca3fba6?version=2022-06-28&generation=2"\
  -H "Authorization: Bearer $iam_token"\
  -d '{
      "active": true,
      "attach_user_tags": ["my-daily-backup-plan"],
      "copy_user_tags": true,
      "cron_spec": "*/5 1,2,3 * * *",
      "deletion_trigger": {
        "delete_after": 20,
        "delete_over_count": 1
        },
      "name": "my-policy-plan"
    }'

API を使用した高速リストア・オプションのバックアップ・ポリシー・プランの更新

バックアップ計画を更新するには、 POST /backup_policies/{backup_policy_id}/plans/{plan_id} 要求を行います。 clone_policy プロパティーと zones サブプロパティーを指定して、バックアップ・スナップショット・クローンを作成するリージョン内のゾーンを指定します。 ゾーンは、ソース・ゾーンとは異なるものでなければなりません。 複数のゾーンを指定することができます。 この計画には、各ゾーンに最大 2 つのキャッシュ・バックアップ・スナップショットを保持することが含まれます。

この例では、バックアップ・ポリシーを更新してバックアップ計画を作成します。 新規プランは、ゾーン _us-south-3_にスナップショット・クローンを作成するためのクローン・ポリシーを定義します。 プランでは、最大 3 つのキャッシュ・バックアップ・スナップショットを保持することが指定されています。

curl -X POST "$vpc_api_endpoint/v1/backup_policies/8758bd18-344b-486a-b606-5b8cb8cdd044/plans?version=2022-12-09&generation=2"\
   -H "Authorization: Bearer $iam_token"\
   -d '{
        "active": true,
        "attach_user_tags": ["daily-backups"],
        "clone_policy": {
          "max_snapshots": 3,
          "zones": [
            {"name": "us-south-3"},
            {"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3"}
            ]
         },
        "copy_user_tags": true,
        "cron_spec": "30 */2 * * 1-5",
        "deletion_trigger": {
          "delete_after": 20,
          "delete_over_count": 20
        },
        "name": "my-daily-plan-1"
      }'

成功の応答は、複製ポリシーが作成されたことを示します。

{
  "active": true,
  "attach_user_tags": ["daily-backups"],
  "clone_policy": {
    "max_snapshots": 3,
    "zones": [
      {"name": "us-south-2"},
      {"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3"}
      ]
    },
  "copy_user_tags": false,
  "created_at": "2022-12-09T15:16:37Z",
  "cron_spec": "30 */2 * * 1-5",
  "deletion_trigger": {"delete_after": 5},
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/8758bd18-344b-486a-b606-5b8cb8cdd044/plans/6e251cfe-6f7b-4638-a6ba-00e9c327b178",
  "id": "6e251cfe-6f7b-4638-a6ba-00e9c327b178",
  "lifecycle_state": "stable",
  "name": "my-daily-plan-1",
  "resource_type": "backup_policy_plan"
}

API を使用して別のリージョンにコピーを作成するようにバックアップ・ポリシー・プランを更新する

バックアップ計画を更新するには、 PATCH /backup_policies/{backup_policy_id}/plans/{plan_id} 要求を行います。 remote_region_policies プロパティーと region サブプロパティーを指定して、バックアップ・コピーを作成するリージョンを指定します。

この例では、バックアップ・ポリシーを更新して、 us-south リージョンにバックアップを作成するバックアップ計画を作成します。これには、リモート・コピーの作成が含まれます。 以下の例では、コピーが us-east 領域に作成されることを指定しています。

curl -X PATCH "$vpc_api_endpoint/v1/backup_policies/8758bd18-344b-486a-b606-5b8cb8cdd044/plans?version=2023-05-09&generation=2"\
   -H "Authorization: Bearer $iam_token"\
   -d '{
        "active": true,
        "attach_user_tags": ["daily-backups"],
        "copy_user_tags": true,
        "cron_spec": "30 */2 * * 1-5",
        "deletion_trigger": {
          "delete_after": 20,
          "delete_over_count": 20
          },
        "remote_region_policies": {
          "delete_over_count": 5,
          "encryption_key": [{"CRN": "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd617"}],
          "region": [{"name":"us-east"}]
          },
        "name": "my-daily-plan-2"
      }'

成功の応答は、リモート領域ポリシーが作成されたことを示します。

{
  "active": true,
  "attach_user_tags": [
    "hourly-backups"
  ],
  "copy_user_tags": false,
  "created_at": "2023-05-09T15:16:37Z",
  "cron_spec": "0 */2 * * *",
  "deletion_trigger": {
    "delete_after": 5
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/8758bd18-344b-486a-b606-5b8cb8cdd044/plans/6e251cfe-6f7b-4638-a6ba-00e9c327b178",
  "id": "6e251cfe-6f7b-4638-a6ba-00e9c327b178",
  "lifecycle_state": "stable",
  "name": "my-hourly-plan-2",
  "remote_region_policies": {
    "delete_over_count": 5,
    "encryption_key": "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd617",
    "region": [
      {"name": "us-east"},
      {"href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-east/zones/us-east-2"}
     ],
    },
  "resource_type": "backup_policy_plan"
}

ポリシープランがバックアップの作成をトリガーする次回以降、バックアップのスナップショットは指定のリモートリージョンにコピーされます。 バックアップポリシー計画の変更前に存在していたバックアップスナップショットは、リモートロケーションにコピーされません。

高速リストアおよびクロスリージョンコピー機能は、マルチボリュームまたはファイル共有バックアップには対応していません。

Terraform を使用したバックアップ・ポリシーおよびプランの管理

Terraform を使用してバックアップ・ポリシーを管理できます。

Terraformを使用するには、Terraform CLIをダウンロードし、 IBM Cloud プロバイダープラグインを設定してください。 詳しくは、 Terraform の概要 を参照してください。

VPC インフラストラクチャー・サービスは、デフォルトで us-south をターゲットとする特定のリージョン・エンドポイントを使用します。 VPC が別のリージョンに作成されている場合は、 provider.tf ファイル内のプロバイダー・ブロックで適切なリージョンをターゲットにしてください。

デフォルトの us-south 以外の地域をターゲットにする例を以下に示します。

provider "ibm" {
  region = "eu-de"
}

Terraform を使用したバックアップ・ポリシーの更新

バックアップ・ポリシーを更新するには、 ibm_is_backup_policy リソースを使用します。 以下の例では、バックアップ・ポリシーの名前と、関連付けられたタグを識別します。

resource "ibm_is_backup_policy" "example" {
  match_user_tags = ["dev:env","bck:test",]
  name            = "example-backup-policy"
}

引数および属性について詳しくは、 ibm_is_backup_policyを参照してください。

Terraform を使用したバックアップ計画の更新

バックアップ・ポリシーを更新するには、 ibm_is_backup_policy_plan リソースを使用します。 以下のリソース例は、ID によってポリシーを識別します。名前または cron_spec 引数を更新することによって、プランの名前またはスケジュールを変更できます。

resource "ibm_is_backup_policy_plan" "example" {
  backup_policy_id = "r138-0521986d-963c-4c18-992d-d6a7a99d115f"
  cron_spec        = "10 20 * * *"
  name             = "example-backup-policy-plan"
}

以下の例は、2 つの eu-de ゾーン内の高速リストア・クローンを使用してバックアップ計画を更新するために使用できるリソース定義です。

resource "ibm_is_backup_policy_plan" "example" {
  backup_policy_id = "r138-0521986d-963c-4c18-992d-d6a7a99d115f"
  cron_spec        = "10 20 * * *"
  name             = "example-backup-policy-plan"
  clone_policy {
    zones          = ["eu-de-1", "eu-de-2"]
    max_snapshots  = 4
  }
}

引数および属性について詳しくは、 ibm_is_backup_policy_planを参照してください。

高速リストアおよびクロスリージョンコピー機能は、マルチボリュームまたはファイル共有バックアップには対応していません。

バックアップ・ポリシーの削除の概要

ポリシー内の 1 つのプランまたは複数のプランを削除できます。 バックアップ・ポリシーを削除すると、それに関連付けられているすべてのプランも削除されます。

バックアップ・ポリシーを削除すると、新しいバックアップは作成されなくなります。 ただし、作成された既存のバックアップは、そのライフサイクルがポリシーから独立しているため、そのまま残ります。 既存のバックアップは、 CLIから コンソールで、APIからTerraformで個別に削除する必要があります。

コンソールでバックアッププランを削除する

  1. バックアップ・ポリシーのリスト に移動し、バックアップ・ポリシーを見つけます。

  2. バックアップポリシーの詳細ページで、削除したいプランを選択します。 計画の「アクション」メニューを展開し、 「削除」 を選択します。 ポリシーごとに最大 4 つのバックアップ計画を持つことができます。

コンソールでバックアップポリシーを削除する

  1. バックアップ・ポリシーのリスト に移動します。

  2. 削除するポリシーを見つけます。

  3. 「アクション」メニューから、**「削除」**を選択します。

    バックアップ・ポリシーに関連付けられているリソースがバックアップされなくなったこと、およびポリシーによって作成されたバックアップが引き続き存在することを確認します。 スナップショットのリストに移動して、各スナップショットを手動で削除する必要があります。

  4. 確認のため 「delete 」と入力し、「 ポリシーを削除 」をクリックします。

CLI からバックアッププランを削除する

ibmcloud is backup-policy-plan-delete コマンドを実行し、削除したいバックアップポリシーとプランを指定します。 バックアップ・ポリシーと計画は、ID または名前で指定できます。

次の例は、コマンドの構文を示しています。

ibmcloud is backup-policy-plan-delete POLICY (PLAN1 PLAN2 ...) [--output JSON] [-f, --force] [-q, --quiet]

以下の例では、ID で識別される my-new-policy-23 ポリシーからバックアップ計画 my-policy-plan-a を削除します。

ibmcloud is backup-policy-plan-delete r138-0521986d-963c-4c18-992d-d6a7a99d115f my-policy-plan-a
This will delete plan my-policy-plan-a and cannot be undone. Continue [y/N] ?> y
Deleting plan my-policy-plan-a under account Test Account as user test.user@ibm.com...
OK
Deletion request for plan my-policy-plan-a has been accepted.

使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is backup-policy-plan-delete」を参照してください。

CLI からバックアップポリシーを削除する

backup-policy-delete コマンドを実行して、1 つ以上のバックアップ・ポリシーのポリシー ID またはポリシー名を指定します。 そのポリシーに関連付けられているバックアップ計画も削除されます。 バックアップポリシーの削除に関する詳細については、「 バックアップポリシーの削除の概要 」を参照してください。

ibmcloud is backup-policy-delete (POLICY1 POLICY2 ...) [--output JSON] [-f, --force] [-q, --quiet]

以下の例は、名前を指定してバックアップ・ポリシーを削除する要求です。

ibmcloud is backup-policy-delete  my-backup-policy-v1
This will delete backup policy my-backup-policy-v1 and can't be undone. Continue [y/N] ?> y
Deleting backup policy my-backup-policy-v1 under account Test Account as user test.user@ibm.com...
OK
Deletion request for backup policy my-backup-policy-v1 has been accepted.

以下の例は、ID を指定してバックアップ・ポリシーを削除する要求であり、応答を JSON 形式で提供します。

$ ibmcloud is backup-policy-delete r138-5c719085-cf26-456e-9216-984866659e29 --output JSON
[
    {
        "id": "r138-5c719085-cf26-456e-9216-984866659e29",
        "result": true,
        "Error": null
    }
]

使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is backup-policy-delete」を参照してください。

API を使用したバックアッププランの削除

DELETE /backup_policies/{backup_policy_id}/plans/{plan_id} 要求を行って、バックアップ・ポリシーから特定のバックアップ計画を削除します。 計画によって作成されたリソースは残りますが、計画の削除トリガーの対象ではなくなります。 削除中は、状況に deleting と表示されます。 削除が完了すると(ステータス = deleted )、バックアッププランは復元できなくなります。

以下の例を参照してください。

curl -X DELETE\
"$vpc_api_endpoint/v1/backup_policies/5063bfe5-c16f-4606-ba26-fba0f099b97d/plans/4cf9171a-0043-4434-8727-15b53dbc374c?version=2022-06-28&generation=2"\
   -H "Authorization: Bearer $iam_token"

この応答から、バックアップ計画が削除されたことがわかります。

{
  "active": true,
  "attach_user_tags": ["my-daily-backup-plan"],
  "copy_user_tags": true,
  "created_at": "2022-06-22T01:44:49.070Z",
  "cron_spec": "*/5 1,2,3 * * *",
  "deletion_trigger": {"delete_after": 20},
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/0fe9e5d8-0a4d-4818-96ec-e99708644a58/plans/4cf9171a-0043-4434-8727-15b53dbc374c",
  "id": "4cf9171a-0043-4434-8727-15b53dbc374c",
  "lifecycle_state": "deleted",
  "name": "my-policy-plan",
  "resource_type": "backup_policy_plan"
  }

API を使用してバックアップポリシーとプランを削除する

DELETE /backup_policies/{backup_policy_id} 要求を行って、バックアップ・ポリシーおよび関連するすべてのバックアップ計画を削除します。 削除中は、状況に deleting と表示されます。 削除が完了すると(ステータス = deleted )、バックアップポリシーおよびバックアッププランは復元できなくなります。

以下の例を参照してください。

curl -X DELETE\
"$vpc_api_endpoint/v1/backup_policies/5063bfe5-c16f-4606-ba26-fba0f099b97d?version=2022-06-28&generation=2"\
  -H "Authorization: Bearer $iam_token"

この応答によると、すべてのバックアップ計画が削除されたことがわかります。

Terraform を使用したバックアップ計画またはバックアップ・ポリシーの削除

terraform destroy コマンドは、単一のバックアップ計画やバックアップ・ポリシーなどのリモート・オブジェクトを簡単に削除するために使用します。 以下の例では、 example-backup-policy-plan を消去します。

terraform destroy --target ibm_is_backup_policy_plan.example.id

以下の例では、 example-backup-policy を削除します。

terraform destroy --target ibm_is_backup_policy.example.id

詳しくは、 terraform destroyを参照してください。

次のステップ

以下の操作を行うことができます。