Elenco di tutte le istantanee nella console

Nella console, puoi visualizzare un elenco di tutte le istantanee che hai creato, con quella più recente all'inizio dell'elenco. È possibile filtrare l'elenco per visualizzare istantanee specifiche.

1. Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione > Infrastruttura > Storage > Block Storage snapshot per VPC. La pagina contiene due schede principali: il gruppo di congruenza dell'istantanea e le istantanee.

2. Seleziona la scheda " Snapshots ". Le istantanee sono elencate per una regione specifica. Se si desidera visualizzare le istantanee in un'altra regione, fare clic sulla freccia per espandere l'elenco e selezionare una regione diversa. Per impostazione predefinita, le istantanee più recenti vengono visualizzate all'inizio dell'elenco.

3. Man mano che l'elenco di istantanee cresce, utilizzare il filtro per indicare il numero di istantanee da visualizzare per pagina. Utilizzare le frecce di navigazione della pagina per spostarsi avanti e indietro nell'elenco.

La tabella 1 descrive tutte le informazioni per tutte le istantanee visualizzate nell'elenco di istantanee.

Fare clic sull'icona Impostazioni per visualizzare i campi facoltativi che è possibile aggiungere alla tabella.

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

• Rinomina
• Copia UUID.
• Copia CRN.
• Crea volume.
• Creare una copia istantanea.
• Condividete un'istantanea.
• Gestire le autorizzazioni di condivisione.
• Modifica ripristino rapido.
• Elimina.
• Elimina tutte le istantanee per un volume.

È inoltre possibile elencare tutte le istantanee create da un Block Storage for VPC volume dalla pagina dei dettagli del volume. Per ulteriori informazioni, vedere Visualizza tutte le istantanee create dal Block Storage for VPC volume.

Visualizzazione dei dettagli delle istantanee nella console

Per visualizzare informazioni dettagliate su un'istantanea, individua l'istantanea nell'elenco di istantanee Block Storage per VPC. Quindi, fare clic sul nome di un'istantanea. La pagina dei dettagli visualizza il nome dell'istantanea, il relativo stato e le tag utente collegate nel titolo.

Il pannello dei dettagli dell'istantanea mostra le informazioni descritte nella tabella seguente.

Dettagli istantanea

Campo	Descrizione
Nome	Il nome dell'istantanea, che è possibile modificare facendo clic sull'icona Modifica . Per ulteriori informazioni, vedi Denominazione delle istantanee.
ID istantanea	GUID copiabile dell'istantanea.
Avviabile	Sì o No.
CRN	CRN copiabile dell'istantanea.
Gruppo di risorse	Il gruppo di risorse definito quando configuri il tuo VPC.
Data di creazione	La data e l'ora in cui è stato avviato il processo di creazione della risorsa istantanea.
Data di acquisizione	La data e l'ora in cui è stata acquisita questa istantanea.
Creato da	Questo campo mostra User o Backup policy. Se l'istantanea viene creata da una politica di backup, l'interfaccia utente visualizza anche il nome del piano di backup che ha creato l'istantanea di backup.
Dimensione	Dimensione in GB dell'istantanea, ereditata dal volume di origine.
Volume di origine	Volume di origine da cui è stata eseguita la prima istantanea. Clicca sul link per i dettagli sul volume. Se il volume è stato eliminato, il nome viene visualizzato senza un collegamento.
Crittografia	Crittografia gestita dal provider o gestita dal cliente. Per la crittografia gestita dal cliente, vengono visualizzati l'istanza KMS, il nome della chiave root e l'ID della chiave root.
Generazione	Questo valore è Gen 1 o Gen 2 in base al profilo del volume di origine.
Espressione del server virtuale	L'espressione allowed-use definisce e limita i profili di server virtuale con cui lo snapshot avviabile è compatibile. Quando si esegue il provisioning di un'istanza di server virtuale utilizzando l'istantanea, l'espressione viene confrontata con le proprietà dell'istanza richiesta. Per ulteriori informazioni, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.
Pannello di ripristino rapido	Utilizzare ripristino rapido per creare un volume da questa istantanea di cui è stato eseguito il provisioning completo. Fare clic su Modifica per abilitare o disabilitare il ripristino rapido in una zona.
Pannello gruppo di congruenza	Visualizza informazioni sul gruppo di congruenza di cui l'istantanea è membro. Fare clic su Crea server virtuale per ripristinare i volumi dal gruppo di congruenza.

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

