Visualizzazione dei dettagli delle istantanee nella console

Per visualizzare informazioni dettagliate su un'istantanea, individuare l'istantanea nella pagina dei dettagli della condivisione file. Quindi, fare clic sul nome di un'istantanea. Il pannello laterale dei dettagli dell'istantanea visualizza informazioni quali il nome dell'istantanea, il suo CRN e ID e i tag di gestione degli utenti e degli accessi collegati.

Sebbene non sia possibile creare uno snapshot su una condivisione replica, gli snapshot della condivisione di origine vengono generati automaticamente sulla replica in occasione della successiva sincronizzazione di replica pianificata. Queste istantanee replicate vengono create dal servizio file. Non ereditano i nomi o i tag delle istantanee originali. Tuttavia, hanno gli stessi valori di impronta digitale delle istantanee di origine.

La tabella seguente descrive le informazioni visualizzabili nel pannello dei dettagli dell'istantanea.

Dettagli istantanea

Campo	Descrizione
Nome	Il nome dell'istantanea, che può essere modificato facendo clic sull'icona Modifica . Per ulteriori informazioni, vedere Denominazione delle istantanee.
ID	UUID copiabile dell'istantanea.
CRN	CRN copiabile dell'istantanea.
Gruppo di risorse	Il gruppo di risorse definito quando configuri il tuo VPC.
Condizione	Ad esempio, stable.
Posizione	La stessa posizione della condivisione di file di origine.
Data di creazione	Data e ora di inizio del processo di creazione della risorsa snapshot.
Dimensione della condivisione dei file di origine	La dimensione della condivisione quando è stata scattata l'istantanea, in GB.
Condivisione del file origine	Quota di origine da cui è stata presa la prima istantanea. Clicca sul link per visualizzare i dettagli della quota.
Crittografia	Crittografia gestita dal fornitore o dal cliente. Per la crittografia gestita dal cliente, vengono visualizzati l'istanza KMS, il nome della chiave principale e l'ID della chiave principale.
Impronta digitale	L'ID di riferimento che può essere utilizzato per individuare l'istantanea nella cartella .snapshot.
Tag utente	I tag aggiunti. Questo campo è vuoto quando si esaminano le istantanee su una condivisione di replica.
Creato da	Mostra se l'istantanea è stata creata dall'utente o da un criterio di backup. Il campo mostra la replica quando le istantanee sono visualizzate su una condivisione di file di replica.

Facendo clic sull'icona Azioni è possibile visualizzare un menu di azioni specifiche per il contesto.

• Rinominare.
• Cancellare.
• Ripristino.

Il menu Azioni è dinamico. Se la condivisione è una condivisione di replica, viene visualizzata solo l'azione Ripristina. Se la condivisione è una condivisione di origine o non ha una replica, sono disponibili tutte e 3 le azioni.

Prima di iniziare

Prima di poter utilizzare la CLI, è necessario installare la CLI di “ IBM Cloud ” e il plug-in CLI per VPC. Per ulteriori informazioni, consultare il sito 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.

Visualizzazione di tutte le istantanee nell'area da CLI

Eseguire il comando ibmcloud is share-snapshots per visualizzare tutte le istantanee disponibili nella 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

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

Per ulteriori informazioni sulle opzioni di comando disponibili, vedere 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

Visualizzazione dei dettagli di un'istantanea dalla CLI

Eseguire il comando ibmcloud is share-snapshot con l'ID dell'istantanea o il nome dell'istantanea e il nome o l'ID della condivisione. Gli ID delle istantanee sono unici per l'account. Tuttavia, i nomi delle istantanee sono unici solo a livello di istantanea.

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

L'esempio seguente mostra i dettagli di un'istantanea.

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

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

Elenco di tutte le istantanee con l'API

È possibile elencare programmaticamente tutte le istantanee delle proprie condivisioni chiamando il metodo /shares/{share-id}/snapshots nell'API VPC, come mostrato nella seguente richiesta di esempio. Per impostazione predefinita, l'elenco mostra prima le istantanee più recenti, seguite da quelle più vecchie in ordine decrescente.

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

È possibile filtrare l'elenco utilizzando l'ID del piano del criterio di backup per visualizzare le istantanee acquisite da un criterio di backup. Ad esempio, la seguente chiamata filtra l'elenco per mostrare le istantanee create da un piano di backup specifico e limita i risultati a cinque per pagina.

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 risposta corretta è simile all'esempio riportato di seguito.

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

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

Elencare i dettagli di un'istantanea con l'API

È possibile recuperare programmaticamente i dettagli di una singola istantanea chiamando il metodo /shares/{share-id}/snapshots/{snapshot-id} nell'API VPC e specificando l'ID della condivisione e l'ID dell'istantanea, come mostrato nella seguente richiesta di esempio.

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 risposta corretta è simile all'esempio riportato di seguito.

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

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

Elenco di tutte le istantanee di una condivisione di file con Terraform

Importare i dettagli di una raccolta di istantanee come origine dati di sola lettura. È possibile filtrare la raccolta di istantanee per source_share, resource_group, name, e così via.

data "ibm_is_snapshots" "example" {
}

Per ulteriori informazioni, vedere ibm_is_snapshots.

Elenco dei dettagli di un'istantanea con Terraform

Importare i dettagli di un'istantanea come origine dati di sola lettura. È possibile specificare l'ID dello snapshot o il nome dello snapshot.

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

Per ulteriori informazioni, vedere ibm_is_share_snapshot.