Affichage des stratégies de sauvegarde

Répertorier et consulter les politiques de sauvegarde d' IBM Cloud s pour vos ressources de stockage, y compris les détails de ces politiques et les ressources dont les balises correspondent à une politique de sauvegarde.

Affichage des politiques de sauvegarde dans la console

Vous pouvez répertorier toutes les règles de sauvegarde et afficher les détails d'une règle spécifique à l'aide de l'interface utilisateur.

Liste de toutes les politiques de sauvegarde dans la console

Répertoriez toutes les politiques de sauvegarde que vous avez créées pour les volumes de votre compte dans la région sélectionnée à l'aide de l'interface utilisateur.

Dans la console IBM Cloud, cliquez sur l'icône de menu Navigation > Infrastructure VPC > Stockage > Politiques de sauvegarde.

Le tableau 1 décrit les informations de la page Liste des stratégies de sauvegarde. La région par défaut du compte est sélectionnée. Vous pouvez sélectionner une autre région dans le menu. Les politiques sont répertoriées sur cette page, de la plus récente à la plus ancienne.

Vue de la liste des politiques de sauvegarde
Zone Valeur
Nom Cliquez sur le nom d'une politique pour en consulter les détails.
Statut Le statut de la politique, par exemple « Stable ». Pour plus d'informations sur les statuts de stratégie, voir Statuts de stratégie de sauvegarde.
Ressources appliquées Nombre de ressources ( Block Storage for VPC volumes, File Storage for VPC partages, ou instances de serveurs virtuels) qui sont marquées pour être sauvegardées par la politique [1]. Ce numéro est un lien qui vous permet d'accéder à la liste des ressources qui s'appliquent à la règle.
Balises pour les ressources cibles Tags pour les volumes cibles ou les parts que vous sauvegardez.
Dernière exécution (locale) Heure d'exécution la plus récente d'un travail pour la stratégie de sauvegarde. Si la zone est vide, les volumes ne possèdent pas de balises correspondantes pour l'exécution d'un travail.
Date de création (locale) Date et heure de création de la sauvegarde.

En cliquant sur l'icône Actions icône Actions, vous pouvez afficher un menu d'actions spécifiques au contexte.

  • Restaurer
  • Supprimer

Affichage des détails d'une politique de sauvegarde dans la console

Vous pouvez consulter les détails d'une stratégie de sauvegarde via l'interface utilisateur.

  1. Dans la console IBM Cloud, cliquez sur l'icône de menu Navigation > Infrastructure VPC > Stockage > Politiques de sauvegarde.

  2. Cliquez sur un nom de règle. Les tableaux 2 et 3 décrivent les informations relatives à la stratégie de sauvegarde sélectionnée et à ses plans associés. Vous pouvez ajouter un suivi des activités, des notifications d'événements ou supprimer la politique à partir du menu Actions Icône Actions.

Détails de la politique de sauvegarde
Zone Valeur
Nom Nom de la stratégie de sauvegarde. Cliquez sur l'icône Editer icône Editer pour éditer.
ID de stratégie ID de stratégie de sauvegarde.
Groupe de ressources Groupe de ressources pour le volume Block Storage for VPC.
Emplacement Stratégies de la région sélectionnée.
Date de création Date de création de la police.
CRN Nom de ressource cloud de la stratégie.
Ressources appliquées Nombre de volumes couverts par la règle. Cette liste comprend les volumes et les partages qui ont été créés par les utilisateurs du compte. Si la règle est une règle à l'échelle de l'entreprise, la liste affiche les volumes du compte d'entreprise, et non les volumes de ses comptes enfant.
Balises pour les ressources cibles Cette zone affiche les balises utilisateur qui peuvent déclencher la création d'une sauvegarde lorsqu'elles sont appliquées à une ressource.
-Vous pouvez cliquer sur l'icône Editer icône Editer pour ajouter d'autres balises. Pour plus d'informations, voir Editer les balises pour les ressources cible.
-Voir aussi Application de règles de sauvegarde à des ressources à l'aide de balises.
Type de ressource cible Les règles de sauvegarde peuvent s'appliquer à des volumes de bloc individuels ou à un groupe de cohérence de volumes de bloc d' instances.
Dernier travail de sauvegarde Il indique la date et l'heure d'exécution du dernier travail de sauvegarde. Les tâches de sauvegarde créent ou suppriment des instantanés de sauvegarde en fonction de la fréquence définie dans le plan et des paramètres de conservation. Pour savoir quel type de tâche a été exécuté en dernier, cliquez sur « Afficher ».
Nom CRN du compte d'entreprise Cette valeur est affichée uniquement lorsque la règle de sauvegarde est une règle à l'échelle de l'entreprise. Il s'agit du nom de ressource de cloud de l'entreprise qui a créé la règle.
Etat Etat de santé en cours de la règle. Pour plus d'informations, voir la FAQ.