• Crea un volume dall'istantanea
• Modificare il ripristino rapido oppure eliminare un'istantanea.

Elenco di tutti i gruppi di coerenza delle istantanee nella console

Nella console, è possibile visualizzare un elenco di tutti i gruppi di congruenza creati, con quello più recente all'inizio dell'elenco. È possibile filtrare l'elenco per visualizzare gruppi di congruenza specifici.

1. Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione > Infrastruttura > Storage > Block Storage snapshot per VPC. La pagina contiene due schede principali: il gruppo di congruenza dell'istantanea e le istantanee.

2. Selezionare la scheda Gruppo di congruenza istantanea. I gruppi sono elencati per una regione specifica. Se si desidera visualizzare i gruppi di congruenza in un'altra regione, fare clic sulla freccia per espandere l'elenco e selezionare un'altra regione. Per impostazione predefinita, i gruppi di istantanea più recenti vengono visualizzati all'inizio dell'elenco.

3. Man mano che l'elenco dei gruppi di congruenza cresce, utilizzare il filtro per indicare il numero di elementi da visualizzare per pagina. Utilizzare le frecce di navigazione della pagina per spostarsi avanti e indietro nell'elenco.

La seguente tabella descrive le informazioni per tutti i gruppi di congruenza nell'elenco.

Fare clic sull'icona Impostazioni per visualizzare i campi facoltativi che è possibile aggiungere alla tabella.

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

• Rinomina
• Copia UUID
• Copia il nome della risorsa cloud (CRN).
• Crea server virtuale
• Elimina

Visualizzazione dei dettagli di un gruppo di coerenza nella console

Per visualizzare informazioni dettagliate su un gruppo di congruenza, individua il gruppo nell'elenco di istantanee Block Storage per VPC. Quindi, fare clic sul nome di un gruppo di congruenza.

La sezione Panoramica fornisce dettagli sul gruppo di congruenza e sull'istanza del server virtuale di cui sono state eseguite le istantanee del gruppo di congruenza. Il primo pannello contiene informazioni sul gruppo di congruenza.

Panoramica del gruppo di coerenza.

Campo	Descrizione
Nome	Il nome univoco del gruppo di congruenza. Se si desidera aggiornarlo, fare clic sull'icona Modifica .
ID gruppo di congruenza	Questo campo visualizza la stringa ID del gruppo di congruenza.
CRN	Nome risorsa cloud del gruppo di congruenza.
Creato da	Il campo mostra user per un'istantanea creata manualmente o una politica di backup per le istantanee automatizzate.
Gruppo di risorse	Il gruppo di risorse a cui appartiene il gruppo di coerenza.
Data di creazione	Mostra la data di creazione del gruppo di congruenza.
Elimina i membri dell'istantanea	Mostra se le istantanee vengono eliminate o conservate quando il gruppo di congruenza viene eliminato. Fare clic sull'interruttore per modificare lo stato.
Regione	La regione VPC in cui è stato creato il gruppo di congruenza.

Per ulteriori informazioni, consultare Gestione dei gruppi di congruenza delle istantanee.

Il primo pannello contiene informazioni sull'istanza del server virtuale a cui sono collegati i volumi di origine della serie di istantanee.

L'elenco di istantanee visualizza le istantanee all'interno del gruppo di congruenza e fornisce le stesse informazioni e azioni descritte nella Tabella 1.

Prima di iniziare

Prima di poter utilizzare la CLI, è necessario installare la CLI di “ IBM Cloud ” e il plug-in CLI di VPC. Per ulteriori informazioni, vedi 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 aver eseguito correttamente l'autenticazione, ti viene richiesto di scegliere il tuo 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 di un account in una region dalla CLI

