バックアップ・ポリシーおよび計画の作成

Block Storage for VPC ボリュームおよび File Storage for VPC 共有に対するバックアップポリシーと計画を作成し、タグに基づく対象指定と保存期間ルールを利用して、スケジュールされたバックアップを自動化します。

開始前に

サービス間許可を付与するための IAM ユーザー役割を設定して、バックアップ・サービスがリソース上のタグを検出し、バックアップを作成できるようにします。
新規または既存のリソース（ストレージボリューム、共有、仮想サーバーインスタンス）に対して、バックアップポリシーに関連付けることができるユーザータグを作成します。タグの追加に関する詳細については、「バックアップポリシーにリソースへのタグを適用する」を参照してください。タグの作成について詳しくは、「タグの処理」を参照してください。
認証範囲の確認： サービス間認証が、バックアップが必要なすべてのリソースを網羅していることを確認してください。リソース固有のIAMポリシーを使用している場合は、ボリュームのバックアップが必要なすべての仮想サーバーインスタンスが、承認範囲に含まれていることを確認してください。

権限の範囲を確認するには、 [管理] > [アクセス (IAM)] > [権限] に移動してください。送信元が「 IBM Cloud Backup for VPC 」、送信先が「 Virtual Server for VPC 」である各承認ポリシーを確認してください。特定のリソース属性（たとえば、 instanceId など）が表示された場合は、適用範囲を広げるか、必要なリソースを網羅するように認証ポリシーを追加してください。

バックアップ・ポリシーの作成時にバックアップ計画を作成する必要はありませんが、ポリシーを使用して少なくとも 1 つのバックアップ計画を作成することをお勧めします。

バックアップジョブはスケジュールされた時間まで開始されず、スケジュールされた時間から最大90分後に開始される可能性があります。たとえば、午後7時（UTC）にバックアップを実行するようにスケジュールした場合、バックアップ・ジョブは午後7時から午後8時30分（UTC）の間に開始されます。

Hyper Protect Crypto Services は非推奨となっています。お客様は、2027年3月20日まで既存のインスタンスをご利用いただけます。詳細については、「 IBM Cloud Hyper Protect Crypto Services の非推奨化」を参照してください。継続的な保護のため、既存の暗号化キーを専用 Key Protect インスタンスに移行することをご検討ください。詳細については、「移行ガイド」をご覧ください。

コンソールでバックアップポリシーとプランを作成する

UI を使用して、バックアップ・ポリシーおよび計画を作成できます。

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

UI を使用してバックアップ・ポリシーを作成するには、以下の手順を使用します。

IBM Cloud コンソールで、 ナビゲーションメニュー アイコン> インフラストラクチャ> ストレージ > バックアップポリシー をクリックします。「作成」タブはデフォルトで選択されています。

アカウントでサービス間の許可が誤っているか欠落している場合、UI に通知メッセージが表示されます。

お客様のアカウント、バックアップ・ポリシーを作成するために必要なサービス間権限とユーザー・アクセス・ロールが許可されていない場合は、 IBM サポートにお問い合わせください。
プロビジョニングフォームの各セクションに情報を入力してください。オプションで、ポリシーのバックアップ計画を作成します。

バックアップ・ポリシー・プロビジョニングの選択
フィールド	説明
ロケーション	バックアップポリシーを作成する場所を選択してください。
-地域	使用可能な地域のリストから適切な値を選択します。
-地域	選択した地域で使用可能な地域のリストから適切な値を選択します。
詳細	ポリシーを定義するための詳細を入力します。ポリシーは、バックアップされるボリュームを定義します。
-名前	ポリシーを簡単に識別できるように、バックアップ・ポリシーに固有の名前を指定してください。標準の命名規則が、ポリシー、計画、およびバックアップに適用されます。例えば、スナップショットの命名規則を参照してください。
-リソース・グループ	オプションで、ポリシーのリソース・グループを指定します。入力後に変更することはできません。詳細については、リソースグループ内でのリソースの整理に関するベストプラクティスを参照してください。
-リソース・タグ	バックアップ・ポリシーのグループ化と管理に役立つオプションのタグ。タグを「キー: 値」のペアとして書き込むことを検討してください。詳しくは、『タグの処理』を参照してください。
ターゲット・リソース・タイプ	個別のブロックボリューム、同じ仮想サーバーインスタンスにアタッチされた複数のボリューム、またはファイル共有の中から選択してください。同じ仮想サーバーインスタンスにアタッチされているボリュームをバックアップするポリシーを作成する場合、ブートボリュームも対象に含めるかどうかを選択できます。
ターゲット・リソースのタグ	選択したリージョン内のターゲットリソース（ボリューム、仮想サーバーインスタンス、または共有）に適用するユーザータグを指定します。複数のリソースで同じタグが使用されている場合、タグが付けられたすべてのリソースに対してバックアップが作成されます。リソースに複数のタグが設定されている場合、バックアップポリシーに関連付けられているタグのうち、1つにのみ一致すれば十分です。バックアップポリシーが作成されると、対象リソースのタグのいずれかを付与されている既存のリソースが自動的に関連付けられます。
スコープ	このオプションは、エンタープライズアカウントにのみ適用されます。エンタープライズ・アカウント管理者は、バックアップ・ポリシーをエンタープライズ・アカウントのみに適用するか、エンタープライズ・アカウントとそのすべてのサブアカウントに適用するかを指定できます。エンタープライズのすべてのアカウントに対してポリシーを有効にするには、このボックスにチェック・マークを付けます。
計画	[ 作成 ] をクリックして、このポリシーのバックアップ計画を作成します。サイド・パネルで、計画の詳細を指定します。完了したら、「作成」をクリックしてください。ページが最新表示され、計画の詳細の要約が表示されます。最大 4 つのバックアップ計画を作成できます。すべてが、バックアップ・ポリシーに一致するタグを持つボリュームに適用されます。オプションの詳細については、次のセクションを参照してください。

**「バックアップ・ポリシーの作成」**をクリックします。「注文概要」のサイドパネルには、バックアップポリシーと、そのポリシーに対して作成されたすべてのプランが表示されます。

まだ注文する準備ができていない場合、または単に価格設定情報を探している場合は、サイド・パネルに表示される情報を見積もりに追加できます。詳しくは、コストの見積もりを参照してください。

コンソールでバックアッププランを作成する

プランでは、あらかじめ定義された設定を使用するか、 cron-spec 式を用いて、バックアップを毎日、毎週、または毎月実行するようにスケジュール設定できます。以下のステップでは、「バックアップ計画の作成」サイド・パネルについて説明します。

