Visualizando políticas de backup

Listar e visualizar as políticas de backup do IBM Cloud para seus recursos de armazenamento, incluindo os detalhes das políticas e os recursos cujas tags correspondem a uma política de backup.

Visualizando políticas de backup no console

É possível listar todas as políticas de backup e visualizar detalhes de uma política específica usando a IU.

Listando todas as políticas de backup no console

Liste todas as políticas de backup que você criou para volumes em sua conta na região selecionada, utilizando a interface do usuário.

No console IBM Cloud, clique no ícone do menu Navegação > ícone VPC de infraestrutura > Armazenamento > Políticas de backup.

A Tabela 1 descreve as informações na página Lista de políticas de backup. A região padrão da conta está selecionada. Você pode selecionar uma região diferente no menu. As políticas estão listadas na página da mais recente para a mais antiga.

Visualização da lista de políticas de backup
Campo Valor
Nome Clique no nome de uma política para ver seus detalhes.
Status O status da política, como, por exemplo, “Estável ”. Para obter mais informações sobre os status de política, consulte status de política de backup.
Recursos aplicados Número de recursos (volumes Block Storage for VPC, compartilhamentos File Storage for VPC ou instâncias de servidor virtual) que são marcados para backup pela política [1]. O número é um link que o leva a uma lista de recursos que se aplicam para a política
Tags para recursos de destino Tags para volumes ou compartilhamentos de destino dos quais você está fazendo backup.
Hora da última execução (Local) O horário mais recente em que uma tarefa foi executada para a política de backup. Se o campo estiver em branco, os volumes não possuem tags correspondentes para um trabalho executar.
Data de criação (Local) Data e hora em que o backup foi criado.

Clicando no ícone Ações Ações, é possível exibir um menu de ações específicas do contexto.

  • Restaurar
  • Excluir

Visualizando detalhes de uma política de backup no console

É possível visualizar os detalhes de uma política de backup por meio da interface do usuário.

  1. No console IBM Cloud, clique no ícone do menu Navegação > ícone VPC de infraestrutura > Armazenamento > Políticas de backup.

  2. Clique em um nome de política. As tabelas 2 e 3 descrevem as informações sobre a política de backup selecionada e seus planos associados. Você pode adicionar rastreamento de atividades, notificações de eventos ou excluir a política no menu Ações Icone de ações.

Detalhes da política de backup
Campo Valor
Nome Nome da política de backup. Clique no ícone Editar ícone Editar para editar.
ID de política ID da política de backup.
Grupo de recursos Grupo de recursos para o volume Block Storage for VPC.
Local Políticas para a região selecionada.
Data de criação A data em que a apólice foi emitida.
CRN Nome de recurso em nuvem da política.
Recursos aplicados O número de volumes cobertos pela política. Essa lista inclui volumes e compartilhamentos que foram criados por usuários para a conta. Se a política for uma política corporativa, a lista mostrará volumes da conta corporativa e não os volumes de suas contas filhas.
Tags para recursos de destino Este campo mostra as tags de usuário que podem acionar a criação de um backup quando elas são aplicadas a um recurso
-É possível clicar em Editar ícone Editar ícone para incluir mais tags Para obter mais informações, consulte Editar tags para recursos de origem.
-Consulte também Aplicando políticas de backup a recursos usando tags.
Tipo do recurso de destino A política de backup pode ser aplicada a volumes de bloco individuais ou a um grupo de consistências de volumes de blocos de instâncias
Última tarefa de backup Mostra a data e hora em que a última tarefa de backup foi executada. As tarefas de backup criam ou excluem instantâneos de backup com base na frequência do plano e nas configurações de retenção. Para ver qual tipo de tarefa foi executada por último, clique em “Exibir ”.
CRN da conta corporativa Esse valor é mostrado apenas quando a política de backup é uma política corporativa. É o Nome do Recurso em Nuvem da Empresa que criou a política.
Funcionamento O estado de funcionamento atual da política Para obter mais informações, consulte as Perguntas mais frequentes.