Eseguire il comando snapshots per elencare tutte le istantanee. L'esempio seguente fornisce un elenco di tutte le istantanee in tutti i gruppi di risorse della regione us-south.

ibmcloud is snapshots [--json]

Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name             Status   Source volume                               Bootable   Resource group   Created                     Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-22db5609-69a1-4fe2-bd02-f64fb11230b3   my-test-snapshot stable   r006-ccbc5bc6-cd88-48e0-9a1d-de0f4d024324   true       defaults         2025-07-31T00:04:24+00:00   -                          -                       1
r006-e799fad8-aefa-4df5-81bd-dac6d13200a6   my-test-snap-1   stable   r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   true       defaults         2025-08-06T22:38:01+00:00   -                          -                       1

Per ulteriori informazioni sulle opzioni del comando di istantanea disponibili, consultare ibmcloud is snapshots.

Visualizzazione di tutte le istantanee di un volume dalla CLI

Eseguire il comando snapshots e specificare l'ID volume.

ibmcloud is snapshots --volume VOLUME-ID [--json]

Il seguente esempio mostra tutte e tre le istantanee che sono state prese del volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa.

ibmcloud is snapshots --volume  r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa

Listing snapshots in all resource groups and region eu-de under account Test Account as user test.user@ibm.com...
ID                                          Name                             Status   Source volume                               Bootable   Resource group   Created
r138-7cac80af-63bb-4a1b-83dd-5f6d550a5db7   bear-peroxide-viewable-oxidant   stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:49:48+00:00
r138-4463eb2c-4913-43b1-b9bf-62a94f74c146   cli-snapshot-test                stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      defaults         2023-02-17T20:15:43+00:00
r138-e6664842-b370-496a-9ae7-da3fb647707c   snappy-snap-snap                 stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:53:57+00:00

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is snapshots.

Visualizzazione di tutte le istantanee in un gruppo di congruenza dalla CLI

Eseguire il comando snapshots e specificare l'ID del gruppo di congruenza, il nome o il CRN.

ibmcloud is snapshots --volume CONSISTENCY_GROUP_ID

Il seguente esempio utilizza l'ID del gruppo di congruenza per elencare le istantanee che sono membri della serie.

ibmcloud is snapshots --snapshot-consistency-group r174-7c8762e2-c1b9-424e-b773-23240d1780dd

Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name            Status   Source volume                               Bootable   Resource group   Created
r174-b8cac978-a990-4824-a15c-604856982efe   snapshot-no-2   stable   r174-0641e516-09a1-4291-96ca-af254017123e   true       Default          2023-09-05T23:14:40+05:30
r174-7311f226-8259-46be-9bfa-5b2cd08bdf2f   snapshot-no-1   stable   r174-bf595773-9922-4dd4-9a3c-998b10022e0c   false      Default          2023-09-05T23:14:40+05:30

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is snapshots.

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is snapshots.

Visualizzazione dei dettagli di un'istantanea dalla CLI

Esegui il comando snapshot e specifica l'ID dello snapshot.

ibmcloud is snapshot SNAPSHOTS_ID [--json]

Il seguente esempio riporta i dettagli di un'istantanea avviabile nella regione us-south.

ibmcloud is snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6

Getting snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6 under account Test Account as user test.user@ibm.com...
ID                              r006-e799fad8-aefa-4df5-81bd-dac6d13200a6
Name                            my-test-snap-1
CRN                             crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-e799fad8-aefa-4df5-81bd-dac6d13200a6
Status                          stable
Clones                          Zone   Available   Created
Source volume                   ID                                          Name               Remote Region   CRN                                                                                                                        Resource type
                                r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   test-volume-fast   -               crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   volume
Backup policy plan              -
Snapshot Copies                 -
Bootable                        true
Encryption                      provider_managed
Encryption key                  -
Source Snapshot                 -
Minimum capacity(GB)            100
Size(GB)                        10
Source Image                    ID                                          Name                                 Remote Region   CRN                                                                                                                     Resource type
                                r006-cec640a3-615e-4364-bae7-d3642d9f9e34   ibm-ubuntu-22-04-5-minimal-amd64-4   -               crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-cec640a3-615e-4364-bae7-d3642d9f9e34   image