La carte Plans affiche le nom du plan, la règle de conservation et le statut du plan. Si vous le souhaitez, vous pouvez cliquer sur « Créer » pour ajouter d'autres formules à une police existante.

Détails de la politique de sauvegarde
Zone Valeur
Nom du plan Nom unique du plan. Développez pour afficher les détails du plan, tels que la fréquence, les balises associées à ce plan et si la restauration rapide et les copies distantes sont activées.
Conservation Durée pendant laquelle vous souhaitez que le plan soit en vigueur, par exemple 30 jours.
Statut Statut du plan. Affiche enabled pour un plan actif.

En cliquant sur l'icône Actions icône Actions, vous pouvez afficher un menu d'actions spécifiques au contexte. Vous pouvez modifier le nom et d'autres détails du plan, tels que la conservation, les étiquettes, la restauration rapide et les copies distantes. Pour plus d'informations, voir Modifier ou supprimer un plan de sauvegarde dans la console.

Affichage de la liste des ressources associées à une règle de sauvegarde

Affichez la liste des ressources sauvegardées par la règle. Pour qu’une ressource soit prise en charge par une politique, elle doit être associée à au moins une des balises de cette politique destinées aux ressources cibles.

Vous pouvez utiliser cette liste de volumes Block Storage for VPC, de partages File Storage for VPC ou d'instances de serveurs virtuels pour vérifier que les stratégies de sauvegarde sont correctement appliquées.

  1. Dans la console IBM Cloud, cliquez sur l'icône de menu Navigation > Infrastructure VPC > Stockage > Politiques de sauvegarde.

  2. Cliquez sur un nom de règle.

  3. Cliquez sur l'onglet Ressources appliquées.

    • Si la règle concerne des volumes Block Storage for VPC individuels, la liste des volumes sauvegardés par cette règle s'affiche. Les informations relatives aux volumes comprennent le nom du volume, son état, sa taille et le type de chiffrement.
    Liste des volumes Block Storage for VPC pour la politique de sauvegarde
    Zone Description
    Nom Nom du volume. Cliquez sur l'icône Editer icône Editer pour éditer.
    Statut Statut du volume.
    Taille Taille du volume en Go.
    Chiffrement Chiffrement géré par IBM ou Chiffrement géré par le client.

    Vous pouvez ajouter d'autres volumes à cette règle en cliquant sur Ajouter des volumes. Le panneau latéral d'information fournit une liste de balises pour les ressources cible que vous pouvez appliquer au volume, ainsi qu'un lien vers la liste des volumes Block Storage for VPC. Vous devez attribuer au volume au moins l'une des balises de la stratégie applicables aux ressources cibles. |

    • Si la règle s'applique aux sauvegardes multivolumes d'un groupe de cohérence de volumes Block Storage for VPC, la liste des instances de serveur virtuel s'affiche. La liste contient les instances de serveur virtuel dont les volumes Block Storage sont sauvegardés avec cette règle. Les informations sur les instances de serveur virtuel incluent le nom, le statut, le VPC et le profil.
    Liste des instances de serveurs virtuels.
    Zone Description
    Nom Nom du volume. Cliquez sur l'icône Editer icône Editer pour éditer.
    Statut Statut du volume.
    Virtual Private Cloud Nom du VPC dans lequel se trouve l'instance de serveur virtuel. Cliquez pour accéder à la page des détails du VPC.
    Profil Le profil de calcul de l'instance de serveur virtuel.
    Cliquez sur **Ajouter une instance de serveur virtuel** pour ajouter les volumes connectés d'une instance de serveur virtuel à cette règle. Le panneau latéral d'information fournit une liste de balises pour les ressources cible que vous pouvez appliquer à l'instance de serveur virtuel. Il contient également un lien vers la liste des instances de serveur virtuel de votre compte. Vous devez appliquer au volume au moins l'une des balises de la stratégie pour les ressources.
    
    • Si la politique concerne les partages de fichiers, une liste des partages sauvegardés par cette politique s'affiche. Les informations sur les partages comprennent leur nom, leur état, la taille des volumes et les types de chiffrement.
    Liste des partages File Storage for VPC pour la politique de sauvegarde
    Zone Description
    Nom Nom de l'action. Cliquez sur l'icône Editer icône Editer pour éditer.
    Statut Statut de l'action.
    Taille Taille de la part en Go.
    Chiffrement Chiffrement géré par IBM ou Chiffrement géré par le client.

Affichage des politiques de sauvegarde depuis l'interface de ligne de commande (CLI)

Vous pouvez afficher les règles de sauvegarde à l'aide de l'interface de ligne de commande.

