Exibição de detalhes do instantâneo no console

Para ver informações detalhadas sobre um instantâneo, localize o instantâneo na página de detalhes do compartilhamento de arquivos. Em seguida, clique no nome de um snapshot. O painel lateral Snapshot details (Detalhes do instantâneo) exibe informações como o nome do instantâneo, seu CRN e ID e as tags de gerenciamento de acesso e usuário anexadas.

Embora não seja possível criar um instantâneo em um compartilhamento de réplica, os instantâneos do compartilhamento de origem são gerados automaticamente na réplica na próxima sincronização de replicação programada. Esses instantâneos replicados são criados pelo serviço de arquivos. Eles não herdam os nomes ou as tags dos snapshots originais. No entanto, eles têm os mesmos valores de impressão digital com os snapshots de origem.

A tabela a seguir descreve as informações que podem ser visualizadas no painel de detalhes do Snapshot.

Detalhes da captura instantânea

Campo	Descrição
Nome	O nome do instantâneo, que pode ser alterado clicando no ícone Editar . Para obter mais informações, consulte Nomeando capturas instantâneas.
ID	UUID copiável do instantâneo.
CRN	CRN copiável da captura instantânea.
Grupo de recursos	Grupo de recursos definido quando você configura seu VPC.
Status	Por exemplo, stable.
Local	O mesmo que o local do compartilhamento de arquivos de origem.
Data de criação	Data e hora em que o processo de criação de recurso de captura instantânea foi iniciado.
Tamanho do compartilhamento do arquivo de origem	O tamanho do compartilhamento quando o instantâneo foi tirado, em GBs.
Compartilhamento de arquivo de origem	Compartilhamento de origem do qual foi tirado o primeiro instantâneo. Clique no link para ver os detalhes da ação.
Criptografia	Criptografia gerenciada pelo provedor ou gerenciada pelo cliente. Para a criptografia gerenciada pelo cliente, são mostrados a instância do KMS, o nome da chave raiz e o ID da chave raiz.
Impressão digital	O ID de referência que você pode usar para localizar o snapshot na pasta .snapshot.
Tags de usuário	As tags que você adicionou. Esse campo fica vazio quando você examina os instantâneos em um compartilhamento de réplica.
Criado por	Mostra se o instantâneo foi criado pelo usuário ou por uma política de backup. O campo mostra a replicação quando os instantâneos são visualizados em um compartilhamento de arquivos de réplica.

Ao clicar no ícone Ações , você pode exibir um menu de ações específicas do contexto.

• Renomear.
• Excluir.
• Restaurar.

O menu Ações é dinâmico. Se o compartilhamento for uma réplica, somente a ação Restaurar será exibida. Se o compartilhamento for um compartilhamento de origem ou não tiver réplica, todas as três ações estarão disponíveis.

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ê será 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.

Exibição de todos os snapshots na região a partir da CLI

Execute o comando ibmcloud is share-snapshots para ver todos os instantâneos que estão disponíveis na zona.

ibmcloud is share-snapshots [--share SHARE] [--backup-policy-plan BACKUP_POLICY_PLAN [--backup-policy BACKUP_POLICY]] [--output JSON] [-q, --quiet]

ibmcloud is share-snapshots

Listing share snapshots in all resource groups and region au-syd under account Test Account as user test.user@ibm.com...
ID                                          Name                                Created at                  Fingerprint                            Minimum Size   Lifecycle state   Zone       Status      User Tags
r026-c8fd81f8-3437-424e-8fc0-f9dd2f4766d3   demo-bkp-plan-2-02ae167865c0-44e8   2024-12-09T16:55:13+05:30   15b9509d-b6f8-461b-987a-2333be203e0e   40             stable            au-syd-1   available   dev:tags
r026-9997158e-daa6-409d-8e51-b2bbbc23c5d2   demo-bkp-plan-2-29e97584db07-4e86   2024-12-09T16:55:12+05:30   0b9c1e17-d872-4858-b478-a4d46cfd3dfe   40             stable            au-syd-1   available   dev:tags
r026-d04eb5f7-4159-4fa0-bfdd-83deca3b73b0   demo-bkp-plan-2-2b8c5b1bcadc-496f   2024-12-09T18:55:14+05:30   622a0e1f-7a48-4dce-adf0-c54adb4605c3   40             stable            au-syd-1   available   dev:tags
r026-9289ba15-a922-4b75-9650-7afc9471e9d9   demo-bkp-plan-2-47a13671bf22-47e0   2024-12-09T17:55:11+05:30   9a433610-0134-4162-8af3-d9358af832b5   40             stable            au-syd-1   available   dev:tags
r026-bee1b285-adc3-43e6-b8dd-5645efbe5732   demo-bkp-plan-2-4a90deb0778a-4f1a   2024-12-09T17:55:11+05:30   f8ec608d-9fbc-48cf-9018-01b1a8711449   40             stable            au-syd-1   available   dev:tags