「プレーンの作成」サイド・パネルでは、計画状況トグルはデフォルトで「使用可能」に設定されています。
計画の名前を入力します (例えば、 daily-dallas-vol1)。計画名は、ポリシー内で固有でなければなりません。
周波数を指定してください。リストから以下の選択肢のいずれか1つを選択してください。
- 日次
  - 「デイリー」プランの場合は、 開始時刻（UTC） を時間と分単位で入力してください（協定世界時）。例えば、正午は 12:00 です。画面上では現地時間の変換が自動的に表示されます。例えば、「中部夏時間午後12時」といった具合です。
- 毎週
  - 「週単位のスケジュール」では、バックアップを実行したい曜日を選択してください。たとえば、月曜日、水曜日、金曜日を選択することができます。「日次」計画と同じ方法で開始時刻を指定します。
- 月次
  - 月額プランをご利用の場合は、バックアップを実行したい月の日付を選択してください。たとえば、「1」と指定すると、毎月1日にバックアップが実行されるようになります。「日次」計画と同じ方法で開始時刻を指定します。
- cron 式を使用して指定してください
  - 「Cron式（UTC） 」の欄に、バックアップの作成頻度を「 cron-spec 」の形式（分、時、日、月、曜日）で入力してください。例えば、毎日午後 5:30 にバックアップを作成するには、 30 17 * * * と入力する必要があります。
「バックアップの宛先」 には、ターゲット・リソースのリージョンが表示されます。 「バックアップ・リソース・グループ」 は、ターゲット・リソースに関連付けられているリソース・グループです。
バックアップの 「保存タイプ」 を指定します。保存期間を日数と保存する総数で指定できます。
- 年齢については、バックアップを保持したい日数を1から1000までの範囲で指定します。
- 「カウント」 には、保持するバックアップの数を指定します。
コストを抑えるため、ニーズに見合った保存期間またはスナップショットの数を設定してください。たとえば、[ Age] を「7」に設定すると、1週間分のバックアップが保持されます。
「オプション」 の下で、個々のボリューム・バックアップに対して 2 つのオプションを構成できます。マルチボリュームバックアップまたは共有バックアップ用のポリシーのプランを作成している場合、高速スナップショットリストアは使用できません。
- 高速スナップショット・リストア-この機能を有効にする場合は、高速リストアを有効にする 1 つ以上のゾーンを指定する必要があります。保存する高速リストア・スナップショットの最大数を指定することもできます。高速リストア機能は、スナップショットのサイズに関係なく、有効になっているゾーンごとに追加の時間単位の料金で請求されます。高速リストアクローンの維持は、通常のスナップショットの維持よりもかなりコストがかかる。
- タグ付け: 計画の実行時にバックアップに適用される追加のタグを指定します。
  - このチェックボックスを選択すると、ソースリソースのすべてのタグがすべてのバックアップにコピーされます。
  - 「バックアップのタグ (Tags for backups)」 の下で、このフィールドに追加のプラン・タグを手動で追加できます。このオプションはファイル共有バックアップでは使用できません。
マルチボリュームバックアップまたは共有バックアップ用のバックアッププランを作成している場合は、［作成］をクリックしてバックアップポリシーページに戻ることができます。個々のボリュームのバックアッププランを作成している場合は、**［次へ］**をクリックして、プランのオプション部分であるリモートコピーの構成に進むことができます。
1. バックアップの地域間コピーを作成するには、コピーを作成する地域と地域を選択します。なお、1地域につき1部のみお持ちいただけますので、ご注意ください。
2. トグルをクリックして、選択した領域でリモート・コピーを有効にします。
3. ソース・スナップショットがお客様管理の鍵を使用して暗号化されている場合は、暗号化サービス・インスタンスを選択し、鍵の名前を指定する必要があります。必要に応じて、リンクに従ってサービス・インスタンスまたは暗号鍵を作成することもできます。
  - Key Protect- これは、 Key Protect サービスを使用して元のボリュームが暗号化されている場合に使用できます。
4. 「変更の適用」 をクリックして、新規プランを保存します。ポリシーの詳細ページで計画のリストが更新されます。
変更を加えたい場合は、そのプランの編集アイコン をクリックします。プランを削除したい場合は、削除アイコンをクリックしてください。

予想される利用量と費用の見積もり

コスト見積もりツールを使用して、 Block Storage for VPC ボリュームの予想される変更率に基づいて、バックアップにかかる費用の目安を確認してください。

バックアップポリシーとプランを作成したら、「バックアップの概要」のサイドパネルで、「 見積もりに追加 」をクリックします。
「見積もり」サイドパネルで、初期費用に予想使用量を入力してください。バックアップ・ポリシーは無料です。バックアップストレージの使用量に応じて料金をお支払いいただきます。以下の見積もりを指定してください。
- バックアップポリシーに関連付けるボリュームまたは共有の数。
- 1ボリュームまたは1共有あたりの平均データ量（GB単位）。例えば、2 つのボリュームを 1 つのポリシーに関連付けるとします。最初のボリュームには 4 GB のデータがあり、2 つ目のボリュームには 20 GB のデータがあります。この 2 つの平均は 12 GB です。
- ボリュームまたは共有ごとに、1か月あたりのバックアップ回数。バックアップスナップショットは、1ボリュームにつき最大750個まで、1共有につき最大750個まで作成できます。
- 初回バックアップ後の増分変更の割合。たとえば、その後のバックアップごとにサイズを15％ずつ増やすといった具合です。
完了したら、**「コストの計算」**をクリックします。

費用見積書の概要には、費用の算出方法が示されており、保管費用の内訳とともに、月額の見積額が記載されています。 **「保存」**をクリックすると、コスト見積もりツール・パネルに詳細が表示されます。

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

バックアップ・ポリシーは、コマンド・ライン・インターフェース (CLI) から作成できます。以下の例は、既存のポリシーについて、プランなしのポリシー、ポリシーとプランを一緒に作成する方法、および別個のバックアップ・プランを作成する方法を示しています。また、既存のポリシーの複数の計画を作成する方法、およびバックアップの高速リストアを使用して計画を作成する方法についても説明します。

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

開始前に

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

IBM Cloud® にログインしてください。
```
ibmcloud login --sso -a cloud.ibm.com
```
このコマンドを実行すると、URL が返され、パスコードの入力を求めるプロンプトが表示されます。ブラウザーでその URL にアクセスしてログインします。成功すると、ワンタイム・パスコードが表示されます。そのパスコードをコピーし、プロンプトに応答として貼り付けます。認証に成功すると、アカウントを選択するように求めるプロンプトが出されます。複数のアカウントアクセスできる場合は、ログインしたいアカウントを選択してください。残りのプロンプトにすべて応答して、ログインを完了します。
エンタープライズ・アカウント管理者がバックアップ・ポリシーを作成し、エンタープライズ・アカウントおよびサブアカウントの計画を作成する場合は、エンタープライズ・アカウント CRN を取り出す必要があります。以下のコマンドを実行して、エンタープライズ・アカウント名、ID、および CRN を表示します。
```
ibmcloud enterprise show
```