Avant de commencer

Avant de pouvoir utiliser l'interface de ligne de commande, vous devez installer l'interface de ligne de commande d'IBM Cloud et le plug-in de l'interface de ligne de commande du VPC. Pour plus d'informations, reportez-vous à la rubrique Configuration requise pour l'interface de ligne de commande.

Connectez-vous sur IBM Cloud®.

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

Cette commande renvoie une URL et des invites pour un code d'accès. Accédez à cette URL dans votre navigateur et connectez-vous. En cas de réussite, vous obtenez un code d'accès à usage unique. Copiez ce code et collez-le en réponse à l'invite. Une fois l'authentification réussie, vous êtes invité à choisir votre compte. Si vous avez accès à plusieurs comptes, sélectionnez celui avec lequel vous souhaitez vous connecter. Répondez à toutes les invites restantes pour terminer la connexion.

Afficher la liste de toutes les politiques de sauvegarde depuis l'interface en ligne de commande

Exécutez la commande backup-policies pour afficher la liste de toutes les politiques de sauvegarde que vous avez créées dans votre compte et votre région.

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]

L'exemple suivant illustre la sortie à laquelle vous pouvez vous attendre.

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

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is backup-policies. Pour plus d'informations sur les valeurs de la colonne Status, voir Statuts des règles de sauvegarde.

Afficher la liste de toutes les politiques de sauvegarde filtrées par balises utilisateur depuis l'interface en ligne de commande (CLI)

Exécutez la commande backup-policies pour afficher la liste de toutes les politiques de sauvegarde que vous avez créées dans votre compte et votre région. L'option « --tag » filtre l'ensemble des politiques de sauvegarde dont la valeur de la balise utilisateur correspond exactement à celle indiquée.

ibmcloud is backup-policies --tag

L'exemple suivant génère une liste de règles de sauvegarde comportant la balise 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

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is backup-policies.

Affichage des détails d'une politique de sauvegarde depuis l'interface de ligne de commande (CLI)

Exécutez la commande « backup-policy » et indiquez soit l'ID de la stratégie de sauvegarde, soit le nom de celle-ci.

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

L'exemple suivant répertorie les propriétés d'une règle de sauvegarde avec le plan qu'elle contient.

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

L'exemple suivant utilise l'ID de règle et l'option pour recevoir la réponse au format JSON. Cette règle crée des sauvegardes de groupe de cohérence dans les comptes enfant d'une entreprise.

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": ""
    }
}

L'exemple suivant utilise le nom de la règle et aucune autre option. La règle s'applique à des volumes Block Storage individuels.

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

L'exemple suivant répertorie les propriétés d'une règle de sauvegarde d'entreprise. La portée affiche le CRN du compte d'entreprise.

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

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is backup-policy.

Afficher la liste de tous les plans d'une politique de sauvegarde depuis l'interface de ligne de commande (CLI)

Exécutez la commande « ibmcloud is backup-policy-plans » et indiquez soit l'ID de la politique, soit son nom pour afficher tous les plans créés pour cette politique.

ibmcloud is backup-policy-plans POLICY [--output JSON] [-q, --quiet]

L'exemple suivant indique le nom de la règle. La sortie fournit des informations de base sur les plans de sauvegarde, telles que l'ID, le nom, le statut et les expressions CRON qui définissent les planifications des sauvegardes.

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 * * *

L'exemple suivant indique l'ID de la règle de l'exemple précédent. La sortie fournit des informations plus détaillées sur les plans (my-policy-plan-a et my-policy-plan-c) qui incluent des informations sur les clones de restauration rapide et la règle de conservation.

$ 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"
    }
]

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is backup-policy-plans.

Affichage des détails d'un plan de sauvegarde depuis l'interface de ligne de commande (CLI)

Exécutez la commande ibmcloud is backup-policy-plan et indiquez l'ID ou le nom de la stratégie, ainsi que l'ID ou le nom du plan.

ibmcloud is backup-policy-plan POLICY PLAN [--output JSON] [-q, --quiet]

L'exemple suivant indique la règle et le nom du plan.

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

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is backup-policy-plan.

Affichage des politiques et des plans de sauvegarde via l'API

Vous pouvez afficher les stratégies et les plans de sauvegarde à l'aide de l'API.

Afficher les détails d'une stratégie de sauvegarde via l'API

Vous pouvez extraire à l'aide d'un programme les détails d'une règle de sauvegarde en appelant la méthode /backup_policies/{backup_policy_id} dans l'API VPC, comme illustré dans l'exemple de demande suivant.

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"

Une réponse réussie ressemble à celle de l'exemple ci-après.

{
  "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"
  }
}