Para instantâneos de compartilhamentos de arquivos regionais, o valor da zona fica em branco nas respostas da CLI e da API.

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

ibmcloud is share-snapshots r026-734c173e-044f-4d09-a729-950364ea9900

Listing share snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                         Name                    Created at               Fingerprint                          Minimum size Lifecycle state Zone      Status    User Tags
r138-4463eb2c-4913-43b1-b9bf-62a94f74c146  my-first-share-snapshot 024-12-18T20:15:43+00:00 7abc3aef-c2bc-4f65-a296-2928e534d498 40           stable          us-south-1 Available env:test

ibmcloud is share-snapshots [--backup-policy-plan BACKUP_POLICY_PLAN] [--backup-policy BACKUP_POLICY]

ibmcloud is share-snapshots --backup-policy-plan r006-158e0d66-338e-4501-b756-be0732677da8 --share my-file-share

Listing share snapshots of share my-file-share under account Test Account as user test.user@ibm.com...
ID                                          Name                                Created at                  Fingerprint                            Minimum Size   LifeCycle State   Zone         Status      User Tags
r006-b4d12d66-18de-4660-9fe7-12e667d5ed5b   demo-bkp-plan-1-d619b2fb4a68-4602   2024-11-19T11:33:27+05:30   643ce8da-bbbd-4515-b988-701aea2667df   40             stable            us-south-1   available   dev:tags
r006-59d25cac-92cd-4076-b988-e5d6746a848f   demo-bkp-plan-1-e4406ae16e8f-4cb0   2024-11-19T12:32:23+05:30   202a5bd4-a1e0-4d89-914c-3574f45fc725   40             stable            us-south-1   available   dev:tags
r006-41785c6b-5d48-4dc1-89b7-21a5b2ada21e   demo-bkp-plan-1-efc6f81b8505-4782   2024-11-19T10:32:19+05:30   acd57e05-ffe2-4eed-8e78-40b5000c53d3   40             stable            us-south-1   available   dev:tags

Visualizando detalhes de um snapshot pela CLI

Execute o comando ibmcloud is share-snapshot com o ID do snapshot ou o nome do snapshot e o nome ou ID do compartilhamento. Os IDs de instantâneos são exclusivos em toda a conta. No entanto, os nomes de instantâneos são exclusivos apenas no nível do instantâneo.

ibmcloud is share-snapshot SHARE_SNAPSHOT [--output JSON] [-q, --quiet]

O exemplo a seguir mostra os detalhes de um instantâneo.

ibmcloud is share-snapshot my-file-share r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd

Getting share snapshot ID r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd for share ID my-file-share under account Test Account as user test.user@ibm.com...

ID                   r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Name                 my-first-share-snapshot
Fingerprint          7f29bdd5-bc67-4e67-9b24-638a73be4742
Backup Policy Plan   -
Status               available
Created at           2025-03-10T19:17:55+00:00
Captured At          2025-03-10T19:17:58+00:00
CRN                  crn:v1:bluemix:public:is:us-south-2:a/a1234567::share-snapshot:r006-d14e4b29-cb73-4886-a267-b2cd58d67641/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
LifeCycle Reasons    Code   Message   More Info
                     -      -

LifeCycle State      stable
Href                 https://us-south.iaas.cloud.ibm.com/v1/shares/r006-d14e4b29-cb73-4886-a267-b2cd58d67641/snapshots/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Minimum Size         10
Zone                 ID   Name
                          us-south-2