アカウントの CLI からの個々のボリュームのバックアップ・ポリシーの作成

ibmcloud is backup-policy-create コマンドを実行して、バックアップ計画なしでバックアップ・ポリシーを作成します。オプション --match-tags および --name を使用して、ポリシーに名前を付け、ターゲット・リソースに使用するタグを識別します。ポリシーが作成されたら、後でそのポリシーにバックアップ計画を追加できます。

ibmcloud is backup-policy-create --match-tags dev:test --name my-backup-policy-v1

Creating backup policy my-backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID                     r006-d6052504-516f-4923-938b-9e9def977428
Name                   my-backup-policy-v1
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-d123456
Status                 pending
Plans                  ID   Name   Resource type
Backup tags            dev:test
Match resource type    volume
Resource group         ID                                 Name
                       11caaa983d9c4beb82690daab08717e9   Default
Scope                  ID                                 Resource type
                       efe5afc483594adaa8325e2b4d1290df   account
Health State           ok
Created at             2023-12-05T19:27:28+05:30

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

エンタープライズの CLI からの個々のボリュームのバックアップ・ポリシーの作成

ibmcloud is backup-policy-create コマンドを実行して、バックアップ計画なしでバックアップ・ポリシーを作成します。エンタープライズ CRN を指定して、エンタープライズ・アカウントとそのサブアカウントのポリシーを作成します。ポリシーが作成されたら、後でそのポリシーにバックアップ計画を追加できます。

ibmcloud is backup-policy-create --match-tags dev:test --name backup-enterprise-scope --scope  crn:v1:bluemix:public:enterprise::a/a1234567::enterprise:7e44cb4667ba4b88b1b1f8dcc15e33b3

Creating backup policy backup-scope-1 under account Enterprise Test as user test.user@ibm.com...
ID                     r006-a1b46efe-12bd-403a-9f09-bede1ad3766f
Name                   backup-enterprise-scope
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-a1b46efe-12bd-403a-9f09-bede1ad3766f
Status                 pending
Plans                  ID   Name   Resource type
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-09-26T13:34:56+05:30

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

アカウントの CLI からの整合性グループのバックアップ・ポリシーの作成

ibmcloud is backup-policy-create コマンドを実行して、バックアップ計画なしでバックアップ・ポリシーを作成します。オプション --match-resource-type、 --included-content、--match-tags、および --name を使用して、ポリシーに名前を付け、ターゲット・リソースに使用するタグを識別します。ポリシーが作成されたら、後でそのポリシーにバックアップ計画を追加できます。

以下の例では、タグ付きインスタンスのブート・ボリュームおよびデータ・ボリュームのバックアップ・ポリシーを作成します。

ibmcloud is backup-policy-create --match-tags dev:test --name my-cr-backup-policy-v1 --match-resource-type instance --included-content data_volumes,boot_volume

Creating 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                pending
Plans                 ID   Name   Resource type
Backup tags           dev:test
Match resource type   instance
Included Content      data_volumes,boot_volume
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-create --match-tags dev:test --name my-cr-backup-policy-v2 --match-resource-type instance --included-content data_volumes

Creating backup policy my-cr-backup-policy-v2 under account Test Account as user test.user@ibm.com...
ID                    r006-e773722f-d61e-487a-ac88-b1800395aa92
Name                  my-cr-backup-policy-v2
CRN                   crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-e773722f-d61e-487a-ac88-b1800395aa92
Status                pending
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-10-20T19:31:16+05:30

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

ibmcloud is backup-policy-create コマンドを実行して、バックアップ計画なしでバックアップ・ポリシーを作成します。 --match-resource-type 、 --match-tags 、 --name のオプションを使用して、ポリシーに名前を付け、対象リソースに使用するタグを特定します。ポリシーの作成後、後でバックアッププランを追加することができます。

次の例では、タグ付きインスタンスのファイル共有のバックアップ・ポリシーを作成します。

ibmcloud is backup-policy-create --match-tags dev:test --name my-share-backup-policy --match-resource-type share

Creating 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-share-backup-policy
CRN                   crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-e0713176-37b6-4168-88ab-ad92f8a544f9
Status                pending
Plans                 ID   Name   Resource type
Backup tags           dev:test
Match resource type   share
Included Content
Resource group        ID                                 Name
                      11caaa983d9c4beb82690daab08717e9   Default
Scope                 ID                                 Resource type
                      a1234567                           account
Health State          ok
Created at            2023-12-05T19:29:35+05:30

アカウントの CLI からのプランを使用したバックアップ・ポリシーの作成

backup-policy-create コマンドを実行して、同じコマンドでバックアップ・ポリシーとバックアップ計画を作成します。

以下の例では、 --match_tags オプションを使用して、ユーザー・タグ dev:test を持つボリュームにタグを突き合わせ、バックアップ計画の頻度を cron-spec 式として指定します。 --plan-attach-user-tags オプションは、バックアップ計画のユーザー・タグがバックアップ・スナップショットに付加されることを示します。 --plan-copy-user-tags オプションをfalseに設定すると、ソースボリュームのユーザータグがバックアップにコピーされないことを示します。 --plan-delete-after オプションは、バックアップを保持する最大日数を示し、 --plan-delete-over-count オプションは、保持する最近のバックアップの最大数を定義します。 -plan-clone-policy-zones オプションは、バックアップ・スナップショットが作成され、別のリージョン・ストレージ・リポジトリに保存された後、バックアップの完全コピーがアベイラビリティ・ゾーンの us-south-1 リージョンに保存されることを指定します。 --plan-clone-policy-max-snapshots オプションは、AZ に保管されるキャッシュ・バックアップの数を 4 に変更します。デフォルト値は 5 です。

ibmcloud is backup-policy-create --match-tags dev:test --name my-backup-policy-v2 --plan-name my-plan-b  --plan-attach-tags bkp:test --plan-copy-tags false --plan-delete-after 60 --plan-cron-spec '45 09 * * *' --plan-active --plan-clone-policy-max-snapshots 4 --plan-clone-policy-zones us-south-1,us-south-2 --plan-delete-over-count 2

Creating backup policy my-backup-policy-v2 under Test Account as user test.user@ibm.com...
ID                     r006-0723c648-9a47-4d51-b1ba-349e21e715b6
Name                   my-backup-policy-v2
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-0723c648-9a47-4d51-b1ba-349e21e715b6
Status                 pending
Plans                  ID                                          Name        Resource type
                       r006-e888bb31-7bf2-4885-a9f3-d448c1c37326   my-plan-b   backup_policy_plan
Backup tags            dev:test
Match resource type    volume
Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults
Scope                  ID                                 Resource type
                       a1234567                           account
Health State           ok
Created at             2023-12-05T19:27:28+05:30

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