Operating system                Name                 Vendor      Version                                     Family         Architecture   Display name
                                ubuntu-22-04-amd64   Canonical   22.04 LTS Jammy Jellyfish Minimal Install   Ubuntu Linux   amd64          Ubuntu Linux 22.04 LTS Jammy Jellyfish Minimal Install (amd64)
Resource group                  ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                         2025-08-06T22:38:01+00:00
Captured at                     2025-08-06T22:38:02+00:00
Tags                            -
Service Tags                    -
Storage Generation              1
Allowed Use API Version         2025-07-17
Allowed Use Bare Metal Server   true
Allowed Use Instance            true

Le proprietà di allowed-used sono ereditate dal volume sorgente o dall'istantanea al momento della creazione. È possibile modificare il loro valore al momento della creazione o in un secondo momento se si è autorizzati al ruolo IAM is.snapshot.snapshot.manage-allowed-use. Le proprietà comprendono un'espressione booleana del Common Expression Language. Quando l'espressione di istanza viene valutata come true, allora il provisioning di un'istanza di server virtuale è consentito con lo snapshot. Quando l'espressione viene valutata come false, il provisioning viene bloccato. Se il valore non è specificato al momento della creazione, le espressioni del vincolo vengono prese dalla risorsa di partenza.

Il seguente esempio mostra i dettagli di un'istantanea non avviabile nella regione eu-de, che ha anche un clone di ripristino rapido nella zona eu-de-1.

ibmcloud is snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146

Getting snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
ID                         r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Name                       cli-snapshot-test
CRN                        crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Status                     stable
Clones                     Zone      Available   Created
                           eu-de-1   true        2023-02-17T20:15:46+00:00
Source volume              ID                                          Name
                           r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   block-test1
Bootable                   false
Encryption                 provider_managed
Encryption key             -
Minimum capacity(GB)       20
Size(GB)                   1
Snapshot Consistency Group ID                                                    Name                    Snapshot Consistency Group ID                                         Name                                   CRN                                                                    Resource type
                           r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44 multiple-snapshots-consistency-group-1   crn:v1:bluemix:public:is:eu-de:a/a1234567:snapshot-consistency-group:r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44   snapshot_consistency_group
Resource group             ID                                 Name
                           6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                    2023-12-05T20:15:43+00:00
Captured at                2023-12-05T20:15:44+00:00
Tags                       env:prod,env:test
Service Tags               -
Storage Generation         1

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is snapshots.

Visualizzazione di tutti i cloni di istantanee di ripristino rapido dalla CLI

È possibile elencare tutti i cloni di ripristino rapido disponibili di un'istantanea immettendo il comando ibmcloud is snapshot-clones. Il seguente esempio elenca i cloni di istantanea di ripristino rapido disponibili dell'istantanea con ID r138-4463eb2c-4913-43b1-b9bf-62a94f74c146.

ibmcloud is snapshot-clones r138-4463eb2c-4913-43b1-b9bf-62a94f74c146

Listing zonal clones of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone      Available   Created
eu-de-1   true        2023-02-17T20:15:46+00:00
eu-de-3   true        2023-02-17T20:29:21+00:00

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is snapshot-clones.

Visualizzazione dei dettagli di un clone di istantanea di ripristino rapido dalla CLI

È possibile eseguire il comando ibmcloud is snapshot-clone per elencare i dettagli di un clone dell'istantanea di ripristino rapido specifico. L'esempio seguente mostra come elencare i dettagli del clone dell'istantanea di ripristino rapido dell'istantanea r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 che si trova nella zona di ripristino rapido ( eu-de-3 ).

ibmcloud is snapshot-clone r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3

Getting zonal clone eu-de-3 of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone        eu-de-3
Available   true
Created     2023-02-17T20:29:21+00:00
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is snapshot-clone.

Visualizzazione dei dettagli di una copia di istantanea della regione remota dalla CLI