O cartão Planos mostra o nome do plano, política de retenção e status do plano. Se desejar, você pode clicar em “Criar” para adicionar mais planos a uma apólice já existente.

Detalhes da política de backup
Campo Valor
Nome do plano Nome exclusivo para o plano. Expanda para ver detalhes do plano, como frequência, tags associadas a esse plano e se a restauração rápida e as cópias remotas estão ativadas.
Retenção Período definido para a vigência do plano, por exemplo, 30 dias.
Status Status do plano. Mostra enabled para um plano ativo.

Clicando no ícone Ações Ações, é possível exibir um menu de ações específicas do contexto. É possível alterar o nome e outros detalhes do plano, como retenção, identificações, restauração rápida e cópias remotas Para mais informações, veja Edite ou exclua um plano de backup no console.

Visualizando a lista de recursos associados a uma política de backup

Visualize a lista de recursos submetidos a backup pela política. Para que um recurso seja incluído em um backup de acordo com uma política, ele deve estar marcado com pelo menos uma das tags da política destinadas aos recursos-alvo.

Você pode usar essa lista de volumes Block Storage for VPC, compartilhamentos File Storage for VPC ou instâncias de servidores virtuais para verificar se as políticas de backup foram aplicadas corretamente.

  1. No console IBM Cloud, clique no ícone do menu Navegação > ícone VPC de infraestrutura > Armazenamento > Políticas de backup.

  2. Clique em um nome de política.

  3. Clique na guia Recursos aplicados.

    • Se a política for para volumes individuais do Block Storage for VPC, uma lista dos volumes submetidos a backup por essa política será mostrada. As informações sobre os volumes incluem o nome do volume, o status, o tamanho do volume e o tipo de criptografia.
    Lista de volumes Block Storage for VPC para a política de backup
    Campo Descrição
    Nome Nome do volume. Clique no ícone Editar ícone Editar para editar.
    Status O status do volume.
    Tamanho Tamanho do volume em GBs.
    Criptografia Criptografia gerenciada pela IBM ou criptografia gerenciada pelo cliente.

    É possível incluir outros volumes para essa política clicando em Incluir volumes O painel lateral informativo fornece uma lista de tags para os recursos de destino que podem ser aplicados ao volume e um link para a lista de Block Storage for VPC volumes. É necessário aplicar ao volume pelo menos uma das tags da política para os recursos de destino. |

    • Se a política for para backups de vários volumes de um grupo de consistências de volumes Block Storage for VPC, uma lista de instâncias de servidor virtual será mostrada. A lista contém as instâncias de servidor virtual cujos volumes Block Storage são submetidos a backup dessa política. As informações sobre as instâncias de servidor virtual incluem o nome, o status, a VPC e o perfil..
    Lista de instâncias de servidores virtuais.
    Campo Descrição
    Nome Nome do volume. Clique no ícone Editar ícone Editar para editar.
    Status O status do volume.
    Nuvem privada virtual O nome da VPC na qual a instância do servidor virtual está.. Clique para acessar a página de detalhes do VPC.
    Profile O perfil de computação da instância do servidor virtual.
    Clique em **Incluir instância de servidor virtual** para incluir os volumes conectados de uma instância de servidor virtual a essa política O painel lateral informativo fornece uma lista de tags para os recursos de destino que podem ser aplicados à instância de servidor virtual Ela também contém um link para a lista de instâncias de servidor virtual de sua conta. Deve-se aplicar pelo menos uma das tags da política para recursos de destino ao volume.
    
    • Se a política for para compartilhamentos de arquivos, será mostrada uma lista dos compartilhamentos cujo backup é feito por essa política. As informações sobre os compartilhamentos incluem seus nomes, status, tamanhos de volume e tipos de criptografia.
    Lista de compartilhamentos File Storage for VPC para a política de backup
    Campo Descrição
    Nome Nome da ação. Clique no ícone Editar ícone Editar para editar.
    Status Status da ação.
    Tamanho Tamanho da parte em GB.
    Criptografia Criptografia gerenciada pela IBM ou criptografia gerenciada pelo cliente.

