Gestione delle istantanee di File Storage for VPC

Gestisci le istantanee di File Storage for VPC tramite la console, la CLI, l'API o Terraform. È possibile rinominare gli snapshot, aggiornare i tag utente ed eliminare gli snapshot per liberare spazio.

Sebbene non sia possibile creare uno snapshot su una condivisione replica, gli snapshot di una condivisione di origine zonale vengono copiati dalla sorgente alla replica in occasione della successiva sincronizzazione programmata. Queste istantanee di replica vengono create dal servizio file. Non ereditano i tag o il nome dalle istantanee originali. Tuttavia, hanno lo stesso valore di impronta digitale dell'istantanea di origine. Non possono essere eliminati manualmente dalla condivisione di replica, ma vengono rimossi dalla condivisione di replica alla successiva sincronizzazione di replica se l'istantanea di origine viene eliminata sulla condivisione di origine.

Rinominare un'istantanea nella console

Per rinominare uno snapshot nella console, procedere come segue.

Andare all'elenco delle istantanee. Nel sito IBM Cloud console, fate clic sull'icona Menu di navigazione > Infrastrutture > Archiviazione > Condivisioni di archiviazione dei file.
Le condivisioni di file sono elencate per una regione specifica. Se si desidera visualizzare le risorse in un'altra regione, fare clic sulla freccia per espandere l'elenco e selezionare un'altra regione. Per impostazione predefinita, le azioni più recenti vengono visualizzate all'inizio dell'elenco.
Selezionare la condivisione di file che si desidera visualizzare e fare clic sulla scheda Istantanee.
Individuare l'istantanea nell'elenco, quindi fare clic sull' e selezionare Rinomina.
Inserisci il nuovo nome e fai clic su " Rinomina".

Aggiornamento dei tag utente di un'istantanea nella console

Per aggiornare i tag utente di un'istantanea nella console, procedere come segue.

Andare all'elenco delle istantanee. Nel sito IBM Cloud console, fate clic sull'icona Menu di navigazione > Infrastrutture > Archiviazione > Condivisioni di archiviazione dei file.
Le condivisioni di file sono elencate per una regione specifica. Se si desidera visualizzare le risorse in un'altra regione, fare clic sulla freccia per espandere l'elenco e selezionare un'altra regione. Per impostazione predefinita, le azioni più recenti vengono visualizzate all'inizio dell'elenco.
Selezionare la condivisione di file che si desidera visualizzare e fare clic sulla scheda Istantanee.
Fare clic sul nome di un'istantanea per aprire il pannello dei dettagli dell'istantanea.
Fare clic sull'icona Modifica accanto ai tag Utente.
È possibile rimuovere i tag esistenti e aggiungerne di nuovi. Fare clic su Salva.

Aggiornamento dei dettagli di un'istantanea dalla CLI

Prerequisiti per l'emissione di comandi dalla CLI

Prima di poter utilizzare la CLI, è necessario installare la CLI di “ IBM Cloud ” e il plug-in CLI per VPC. Per ulteriori informazioni, vedere i prerequisiti della CLI.

Accedi a IBM Cloud®.

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

Questo comando restituisce un URL e richiede un passcode. Vai a tale URL nel tuo browser e accedi. Se l'operazione ha esito positivo, ricevi un passcode monouso. Copia questo passcode e incollalo come risposta al prompt. Dopo l'autenticazione, viene richiesto di scegliere il proprio account. Se hai accesso a più account, seleziona quello con cui desideri effettuare l'accesso. Rispondi alle richieste rimanenti per completare l'accesso.

Aggiornamento dei tag utente di un'istantanea dalla CLI

È possibile aggiornare i tag utente assegnati a uno snapshot dalla CLI. Emettere il comando ibmcloud is share-snapshot-update e fornire l'ID dell'istantanea e il nuovo tag.

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

Si veda l'esempio seguente, che aggiunge un tag utente.

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

Per le istantanee delle condivisioni di file regionali, il valore della zona è vuoto sia nella CLI che nelle risposte API.

Rinominare un'istantanea con l'API

È possibile rinominare un'istantanea utilizzando l'API. Effettuare una chiamata a PATCH /shares/{share-id}/snapshots/{snapshot-id} e specificare l'ID dello snapshot e il nuovo nome dello snapshot.

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

Aggiornamento dei tag utente con l'API

È possibile aggiornare i tag utente di un'istantanea utilizzando l'API. Effettuare una richiesta a PATCH /shares/{share-id}/snapshots/{snapshot-id} e specificare l'ID dell'istantanea e i tag che si desidera avere.

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

Aggiornamento di un'istantanea con Terraform

Per utilizzare Terraform, scarica la CLI di Terraform e configura il plug-in del provider IBM Cloud. Per ulteriori informazioni, si veda Iniziare con Terraform.

I servizi di infrastruttura VPC utilizzano un endpoint regionale specifico, che per impostazione predefinita si rivolge a us-south. Se la VPC è stata creata in un'altra regione, assicurarsi di puntare alla regione appropriata nel blocco provider del file provider.tf.