È possibile eseguire il comando " ibmcloud is snapshot " per elencare i dettagli relativi a una specifica copia dell'istantanea di una regione remota. L'esempio seguente mostra come elencare i dettagli dell'istantanea della regione remota (my-cli-snapshot-crc) che si trova nella regione us-south. La risposta fornisce informazioni sullo snapshot padre (cli-snap-crc-test), sul volume padre e sul criterio di backup che ha creato lo snapshot.

ibmcloud is snapshot my-cli-snapshot-crc

Getting snapshot my-cli-snapshot-crc-target under account Test Account as user test.user@ibm.com...
ID                     r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Status                 stable
Clones                 Zone   Available   Created
Source volume          ID                                          Name                   Remote Region   CRN                                                                                                                       Resource type
                       r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   -remote-814bfc1e108b   us-east         crn:v1:bluemix:public:is:us-east-a/a1234567::volume:r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   volume
Backup policy plan     ID                                          Name                   Resource type
                       r014-d659eb15-ff07-4d54-8dd8-808a037e1b61   -remote-808a037e1b61   backup_policy_plan
Snapshot Copies        -
Bootable               false
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                Remote Region   CRN                                                                                                                       Resource type
                       r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   cli-snap-crc-test   us-east         crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   snapshot
Minimum capacity(GB)   100
Size(GB)               1
Source Image           -
Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                2024-06-18T17:21:24+00:00
Captured at            2024-06-18T17:21:20+00:00
Tags                   -
Service Tags           -
Storage Generation     1

Visualizzazione di tutti i gruppi di congruenza di istantanee dalla CLI

Eseguire il comando snapshot-consistency-groups per elencare tutti i gruppi di congruenza in una region.

ibmcloud is snapshot-consistency-groups

Nuovo: se lo si desidera, è possibile filtrare i risultati della query in base all'ID di un processo di backup. Il filtro in base all'ID del processo di backup può rivelarsi utile quando si desidera ripristinare un'istanza ripristinando i volumi da due gruppi di coerenza di snapshot di backup creati perché l'istanza originale presentava un mix di volumi di prima e seconda generazione collegati.

ibmcloud is snapshot-consistency-groups --backup-policy-job BACKUP_POLICY_JOB_ID

Si veda il seguente esempio di output:

Listing snapshot consistency groups in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                      Name                           Backup policy job                      Backup policy plan                 Snapshots count   Lifecycle State   Service Tags                                               Resource group
r006-687c49cb-13ad-4dd8-9d04-0e264baa99a1  test-cli-2-4a3286e405b-4d3b  r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36  r006-ee0bddb-17b9-4279-8d1a-802afe9104da  1                 stable            is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d  Default
r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc  test-cli-2-f4690eb88143-441a  r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36  r006-ee0bddb-17b9-4279-8d1a-802afe9104da  2                 stable            is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d  Default

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is snapshot-consistency-groups.

Visualizzazione dei dettagli di un gruppo di congruenza dell'istantanea dalla CLI

Eseguire il comando snapshot-consistency-group per elencare i dettagli di un gruppo di congruenza specifico in una region.

ibmcloud is snapshot-consistency-group CONSISTENCY_GROUP_ID

Nuovo Esempio di output che mostra le informazioni relative al processo e al piano della politica di backup:

Getting snapshot consistency group r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc under account Test Account as user test.user@ibm.com...
ID
r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Name
test-cli-2-f4690eb88143-441a
CRN
crn:v1:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Href
https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Status
stable
Backup policy job
ID                                   Resource type
r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36   backup_policy_job
Backup policy plan
ID                                   Name        Resource type
r006-ee0bddb-17b9-4279-8d1a-802afe9104da   test-cli-2   backup_policy_plan
Delete snapshot on delete
true
Source Snapshot
ID                                   Name                          Remote Region   CRN                                                                                                           Resource type
r006-7e672c73-b476-4ec6-94e9-b1ef498362aa   test-cli-2-c01a2ef47cd3-4202              crn:v1:public:is:us-south:a/a1234567::snapshot:r006-7e672c73-b476-4ec6-94e9-b1ef498362aa   snapshot
r006-388f4bb7-cdd2-4e60-b57e-690066412d45   test-cli-2-12524f129f23-4fbc              crn:v1:public:is:us-south:a/a1234567::snapshot:r006-388f4bb7-cdd2-4e60-b57e-690066412d45   snapshot
Resource group
ID                                   Name
11caaa983d9c4beb82690daadb08717e9     Default
Created
2026-05-05T21:42:30+05:30
Service Tags
is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d

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