エンタープライズ用の CLI からのプランを使用したバックアップ・ポリシーの作成

backup-policy-create コマンドを実行して、同じコマンドでバックアップ・ポリシーとバックアップ計画を作成します。 scope でエンタープライズ CRN を指定して、エンタープライズ・アカウントとそのサブアカウントのポリシーを作成します。

ibmcloud is backup-policy-create --match-tags dev:test --name backup-scope-2 --plan-name scope-plan-2 --plan-attach-tags dev:test --plan-copy-tags false --plan-delete-after 60 --plan-cron-spec '45 09 * * *' --plan-active  --plan-delete-over-count 2 --scope  crn:v1:bluemix:public:enterprise::a1234567::enterprise:7e44cb4667ba4b88b1b1f8dcc15e33b3

Creating backup policy backup-scope-2 under account Enterprise Test as user test.user@ibm.com...
ID                     r006-0bc533ed-4796-407a-982e-693b418f3de3
Name                   backup-scope-2
CRN                    crn:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-0bc533ed-4796-407a-982e-693b418f3de3
Status                 pending
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
                       e7654321   crn:v1:bluemix:public:enterprise::a/a1234567::enterprise:e7654321   -
Health State           ok
Created at             2023-08-30T13:39:10+05:30

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

CLI を使用して、複数のプランを含むバックアップポリシーを作成する

ibmcloud is backup-policy-create コマンドを実行し、複数のプランを JSON 形式で定義します。この例では、my-policy-plan-a と my-policy-plan-bの 2 つの計画を作成します。

$ ibmcloud is backup-policy-create --match-tags dev:test --name backup-policy-v1  --plans '[{
   "active": true,
   "attach_user_tags": ["daily-backup-plan"],
   "copy_user_tags": true,
   "cron_spec": "05 15 * * *",
   "clone_policy": {
     "max_snapshots": 4,
      "zones": [
        {"name": "eu-de-1"},
        {"name": "eu-de-2"}
       ]
     },
   "deletion_trigger": {
     "delete_after": 20,
     "delete_over_count": 20
   },
   "name": "my-policy-plan-a"
 },{
   "active": true,
   "attach_user_tags": ["daily-backup-plan"],
   "copy_user_tags": true,
   "cron_spec": "10 20 * * *",
    "clone_policy": {
     "max_snapshots": 3,
      "zones": [
        {"name": "eu-de-1"},
        {"name": "eu-de-2"}
       ]
     },
   "deletion_trigger": {
     "delete_after": 20,
     "delete_over_count": 20
   },
   "name": "my-policy-plan-c"
 }]'

結果によると、2つの計画が作成されたことがわかります。

Creating backup policy backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID                     r138-0521986d-963c-4c18-992d-d6a7a99d115f
Name                   backup-policy-v1
CRN                    crn:v1:bluemix:public:is:eu-de:a/a1234567::backup-policy:r138-0521986d-963c-4c18-992d-d6a7a99d115f
Status                 pending
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

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

CLI からのバックアップ計画の作成

backup-policy-plan-create コマンドを実行してバックアッププランを作成し、それを既存のポリシーに紐付けます。 ID または名前でポリシーを識別します。

構文:

