Gestión de instantáneas File Storage for VPC

Gestiona las instantáneas de « File Storage for VPC » a través de la consola, la CLI, la API o Terraform. Puedes cambiar el nombre de las instantáneas, actualizar las etiquetas de usuario y eliminar instantáneas para liberar espacio.

Aunque no es posible crear una instantánea en un recurso compartido de réplica, las instantáneas de un recurso compartido de origen zonal se copian desde el origen a la réplica en la siguiente sincronización programada. Estas réplicas son creadas por el servicio de archivos. No heredan las etiquetas ni el nombre de las instantáneas originales. Sin embargo, tienen el mismo valor de huella digital que la instantánea de origen. No se pueden eliminar manualmente del recurso compartido de réplica, pero se eliminan del recurso compartido de réplica en la siguiente sincronización de replicación si se elimina la instantánea de origen en el recurso compartido de origen.

Renombrar una instantánea en la consola

Sigue estos pasos para cambiar el nombre de una instantánea en la consola.

Vaya a la lista de instantáneas. En IBM Cloud consola, haga clic en el icono Menú de navegación > Infraestructura > Almacenamiento > Archivos compartidos.
Los archivos compartidos se enumeran para una región específica. Si desea ver los recursos de otra región, haga clic en la flecha para ampliar la lista y seleccione otra región. Por defecto, los contenidos compartidos más recientes aparecen al principio de la lista.
Seleccione el archivo compartido que desea ver y haga clic en la pestaña Instantáneas.
Localice la instantánea en la lista, haga clic en el y seleccione Cambiar nombre.
Introduce el nuevo nombre y haz clic en « Renombrar ».

Actualización de las etiquetas de usuario de una instantánea en la consola

Siga estos pasos para actualizar las etiquetas de usuario de una instantánea en la consola.

Vaya a la lista de instantáneas. En IBM Cloud consola, haga clic en el icono Menú de navegación > Infraestructura > Almacenamiento > Archivos compartidos.
Los archivos compartidos se enumeran para una región específica. Si desea ver los recursos de otra región, haga clic en la flecha para ampliar la lista y seleccione otra región. Por defecto, los contenidos compartidos más recientes aparecen al principio de la lista.
Seleccione el archivo compartido que desea ver y haga clic en la pestaña Instantáneas.
Haga clic en el nombre de una instantánea para abrir el panel de detalles de la instantánea.
Haga clic en el icono Editar junto a las etiquetas de usuario.
Puede eliminar las etiquetas existentes y añadir otras nuevas. Pulse Guardar.

Actualización de los detalles de una instantánea desde la CLI

Requisitos previos para emitir comandos desde la CLI

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.

Actualización de las etiquetas de usuario de una instantánea desde la CLI

Puede actualizar las etiquetas de usuario asignadas a una instantánea desde la CLI. Emita el comando ibmcloud is share-snapshot-update y proporcione el ID de la instantánea y la nueva etiqueta.

ibmcloud is share-snapshot-update SHARE SNAPSHOT --tags NEW_TAG1,NEW_TAG2 [--output JSON] [-q, --quiet]

Véase el siguiente ejemplo, que añade una etiqueta de usuario.

ibmcloud is share-snapshot-update my-file-share r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 --user-tags test:cli

Updating file share snapshot share-snapshot-cli-update for share my-file-share under account Test Account as user test.user@ibm.com...
ID                   r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
Name                 share-snapshot-cli-update
Fingerprint          c25fdce4-6e0a-433f-99c0-9985f127cd54
Backup Policy Plan   -
Status               available
Status reasons       Status code   Status message
                     -             -
Created at           2024-12-17T11:19:33+05:30
Captured At          2024-12-17T11:19:34+05:30
CRN                  crn:v1:bluemix:public:is:us-south-1:a/a123456::share-snapshot:r006-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
LifeCycle State      stable
LifeCycle Reasons    Code   Message   More Info
                      -      -
Href                 https://us-south.iaas.cloud.ibm.com/v1/shares/r006-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/snapshots/r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
Minimum Size         40
User Tags            test:cli
Zone                 ID   Name
                          us-south-1
Resource group       ID                                 Name
                     11caaa983d9c4beb82690daab08717e9   Default
Resource type        share_snapshot

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.

Cambiar el nombre de una instantánea mediante la API

Puedes renombrar una instantánea utilizando la API. Realiza una llamada PATCH /shares/{share-id}/snapshots/{snapshot-id} y especifica el ID de la instantánea y el nuevo nombre de la misma.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "name": "my-snapshot-renamed"
   }'

Actualización de las etiquetas de usuario con la API

Puede actualizar las etiquetas de usuario de una instantánea utilizando la API. Haz una petición a PATCH /shares/{share-id}/snapshots/{snapshot-id} y especifica el ID de la instantánea y las etiquetas que quieres que tenga la instantánea.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "user_tags": ["env:test","dev:test"]
    }'

Actualización de una instantánea con Terraform