Elenco di tutte le istantanee con l'API

Puoi elencare in modo programmatico tutte le istantanee dei tuoi volumi richiamando il metodo /snapshots nell'API VPC come mostrato nella seguente richiesta di esempio. Per impostazione predefinita, l'elenco mostra prima le istantanee più recenti, seguite dalle istantanee più vecchie in ordine decrescente.

curl -X GET \
  "$vpc_api_endpoint/v1/snapshots?version=2022-12-16&generation=2" \
  -H "Authorization: Bearer $iam_token"

È possibile filtrare l'elenco utilizzando l'ID gruppo di risorse, l'ID volume di origine o il CRN volume di origine e filtrare ulteriormente i risultati utilizzando le seguenti opzioni:

• Limite - Per controllare il numero di istantanee visualizzate su una pagina.
• Inizio - Per specificare quale snapshot (per ID) avviare l'elenco.
• Ordina - Per controllare l'ordine in cui si ordina la pagina, ad esempio per data di creazione o alfabeticamente per nome istantanea.

Ad esempio, la seguente chiamata filtra l'elenco per mostrare le istantanee create per un singolo volume e limita i risultati a cinque per pagina.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots?version=2022-08-16&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "limit": 5,
      "source_volume":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

Una risposta corretta è simile all'esempio riportato di seguito.

{
    "first": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots?limit=50"
    },
    "limit": 5,
    "snapshots": [
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-18T20:18:18Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/f945d446-0d46-478a-a298-acba907d45d1",
        "id": " f945d446-0d46-478a-a298-acba907d45d1",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
          "name": "ubuntu-20-04-amd64",
          "vendor": "Canonical",
          "version": "20.04 LTS Focal Fossa Minimal Install"
        },
        "resource_group": {
          "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
          "id": "678523bcbe2b4eada913d32640909956",
          "name": "Default"
        },
        "resource_type": "snapshot",
        "service_tags": [],
        "size": 1,
        "source_image": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "id": "de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      },
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-17T20:11:28Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/e5bfa329-0e36-433f-a3bb-0df632e79263",
        "id": "e5bfa329-0e36-433f-a3bb-0df632e79263",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot-2",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
          "name": "ubuntu-20-04-amd64",
          "vendor": "Canonical",
          "version": "20.04 LTS Focal Fossa Minimal Install"
        },
        "resource_group": {
          "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
          "id": "678523bcbe2b4eada913d32640909956",
          "name": "Default"
        },
        "resource_type": "snapshot",
        "service_tags": [],
        "size": 1,
        "source_image": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "id": "23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      }
    ],
    "total_count": 2
  }

Elenco dei dettagli di una snapshot con l'API

