IBM Cloud Docs
バックアップ・ポリシーの表示

バックアップ・ポリシーの表示

CLI から、API または Terraform を使用して、コンソールでストレージ・リソース用に作成したすべてのバックアップ・ポリシーをリストおよび表示できます。 個々のポリシーの詳細を確認し、バックアップ・ポリシーに一致するタグを持つリソースの数を表示することができます。

バックアップ操作を正常に実行するには、タグ付けされたボリュームが実行中の仮想サーバー・インスタンスに接続されている必要があります。 接続されていないボリュームは、正しいタグを持っていてもバックアップされません。

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

UI を使用して、すべてのバックアップ・ポリシーをリストし、特定のポリシーの詳細を表示することができます。

コンソールですべてのバックアップポリシーを一覧表示する

UIを使用して、選択した地域のアカウント内のボリュームに対して作成したすべてのバックアップポリシーを一覧表示します。

IBM Cloud コンソールで、 ナビゲーション メニュー アイコンメニュー アイコン> インフラストラクチャVPC アイコン> ストレージ > バックアップ ポリシー をクリックします。

表 1 は、「バックアップ・ポリシー・リスト」ページの情報について説明しています。 アカウントのデフォルト地域が選択されています。 メニューから別の地域を選択できる。 ポリシーは新しいものから古いものへとページに表示されます。

バックアップポリシー一覧表示
フィールド 値
名前 ポリシーの名前をクリックすると、その詳細が表示されます。
ステータス ポリシーの_ステータス_。 ポリシー状況について詳しくは、 バックアップ・ポリシー状況 を参照してください。
適用されたリソース ポリシーによってバックアップするようにタグ付けされているリソース Block Storage for VPC ボリューム、 File Storage for VPC 共有、または仮想サーバーインスタンス）の数 [1] 。 この番号は、ポリシーに適用されるリソースのリストに移動するリンクです。
ターゲット・リソースのタグ バックアップ対象のボリュームまたは共有のタグ。
最終実行時刻 (ローカル) バックアップ・ポリシーに対してジョブが最後に実行された時刻。 このフィールドがブランクの場合、ボリュームには実行するジョブと一致するタグがありません。
作成日 (ローカル) バックアップが作成された日時。

「アクション」アイコン 「アクション」アイコン をクリックすると、コンテキスト固有のアクションのメニューを表示できます。

  • リストア
  • の削除

コンソールでバックアップポリシーの詳細を表示する