Resource group       ID                                 Name
                     6edefe513d934fdd872e78ee6a8e73ef   defaults

Status reasons       Status code   Status message
                     -             -

Resource type        share_snapshot

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

Listar todos os snapshots usando a API

Você pode listar programaticamente todos os instantâneos de seus compartilhamentos chamando o método /shares/{share-id}/snapshots na API do VPC, conforme mostrado na solicitação de amostra a seguir. Por padrão, a lista mostra as capturas instantâneas mais recentes primeiro, seguidas pelas capturas instantâneas mais antigas em ordem decrescente.

curl -X GET \
  "$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
  -H "Authorization: Bearer $iam_token"

Você pode filtrar a lista usando o ID do plano da política de backup para exibir os instantâneos que foram tirados por uma política de backup. Por exemplo, a chamada a seguir filtra a lista para exibir instantâneos criados por um plano de backup específico e limita os resultados a cinco por página.

curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "limit": 5,
      "backup_policy_plan":
        "id": "r006-b470ae68-8325-4a9c-9051-1ade8c3806c3"
      }'

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

{
  "limit": 5,
  "snapshots": [
    {
      "captured_at": "2024-12-10T01:21:12.000Z",
      "created_at": "2024-12-10T01:59:46.000Z",
      "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "lifecycle_state": "stable",
      "minimum_size": 10,
      "name": "my-first-share-snapshot",
      "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
        "id": "fee82deba12e4c0fb69c3b09d1f12345",
        "name": "Default"
      },
      "resource_type": "share_snapshot",
      "status": "available",
      "status_reasons": [],
      "user_tags": [],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    },
    {
      "captured_at": "2024-12-10T02:21:12.000Z",
      "created_at": "2024-12-10T02:59:46.000Z",
      "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "fingerprint": "9bbc3aef-c2bc-4f65-a296-2928e534d498",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "id": "r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "lifecycle_state": "stable",
      "minimum_size": 10,
      "name": "my-second-share-snapshot",
      "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
        "id": "fee82deba12e4c0fb69c3b09d1f12345",
        "name": "Default"
      },
      "resource_type": "share_snapshot",
      "status": "available",
      "status_reasons": [],
      "user_tags": [],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    }
  ],
  "total_count": 1
}

Para instantâneos de compartilhamentos de arquivos regionais, o valor da zona fica em branco nas respostas da CLI e da API.

Detalhes de listagem de um snapshot por meio da API

Você pode recuperar programaticamente os detalhes de um único instantâneo chamando o método /shares/{share-id}/snapshots/{snapshot-id} na API VPC e especificando o ID do compartilhamento e o ID do instantâneo, conforme mostrado na solicitação de amostra a seguir.

curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"

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

    {
      "captured_at": "2024-12-10T01:21:12.000Z",
      "created_at": "2024-12-10T01:59:46.000Z",
      "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
      "lifecycle_state": "stable",
      "minimum_size": 10,
      "name": "my-share-snapshot",
      "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
        "id": "fee82deba12e4c0fb69c3b09d1f12345",
        "name": "Default"
      },
      "resource_type": "share_snapshot",
      "status": "available",
      "status_reasons": [],
      "user_tags": [],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    },

Para instantâneos de compartilhamentos de arquivos regionais, o valor da zona fica em branco nas respostas da CLI e da API.

Listagem de todos os instantâneos de um compartilhamento de arquivos com o Terraform

Importe os detalhes de uma coleção de instantâneos como uma fonte de dados somente leitura. Você pode filtrar a coleção de snapshots por source_share, resource_group, name, e assim por diante.

data "ibm_is_snapshots" "example" {
}

Para obter mais informações, consulte ibm_is_snapshots.

Listando detalhes de um snapshot com o Terraform

Importar os detalhes de um instantâneo como uma fonte de dados somente leitura. Você pode especificar a ID do snapshot ou o nome do snapshot.

data "ibm_is_share_snapshot" "example" {
    share_snapshot = ibm_is_share_snapshot.example.share_snapshot
    share = ibm_is_share.example.id
}

Para obter mais informações, consulte ibm_is_share_snapshot.