Visualização das políticas de backup pela CLI

É possível visualizar as políticas de backup usando a CLI (CLI).

Antes de Iniciar

Para usar a CLI, deve-se instalar a CLI da IBM Cloud e o plug-in da CLI da VPC. Para obter mais informações, consulte os Pré-requisitos da CLI.

Efetue login no IBM Cloud®.

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

Esse comando retorna uma URL e solicita uma senha. Acesse essa URL em seu navegador e efetue login. Se bem-sucedido, você receberá uma senha descartável. Copie essa senha e cole-a como uma resposta no prompt. Após a autenticação bem-sucedida, você é solicitado a escolher sua conta.. Se você tiver acesso a várias contas, selecione a conta com a qual deseja fazer login. Responda a quaisquer prompts restantes para concluir o login.

Listar todas as políticas de backup pela CLI

Execute o comando backup-policies para listar todas as políticas de backup criadas na sua conta e na sua região.

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]

O exemplo a seguir mostra a saída que você pode esperar.

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

Para obter mais informações sobre opções de comando disponíveis, consulte ibmcloud is backup-policies. Para obter mais informações sobre os valores na coluna Status, consulte Status de política de backup

Listar todas as políticas de backup filtradas por tags de usuário a partir da CLI

Execute o comando backup-policies para listar todas as políticas de backup criadas na sua conta e na sua região. A opção “ --tag ” filtra o conjunto de políticas de backup com o valor exato da tag do usuário.

ibmcloud is backup-policies --tag

O exemplo a seguir produz uma lista de políticas de backup que possuem a 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

Para obter mais informações sobre opções de comando disponíveis, consulte ibmcloud is backup-policies.

Visualizando os detalhes da política de backup pela CLI

Execute o comando backup-policy e especifique o ID da política de backup ou o nome da política.

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

O exemplo a seguir lista as propriedades de uma política de backup com o plano que ela contém.

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

O exemplo a seguir usa o ID de política e a opção para receber a resposta no formato JSON. Essa política cria backups do grupo de consistências nas contas filhas de uma Empresa.

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

O exemplo a seguir usa o nome da política e nenhuma outra opção A política se aplica a volumes individuais do 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

O exemplo a seguir lista as propriedades de uma política de backup Corporativo O escopo mostra o CRN da conta corporativa

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

Para obter mais informações sobre opções de comando disponíveis, consulte ibmcloud is backup-policy.

Listar todos os planos de uma política de backup pela CLI

Execute o comando ibmcloud is backup-policy-plans e especifique o ID ou o nome da política para visualizar todos os planos criados para essa política.

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

O exemplo a seguir especifica o nome da política A saída fornece informações básicas dos planos de backup, como ID, nome, status e expressões CRON que definem os planejamentos para os backups.

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

O exemplo a seguir especifica o ID da política do exemplo anterior. A saída fornece informações mais detalhadas sobre os planos (my-policy-plan-a e my-policy-plan-c) que incluem informações sobre clones de restauração rápida e a política de retenção também.

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

Para obter mais informações sobre opções de comando disponíveis, consulte ibmcloud is backup-policy-plans.

Visualizando os detalhes do plano de backup pela CLI

Execute o comando ibmcloud is backup-policy-plan e especifique o ID ou nome da política e o ID ou nome do plano.

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

O exemplo a seguir especifica a política e o nome do plano

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

Para obter mais informações sobre opções de comando disponíveis, consulte ibmcloud is backup-policy-plan.

Visualização de políticas e planos de backup por meio da API

É possível visualizar políticas e planos de backup usando a API.

Exibindo detalhes de uma política de backup por meio da API

É possível recuperar programaticamente os detalhes de uma política de backup chamando o método /backup_policies/{backup_policy_id} na API do VPC, conforme mostrado na solicitação de amostra a seguir:

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"

Uma resposta bem-sucedida se parece com o exemplo a seguir.

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

O exemplo a seguir mostra os detalhes de uma política de backup que cria backups de um grupo de consistências de vários volumes.

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