ibmcloud is backup-policy-plan-create POLICY --cron-spec CRON_SPEC [--name NAME] [--active] [--attach-tags ATTACH_TAGS] [--copy-tags true | false] [[--delete-after DELETE_AFTER] [--delete-over-count 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-backup-policy-v1 という名前で識別される既存のポリシーのバックアップ計画を作成します。これは、 not-just-another-plan という名前の新規計画によって作成されたバックアップ・スナップショットにバックアップ・ポリシー・タグを付加します。バックアップ・ジョブは毎朝 01:05 に実行され、ソース・ボリューム・タグをバックアップ・スナップショットにコピーします。高速リストア・クローンは有効になっておらず、最も古いバックアップは、80 個のバックアップ・スナップショットが作成された後に削除されます。

ibmcloud is backup-policy-plan-create my-backup-policy-v1  --attach-tags dev:test --copy-tags true --cron-spec '05 01 * * *' --delete-after 80 --name not-just-another-plan

Creating plan not-just-another-plan of backup policy my-backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID                   r138-4d77d84c-929c-49e9-9f05-952be9486406
Name                 not-just-another-plan
Active               true
Lifecycle state      pending
Clone policy         Max snapshots   Zones
                     0
Deletion trigger     Delete after   Delete over count
                     80             -
Attached tags        dev:test
Copy tags            true
Cron specification   05 01 * * *
Created at           2023-02-21T22:19:22+00:00
Resource type        backup_policy_plan

CLI からの高速リストア・オプションを使用したバックアップ計画の作成

既存のポリシーのバックアップ計画を作成するには、 ibmcloud is backup-policy-plan-create コマンドを使用してポリシー ID を指定します。次に、以下のオプションを使用してプランを作成します。

--cron-spec の後に、バックアップ・ジョブを実行するタイミングを定義する cron 式が続きます。
--active は、プランがアクティブであることを示します。
--name の後に、新規プラン用に選択した名前が続きます。
--attach-tags の後に、バックアップ・スナップショットに付加するタグのリストが続きます。
--copy-tags の後に true または false を指定して、バックアップ・スナップショットが親ボリュームからタグを継承するかどうかを示します。
--delete-after の後に、バックアップを保持する日数を指定します。
--delete-over の後に、ボリュームの保持するバックアップの最大数を指定します。
--clone-policy-max-snapshots の後に、保持するクローンの数を指定します。
--clone-policy-zones の後に、バックアップ・スナップショットのコピーを保持するゾーンのリストが続きます。

以下の例では、eu-de リージョン内の 2 つのゾーンに高速リストア・オプションを含む既存のポリシーのバックアップ計画を作成します。このプランには、各ゾーンに最大 2 つのキャッシュ・バックアップを保持することが含まれます。バックアップ・ジョブは、毎日午後 7 時 15 分にバックアップ・スナップショットの作成を開始します。

ibmcloud is backup-policy-plan-create r138-8c494618-9e4f-4b67-9a08-ee3491404f3b  --cron-spec '15 19 * * *' --active --name my-policy-plan --attach-tags my-daily-backup-plan --copy-tags true --delete-after 10 --delete-over-count 2 --clone-policy-max-snapshots 2 --clone-policy-zones eu-de-1,eu-de-3

Creating plan my-policy-plan of backup policy r138-8c494618-9e4f-4b67-9a08-ee3491404f3b under account Test Account as user ibm.user@ibm.com...
ID                   r138-7734be40-e2a5-4ee6-b4bd-75763639092b
Name                 my-policy-plan
Active               true
Lifecycle state      pending
Clone policy         Max snapshots   Zones
                     2               eu-de-1,eu-de-3
Deletion trigger     Delete after   Delete over count
                     10             2
Attached tags        my-daily-backup-plan
Copy tags            true
Cron specification   15 19 * * *
Created at           2023-02-21T19:21:28+00:00
Resource type        backup_policy_plan

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

高速復元機能は、この機能が有効になっている各ゾーンごとに、1時間あたりの追加料金が課金されます。高速リストア・クローンの維持は、通常のバックアップ・スナップショットを保持するよりもかなりコストがかかります。

高速リストア機能は、マルチボリュームまたは共有バックアップでは使用できません。

CLI からの地域間コピー・オプションを使用したバックアップ計画の作成

バックアップ・スナップショットのコピーも別のリージョンに保存するバックアップ計画を作成するには、 --remote-region-policies オプションを指定して ibmcloud is backup-policy-plan-create コマンドを実行します。

ソース・スナップショットがカスタマー・キーで暗号化されていない場合、コピーの暗号化はプロバイダー管理のままになります。ソース・スナップショットがお客様管理の鍵によって保護されている場合は、 --encryption-key オプションを使用して、新規コピーの暗号化に使用するお客様管理の鍵を指定する必要があります。以下の例を参照してください。

ibmcloud is backup-policy-plan-create my-backup-policy-v1 --cron-spec '0 0 * * *' --name my-crc-plan1 --remote-region-policies '[
  {
    "delete_over_count": 10,
    "region": {"name": "us-east"}
  }
]'

Creating plan my-crc-plan1 of backup policy my-backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID                       r006-f0d881c9-213e-471b-bba7-999ee2eee3ff
Name                     my-crc-plan1
Active                   true
Lifecycle state          pending
Clone policy             Max snapshots   Zones
                         0
Deletion trigger         Delete after   Delete over count
                         30             -
Remote Region Policies   Region    Encryption Key   Delete over count
                         us-east   -                10
Attached tags            -
Copy tags                true
Cron specification       0 0 * * *
Created at               2023-05-05T15:27:01+05:30
Resource type            backup_policy_plan

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

クロスリージョナルコピー機能は、マルチボリュームまたは共有バックアップには適用できません。

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

以下のサンプル要求に示すように、 VPC API で /backup_policies メソッドを呼び出すことにより、バックアップ・ポリシーをプログラムで作成できます。 POST /backup_policies 要求は、バックアップ対象の Block Storage for VPC ボリューム・リソースを識別するために指定したタグを使用してバックアップ・ポリシーを作成します。バックアップ・ポリシーは、バックアップ・スケジュールおよび削除ルールを定義するバックアップ計画を受け入れます。

エンタープライズ・アカウント管理者がバックアップ・ポリシーを作成し、エンタープライズ・アカウントおよび子アカウントを計画する場合は、エンタープライズ・アカウント CRN を取り出す必要があります。以下の例のように、 Enterprise Management API に対して API 要求を行います。

curl -X GET "https://enterprise.cloud.ibm.com/v1/accounts/$ACCOUNT_ID" -H "Authorization: Bearer <IAM_Token>" -H 'Content-Type: application/json'

応答で、「親」CRN を探します。この CRN には、エンタープライズ ID とアカウント ID が含まれます。

{
	"url": "/v1/accounts/ea123456",
	"id": "ea1ef237216e4f9e8e6f76eccec761f8",
	"parent": "crn:v1:bluemix:public:enterprise::a/ea123456::enterprise:b0398194",
	"enterprise_account_id": "ea123456",
	"enterprise_id": "b0398194",
	"enterprise_path": "enterprise:b0398194",
	"name": "Enterprise for VPC",
	"state": "ACTIVE",
	"paid": true,
	"owner_iam_id": "IBM_ID",
	"owner_email": "test.user@ibm.com",
	"created_at": "2022-08-03T16:26:59.175Z",
	"created_by": "iam-ServiceId-3a65c352-34b4-40ca-9360-93a0045fa76a",
	"updated_at": "2023-03-30T23:25:55.556Z",
	"updated_by": "iam-ServiceId-3b123876-4cf2-4565-ba37-2f0a0a8faab1",
	"crn": "crn:v1:bluemix:public:enterprise::a/ea123456:account:ea123456",
	"is_enterprise_account": true
}

アカウントの API を使用した個々のボリュームのバックアップ・ポリシーおよびプランの作成

POST /backup_policies 要求を行って、バックアップ・ポリシーを作成します。 match_resource_type の値は volume です。 match_user_tags プロパティは、 Block Storage for VPC ボリュームリソース上のバックアップタグを識別し、それをこのプランに関連付けます。この例では、バックアップ計画の頻度は cron_spec で定義されています。

curl -X POST "$vpc_api_endpoint/v1/backup_policies?version=2022-04-19&generation=2"\
   -H "Authorization: Bearer $iam_token"\
   -d '{
      "match_resource_type": "volume",
      "match_user_tags": "my-daily-backup-policy",
      "name": "my-backup-policy",
      "plans": [
       {
         "attach_user_tags": "my-daily-backup-plan",
         "copy_user_tags": true,
         "cron_spec": "*/5 1,2,3 * * *",
         "deletion_trigger": {"delete_after": 20},
         "name": "my-backup-plan"
       }
     ],
     "resource_group": {
       "crn": "crn:v1:bluemix:public:resource-controller::a/123456::resource-group:678523bcbe2b4eada913d32640909956",
       "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
       "id": "678523bcbe2b4eada913d32640909956",
       "name": "Default"
     }
   }'

正常な応答は、次の例のようになります。

{
  "created_at": "2022-04-19T18:10:58.060Z",
  "crn": "crn:v1:bluemix:public:is:us-south:a/123456::backup-policy:eca6556f-f67d-4a3e-8428-3db8819fc60c",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/eca6556f-f67d-4a3e-8428-3db8819fc60c",
  "id": "eca6556f-f67d-4a3e-8428-3db8819fc60c",
  "lifecycle_state": "stable",
  "match_resource_type": "volume",
  "match_user_tags": "my-daily-backup-policy",
  "name": "my-backup-policy",
  "plans": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/eca6556f-f67d-4a3e-8428-3db8819fc60c/plans/f0b3740b-83b6-4426-af99-140b90ad6f33",
      "id": "f0b3740b-83b6-4426-af99-140b90ad6f33",
      "name": "my-policy-plan",
      "resource_type": "backup_policy_plan"
    }
  ],
  "resource_group": {
    "crn": "crn:v1:bluemix:public:resource-controller::a/123456::resource-group:fee82deba12e4c0fb69c3b09d1f12345",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "my-resource-group"
  },
  "resource_type": "backup_policy"
}

エンタープライズ用の API を使用した個々のボリュームのバックアップ・ポリシーおよび計画の作成

