Visualización de los detalles de la instantánea en la consola

Para ver información detallada sobre una instantánea, localícela en la página de detalles del recurso compartido. A continuación, haz clic en el nombre de una instantánea. El panel lateral de detalles de la instantánea muestra información como el nombre de la instantánea, su CRN e ID, y las etiquetas de usuario y gestión de acceso adjuntas.

Aunque no es posible crear una instantánea en un recurso compartido de réplica, las instantáneas del recurso compartido de origen se generan automáticamente en la réplica durante la siguiente sincronización de replicación programada. Estas instantáneas replicadas son creadas por el servicio de archivos. No heredan los nombres ni las etiquetas de las instantáneas originales. Sin embargo, tienen los mismos valores de huella digital con las instantáneas de origen.

La siguiente tabla describe la información que se puede ver en el panel de detalles de la instantánea.

Detalles de instantánea

Campo	Descripción
Nombre	El nombre de la instantánea, que puede cambiar haciendo clic en el icono Editar . Para obtener más información, consulte Denominación de instantáneas.
ID	UUID copiable de la instantánea.
CRN	CRN de la instantánea que se puede copiar.
Grupo de recursos	Grupo de recursos definido al configurar la VPC.
Estado	Por ejemplo, stable.
Ubicación	Igual que la ubicación del archivo compartido de origen.
Fecha de creación	Fecha y hora de inicio del proceso de creación de recursos de la instantánea.
Tamaño de la compartición de archivos de origen	El tamaño de la acción cuando se tomó la instantánea en GBs.
Compartición de archivos de origen	Fuente de la que se extrajo la primera instantánea. Haz clic en el enlace para ver los detalles de la acción.
Cifrado	Cifrado gestionado por el proveedor o por el cliente. Para el cifrado gestionado por el cliente, se muestran la instancia KMS, el nombre de la clave raíz y el ID de la clave raíz.
Huella dactilar	El ID de referencia que puede utilizar para localizar la instantánea en la carpeta .snapshot.
Etiquetas de usuario	Las etiquetas que has añadido. Este campo está vacío cuando se miran las instantáneas de una réplica compartida.
Creado por	Muestra si la instantánea fue creada por el usuario o por una política de copia de seguridad. El campo muestra la replicación cuando las instantáneas se visualizan en un recurso compartido de archivos de réplica.

Haciendo clic en el icono Acciones , puede visualizar un menú de acciones específicas del contexto.

• Renombrar.
• Borrar.
• Restaurar.

El menú Acciones es dinámico. Si el recurso compartido es una réplica, sólo se muestra la acción Restaurar. Si el recurso compartido es de origen o no tiene réplica, las 3 acciones están disponibles.

Antes de empezar

Para poder utilizar la CLI, debe instalar la CLI de IBM Cloud y el plugin de la CLI de VPC. Para obtener más información, consulte los Requisitos previos de la CLI.

Inicia sesión en IBM Cloud®.

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

Este mandato devuelve un URL y solicita un código de acceso. Vaya a ese URL en el navegador e inicie la sesión. Si se ejecuta correctamente, recibe un código de acceso de un solo uso. Copie este código de acceso y péguelo como respuesta en la solicitud. Tras autenticarse correctamente, se le pedirá que elija su cuenta. Si tienes acceso a varias cuentas, selecciona la cuenta con la que quieras iniciar sesión. Responda a cualquier solicitud restante para finalizar el inicio de sesión.

Visualización de todas las instantáneas de la región desde la CLI

Ejecute el comando ibmcloud is share-snapshots para ver todas las instantáneas disponibles en la 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 las instantáneas de recursos compartidos de archivos regionales, el valor de zona está en blanco tanto en las respuestas de la CLI como en las de la API.

Para obtener más información sobre las opciones de comando disponibles, 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

Cómo consultar los detalles de una instantánea desde la CLI

Ejecute el comando ibmcloud is share-snapshot con el ID de la instantánea, o el nombre de la instantánea y el nombre o ID del recurso compartido. Los ID de las instantáneas son únicos para toda la cuenta. Sin embargo, los nombres de las instantáneas sólo son únicos a nivel de instantánea.

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

El siguiente ejemplo muestra los detalles de una instantánea.

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 obtener más información sobre las opciones de comando disponibles, consulte ibmcloud is share-snapshot.

Listar todas las instantáneas mediante la API

Puede listar mediante programación todas las instantáneas de sus recursos compartidos llamando al método /shares/{share-id}/snapshots de la API de VPC, como se muestra en la siguiente solicitud de ejemplo. De forma predeterminada, la lista muestra primero las instantáneas más recientes, seguidas de las instantáneas más antiguas en orden descendente.

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

Puede filtrar la lista utilizando el ID del plan de la política de copia de seguridad para mostrar las instantáneas que fueron tomadas por una política de copia de seguridad. Por ejemplo, la siguiente llamada filtra la lista para mostrar las instantáneas creadas por un plan de copia de seguridad concreto y limita los 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"
      }'

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
  "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 las instantáneas de recursos compartidos de archivos regionales, el valor de zona está en blanco tanto en las respuestas de la CLI como en las de la API.

Consultar los detalles de una instantánea mediante la API

Puede recuperar mediante programación los detalles de una única instantánea llamando al método /shares/{share-id}/snapshots/{snapshot-id} en la API de VPC y especificando el ID de recurso compartido y el ID de instantánea, como se muestra en la siguiente solicitud de ejemplo.

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"

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

    {
      "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 las instantáneas de recursos compartidos de archivos regionales, el valor de zona está en blanco tanto en las respuestas de la CLI como en las de la API.

Listado de todas las instantáneas de un archivo compartido con Terraform

Importe los detalles de una colección de instantáneas como fuente de datos de sólo lectura. Puede filtrar la colección de instantáneas por source_share, resource_group, name, etc.

data "ibm_is_snapshots" "example" {
}

Para obtener más información, consulte ibm_is_snapshots.

Listado de detalles de una instantánea con Terraform

Importe los detalles de una instantánea como fuente de datos de sólo lectura. Puede especificar el ID de la instantánea o el nombre de la instantánea.

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

Para obtener más información, consulte ibm_is_share_snapshot.