バックアップ・ポリシーの表示
ストレージリソースに対する「 IBM Cloud 」のバックアップポリシーを一覧表示し、ポリシーの詳細や、バックアップポリシーのタグと一致するリソースを確認します。
コンソールでバックアップポリシーを表示する
UI を使用して、すべてのバックアップ・ポリシーをリストし、特定のポリシーの詳細を表示することができます。
コンソールですべてのバックアップポリシーを一覧表示する
UI を使用して、選択したリージョン内のアカウントに属するボリュームに対して作成したすべてのバックアップポリシーを一覧表示します。
IBM Cloud コンソールで、 ナビゲーション メニュー アイコン
> インフラストラクチャ
> ストレージ > バックアップ ポリシー をクリックします。
表 1 は、「バックアップ・ポリシー・リスト」ページの情報について説明しています。 アカウントのデフォルトの地域が選択されています。 メニューから別の地域を選択することができます。 このページには、ポリシーが新しいものから古いものの順に一覧表示されています。
| フィールド | 値 |
|---|---|
| 名前 | ポリシーの名前をクリックすると、その詳細が表示されます。 |
| ステータス | 「 Stable 」など、ポリシーのステータス。 ポリシー状況について詳しくは、 バックアップ・ポリシー状況 を参照してください。 |
| 適用されたリソース | ポリシーによってバックアップするようにタグ付けされているリソース Block Storage for VPC ボリューム、 File Storage for VPC 共有、または仮想サーバーインスタンス）の数 [1] 。 この番号は、ポリシーに適用されるリソースのリストに移動するリンクです。 |
| ターゲット・リソースのタグ | バックアップ対象のボリュームまたは共有のタグ。 |
| 最終実行時刻 (ローカル) | バックアップ・ポリシーに対してジョブが最後に実行された時刻。 このフィールドがブランクの場合、ボリュームには実行するジョブと一致するタグがありません。 |
| 作成日 (ローカル) | バックアップが作成された日時。 |
「アクション」アイコン 
をクリックすると、コンテキスト固有のアクションのメニューを表示できます。
- 復元
- の削除
コンソールでバックアップポリシーの詳細を表示する
UI を使用して、バックアップポリシーの詳細を確認できます。
-
IBM Cloud コンソールで、 ナビゲーション メニュー アイコン
> インフラストラクチャ> ストレージ > バックアップ ポリシー をクリックします。 -
ポリシー名をクリックします。 表 2 および 3 には、選択したバックアップ・ポリシーとその関連プランに関する情報が記載されています。 アクションメニュー
から、アクティビティ追跡、イベント通知の追加、ポリシーの削除ができます。
| フィールド | 値 |
|---|---|
| 名前 | バックアップ・ポリシーの名前。 「編集」アイコン  をクリックして編集します。 |
| ポリシー ID | バックアップ・ポリシー ID。 |
| リソース・グループ | Block Storage for VPC ボリュームの リソース・グループ。 |
| ロケーション | 選択したリージョンのポリシー。 |
| 作成日 | 保険契約が締結された日付。 |
| CRN | ポリシーのクラウド・リソース名。 |
| 適用されたリソース | ポリシーによってカバーされているボリュームの数。 このリストには、そのアカウントのユーザーが作成したボリュームと共有が含まれる。 ポリシーがエンタープライズ全体のポリシーである場合、リストには、子アカウントのボリュームではなく、エンタープライズ・アカウントのボリュームが表示されます。 |
| ターゲット・リソースのタグ |
このフィールドには、リソースへの適用時にバックアップの作成をトリガーできるユーザー・タグが表示されます。
|
| ターゲット・リソース・タイプ | バックアップ・ポリシーは、個々のブロック・ ボリューム または インスタンスのブロック・ボリュームの整合性グループに適用できます。 |
| 最終バックアップ・ジョブ | これは、最後のバックアップ・ジョブが実行された日時を示します。 バックアップジョブは、計画の頻度および保存期間の設定に基づいて、バックアップスナップショットを作成または削除します。 最後に実行されたジョブのタイプを確認するには、「 表示 」をクリックしてください。 |
| エンタープライズ・アカウント CRN | この値は、バックアップ・ポリシーがエンタープライズ全体のポリシーである場合にのみ表示されます。 これは、ポリシーを作成したエンタープライズのクラウド・リソース名です。 |
| health | ポリシーの現在の正常性の状態。 詳細については、よくある質問を参照してください。 |
「プラン」カードには、プラン名、保存ポリシー、およびプランの状況が表示されます。 必要に応じて、「 作成 」をクリックして、既存の保険契約にプランを追加することもできます。
| フィールド | 値 |
|---|---|
| プラン名 | 計画の固有の名前。 展開すると、計画の詳細 (頻度、この計画に関連付けられているタグ、および高速リストアとリモート・コピーが有効かどうかなど) が表示されます。 |
| 保存 | プランの有効期間として設定する期間。例えば、30日間など。 |
| ステータス | 計画の状況。 アクティブ計画の enabled を表示します。 |
「アクション」アイコン をクリックすると、コンテキスト固有のアクションのメニューを表示できます。 名前およびその他のプランの詳細 (保存、タグ、高速リストア、リモート・コピーなど) を変更できます。 詳細については、コンソールでバックアッププランを編集または削除する。
バックアップ・ポリシーに関連付けられているリソースのリストの表示
ポリシーによってバックアップされたリソースのリストを表示します。 リソースがポリシーによってバックアップ対象となるには、そのリソースに、当該ポリシーの「対象リソース」タグのうち少なくとも1つが付けられている必要があります。
この Block Storage for VPC ボリューム、 File Storage for VPC シェア、または仮想サーバーインスタンスのリストを使用して、バックアップポリシーが正しく適用されていることを確認できます。
-
IBM Cloud コンソールで、 ナビゲーション メニュー アイコン
> インフラストラクチャ> ストレージ > バックアップ ポリシー をクリックします。 -
ポリシー名をクリックします。
-
**「適用されたリソース」**タブをクリックします。
- ポリシーが個々の Block Storage for VPC ボリュームに対するものである場合、このポリシーによってバックアップされたボリュームのリストが表示されます。 ボリュームに関する情報には、ボリューム名、ステータス、ボリュームサイズ、および暗号化の種類が含まれます。
バックアップポリシーのBlock Storage for VPCのリスト フィールド 説明 名前 ボリュームの名前。 「編集」アイコン をクリックして編集します。ステータス ボリュームの状況。 サイズ ボリュームのサイズ (GB)。 暗号化 IBM 管理の暗号化または お客様管理の暗号化。 「ボリュームの追加」 をクリックして、このポリシーに他のボリュームを追加できます。 情報サイド・パネルには、ボリュームに適用できるターゲット・リソースのタグのリストと、 Block Storage for VPC ボリュームのリスト へのリンクが表示されます。 対象リソースに対して、ポリシーに割り当てられたタグのうち少なくとも1つをボリュームに適用する必要があります。 |
- ポリシーが Block Storage for VPC ボリュームの整合性グループのマルチボリューム・バックアップ用である場合、仮想サーバー・インスタンスのリストが表示されます。 このリストには、このポリシーをバックアップする Block Storage ・ボリュームを持つ仮想サーバー・インスタンスが含まれます。 仮想サーバー・インスタンスに関する情報には、名前、状況、VPC、およびプロファイルが含まれます。
仮想サーバーインスタンスのリスト。 フィールド 説明 名前 ボリュームの名前。 「編集」アイコン をクリックして編集します。ステータス ボリュームの状況。 Virtual Private Cloud 仮想サーバー・インスタンスが含まれている VPC の名前。 これをクリックして、VPC の詳細ページに移動します。 プロフィール 仮想サーバーインスタンスの「Compute」プロファイル。 **「仮想サーバー・インスタンスの追加」** をクリックして、仮想サーバー・インスタンスの接続ボリュームをこのポリシーに追加します。 情報サイド・パネルには、仮想サーバー・インスタンスに適用できるターゲット・リソースのタグのリストが表示されます。 また、アカウントの仮想サーバー・インスタンスのリストへのリンクも含まれています。 ターゲット・リソースのポリシーのタグの少なくとも 1 つをボリュームに適用する必要があります。- ポリシーがファイル共有の場合、このポリシーでバックアップされる共有のリストが表示されます。 共有に関する情報には、名前、ステータス、ボリューム・サイズ、暗号化タイプが含まれる。
バックアップポリシーの File Storage for VPC 共有のリスト フィールド 説明 名前 株式の名称 「編集」アイコン をクリックして編集します。ステータス 株式の状況 サイズ GB単位でのシェアの大きさ。 暗号化 IBM 管理の暗号化または お客様管理の暗号化。
CLI からバックアップポリシーを表示する
CLI を使用してバックアップ・ポリシーを表示できます。
開始前に
CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。 詳しくは、CLI の前提条件を参照してください。
IBM Cloud® にログインしてください。
ibmcloud login --sso -a cloud.ibm.com
このコマンドを実行すると、URL が返され、パスコードの入力を求めるプロンプトが表示されます。 ブラウザーでその URL にアクセスしてログインします。 成功すると、ワンタイム・パスコードが表示されます。 そのパスコードをコピーし、プロンプトに応答として貼り付けます。 認証に成功すると、アカウントを選択するように求めるプロンプトが出されます。 複数のアカウントアクセスできる場合は、ログインしたいアカウントを選択してください。 残りのプロンプトにすべて応答して、ログインを完了します。
CLI からすべてのバックアップポリシーを一覧表示する
backup-policies コマンドを実行すると、 アカウントおよびリージョンで作成したすべてのバックアップポリシーが一覧表示されます。
ibmcloud is backup-policies [--tag TAG_NAME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]
以下の例は、予想される出力を示しています。
ibmcloud is backup-policies
Listing backup policies in all resource groups and region eu-de under account Test Account as user test.user@ibm.com...
ID Name Status Resource group
r138-0521986d-963c-4c18-992d-d6a7a99d115f backup-policy-v1 stable defaults
r138-a84c2063-e95f-46dc-98a8-9799b0e2fd2f demo2 stable defaults
r138-8c494618-9e4f-4b67-9a08-ee3491404f3b my-backup-policy-v1 stable defaults
r138-5c719085-cf26-456e-9216-984866659e29 my-backup-policy-v2 stable defaults
使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is backup-policies」を参照してください。 Status 列の値について詳しくは、 バックアップ・ポリシーの状況 を参照してください。
CLI からバックアップポリシーの詳細を表示する
backup-policy コマンドを実行し、バックアップポリシー ID またはポリシー名のいずれかを指定します。
ibmcloud is backup-policy POLICY [--output JSON] [-q, --quiet]
以下の例では、バックアップ・ポリシーとそれに含まれる計画のプロパティーをリストします。
ibmcloud is backup-policy my-backup-policy-v2
Getting backup policy my-backup-policy-v2 under account 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 stable
Last job completed at 2023-09-26T10:13:18.000Z
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
Created at 2023-09-05T16:30:09+00:00
以下の例では、ポリシー ID とオプションを使用して、応答を JSON 形式で受信します。 このポリシーは、エンタープライズの子アカウントに整合性グループ・バックアップを作成します。
ibmcloud is backup-policy r006-0723c648-9a47-4d51-b1ba-349e21e715b6 --output JSON
Getting backup policy r006-0723c648-9a47-4d51-b1ba-349e21e715b6 under account Test Account as user test.user@ibm.com...
{
"created_at": "2023-09-05T16:30:09.000Z",
"crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-0723c648-9a47-4d51-b1ba-349e21e715b6",
"href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-0723c648-9a47-4d51-b1ba-349e21e715b6",
"id": "r006-0723c648-9a47-4d51-b1ba-349e21e715b6",
"lifecycle_state": "stable",
"match_resource_type": "instance",
"included_content": "data_volumes",
"match_user_tags": "dev:test",
"name": "my-backup-policy-v2",
"plans": [
{
"href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-0723c648-9a47-4d51-b1ba-349e21e715b6/plans/r006-e888bb31-7bf2-4885-a9f3-d448c1c37326",
"id": "r006-e888bb31-7bf2-4885-a9f3-d448c1c37326",
"name": "my-plan-b",
"resource_type": "backup_policy_plan"
}
],
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
"id": "6edefe513d934fdd872e78ee6a8e73ef",
"name": "defaults"
},
"resource_type": "backup_policy",
"scope": {
"id": "7e44cb4667ba4b88b1b1f8dcc15e33b3",
"crn": "crn:v1:bluemix:public:enterprise::a/a1234567::enterprise:7e44cb4667ba4b88b1b1f8dcc15e33b3",
"resource_type": ""
}
}
以下の例では、ポリシー名を使用し、その他のオプションは使用しません。 このポリシーは、個々の Block Storage ・ボリュームに適用されます。
ibmcloud is backup-policy my-backup-policy-v1
Getting backup policy my-backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID r138-8c494618-9e4f-4b67-9a08-ee3491404f3b
Name my-backup-policy-v1
CRN crn:v1:bluemix:public:is:eu-de:a/a1234567::backup-policy:r138-8c494618-9e4f-4b67-9a08-ee3491404f3b
Status stable
Last job completed at 2023-02-22T20:12:44.000Z
Plans ID Name Resource type
r138-4d77d84c-929c-49e9-9f05-952be9486406 not-just-another-plan backup_policy_plan
r138-7734be40-e2a5-4ee6-b4bd-75763639092b my-policy-plan backup_policy_plan
Backup tags dev:test
Match resource type volume
Resource group defaults
Created at 2023-02-21T18:37:17+00:00
以下の例では、エンタープライズ・バックアップ・ポリシーのプロパティーをリストします。 スコープには、エンタープライズ・アカウントの CRN が表示されます。
ibmcloud is backup-policy r006-0bc533ed-4796-407a-982e-693b418f3de3
Getting 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 backup-scope-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
included-content data_volumes
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」を参照してください。
CLI からバックアップポリシーのすべてのプランを一覧表示する
ibmcloud is backup-policy-plans を実行し、ポリシーIDまたはポリシー名を指定すると、そのポリシーに対して作成されたすべてのプランを確認できます。
ibmcloud is backup-policy-plans POLICY [--output JSON] [-q, --quiet]
以下の例では、ポリシー名を指定しています。 この出力は、バックアップ計画の基本情報 (ID、名前、状況、およびバックアップのスケジュールを定義する CRON 式など) を提供します。
ibmcloud is backup-policy-plans backup-policy-v1
Listing plans of backup policy backup-policy-v1 under account Test Account as user test.user@ibm.com...
ID Name Active Lifecycle state Cron specification
r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3 my-policy-plan-a true stable 05 15 * * *
r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9 my-policy-plan-c true stable 10 20 * * *
以下の例では、前の例のポリシーのポリシー ID を指定しています。 この出力は、高速リストア・クローンおよび保存ポリシーに関する情報も含む、プラン (my-policy-plan-a および my-policy-plan-c) に関するより詳細な情報を提供します。
$ ibmcloud is backup-policy-plans r138-0521986d-963c-4c18-992d-d6a7a99d115f --output JSON
[
{
"active": true,
"attach_user_tags": [
"daily-backup-plan"
],
"clone_policy": {
"max_snapshots": 4,
"zones": [
{
"href": "https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-1",
"name": "eu-de-1"
},
{
"href": "https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-2",
"name": "eu-de-2"
}
]
},
"copy_user_tags": true,
"created_at": "2023-02-21T22:42:31.000Z",
"cron_spec": "05 15 * * *",
"deletion_trigger": {
"delete_after": 20,
"delete_over_count": 20
},
"href": "https://eu-de.iaas.cloud.ibm.com/v1/backup_policies/r138-0521986d-963c-4c18-992d-d6a7a99d115f/plans/r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3",
"id": "r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3",
"lifecycle_state": "stable",
"name": "my-policy-plan-a",
"resource_type": "backup_policy_plan"
},
{
"active": true,
"attach_user_tags": [
"daily-backup-plan"
],
"clone_policy": {
"max_snapshots": 3,
"zones": [
{
"href": "https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-1",
"name": "eu-de-1"
},
{
"href": "https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-2",
"name": "eu-de-2"
}
]
},
"copy_user_tags": true,
"created_at": "2023-02-21T22:42:32.000Z",
"cron_spec": "10 20 * * *",
"deletion_trigger": {
"delete_after": 20,
"delete_over_count": 20
},
"href": "https://eu-de.iaas.cloud.ibm.com/v1/backup_policies/r138-0521986d-963c-4c18-992d-d6a7a99d115f/plans/r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9",
"id": "r138-6f4f08ba-e0bb-470f-bbfb-f3a22aebbfa9",
"lifecycle_state": "stable",
"name": "my-policy-plan-c",
"resource_type": "backup_policy_plan"
}
]
使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is backup-policy-plans」を参照してください。
CLI からバックアップ計画の詳細を表示する
ibmcloud is backup-policy-plan コマンドを実行して、ポリシー ID またはポリシー名、および計画 ID または計画名を指定します。
ibmcloud is backup-policy-plan POLICY PLAN [--output JSON] [-q, --quiet]
以下の例では、ポリシーとプラン名を指定します。
ibmcloud is backup-policy-plan backup-policy-v1 my-policy-plan-a
Getting plan my-policy-plan-a under account Test Account as user test.user@ibm.com...
ID r138-2129a79a-5629-4069-bf79-7bb0af3b0bd3
Name my-policy-plan-a
Active true
Lifecycle state stable
Clone policy Max snapshots Zones
4 eu-de-1,eu-de-2
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 05 15 * * *
Created at 2023-02-21T22:42:31+00:00
Resource type backup_policy_plan
使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is backup-policy-plan」を参照してください。
API を使用したバックアップポリシーおよびプランの表示
API を使用して、バックアップ・ポリシーとプランを表示できます。
API を使用してバックアップポリシーの詳細を表示する
以下のサンプル要求に示すように、 VPC API で /backup_policies/{backup_policy_id} メソッドを呼び出すことにより、バックアップ・ポリシーの詳細をプログラムで取得できます。
curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/r006-076191ba-49c2-4763-94fd-c70de73ee2e6?version=2023-09-26&generation=2"\
-H "Authorization: Bearer $iam_token"
正常な応答は、次の例のようになります。
{
"created_at": "2023-09-26T15:06:03.000Z",
"crn": "crn:v1:bluemix:public:is:us-south:a/123456::backup-policy:r006-076191ba-49c2-4763-94fd-c70de73ee2e6",
"included_content": [
"data_volumes"
],
"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",
"lifecycle_state": "stable",
"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"
}
}
以下の例は、マルチボリューム整合性グループのバックアップを作成するバックアップ・ポリシーの詳細を示しています。
curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/r006-5f45c186-d710-41ed-a4bc-e924a79e47bb?version=2023-12-05&generation=2"\
-H "Authorization: Bearer $iam_token"
{
"created_at": "2023-11-14T19:36:29Z",
"crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::backup-policy:r006-5f45c186-d710-41ed-a4bc-e924a79e47bb",
"health_reasons": [],
"health_state": "ok",
"href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-5f45c186-d710-41ed-a4bc-e924a79e47bb",
"id": "r006-5f45c186-d710-41ed-a4bc-e924a79e47bb",
"included_content": [
"boot_volume",
"data_volumes"
],
"lifecycle_state": "stable",
"match_resource_type": "instance",
"match_user_tags": [
"vsi11"
],
"name": "policy-1699990587",
"plans": [
{
"href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/r006-5f45c186-d710-41ed-a4bc-e924a79e47bb/plans/r006-01fb4c96-57db-4fac-98f0-2158dbfd551f",
"id": "r006-01fb4c96-57db-4fac-98f0-2158dbfd551f",
"name": "plan-1699990587",
"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"
}
}
health_state フィールドと lifecycle_state フィールドの値について詳しくは、 バックアップ・ポリシーの正常性の状態、ライフサイクルの状況、およびイベントのモニター を参照してください。
API を使用してバックアップポリシーのすべてのプランを一覧表示する
以下のサンプル要求に示すように、 VPC API で /backup_policies/{backup_policy_id}/plans メソッドを呼び出すことにより、バックアップ・ポリシーのプランをプログラムでリストできます。
curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plans?version=2022-12-16&generation=2"\
-H "Authorization: Bearer $iam_token"
正常な応答は、次の例のようになります。
{
"plans": [
{
"active": true,
"attach_user_tags": [
"my-daily-backup-plan"
],
"copy_user_tags": true,
"created_at": "2022-12-16T00:45:28.421Z",
"cron_spec": "*/5 1,2,3 * * *",
"deletion_trigger": {
"delete_after": 20
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plans/4cf9171a-0043-4434-8727-15b53dbc374c",
"id": "4cf9171a-0043-4434-8727-15b53dbc374c",
"lifecycle_state": "stable",
"name": "my-policy-plan",
"resource_type": "backup_policy_plan"
}
]
}
単一の計画に関する情報を取得するには、要求内で計画 ID を指定します。
curl -X GET "$vpc_api_endpoint/v1/backup_policies/{backup_policy_id}/plans/{plan_id}?version=2022-12-16&generation=2"
高速リストア・オプションを使用したバックアップ計画のリトリーブ
高速リストア・バックアップ・スナップショットが作成されているゾーンと、各ゾーン内のスナップショットの数に関する情報を確認できます。
GET /backup_policy/{backup_policy_id}/plans/{plan_id} 呼び出しを行います。 応答では、 clone_policy プロパティーは、高速リストア用のスナップショット・クローンが作成されたゾーンと、クローンを保持するボリュームごとの最新スナップショットの最大数を示します。
また、バックアップ・ポリシーのすべての計画を取得したり、バックアップ・スナップショット・クローン用にセットアップした計画を表示したりすることもできます。 詳しくは、API リファレンスの バックアップ・ポリシーのすべてのプランのリスト を参照してください。
以下の例を参照してください。
curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plan/4d58eb08-d950-498b-8175-b4d617b6ba6a?version=2023-08-29&generation=2"
-H "Authorization: Bearer $iam_token"
応答には、複製ポリシー情報が表示されます。 この例では、 us-south-2 のスナップショットに対してクローンが作成され、スナップショットごとに最大 2 つのクローンが保持されます。
{
"active": true,
"attach_user_tags": ["my-plan-2"],
"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-1"}]},
"copy_user_tags": true,
"created_at": "2022-12-16T15:16:37Z",
"cron_spec": "45 * * * *",
"deletion_trigger": {"delete_after": 5},
"href": "https://us-south.iaas.cloud.ibm.com/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plans/4d58eb08-d950-498b-8175-b4d617b6ba6a",
"id": "r006-6da51cfe-6f7b-4638-a6ba-00e9c327b178",
"lifecycle_state": "stable",
"name": "my-backup-plan-2",
"resource_type": "backup_policy_plan"
}
地域間コピー・オプションを使用したバックアップ計画の検索
GET /backup_policy/{backup_policy_id}/plans/{plan_id} 要求を行います。 応答で、 remote_region_policies プロパティーは、バックアップのコピーが作成されるリモート領域を示します。
以下の例を参照してください。
curl -X GET\
"$vpc_api_endpoint/v1/backup_policies/fb721535-2cc6-45d6-ade7-3ceb95b7f26f/plan/4d58eb08-d950-498b-8175-b4d617b6ba6a?version=2023-05-09&generation=2"\
-H "Authorization: Bearer $iam_token"
応答には、リモート領域ポリシー情報が示されます。 この例の出力は、バックアップ・ジョブが us-south リージョンにバックアップ・スナップショットを作成するときに、 us-east リージョンにもバックアップのコピーが作成されることを示しています。
{
"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/dffc98a0f1f0f95f6613b3b752286b87: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 を使用したすべてのバックアップ・ポリシーのリスト表示
バックアップ・ポリシーのコレクションの詳細を読み取り専用データ・ソースとしてインポートします。 名前、リソース・グループ、または関連付けられたタグを指定することにより、コレクションをフィルターに掛けることができます。
data "ibm_is_backup_policies" "example" {
}
引数および属性について詳しくは、 ibm_is_backup_policiesを参照してください。
Terraform を使用したバックアップ・ポリシーの詳細の表示
バックアップ・ポリシーの詳細を読み取り専用データ・ソースとしてインポートします。 ポリシー ID またはポリシー名のいずれかを指定できます。
data "ibm_is_backup_policy" "example" {
identifier = ibm_is_backup_policy.example.id
}
data "ibm_is_backup_policy" "example" {
name = ibm_is_backup_policy.example.name
}
引数および属性について詳しくは、 ibm_is_backup_policyを参照してください。
Terraform を使用したバックアップ・ポリシーのすべてのプランのリスト表示
バックアップ・ポリシーの一部であるバックアップ計画のリストを読み取り専用データ・ソースとしてインポートします。 オプションで、表示するプランの名前を指定することができます。
data "ibm_is_backup_policy_plans" "example" {
backup_policy_id = ibm_is_backup_policy.example.id
}
data "ibm_is_backup_policy_plans" "example" {
backup_policy_id = ibm_is_backup_policy.example.id
name = "my-policy-plan"
}
引数および属性について詳しくは、 ibm_is_backup_policy_plansを参照してください。
Terraform を使用したバックアップ・プランの詳細の表示
バックアップ計画の詳細を読み取り専用データ・ソースとしてインポートします。 以下の例に示すように、プラン ID またはプラン名のいずれかを指定できます。
data "ibm_is_backup_policy_plan" "example" {
backup_policy_id = ibm_is_backup_policy.example.id
identifier = ibm_is_backup_policy_plan.example.id
}
data "ibm_is_backup_policy_plan" "example" {
backup_policy_id = ibm_is_backup_policy.example.id
name = ibm_is_backup_policy_plan.example.name
}
引数および属性について詳しくは、 ibm_is_backup_policy_planを参照してください。
次のステップ
以下の操作を行うことができます。
- バックアップ用にリソースにタグを適用します。
- バックアップ・ポリシーおよび計画を管理します。
- バックアップ・スナップショットからのボリュームのリストア。
- Backup for VPCのイベント通知を有効にする。
-
バックアップ操作を正常に実行するには、タグ付けされたボリュームが実行中の仮想サーバー・インスタンスに接続されている必要があります。 接続されていないボリュームは、正しいタグを持っていてもバックアップされません。 ↩︎