Para utilizar Terraform, descarga la CLI de Terraform y configura el complemento del proveedor « IBM Cloud ». Para obtener más información, consulte Introducción a Terraform.

Los servicios de infraestructura VPC utilizan un punto final regional específico, que se dirige a us-south por defecto. Si su VPC se ha creado en otra región, asegúrese de indicar la región correspondiente en el bloque de proveedores del archivo provider.tf.

Véase el siguiente ejemplo de selección de una región distinta de la predeterminada us-south.

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

Para actualizar una instantánea, utilice el recurso ibm_is_share_snapshot. Puede cambiar las etiquetas de la instantánea añadiéndolas con el argumento tags.

resource "ibm_is_share_snapshot" "example" {
  tags          = "dev:test"
  source_share  = ibm_is_share.example.id
  }

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_snapshot.

Eliminación de instantáneas en la consola

Puede eliminar cualquier instantánea de una acción. Para poder eliminar una instantánea, ésta debe cumplir los siguientes requisitos previos:

Encontrarse en los estados stable o pending.
No estar restaurando activamente un recurso compartido.

Una forma cómoda de determinar si puedes eliminar una instantánea es buscar en la consola la lista de instantáneas y comprobar su estado.

Eliminación de una sola instantánea en la consola

Puedes eliminar una instantánea de la lista de instantáneas siguiendo estos pasos.

Accede a la lista de todas las acciones de « File Storage for VPC ». En IBM Cloud consola, vaya a menú > Infraestructura > Almacenamiento > Archivos compartidos.
Selecciona un recurso compartido de la lista y haz clic en su nombre para acceder a la página de detalles del recurso compartido.
Haz clic en la pestaña «Instantáneas» para ver una lista de las instantáneas tomadas de este recurso compartido.
Busca la instantánea que quieras eliminar.
Pulse el icono Acciones .
Seleccione Suprimir.
Confirme la supresión.

Eliminación de instantáneas desde la CLI

Puede eliminar cualquier instantánea de un recurso compartido o todas las instantáneas de un recurso compartido. Para poder eliminar una instantánea, ésta debe cumplir los siguientes requisitos previos:

Encontrarse en los estados stable o pending.
No estar restaurando activamente un recurso compartido.

Siga estos pasos para eliminar una instantánea utilizando la CLI.

Enumere las instantáneas disponibles para un recurso compartido para confirmar el ID de la instantánea que desea eliminar.
```
ibmcloud is share-snapshots SHARE [--output JSON] [-q, --quiet]
```
```
ibmcloud is share-snapshots my-file-share
```
Ejecute el comando ibmcloud is share-snapshot-delete y especifique el ID de la instantánea. Para eliminar varias instantáneas, debe especificar todos sus ID en el mismo comando.
```
ibmcloud is share-snapshot-delete SHARE (SNAPSHOT1 SNAPSHOT2 ...) [-f, --force] [--output JSON] [-q, --quiet]
```

Confirma la eliminación de la instantánea. El mensaje de respuesta indica que se ha suprimido la instantánea.

$ ibmcloud is share-snapshot-delete my-file-share r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
This will delete share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share and cannot be undone. Continue [y/N] ?> y
Deleting share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share under account Test Account as user test.user@ibm.com...
OK
Share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 is deleted.

Para más información sobre las opciones de comando disponibles, ibmcloud is snapshot-delete.

Eliminación de instantáneas mediante la API

Encontrarse en los estados stable o pending.
No estar restaurando activamente un recurso compartido.

Llame al método DELETE /shares/{share-id}/snapshots/{snapshot-id} para eliminar una instantánea específica por ID.

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

Eliminación de instantáneas con Terraform

Encontrarse en los estados stable o pending.
No estar restaurando activamente un recurso compartido.

Utilice el comando " terraform destroy " para eliminar cómodamente un objeto remoto, como una sola instantánea. El siguiente ejemplo elimina my-snapshot.

terraform destroy --target ibm_is_snapshot.my-snapshot

Para más información, consulta terraformar destruir.

Estados de ciclo de vida

La tabla 2 describe los estados de las instantáneas a lo largo de su ciclo de vida.

Estados del ciclo de vida de las instantáneas de archivos compartidos
Estado de la instantánea	Explicación
Estable	La instantánea se crea y está disponible para restaurar una acción.
En espera	Se está recuperando la información de instantánea.
Pendiente	La instantánea se está replicando en un recurso compartido remoto. Mientras la replicación está en proceso, se muestra el porcentaje completado.
Error	No se ha podido crear la instantánea; no es posible restaurar el recurso compartido a partir de una instantánea.
Suspendido	La instantánea no está disponible temporalmente.
Actualizando	Has cambiado el nombre de la instantánea y se está actualizando.
Suprimiendo	Se está eliminando la instantánea.
Suprimidos	La instantánea se ha eliminado y ya no está disponible para restaurar los recursos compartidos.

Próximos pasos

Puede Restaurar un recurso compartido a partir de una instantánea.