curl -X POST "$vpc_api_endpoint/v1/backup_policies?version=2023-08-12&generation=2"
-H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer $iam_token"\
-d "{
  {
      "match_resource_type": "volume",
      "match_user_tags": "my-daily-backup-policy",
      "name": "my-backup-policy",
      "plans": [
       {
         "attach_user_tags": ["my-daily-backup-plan"],
         "copy_user_tags": true,
         "cron_spec": "*/5 1,2,3 * * *",
         "deletion_trigger": {"delete_after": 20},
         "name": "my-backup-plan"
       },
       {
         "attach_user_tags": "my-daily-backup-plan",
         "copy_user_tags": true,
         "cron_spec": "*/5 1,2,3 * * *",
         "deletion_trigger": {"delete_after": 20},
         "name": "my-backup-plan"
       }
     ],
     "resource_group": {
       "crn": "crn:v1:bluemix:public:resource-controller::a/123456::resource-group:678523bcbe2b4eada913d32640909956",
       "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
       "id": "678523bcbe2b4eada913d32640909956",
       "name": "Default"
     },
     "scope": {"crn":"crn:v1:bluemix:public:enterprise::a/ea123456::enterprise:b0398194"}
  }'

正常な応答は、次の例のようになります。

{
  "created_at": "2022-04-21T15:06:03.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south:a/123456::backup-policy:r006-076191ba-49c2-4763-94fd-c70de73ee2e6",
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-076191ba-49c2-4763-94fd-c70de73ee2e6",
  "id": "r006-076191ba-49c2-4763-94fd-c70de73ee2e6",
  "included_content": "data_volume",
  "lifecycle_state": "pending",
  "match_resource_type": "volume",
  "match_user_tags": ["my-tag-1", "my-tag-2"],
  "name": "my-backup-policy",
  "plans": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-076191ba-49c2-4763-94fd-c70de73ee2e6/plans/r006-4d6074c4-3811-4bb3-af4a-1fd6cb38d6fe",
      "id": "r006-4d6074c4-3811-4bb3-af4a-1fd6cb38d6fe",
      "name": "my-backup-plan-1",
      "resource_type": "backup_policy_plan"
    }
  ],
  "resource_group": {
    "crn": "crn:v1:bluemix:public:resource-controller::a/123456::resource-group:678523bcbe2b4eada913d32640909956",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "backup_policy",
  "scope": {
    "crn": "crn:v1:bluemix:public:enterprise::a/e92d45e305dc4ee0b13e29be392f1c0c::enterprise:ebc2b430240943458b9e91e1432cfcce",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "resource_type": "account",
    "scope": {"crn":"crn:v1:bluemix:public:enterprise::a/ea123456::enterprise:b0398194"}
  }
}

Block Storage ・ボリュームの整合性グループのバックアップ・ポリシーおよび計画の作成

POST /backup_policies 要求を行って、バックアップ・ポリシーを作成します。 match_resource_type の値は instance です。データ・ボリュームのみのバックアップを作成するには、 included_content オプションに data volumes を指定します。バックアップ操作にブート・ボリュームを含める場合は、 included_content オプションの一部として boot-volume も指定します。 match_user_tags プロパティーは、仮想サーバー・インスタンス・リソース上のバックアップ・タグを識別し、接続されている Block Storage for VPC ボリュームをこのポリシーおよびプランに関連付けます。この例では、バックアップ計画の頻度は cron_spec で定義され、データ・ボリュームのみがバックアップに含まれます。

curl -X POST "$vpc_api_endpoint/v1/backup_policies?version=2023-12-05&generation=2"\
   -H "Authorization: Bearer $iam_token"\
   -d '{
      "match_resource_type": "instance",
      "included_content": "data_volumes",
      "match_user_tags": "my-daily-backup-policy",
      "name": "my-backup-policy-for-consistency-group",
      "plans": [
       {
         "name": "my-backup-plan-for-cg",
         "attach_user_tags": ["my-daily-backup-plan"],
         "copy_user_tags": true,
         "cron_spec": "*/5 1,2,3 * * *",
         "deletion_trigger": {"delete_after": 20}
       }
      ],
      "resource_group": {
        "crn": "crn:v1:bluemix:public:resource-controller::a/a1234567::resource-group:678523bcbe2b4eada913d32640909956",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
        "id": "678523bcbe2b4eada913d32640909956",
        "name": "Default"
      },
     }'

正常な応答は、次の例のようになります。

{
  "included_content": ["data_volumes"],
  "match_resource_type": ["instance"],
  "match_user_tags": ["my-daily-backup-policy"],
  "name": "my-backup-policy-for-consistency-group",
  "plans": [
    {
      "active": true,
      "attach_user_tags": ["my-daily-backup-plan"],
      "clone_policy": {
        "max_snapshots": 0,
        "zones": [
          {"name": "us-south-1"},
          {"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1"}
        ]
       },
      "copy_user_tags": true,
      "cron_spec": "30 */2 * * 1-5",
      "deletion_trigger": {
        "delete_after": 20,
        "delete_over_count": 20
       },
      "name": "my-backup-plan-for-cg"
    }
  ],
  "resource_group": {
    "crn": "crn:v1:bluemix:public:resource-controller::a/123456::resource-group:678523bcbe2b4eada913d32640909956",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
}

以下の例は、ブート・ボリュームを含むマルチボリューム整合性グループのスナップショットを作成するバックアップ・ポリシーです。

curl -X POST "$vpc_api_endpoint/v1/backup_policies?version=2023-12-05&generation=2"\
   -H "Authorization: Bearer $iam_token"\
   -d '{
      "match_resource_type": "instance",
      "included_content": ["data_volumes","boot_volume"]
      "match_user_tags": "vsi11",
      "name": "my-consistency-group-policy",
      "plans": [
       {
         "name": "my-backup-plan-for-cg2",
         "attach_user_tags": ["my-daily-backup-plan"],
         "copy_user_tags": true,
         "cron_spec": "*/5 1,2,3 * * *",
         "deletion_trigger": {"delete_after": 20}
       }
      ],
      "resource_group": {
        "crn": "crn:v1:bluemix:public:resource-controller::a/a1234567::resource-group:678523bcbe2b4eada913d32640909956",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/f20bdbd6554d48739ad38717e0511fdd",
        "id": "f20bdbd6554d48739ad38717e0511fdd",
        "name": "Default"
      },
     }'

正常な応答は、次の例のようになります。