Puoi richiamare in modo programmatico i dettagli di una singola istantanea richiamando il metodo /snapshots nell'API VPC e specificando l'ID istantanea come mostrato nella seguente richiesta di esempio.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Una risposta corretta è simile all'esempio riportato di seguito.

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "clones": [],
  "captured_at": "2022-12-16T20:19:12Z",
  "created_at": "2021-12-16T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": true,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d",
  "id": "7528eb61-bc01-4763-a67a-a414a103f96d",
  "lifecycle_state": "stable",
  "minimum_capacity": 100,
  "name": "my-snapshot",
  "operating_system": {
    "architecture": "amd64",
    "dedicated_host_only": false,
    "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
    "family": "Ubuntu Linux",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
    "name": "ubuntu-20-04-amd64",
    "vendor": "Canonical",
    "version": "20.04 LTS Focal Fossa Minimal Install"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "id": "59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "id": "dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "name": "ubuntu-20-04-minimal-amd64-1"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "id": "c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}

• Le proprietà di allowed-used sono ereditate dal volume sorgente o dall'istantanea al momento della creazione. È possibile modificare il loro valore al momento della creazione o in un secondo momento se si è autorizzati al ruolo IAM is.snapshot.snapshot.manage-allowed-use. Le proprietà comprendono un'espressione booleana del Common Expression Language. Quando l'espressione di istanza viene valutata come true, allora il provisioning di un'istanza di server virtuale è consentito con lo snapshot. Quando l'espressione viene valutata come false, il provisioning viene bloccato. Se il valore non è specificato al momento della creazione, le espressioni del vincolo vengono prese dalla risorsa di partenza.

Visualizzazione di tutti i cloni di istantanea di ripristino rapido con l'API

Puoi elencare in modo programmatico tutti i cloni di ripristino rapido richiamando il metodo /snapshots/clones nell'API VPC e specificando l'ID istantanea come mostrato nella seguente richiesta di esempio.

Effettuare una richiesta GET /v1/snapshots/{id}/clones per elencare tutti i cloni di istantanea di ripristino rapido.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Una risposta di esito positivo fornisce informazioni sui cloni dell'istantanea di ripristino rapido.

{
  "clones": [
    {
      "available": true,
      "created_at": "2022-12-16T19:55:28.537Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
      }
    },
    {
      "available": true,
      "created_at": "2022-12-16T19:58:22.337Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
      }
    }
  ]
}

Visualizzazione dei dettagli di un clone di istantanea di ripristino rapido con l'API

Puoi richiamare in modo programmatico i dettagli di un singolo clone di ripristino rapido richiamando il metodo /snapshots/clones in API VPC e specificando l'ID istantanea e la zona come mostrato nella seguente richiesta di esempio.

Effettuare una richiesta GET /v1/snapshots/{id}/clones/{zone-name} per richiamare un singolo clone dell'istantanea di ripristino rapido specificato per ID e nome zona.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones/us-south-1?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Una risposta corretta mostra le seguenti informazioni sul clone dell'istantanea di ripristino rapido.

{
  "available": true,
  "created_at": "2022-12-16T20:15:35.164Z",
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Visualizzare i dettagli di una copia di istantanea della regione remota con l'API

Puoi richiamare in modo programmatico i dettagli di una singola istantanea richiamando il metodo /snapshots nell'API VPC e specificando l'ID istantanea come mostrato nella seguente richiesta di esempio.

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

Una risposta corretta mostra informazioni simili al seguente esempio.

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "created_at": "2023-05-18T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": false,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "id": "r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "lifecycle_state": "stable",
  "minimum_capacity": 100,
  "name": "my-snapshot",
  "operating_system": {
    "architecture": "amd64",
    "dedicated_host_only": false,
    "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
    "family": "Ubuntu Linux",
    "gpu_supported": [],
    "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
    "name": "ubuntu-20-04-amd64",
    "vendor": "Canonical",
    "version": "20.04 LTS Focal Fossa Minimal Install"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "region": "us-east",
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "id": "r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "name": "ibm-ubuntu-20-04-minimal-amd64-1"
  },
  "source_snapshot": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-511a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-511a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-snapshot-data"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-411a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-411a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}

Visualizzazione di tutti i gruppi di congruenza di istantanee con l'API

È possibile elencare programmaticamente tutti i gruppi di congruenza richiamando il metodo /snapshot_consistency_groups in API VPC come mostrato nella seguente richiesta di esempio.

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"

Nuovo: se lo si desidera, è possibile filtrare i risultati della query in base all'ID di un processo di backup. Il filtro in base all'ID del processo di backup può rivelarsi utile quando si desidera ripristinare un'istanza ripristinando i volumi da due gruppi di coerenza di snapshot di backup creati perché l'istanza originale presentava un mix di volumi di prima e seconda generazione collegati.

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups/006-e8707243-96b3-4c27-be1f-57eff0196207?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"\
-d '{
      "backup_policy_job_id":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

Visualizzazione dei dettagli di un gruppo di congruenza di istantanee con l'API

È possibile richiamare in modo programmatico i dettagli di un gruppo di congruenza chiamando il metodo /snapshot_consistency_groups in API VPC come mostrato nella seguente richiesta di esempio.

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups/006-e8707243-96b3-4c27-be1f-57eff0196207?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"

Una risposta corretta è simile all'esempio riportato di seguito.

{
    "created_at": "2023-12-05T22:40:42Z",
    "id": "r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "delete_snapshots_on_delete": true,
    "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "name": "my-consistency-group-snapshots",
    "resource_group": {
        "id": "a41ca701e1c041c1bb224564ff645770",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/a41ca701e1c041c1bb224564ff645770",
        "name": "Default"
    },
    "lifecycle_state": "stable",
    "resource_type": "snapshot_consistency_group",
    "service_tags": [
        "is.instance:0727_44fda9fe-eeef-4e71-8fa4-4c3f7300e645"
    ],
    "snapshots": [
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "id": "r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "name": "my-test-scg-1",
            "resource_type": "snapshot"
        },
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "id": "r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "name": "my-test-scg-2",
            "resource_type": "snapshot"
        }
    ]
}