Si veda il seguente esempio di targeting di una regione diversa da quella predefinita us-south.

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

Per aggiornare un'istantanea, utilizzare la risorsa ibm_is_share_snapshot. È possibile modificare i tag dell'istantanea aggiungendoli con l'argomento tags.

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

Per ulteriori informazioni sugli argomenti e gli attributi, vedere ibm_is_snapshot.

Eliminazione delle istantanee nella console

È possibile eliminare qualsiasi istantanea di una condivisione. Per poter eliminare un'istantanea, questa deve soddisfare i seguenti prerequisiti:

Essere in uno stato stable o pending.
Non essere in grado di ripristinare attivamente un'azione.

Un modo pratico per determinare se è possibile eliminare un'istantanea è quello di cercare nella console l'elenco delle istantanee e verificarne lo stato.

Eliminazione di una singola istantanea nella console

Per eliminare un'istantanea dall'elenco delle istantanee, procedere come segue.

Vai all'elenco di tutte le azioni File Storage for VPC. Nel sito IBM Cloud console, andare al sito menu > Infrastrutture > Archiviazione > Condivisioni di archiviazione dei file.
Selezionare una condivisione dall'elenco e fare clic sul nome della condivisione per accedere alla pagina dei dettagli della condivisione.
Fare clic sulla scheda Istantanee per visualizzare un elenco di istantanee scattate su questa condivisione.
Individua lo snapshot che desideri eliminare.
Fare clic sull'icona Azioni Azioni.
Seleziona Delete.
Conferma l'eliminazione.

Eliminazione delle istantanee dalla CLI

È possibile eliminare qualsiasi istantanea di una condivisione o tutte le istantanee di una condivisione. Per poter eliminare un'istantanea, questa deve soddisfare i seguenti prerequisiti:

Essere in uno stato stable o pending.
Non essere in grado di ripristinare attivamente un'azione.

Procedere come segue per eliminare una singola istantanea utilizzando la CLI.

Elencare le istantanee disponibili per una condivisione per confermare l'ID dell'istantanea che si desidera eliminare.
```
ibmcloud is share-snapshots SHARE [--output JSON] [-q, --quiet]
```
```
ibmcloud is share-snapshots my-file-share
```
Eseguire il comando ibmcloud is share-snapshot-delete e specificare l'ID dell'istantanea. Per eliminare più istantanee, è necessario specificare tutti i loro ID nello stesso comando.
```
ibmcloud is share-snapshot-delete SHARE (SNAPSHOT1 SNAPSHOT2 ...) [-f, --force] [--output JSON] [-q, --quiet]
```

Confermare l'eliminazione dell'istantanea. Il messaggio di risposta indica che l'istantanea è stata eliminata.

$ 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.

Per ulteriori informazioni sulle opzioni di comando disponibili, ibmcloud is snapshot-delete.

Eliminazione delle istantanee tramite l'API

È possibile eliminare qualsiasi istantanea di una condivisione o tutte le istantanee di una condivisione. Per poter eliminare un'istantanea, questa deve soddisfare i seguenti prerequisiti:

Essere in uno stato stable o pending.
Non essere in grado di ripristinare attivamente un'azione.

Richiamare il metodo DELETE /shares/{share-id}/snapshots/{snapshot-id} per eliminare un'istantanea specifica per 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}"

Eliminazione delle istantanee con Terraform

È possibile eliminare qualsiasi istantanea di una condivisione o tutte le istantanee di una condivisione. Per poter eliminare un'istantanea, questa deve soddisfare i seguenti prerequisiti:

Essere in uno stato stable o pending.
Non essere in grado di ripristinare attivamente un'azione.

Utilizza il comando " terraform destroy " per eliminare comodamente un oggetto remoto, come una singola istantanea. L'esempio seguente cancella my-snapshot.

terraform destroy --target ibm_is_snapshot.my-snapshot

Per ulteriori informazioni, consultare la voce Terraform destroy.

Stati del ciclo di vita dell'istantanea

La Tabella 2 descrive gli stati dell'istantanea nel ciclo di vita dell'istantanea.

Stati del ciclo di vita delle istantanee della condivisione file
Stato istantanea	Spiegazione
Stabile	L'istantanea viene creata ed è disponibile per il ripristino di una condivisione.
In attesa	Si stanno recuperando le informazioni dell'istantanea.
In sospeso	L'istantanea viene replicata su una condivisione remota. Mentre la replica è in corso, viene visualizzata la percentuale di completamento.
Non riuscito	La creazione della snapshot non è riuscita, la condivisione non può essere ripristinata da una snapshot.
Sospeso	L'istantanea non è temporaneamente disponibile.
Aggiornamento	Il nome dell'istantanea è stato modificato e viene aggiornato.
Eliminazione	L'istantanea sta per essere eliminata.
Eliminato	L'istantanea è stata eliminata e non è disponibile per il ripristino delle azioni.

Passi successivi

È possibile ripristinare una condivisione da un'istantanea.