{
  "created_at": "2023-12-05T19:49:02Z",
  "crn": "crn:v1:bluemix:public:is:eu-es:a/a7654321::backup-policy:r050-05135f1e-e1ce-467f-82bd-c46a18ff5d3b",
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://eu-es.iaas.cloud.ibm.com/v1/backup_policies/r050-05135f1e-e1ce-467f-82bd-c46a18ff5d3b",
  "id": "r050-05135f1e-e1ce-467f-82bd-c46a18ff5d3b",
  "included_content": [
    "boot_volume",
    "data_volumes"
  ],
  "lifecycle_state": "pending",
  "match_resource_type": "instance",
  "match_user_tags": [
    "vsi11"
  ],
  "name": "my-consistency-group-policy",
  "plans": [
    {
      "href": "https://eu-es.iaas.cloud.ibm.com/v1/backup_policies/r050-05135f1e-e1ce-467f-82bd-c46a18ff5d3b/plans/r050-63031736-14cc-472c-aa94-d1c790438d93",
      "id": "r050-63031736-14cc-472c-aa94-d1c790438d93",
      "name": "my-backup-plan-for-cg2",
      "resource_type": "backup_policy_plan"
    }
  ],
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/f20bdbd6554d48739ad38717e0511fdd",
    "id": "f20bdbd6554d48739ad38717e0511fdd",
    "name": "Default"
      },
  "resource_type": "backup_policy",
  "scope": {
    "id": "53945f147c1441b0940bc00927863af6",
    "resource_type": "account"
  }
}

POST /backup_policies 要求を行って、バックアップ・ポリシーを作成します。 match_resource_type の値は share です。 match_user_tags プロパティは、ファイル共有リソースのバックアップタグを識別し、このポリシーとプランに関連付けます。

curl -X POST "$vpc_api_endpoint/v1/backup_policies?version=2024-12-10&generation=2"\
   -H "Authorization: Bearer $iam_token"\
   -d '{
      "match_resource_type": "share",
      "match_user_tags": "my-daily-backup-policy",
      "name": "my-backup-policy-for-file-shares",
      "plans": [
       {
         "name": "my-backup-plan-for-share",
         "attach_user_tags": ["my-daily-backup-plan"],
         "copy_user_tags": true,
         "cron_spec": "*/5 1,2,3 * * *",
         "deletion_trigger": {"delete_after": 20}
       }
      ],
      "resource_group": {
        "crn": "crn:v1:bluemix:public:resource-controller::a/a1234567::resource-group:678523bcbe2b4eada913d32640909956",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
        "id": "678523bcbe2b4eada913d32640909956",
        "name": "Default"
      },
     }'

API を使用した既存のバックアップ・ポリシーの計画の作成

以下のサンプル要求に示すように、 VPC API で /backup_policies/{id}/plans メソッドを呼び出すことにより、既存の ID のバックアップ計画をプログラマチックに作成できます。

curl -X POST "$vpc_api_endpoint/v1/backup_policies/8758bd18-344b-486a-b606-5b8cb8cdd044/plans?version=2022-04-19&generation=2"\
   -H "Authorization: Bearer $iam_token"\
   -d '{
     "attach_user_tags": ["my-daily-backup-plan"],
     "copy_user_tags": true,
     "cron_spec": "*/5 1,2,3 * * *",
     "deletion_trigger": {"delete_after": 20},
     "name": "my-backup-plan"
   }'

正常な応答は、次の例のようになります。

{
  "active": true,
  "attach_user_tags": ["my-daily-backup-plan"],
  "copy_user_tags": true,
  "created_at": "2022-04-22T22:51:31.303Z",
  "cron_spec": "*/5 1,2,3 * * *",
  "deletion_trigger": {"delete_after": 20},
  "href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/8758bd18-344b-486a-b606-5b8cb8cdd044/plans/4cf9171a-0043-4434-8727-15b53dbc374c",
  "id": "4cf9171a-0043-4434-8727-15b53dbc374c",
  "lifecycle_state": "stable",
  "name": "my-backup-plan",
  "resource_type": "backup_policy_plan"
}

API を使用した高速リストア・オプションによるバックアップ計画の作成

既存のポリシーのバックアップ計画を作成するときに、バックアップ・スナップショットのクローンを作成することを指定できます。これらのクローンはリージョン内の異なるゾーンに作成されるため、完全にプロビジョンされたボリュームを素早くリストアできます。このオプションについて詳しくは、高速リストアを使用したボリュームのリストアを参照してください。

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

以下の例では、 us-south-2 ゾーンに高速リストアを含む既存のポリシーのバックアップ計画を作成します。プランでは、最大 2 つのキャッシュ・バックアップ・スナップショットを保持することが指定されています。

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": ["hourly-backups"],
        "clone_policy": {
          "max_snapshots": 2,
          "zones": [
            {"name": "us-south-2"},
            {"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2"}
          ]
        },
        "copy_user_tags": true,
        "cron_spec": "0 */2 * * *",
        "deletion_trigger": {
          "delete_after": 20,
          "delete_over_count": 20
        },
        "name": "my-hourly-plan-1"
      }'

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

{
  "active": true,
  "attach_user_tags": ["hourly-backups"],
  "clone_policy": {
    "max_snapshots": 2,
    "zones": [
      {"name": "us-south-2"},
      {"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2"}
    ]
  },
  "copy_user_tags": false,
  "created_at": "2022-12-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-1",
  "resource_type": "backup_policy_plan"
}

また、バックアップ・ポリシーおよび計画を作成するときに、高速リストア・オプションをセットアップすることもできます。 plans プロパティーのサブプロパティーとして clone_policy を指定します。詳しくは、API リファレンスのバックアップ・ポリシーの作成を参照してください。

高速リストア機能は、それが有効になっている各ゾーンについて、1時間あたりの追加料金で請求される。高速リストア・クローンの維持は、通常のバックアップ・スナップショットを保持するよりもかなりコストがかかります。

高速リストア機能は、マルチボリュームまたは共有バックアップには適用されません。

API を使用した地域間コピー・オプションによるバックアップ計画の作成

バックアップ計画を作成するときに、バックアップ・スナップショットのコピーを別のリージョンに作成することを選択できます。

ソース・スナップショットがカスタマー・キーで暗号化されていない場合、コピーの暗号化はプロバイダー管理のままになります。ソース・スナップショットがお客様管理の鍵によって保護されている場合は、 encryption_key サブプロパティーを使用して、新規コピーの暗号化に使用するお客様管理の鍵を指定する必要があります。以下の例を参照してください。

以下の例では、 us-east リージョンにバックアップのコピーを持つバックアップ・ポリシーを us-south リージョンに作成します。

curl -X POST "$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": ["hourly-backups"],
        "copy_user_tags": true,
        "cron_spec": "0 */2 * * *",
        "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-hourly-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 Providerプラグインを設定する。詳しくは、 Terraform の概要を参照してください。

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

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

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

Terraform を使用したアカウントの個々のボリュームのバックアップ・ポリシーの作成

バックアップ・ポリシーを作成するには、 ibm_is_backup_policy リソースを使用します。以下の例では、 my-backup-policy-v1 という名前のバックアップ・ポリシーを定義します。また、新しいポリシーは、 dev:test タグを持つリソースに適用されます。