UIを使用してバックアップポリシーの詳細を表示できます。

  1. IBM Cloud コンソールで、 ナビゲーション メニュー アイコンメニュー アイコン> インフラストラクチャVPC アイコン> ストレージ > バックアップ ポリシー をクリックします。

  2. ポリシー名をクリックします。 表 2 および 3 には、選択したバックアップ・ポリシーとその関連プランに関する情報が記載されています。 アクションメニューアクションアイコン から、アクティビティ追跡、イベント通知の追加、ポリシーの削除ができます。

    バックアップ・ポリシーの詳細
    フィールド 値
    名前 バックアップ・ポリシーの名前。 「編集」アイコン 「編集」アイコン をクリックして編集します。
    ポリシー ID バックアップ・ポリシー ID。
    リソース・グループ Block Storage for VPC ボリュームの リソース・グループ。
    Location 選択したリージョンのポリシー。
    作成日 ポリシーが作成された日付。
    CRN ポリシーのクラウド・リソース名。
    適用されたリソース ポリシーによってカバーされているボリュームの数。 このリストには、そのアカウントのユーザーが作成したボリュームと共有が含まれる。 ポリシーがエンタープライズ全体のポリシーである場合、リストには、子アカウントのボリュームではなく、エンタープライズ・アカウントのボリュームが表示されます。
    ターゲット・リソースのタグ

    このフィールドには、リソースへの適用時にバックアップの作成をトリガーできるユーザー・タグが表示されます。
    ターゲット・リソース・タイプ バックアップ・ポリシーは、個々のブロック・ ボリューム または インスタンスのブロック・ボリュームの整合性グループに適用できます。
    最終バックアップ・ジョブ これは、最後のバックアップ・ジョブが実行された日時を示します。 バックアップジョブは、プランの頻度と保持設定に基づいてバックアップスナップショットを作成または削除します。 最後に実行されたジョブの種類を確認するには、 表示をクリックします。
    エンタープライズ・アカウント CRN この値は、バックアップ・ポリシーがエンタープライズ全体のポリシーである場合にのみ表示されます。 これは、ポリシーを作成したエンタープライズのクラウド・リソース名です。
    Health ポリシーの現在の正常性の状態。 詳細については、よくある質問を参照してください。

    「プラン」カードには、プラン名、保存ポリシー、およびプランの状況が表示されます。 オプションで、既存のポリシーにさらにプランを追加するには、[ 作成] をクリックします。

    バックアップ・ポリシーの詳細
    フィールド 値
    プラン名 計画の固有の名前。 展開すると、計画の詳細 (頻度、この計画に関連付けられているタグ、および高速リストアとリモート・コピーが有効かどうかなど) が表示されます。
    保存 プランが有効になる期間（例えば30日間）を設定します。
    ステータス 計画の状況。 アクティブ計画の enabled を表示します。

    「アクション」アイコン 「アクション」アイコン をクリックすると、コンテキスト固有のアクションのメニューを表示できます。 名前およびその他のプランの詳細 (保存、タグ、高速リストア、リモート・コピーなど) を変更できます。 詳細については、コンソールでバックアッププランを編集または削除する。

バックアップ・ポリシーに関連付けられているリソースのリストの表示

ポリシーによってバックアップされたリソースのリストを表示します。 リソースがポリシーによってバックアップされるためには、そのリソースが、ターゲット・リソースに対するポリシーのタグの少なくとも1つでタグ付けされている必要があります。

この Block Storage for VPC ボリューム、 File Storage for VPC シェア、または仮想サーバーインスタンスのリストを使用して、バックアップポリシーが正しく適用されていることを確認できます。

  1. IBM Cloud コンソールで、 ナビゲーション メニュー アイコンメニュー アイコン> インフラストラクチャVPC アイコン> ストレージ > バックアップ ポリシー をクリックします。

  2. ポリシー名をクリックします。

  3. **「適用されたリソース」**タブをクリックします。

    • ポリシーが個々の 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 の詳細ページに移動します。
      プロフィール 仮想サーバーインスタンスのコンピュートプロファイル。

      「仮想サーバー・インスタンスの追加」 をクリックして、仮想サーバー・インスタンスの接続ボリュームをこのポリシーに追加します。 情報サイド・パネルには、仮想サーバー・インスタンスに適用できるターゲット・リソースのタグのリストが表示されます。 また、アカウントの仮想サーバー・インスタンスのリストへのリンクも含まれています。 ターゲット・リソースのポリシーのタグの少なくとも 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]

以下の例は、予想される出力を示しています。

cloudshell:~$ 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-policies コマンドを実行し、アカウントと地域で作成したすべてのバックアップポリシーを一覧表示します。 --tag オプションは、正確なユーザータグ値でバックアップポリシーのコレクションをフィルタリングします。

ibmcloud is backup-policies --tag

以下の例では、 dev:test タグを持つバックアップ・ポリシーのリストを生成します。

$ ibmcloud is backup-policies --tag dev:test
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-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」を参照してください。

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
{
    "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 ・ボリュームに適用されます。

cloudshell:~$ 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 式など) を提供します。

cloudshell:~$ 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]

以下の例では、ポリシーとプラン名を指定します。

cloudshell:~$ 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: $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: $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: $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: $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: $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を参照してください。

次のステップ

次のようなことができる。

  1. バックアップ操作を正常に実行するには、タグ付けされたボリュームが実行中の仮想サーバー・インスタンスに接続されている必要があります。 接続されていないボリュームは、正しいタグを持っていてもバックアップされません。 ↩︎