Para obter mais informações sobre os valores dos campos health_state e lifecycle_state, consulte Monitorando estados de funcionamento da política de backup, status de ciclo de vida e eventos.

Listar todos os planos de uma política de backup por meio da API

É possível listar programaticamente os planos de uma política de backup chamando o método /backup_policies/{backup_policy_id}/plans na API do VPC conforme mostrado na solicitação de amostra a seguir.

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"

Uma resposta bem-sucedida se parece com o exemplo a seguir.

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

Para recuperar informações sobre um único plano, especifique o ID do plano na solicitação:

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

Recuperando um plano de backup com a opção de restauração rápida

Você pode ver informações sobre a zona na qual snapshots de backup de restauração rápida estão sendo criados e o número de snapshots em cada zona.

Faça uma chamada GET /backup_policy/{backup_policy_id}/plans/{plan_id}. Na resposta, a propriedade clone_policy mostra a zona na qual o clone instantâneo para restauração rápida é criado e o número máximo de snapshots recentes por volume que mantém clones.

Você também pode recuperar todos os planos para uma política de backup e planos de visualização configurados para clones de captura instantânea de backup. Para obter mais informações, consulte Listar todos os planos para uma política de backup na referência da API.

Consulte o exemplo a seguir.

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"

A resposta mostra as informações da política de clone. Neste exemplo, clones são criados para snapshots em us-south-2 com um máximo de dois clones por instantâneo a ser mantido.

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

Recuperando um plano de backup com a opção de cópia regional cruzada

Faça uma solicitação GET /backup_policy/{backup_policy_id}/plans/{plan_id}. Na resposta, a propriedade remote_region_policies mostra a região remota na qual uma cópia do backup é criada

Consulte o exemplo a seguir.

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"

A resposta mostra as informações de política da região remota Neste exemplo, a saída mostra que quando a tarefa de backup cria uma captura instantânea de backup na região us-south, uma cópia do backup é criada na região us-east também.

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

Visualizando políticas e planos de backup com o Terraform

É possível usar o Terraform para visualizar políticas e planos de backup.

Para usar o Terraform, faça o download da CLI do Terraform e configure o plug-in do provedor IBM Cloud. Para obter mais informações, consulte Introdução ao Terraform.

Os serviços de infraestrutura de VPC usam um terminal regional específico, que tem como destino o us-south por padrão Se sua VPC for criada em outra região, certifique-se de destinar a região apropriada no bloco do provedor no arquivo provider.tf.

Veja o exemplo a seguir de destinação de uma região diferente do us-south padrão:

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

Listando todas as políticas de backup com o Terraform

Importe os detalhes de uma coleção de políticas de backup como uma origem de dados somente leitura É possível filtrar a coleção especificando o nome, grupo de recursos ou tags associadas.

data "ibm_is_backup_policies" "example" {
}

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_backup_policies.

Visualizando detalhes da política de backup com o Terraform

Importe os detalhes de uma política de backup como uma origem de dados somente leitura. É possível especificar o ID da política ou o nome da política..

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
}

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_backup_policy.

Listando todos os planos para uma política de backup com o Terraform

Importe a lista dos planos de backup que fazem parte de uma política de backup como uma origem de dados somente leitura Opcionalmente, é possível especificar o nome do plano que você deseja ver.

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

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_backup_policy_plans.

Visualizando detalhes do plano de backup com o Terraform

Importe os detalhes de um plano de backup como uma origem de dados somente leitura É possível especificar o ID do plano ou o nome do plano, conforme é possível ver nos exemplos a seguir:

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
}

Para obter mais informações sobre os argumentos e os atributos, consulte ibm_is_backup_policy_plan.

Próximas etapas

Você pode realizar as seguintes ações.


  1. Para que a operação de backup seja bem-sucedida, os volumes identificados devem ser anexados às instâncias de servidor virtual em execução Os volumes não anexados não serão submetidos a backup mesmo se eles tiverem as tags certas. ↩︎