L'exemple suivant montre les détails d'une règle de sauvegarde qui crée des sauvegardes d'un groupe de cohérence multivolume.

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"
  }
}

Pour plus d'informations sur les valeurs des zones health_state et lifecycle_state, voir Surveillance des états de santé, du statut du cycle de vie et des événements de la règle de sauvegarde.

Répertorier tous les plans d'une politique de sauvegarde via l'API

Vous pouvez répertorier à l'aide d'un programme les plans d'une règle de sauvegarde en appelant la méthode /backup_policies/{backup_policy_id}/plans dans l'API VPC, comme illustré dans l'exemple de demande suivant.

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"

Une réponse réussie ressemble à celle de l'exemple ci-après.

{
  "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"
    }
  ]
}

Pour extraire des informations sur un plan, indiquez l'ID du plan dans la demande :

curl -X GET "$vpc_api_endpoint/v1/backup_policies/{backup_policy_id}/plans/{plan_id}?version=2022-12-16&generation=2"

Extraction d'un plan de sauvegarde avec l'option de restauration rapide

Vous pouvez voir des informations sur la zone dans laquelle des instantanés de sauvegarde de restauration rapide sont créés et le nombre d'instantanés dans chaque zone.

Effectuez un appel GET /backup_policy/{backup_policy_id}/plans/{plan_id}. Dans la réponse, la propriété clone_policy affiche la zone dans laquelle le clone d'instantané pour la restauration rapide est créé et le nombre maximal d'instantanés récents par volume qui conserve les clones.

Vous pouvez également extraire tous les plans pour une règle de sauvegarde et afficher les plans que vous configurez pour les clones d'image instantanée de sauvegarde. Pour plus d'informations, voir Liste de tous les plans pour une stratégie de sauvegarde dans la référence d'API.

Consultez l'exemple suivant.

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"

La réponse affiche les informations de stratégie de clonage. Dans cet exemple, des clones sont créés pour les instantanés dans us-south-2 avec un maximum de deux clones par instantané à conserver.

{
  "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"
  }

Extraction d'un plan de sauvegarde avec l'option de copie interrégionale

Effectuez une demande GET /backup_policy/{backup_policy_id}/plans/{plan_id}. Dans la réponse, la propriété remote_region_policies affiche la région distante dans laquelle une copie de la sauvegarde est créée.

Consultez l'exemple suivant.

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"

La réponse affiche les informations de stratégie de région éloignée. Dans cet exemple, la sortie montre que lorsque le travail de sauvegarde crée une image instantanée de sauvegarde dans la région us-south, une copie de la sauvegarde est également créée dans la région 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"
}

Affichage des stratégies et des plans de sauvegarde avec Terraform

Vous pouvez utiliser Terraform pour afficher les stratégies et les plans de sauvegarde.

Pour utiliser Terraform, téléchargez le CLI Terraform et configurez le plug-in IBM Cloud Provider. Pour plus d'informations, voir Initiation à Terraform.

Les services d'infrastructure VPC utilisent un noeud final régional spécifique, qui cible us-south par défaut. Si votre VPC est créé dans une autre région, veillez à cibler la région appropriée dans le bloc fournisseur du fichier provider.tf.

Consultez l'exemple suivant de ciblage d'une région autre que la région par défaut us-south.

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

Liste de toutes les règles de sauvegarde avec Terraform

Importez les détails d'une collection de règles de sauvegarde en tant que source de données en lecture seule. Vous pouvez filtrer la collection en spécifiant le nom, le groupe de ressources ou les balises associées.

data "ibm_is_backup_policies" "example" {
}

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_backup_policies.

Affichage des détails des règles de sauvegarde avec Terraform

Importez les détails d'une règle de sauvegarde en tant que source de données en lecture seule. Vous pouvez spécifier l'ID ou le nom de la règle.

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
}

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_backup_policy.

Liste de tous les plans pour une stratégie de sauvegarde avec Terraform

Importez la liste des plans de sauvegarde qui font partie d'une règle de sauvegarde en tant que source de données en lecture seule. Vous pouvez éventuellement spécifier le nom du plan à afficher.

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"
}

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_backup_policy_plans.

Affichage des détails d'un plan de sauvegarde avec Terraform

Importez les détails d'un plan de sauvegarde en tant que source de données en lecture seule. Vous pouvez spécifier l'ID de plan ou le nom de plan comme vous pouvez le voir dans les exemples suivants.

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
}

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_backup_policy_plan.

Etapes suivantes

Vous pouvez effectuer les actions suivantes.


  1. Pour que l'opération de sauvegarde aboutisse, les volumes référencés doivent être connectés à des instances de serveur virtuel en cours d'exécution. Les volumes non connectés ne sont pas sauvegardés même s'ils possèdent les balises appropriées. ↩︎