Elenco di tutte le istantanee con Terraform

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

data "ibm_is_snapshots" "example" {
}

Per ulteriori informazioni, vedi ibm_is_snapshots.

Elenco dei dettagli di un'istantanea con Terraform

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

data "ibm_is_snapshot" "example" {
  identifier = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

data "ibm_is_snapshot" "example" {
  name = "snappy-snap-snap"
}

• Le proprietà di allowed-used sono ereditate dal volume sorgente o dall'istantanea al momento della creazione. È possibile modificare il loro valore al momento della creazione o in un secondo momento se si è autorizzati al ruolo IAM is.snapshot.snapshot.manage-allowed-use. Le proprietà comprendono un'espressione booleana del Common Expression Language. Quando l'espressione di istanza viene valutata come true, allora il provisioning di un'istanza di server virtuale è consentito con lo snapshot. Quando l'espressione viene valutata come false, il provisioning viene bloccato. Se il valore non è specificato al momento della creazione, le espressioni del vincolo vengono prese dalla risorsa di partenza.

Per ulteriori informazioni, consultare ibm_is_snapshot.

Elenco di tutti i cloni di istantanee di ripristino rapido

Importare i dettagli di tutti i cloni di ripristino rapido di un'istantanea come origine dati di sola lettura.

data "ibm_is_snapshot_clones" "ds_snapshotclones" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

Per ulteriori informazioni, consultare ibm_is_snapshot_clones.

Elenco dei dettagli di un clone di ripristino rapido con Terraform

Importare i dettagli di un clone di ripristino rapido di un'istantanea in una zona come origine dati di sola lettura.

data "ibm_is_snapshot_clone" "ds_snapshotclone" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
  zone     = "eu-de-1"
}

Per ulteriori informazioni, consultare ibm_is_snapshot_clone.

Elenco di tutti i gruppi di congruenza con Terraform

Importare i dettagli di una raccolta di gruppi di congruenza come origine dati di sola lettura.

data "ibm_is_snapshot_consistency_groups" "example" {
}

Per ulteriori informazioni, consultare ibm_is_consistency_groups.

Elenco dei dettagli di un gruppo di congruenza con Terraform

Importare i dettagli di un gruppo di congruenza dell'istantanea come origine dati di sola lettura. È possibile specificare il gruppo di congruenza in base all'ID o al nome del gruppo di congruenza.

data "ibm_is_snapshot_consistency_group" "example 1" {
  identifier = ibm_is_snapshot_consistency_group.is_snapshot_consistency_group.id
}

data "ibm_is_snapshot_consistency_group" "example 2" {
  name = "my-data-consistency-group"
}

Nuovo È inoltre possibile filtrare la raccolta in base ai gruppi di coerenza degli snapshot utilizzando la proprietà backup_policy_job.id. Vedi il seguente esempio.

data "ibm_is_snapshot_consistency_groups" "example 3" {
    backup_policy_job = "r006-fc4b7fbc-38af-45d9-9fb6-bf0533acbfc4"
}

Per ulteriori informazioni, vedere ibm_is_consistency_group.