resource "ibm_is_backup_policy" "example" {
  match_resource_type  = ["volume"]
  match_user_tags      = ["dev:test"]
  name                 = "my-backup-policy-v1"
}

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

Terraform を使用したボリュームの整合性グループのバックアップ・ポリシーの作成

バックアップ・ポリシーを作成するには、 ibm_is_backup_policy リソースを使用します。以下の例では、 my-backup-policy-v2 という名前のバックアップ・ポリシーを定義します。また、新規ポリシーは、 dev:test タグでタグ付けされたインスタンスに接続されているブロック・ストレージ・ボリュームに適用されます。

resource "ibm_is_backup_policy" "example" {
  match_resource_type  = ["instance"]
  included_content     = ["boot_volume", "data_volumes"]
  match_user_tags      = ["dev:test"]
  name                 = "my-backup-policy-v2"
}

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

バックアップ・ポリシーを作成するには、 ibm_is_backup_policy リソースを使用します。以下の例では、 my-backup-policy-v3 という名前のバックアップ・ポリシーを定義します。そして新しいポリシーは、 dev:test タグが付けられたファイル共有に適用される。

resource "ibm_is_backup_policy" "example" {
  match_resource_type  = ["share"]
  match_user_tags      = ["dev:test"]
  name                 = "my-backup-policy-v2"
}

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

Terraform を使用したエンタープライズのバックアップ・ポリシーの作成

バックアップ・ポリシーを作成するには、 ibm_is_backup_policy リソースを使用します。以下の例では、 my-backup-policy-v2 という名前のバックアップ・ポリシーを定義し、有効範囲内の Enterprise CRN を指定します。また、新しいポリシーは、 dev:test タグを持つリソースに適用されます。

resource "ibm_is_backup_policy" "ent-baas-example" {
  match_resource_type  = ["volume"]
  match_user_tags      = ["dev:test"]
  name                 = "my-backup-policy-v2"
  scope {
    crn = "crn:v1:bluemix:public:is:us-south:a/123456::reservation:7187-ba49df72-37b8-43ac-98da-f8e029de0e63"
  }
}

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

Terraform を使用した既存のバックアップ・ポリシーのプランの作成

バックアップ計画を作成するには、 ibm_is_backup_policy_plan リソースを使用します。以下の例では、 my-backup-policy-v1 ポリシー内で計画を定義します。新しい計画は not-just-another-plan と呼ばれ、毎朝 01:05 にバックアップ・ジョブを開始します。

 resource "ibm_is_backup_policy_plan" "example" {
  backup_policy_id = ibm_is_backup_policy.example.id
  cron_spec        = "05 01 * * *"
  name             = "my-backup-plan"
}

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

Terraform での高速リストア・オプションを使用したバックアップ計画の作成

高速リストア・オプションを使用してバックアップ計画を作成するには、 ibm_is_backup_policy_plan リソースを使用します。

以下の例では、eu-de リージョン内の 2 つのゾーンでの高速リストアを含む既存のポリシーのバックアップ計画を定義します。このプランには、各ゾーンに最大 2 つのキャッシュ・バックアップを保持することが含まれます。バックアップ・ジョブは、毎日午後 7 時 15 分にバックアップ・スナップショットの作成を開始します。

resource "ibm_is_backup_policy_plan" "example" {
  backup_policy_id = "ibm_is_backup_policy.example.id"
  cron_spec        = "15 19 * * *"
  name             = "my-policy-plan"
  clone_policy {
    zones          = ["eu-de-1", "eu-de-3"]
    max_snapshots  = 2
  }
}

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

高速リストア機能は、マルチボリュームまたは共有バックアップには適用されません。

Terraform を使用した地域間コピー・オプションによるバックアップ計画の作成

地域間コピー・オプションを使用してバックアップ計画を作成するには、 ibm_is_backup_policy_plan リソースを使用します。ソース・スナップショットがカスタマー・キーで暗号化されていない場合、コピーの暗号化はプロバイダー管理のままになります。ソース・スナップショットがお客様管理の鍵によって保護されている場合は、 --encryption-key オプションを使用して、新規コピーの暗号化に使用するお客様管理の鍵を指定する必要があります。以下の例を参照してください。

resource "ibm_is_backup_policy_plan" "example" {
  backup_policy_id = "ibm_is_backup_policy.example.id"
  cron_spec        = "30 */2 * * 1-5"
  name             = "my-policy-plan"
  deletion_trigger {
    delete_after      = 20
    delete_over_count = 20
  }
  remote_copy_policies {
    delete_over_count = 1
    encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
    region = "us-south"
  }
}

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

クロスリージョナルコピー機能は、マルチボリュームまたは共有バックアップには適用できません。

次のステップ

バックアップ・ポリシーを作成した後、以下のアクションを実行できます。

バックアップ・ポリシーおよび計画の作成

バックアップ・ポリシーおよび計画の作成

開始前に

コンソールでバックアップポリシーとプランを作成する

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

コンソールでバックアッププランを作成する

予想される利用量と費用の見積もり

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

開始前に

アカウントの CLI からの個々のボリュームのバックアップ・ポリシーの作成

エンタープライズの CLI からの個々のボリュームのバックアップ・ポリシーの作成

アカウントの CLI からの整合性グループのバックアップ・ポリシーの作成

CLIからファイル共有のバックアップポリシーを作成する

アカウントの CLI からのプランを使用したバックアップ・ポリシーの作成

エンタープライズ用の CLI からのプランを使用したバックアップ・ポリシーの作成

CLI を使用して、複数のプランを含むバックアップポリシーを作成する

CLI からのバックアップ計画の作成

CLI からの高速リストア・オプションを使用したバックアップ計画の作成

CLI からの地域間コピー・オプションを使用したバックアップ計画の作成

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

アカウントの API を使用した個々のボリュームのバックアップ・ポリシーおよびプランの作成

エンタープライズ用の API を使用した個々のボリュームのバックアップ・ポリシーおよび計画の作成

Block Storage ・ボリュームの整合性グループのバックアップ・ポリシーおよび計画の作成

ファイル共有のバックアップポリシーとプランの作成

API を使用した既存のバックアップ・ポリシーの計画の作成

API を使用した高速リストア・オプションによるバックアップ計画の作成

API を使用した地域間コピー・オプションによるバックアップ計画の作成

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

Terraform を使用したアカウントの個々のボリュームのバックアップ・ポリシーの作成

Terraform を使用したボリュームの整合性グループのバックアップ・ポリシーの作成

Terraformでファイル共有のバックアップポリシーを作成する

Terraform を使用したエンタープライズのバックアップ・ポリシーの作成

Terraform を使用した既存のバックアップ・ポリシーのプランの作成

Terraform での高速リストア・オプションを使用したバックアップ計画の作成

Terraform を使用した地域間コピー・オプションによるバックアップ計画の作成

次のステップ