Creazione di istantanee Block Storage for VPC

Con l'interfaccia utente, la CLI, l'API o Terraform, è possibile creare un'istantanea di un volume di prima Block Storage for VPC generazione collegato a un'istanza di server virtuale in esecuzione. È possibile creare un'istantanea di un volume di dati o di avvio. Se il volume non è collegato a un'istanza del server, non puoi crearne un'istantanea.

Nella versione attuale dei volumi di archiviazione a blocchi di seconda generazione, è possibile eseguire un'istantanea di un volume di archiviazione di seconda generazione anche se non è collegato a un'istanza di server virtuale in esecuzione. La funzione è disponibile nelle regioni di Dallas (us-south), Francoforte (eu-de), Londra (eu-gb), Madrid (eu-es), Osaka (js-osa), San Paolo (br-sao), Sydney (au-syd), Tokyo (jp-tok), Toronto (ca-tor) e Washington (us-east). Le istantanee dei gruppi di coerenza non sono supportate.

Prima di eseguire uno snapshot, assicurarsi che tutti i dati memorizzati nella cache siano presenti sul disco, in particolare quando si esegue uno snapshot di istanze con sistemi operativi Windows Linux® e. Ad esempio, sui Linux® sistemi operativi, eseguire il sync comando per forzare la scrittura immediata di tutti i dati memorizzati nella cache sul disco.

È possibile creare un gruppo di coerenza che contiene le istantanee di più volumi Gen 1 collegati a un'istanza di server virtuale. Tutte le istantanee nel gruppo di congruenza vengono create contemporaneamente e sono accoppiate in modo flessibile. Per ulteriori informazioni, consultare Creazione di gruppi di congruenza delle istantanee.

Creare un'istantanea nella console

Nella console è possibile creare uno snapshot di un volume di tipo “ Block Storage for VPC ” collegato a un’istanza di server virtuale in esecuzione.

  1. Puoi accedere all'istantanea Block Storage per la schermata di provisioning del VPC nella consoleIBM Cloud® in più modi.

    • Dall'elenco Block Storage snapshots for VPC,

      1. Fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC Magazzino > Block Storage istantanee.
      2. Dall'elenco di istantanee inizialmente vuoto, fare clic su Crea.

    • Dall'elenco Block Storage volumes for VPC,

      1. Fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC Magazzino > Block Storage volumi.
      2. Dall'elenco di volumi, individuare un volume di avvio o di dati collegato a un'istanza.
      3. Fare clic sul menu Azioni Icona Azioni e selezionare Crea istantanea.

    • Dalla schermata Block Storage volume details,

      1. Andare alla pagina dei dettagli del volume in uno di questi modi.

        • Fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC > Calcolo > Istanze server virtuali. Selezionare l'istanza che contiene il volume di cui si desidera creare un'istantanea. Dalla pagina dei dettagli dell'istanza, scorri all'elenco dei volumi collegati e fai clic sul nome del volume.
        • Fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC Magazzino > Block Storage volumi. Dall'elenco di volumi Block Storage, selezionare il volume di cui si desidera creare un'istantanea.

      2. Nella pagina dei dettagli del volume, selezionare Crea istantanea dal menu Azioni.

  2. Immettere le informazioni richieste per definire l'istantanea e selezionare il volume Block Storage for VPC di cui si desidera eseguire un'istantanea.

    Selezioni per la creazione di un'istantanea
    Campo Valore
    Posizione Specificare l'area geografica e la regione per questa istantanea.
    Tipo di istantanea Selezionare Volume singolo.
    Nome Assegnare un nome univoco allo snapshot. L'interfaccia utente verifica il nome per le convenzioni appropriate e identifica i nomi duplicati. Per suggerimenti su come denominare le istantanee, vedi Denominazione delle istantanee.
    Gruppo di risorse Selezionare un Gruppo di risorse per l'istantanea oppure utilizzare il valore predefinito. Non è possibile modificare il gruppo di risorse dopo la creazione dello snapshot.
    Tag Specificare eventuali tag utente che si desidera identificare questa risorsa.
    Tag di gestione accesso Specificare eventuali tag di gestione accessi per questa risorsa.
    Volume Seleziona un volume dall'elenco. Il volume di avvio o di dati deve essere collegato a un'istanza del server virtuale in esecuzione.
    Crittografia Informazioni di crittografia per il volume selezionato, crittografia gestita dal provider o crittografia gestita dal cliente. L'istantanea eredita la codifica del volume di origine. Non è possibile modificare il tipo di crittografia.
    Configurazioni facoltative Copia istantanea tra regioni. Seleziona "Copia snapshot in un'altra regione". Fai clic su Crea.

  3. Fai clic su Crea. Si ritorna allo schermo da cui si è iniziato. La creazione delle istantanee è asincrona. L'istantanea viene creata immediatamente, ma rimane in stato di attesa fino a quando tutti i dati non vengono trasferiti all'archivio di archiviazione regionale. I messaggi vengono visualizzati durante la creazione dell'istantanea e quando è pronta, l'istantanea viene visualizzata nell'elenco di istantanee. Per ulteriori informazioni, vedere Visualizzazione dei dettagli delle istantanee nella console.

Se non sei ancora pronto per ordinare o stai solo cercando informazioni sui prezzi, puoi aggiungere le informazioni che vedi nel pannello laterale a una stima. Per ulteriori informazioni sul funzionamento di questa funzione, consulta la sezione " Stima dei costi ".

Abilitazione dei cloni di istantanee di ripristino rapido nella console

  1. Per abilitare la funzione di ripristino rapido, fare clic sulla nuova istantanea per visualizzarne i dettagli.
  2. Scorrere la scheda Ripristino rapido e fare clic su Modifica.
  3. Nel pannello laterale, selezionare le zone in cui si desidera abilitare i cloni di ripristino rapido.
  4. Fare clic su Salva.

La funzione di ripristino rapido viene fatturata a una tariffa oraria aggiuntiva per ogni zona in cui è abilitata, indipendentemente dalla dimensione dell'istantanea. Il mantenimento di cloni di ripristino rapidi è notevolmente più costoso rispetto al mantenimento di istantanee regolari.

Crea una copia interregionale dall'elenco di istantanee per VPC

Nella sezione precedente si è visto come creare una copia dell'istantanea interregionale quando si crea una nuova istantanea nella console. È inoltre possibile creare copie interregionali di istantanee esistenti.

  1. Nella console, fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC > Archiviazione > Block Storage snapshot.
  2. Nell'elenco delle istantanee, individuare l'istantanea che si desidera copiare. Assicurarsi che l'istantanea sia in stato Stabile.
  3. Fare clic sul menu Azioni Icona Azioni e selezionare Copia istantanea.
  4. Seleziona la regione in cui desideri creare la copia.
  5. Fai clic su Crea.

Creazione di uno snapshot dalla CLI

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, vedi i prerequisiti della CLI.

  1. 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 una corretta 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.

Prima di iniziare, raccogliere le seguenti informazioni:

  • Un nome univoco per l'istantanea.
  • L'ID del volume di origine.
  • L'ID del gruppo di risorse. Non è possibile modificare il gruppo di risorse dopo la creazione dello snapshot.
  • Qualsiasi tag che si desidera allegare all'istantanea.

Utilizza i seguenti comandi CLI per raccogliere le informazioni di cui hai bisogno.

-ibmcloud is volumes- Il comando elenca tutti i volumi disponibili nella regione selezionata. Individuare il volume nell'elenco, verificare lo stato (available), il tipo di collegamento (boot o data) e il gruppo di risorse. - ibmcloud is volume VOLUME_ID- Usare questo comando con l'ID del volume ricavato dall'output del comando precedente per esaminare i dettagli del volume. Se l'output mostra che il volume è disponibile, collegato a una istanza e non occupato, è possibile creare un'istantanea.

Creazione di uno snapshot dalla CLI

Per creare un'istantanea, eseguire il comando ibmcloud is snapshot-create.

ibmcloud is snapshot-create --volume VOLUME [--name NAME] [--clone-zones CLONE_ZONES] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags  TAG_NAME1,TAG_NAME2,...] [--output JSON] [-q, --quiet]

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

Il seguente esempio crea un'istantanea con il nome cli-snapshot-test del volume dati block-test1 nella regione eu-de-2. L'istantanea è contrassegnata con env:test e env:prod e ha un clone di istantanea di ripristino rapido nella zona eu-de-1.

ibmcloud is snapshot-create --volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa --name cli-snapshot-test --tags env:test,env:prod --clone-zones eu-de-1

Creating snapshot cli-snapshot-test 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                 pending
Clones                 Zone      Available   Created
                       eu-de-1   false       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
Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                2023-02-17T20:15:43+00:00
Captured at            0001-01-01T00:00:00+00:00
Tags                   env:prod,env:test

Lo stato mostra pending durante la creazione dell'istantanea. Immettere il comando ibmcloud is snapshot con l'ID istantanea per visualizzare la nuova istantanea nello stato stable.

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
Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                2023-02-17T20:15:43+00:00
Captured at            2023-02-17T20:15:44+00:00
Tags                   env:prod,env:test

Creazione di un clone di istantanea di ripristino rapido dalla CLI

È possibile creare un clone di ripristino rapido utilizzando il comando ibmcloud is snapshot-clc con l'ID istantanea e la specifica della zona di destinazione. Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is snapshot-clone-create.

Il seguente esempio crea un clone dell'istantanea di ripristino rapido dell'istantanea r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 nella zona eu-de-3.

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

Creating zonal clone of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...

Zone        eu-de-3
Available   false
Created     2023-02-17T20:29:21+00:00
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

Il clone di istantanea viene visualizzato come non disponibile durante la creazione del clone di istantanea. Immettere il comando ibmcloud is snapshot-cl con l'ID istantanea e la zona di destinazione clone per vedere il nuovo clone istantanea come disponibile.

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

Creating zonal clone of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...

Zone        eu-de-3
Available   false
Created     2023-02-17T20:29:21+00:00
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

La funzione di ripristino rapido viene fatturata a una tariffa oraria aggiuntiva per ogni zona in cui è abilitata, indipendentemente dalla dimensione dell'istantanea. Il mantenimento di cloni di ripristino rapidi è notevolmente più costoso rispetto al mantenimento di istantanee regolari.

Creazione di una copia interregionale di un'istantanea dalla CLI

Per creare una copia di un'istantanea in un'altra regione, eseguire il comando ibmcloud is snapshot-create con l'opzione --source-snapshot-crn e il CRN dell'istantanea di origine.

Se l'istantanea di origine non è codificata con una chiave cliente, la codifica della copia rimane gestita dal provider. Se l'istantanea di origine è protetta da una chiave gestita dal cliente, è necessario specificare la chiave gestita dal cliente che si desidera utilizzare per codificare la nuova copia. Lo snapshot di origine deve essere in stato Stabile perché la copia venga creata con successo.

Il seguente esempio crea un'istantanea nella regione di destinazione (us-south) utilizzando il CRN di un'istantanea dalla regione di origine (us-east).

ibmcloud is snapshot-create --name my-cli-snapshot-crc --source-snapshot-crn crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9

Creating snapshot my-cli-snapshot-crc under account Test Account as user test.user@ibm.com...

ID                     r006-daefc524-2643-4444-a22d-7c38144cc529
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-daefc524-2643-4444-a22d-7c38144cc529
Status                 stable
Clones                 Zone   Available   Created

Source volume          ID                                          Name                   Remote Region   CRN                                                                                                                       Resource type
                       r014-26fce2ff-8177-47ce-8182-49d8aed33063   -remote-49d8aed33063   us-east         crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-26fce2ff-8177-47ce-8182-49d8aed33063   volume

Backup policy plan     -
Snapshot Copies        -
Bootable               true
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                   Remote Region   CRN                                                                                                                       Resource type
                       r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9   my-bootable-snapshot   us-east         crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9   snapshot

Minimum capacity(GB)   100
Size(GB)               3
Source Image           ID                                          Name                   Remote Region   CRN                                                                                                                    Resource type
                       r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214   -remote-1f4a7cd29214   us-east         crn:v1:bluemix:public:is:us-east:a/a1234567::image:r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214   image

Operating system       Name                    Vendor   Version   Family          Architecture   Display name
                       centos-stream-9-amd64   CentOS   9         CentOS Stream   amd64          CentOS Stream 9 - Minimal Install (amd64)

Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                2025-01-21T21:27:30+00:00
Captured at            2025-01-21T21:17:14+00:00
Tags                   -
Service Tags           -

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

Creazione di uno snapshot tramite l'API

Puoi creare un'istantanea utilizzando l'API.

Prerequisiti per la creazione di un'istantanea con l'API

Puoi creare un'istantanea richiamando l'API VPC. Prima di iniziare, raccogliere le seguenti informazioni:

  • Un nome univoco per l'istantanea.
  • L'ID del volume di origine.
  • L'ID del gruppo di risorse. Non è possibile modificare il gruppo di risorse dopo la creazione dello snapshot.
  • Qualsiasi tag che si desidera allegare all'istantanea.

Creazione di uno snapshot tramite l'API

Per creare un'istantanea di un volume di avvio o di dati, creare un POST /snapshots. Il seguente esempio crea un'istantanea di un volume di avvio utilizzando l'ID volume e specifica le tag dell'utente che possono essere associati a una politica di backup ( backup policy).

curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2025-02-18&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-bootable-snapshot",
      "source_volume": {"id": "r014-26fce2ff-8177-47ce-8182-49d8aed33063"},
      "resource_group": {"id": "6edefe513d934fdd872e78ee6a8e73ef"},
      "user_tags": ["env:test","env:prod"]
    }'

Una risposta corretta è simile all'esempio riportato di seguito. Lo stato del ciclo di vita dell'istantanea è pending mentre l'istantanea viene creata. Una volta creato correttamente, lo stato cambia in stable.

{
    "bootable": true,
    "captured_at": "2025-01-21T21:17:14.000Z",
    "clones": [],
    "copies": [],
    "created_at": "2025-01-21T21:17:13.000Z",
    "crn": "crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
    "deletable": true,
    "encryption": "provider_managed",
    "href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
    "id": "r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
    "lifecycle_state": "stable",
    "minimum_capacity": 100,
    "name": "my-bootable-snapshot",
    "operating_system": {
        "allow_user_image_creation": true,
        "architecture": "amd64",
        "dedicated_host_only": false,
        "display_name": "CentOS Stream 9 - Minimal Install (amd64)",
        "family": "CentOS Stream",
        "href": "https://us-east.iaas.cloud.ibm.com/v1/operating_systems/centos-stream-9-amd64",
        "name": "centos-stream-9-amd64",
        "user_data_format": "cloud_init",
        "vendor": "CentOS",
        "version": "9"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "resource_type": "snapshot",
    "service_tags": [],
    "size": 2,
    "source_image": {
        "crn": "crn:v1:bluemix:public:is:us-east:a/a1234567:image:r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
        "href": "https://us-east.iaas.cloud.ibm.com/v1/images/r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
        "id": "r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
        "name": "ibm-centos-stream-9-amd64-9",
        "resource_type": "image"
    },
    "source_volume": {
        "crn": "crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-26fce2ff-8177-47ce-8182-49d8aed33063",
        "href": "https://us-east.iaas.cloud.ibm.com/v1/volumes/r014-26fce2ff-8177-47ce-8182-49d8aed33063",
        "id": "r014-26fce2ff-8177-47ce-8182-49d8aed33063",
        "name": "my-test-vm-boot-1",
        "resource_type": "volume"
    },
    "user_tags": ["env:test","env:prod"]
}

Creazione di un'istantanea e di un clone istantanea di ripristino rapido con l'API

Quando si crea un'istantanea, è anche possibile creare un clone istantanea di ripristino rapido in un'altra zona. Clonando un'istantanea e mantenendola in un'altra zona, puoi in seguito utilizzare la funzione di ripristino rapido per eseguire rapidamente il provisioning di un nuovo volume con dati da un'istantanea. Per ulteriori informazioni, consultare Funzione di ripristino rapido delle istantanee.

Effettuare una richiesta POST/snapshots per creare un'istantanea di un volume di dati o di avvio e specificare la proprietà clones. Indica una o più zone differenti nella tua regione dalla zona in cui stai creando l'istantanea. Nel seguente esempio, viene creato un clone in us-south-2, specificato per nome.

curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2022-12-18&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
    "clones": [{"zone": {"name": "us-south-2"}}],
    "name": "my-snapshot-1",
    "source_volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"},
    "resource_group": {"id": "a342dbfb-3ea7-48d1-96e8-2825ec5feab4"},
    "user_tags": ["env:test","env:prod"]
    }
  }'

Una risposta positiva indica che il clone è stato creato nella zona specificata.

{
  "bootable": true,
  "clones": [
		{
			"available": false,
			"created_at": "2022-12-18T14:58:32Z",
			"zone": {
				"name": "us-south-2",
				"href": "https:ibm.com/v1/regions/us-south/zones/us-south-2",
				"resource_type": "zone"
			}
		}
	],
  "created_at": "2022-12-18T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": false,
  "encryption": "user_managed",
  "encryption_key": {
     "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/12917904-3771-424d-8391-53ec9e305d52",
  "id": "12917904-3771-424d-8391-53ec9e305d52",
  "lifecycle_state": "pending",
}

La funzione di ripristino rapido viene fatturata a una tariffa oraria aggiuntiva per ogni zona in cui è abilitata, indipendentemente dalla dimensione dell'istantanea. Il mantenimento di cloni di ripristino rapidi è notevolmente più costoso rispetto al mantenimento di istantanee regolari.

Creazione di una copia interregionale di un'istantanea con l'API

Quando crei un'istantanea, puoi anche copiare l'istantanea in un'altra regione. Creando una copia di istantanea in un'altra regione e creando nuove istanze con l'aiuto di tale istantanea, puoi espandere il VPC in un'altra regione. Questa funzione può essere utilizzata anche in scenari di ripristino di emergenza. Per ulteriori informazioni, consultare Copie di istantanee interregionali.

Effettuare una richiesta POST /snapshots per creare una copia dell'istantanea nella region di destinazione, specificare il nome e il CRN dell'istantanea di origine. Nel seguente esempio, la regione di destinazione è us - east e la regione di origine è us - south. Le proprietà secondarie name e source_snapshot sono obbligatorie. L' resource_group e è facoltativo. La proprietà secondaria encryption_key è richiesta quando l'istantanea di origine è codificata con una chiave gestita dal cliente.

Se l'istantanea di origine non è codificata con una chiave cliente, la codifica della copia rimane gestita dal provider. Se l'istantanea di origine è protetta da una chiave gestita dal cliente, è necessario specificare la chiave gestita dal cliente che si desidera utilizzare per codificare la nuova copia. Lo snapshot di origine deve essere in stato Stabile perché la copia venga creata con successo.

curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2023-05-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
     "name": "my-api-snapshot-crc",    // required
     "source_snapshot": {      // required
      	"crn": "crn:[crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-daefc524-2643-4444-a22d-7c38144cc529]"
     },
     "resource_group": {       // optional
       "id": "6edefe513d934fdd872e78ee6a8e73ef"
     },
     "encryption_key"; "crn:[...]"     // required when source has customer-managed encryption
}

Una risposta corretta indica che la copia dell'istantanea è stata creata nella region di destinazione.

{
    "bootable": true,
    "captured_at": "2025-01-21T21:17:14.000Z",
    "clones": [],
    "copies": [],
    "created_at": "2025-01-21T21:27:30.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-daefc524-2643-4444-a22d-7c38144cc529",
    "deletable": true,
    "encryption": "provider_managed",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-daefc524-2643-4444-a22d-7c38144cc529",
    "id": "r006-daefc524-2643-4444-a22d-7c38144cc529",
    "lifecycle_state": "stable",
    "minimum_capacity": 100,
    "name": "my-api-snapshot-crc",
    "operating_system": {
        "allow_user_image_creation": true,
        "architecture": "amd64",
        "dedicated_host_only": false,
        "display_name": "CentOS Stream 9 - Minimal Install (amd64)",
        "family": "CentOS Stream",
        "href": "https://us-east.iaas.cloud.ibm.com/v1/operating_systems/centos-stream-9-amd64",
        "name": "centos-stream-9-amd64",
        "user_data_format": "cloud_init",
        "vendor": "CentOS",
        "version": "9"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "resource_type": "snapshot",
    "service_tags": [],
    "size": 3,
    "source_image": {
        "crn": "crn:v1:bluemix:public:is:us-east:a/811f8abfbd32425597dc7ba40da98fa6::image:r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
        "href": "https://us-east.iaas.cloud.ibm.com/v1/images/r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
        "id": "r014-da69503f-30d4-4f1d-b03f-1f4a7cd29214",
        "name": "-remote-1f4a7cd29214",
        "remote": {
            "region": {
                "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-east",
                "name": "us-east"
            }
        },
        "resource_type": "image"
    },
    "source_snapshot": {
        "crn": "crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
        "href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
        "id": "r014-14aae86e-f03d-4978-a4da-ab02e69bb2f9",
        "name": "my-bootable-snapshot",
        "remote": {
            "region": {
                "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-east",
                "name": "us-east"
            }
        },
        "resource_type": "snapshot"
    },
    "source_volume": {
        "crn": "crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-26fce2ff-8177-47ce-8182-49d8aed33063",
        "href": "https://us-east.iaas.cloud.ibm.com/v1/volumes/r014-26fce2ff-8177-47ce-8182-49d8aed33063",
        "id": "r014-26fce2ff-8177-47ce-8182-49d8aed33063",
        "name": "-remote-49d8aed33063",
        "remote": {
            "region": {
                "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-east",
                "name": "us-east"
            }
        },
        "resource_type": "volume"
    },
    "user_tags": []
}

Creazione di un'istantanea con Terraform

Puoi creare un'istantanea utilizzando Terraform.

Prima di iniziare, raccogliere le seguenti informazioni:

  • Un nome univoco per l'istantanea.
  • L'ID del volume di origine.
  • L'ID del gruppo di risorse. Non è possibile modificare il gruppo di risorse dopo la creazione dello snapshot.
  • Qualsiasi tag che si desidera allegare all'istantanea.

Per utilizzare Terraform, scarica la CLI Terraform e configura il IBM Cloud® plug-in Provider. Per ulteriori informazioni, vedi Introduzione a Terraform.

I servizi dell'infrastruttura VPC utilizzano uno specifico endpoint regionale, che per impostazione predefinita punta a us-south. Se il tuo VPC viene creato in un'altra regione, assicurati di specificare la regione appropriata nel blocco del provider nel file provider.tf.

Vedi il seguente esempio di destinazione di una regione diversa da quella predefinita us-south.

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

Per creare un'istantanea, utilizzare la risorsa ibm_is_snapshot. Il seguente esempio crea un'istantanea del volume con l'ID r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa. L'istantanea è denominata snapshot-test.

resource "ibm_is_snapshot" "example" {
   name          = "snapshot-test"
   source_volume = "r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa"
}

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

Creazione di un'istantanea e di un clone di istantanea di ripristino rapido con Terraform

Per creare un'istantanea con cloni di ripristino rapido, utilizzare la risorsa ibm_is_snapshot. Il seguente esempio crea un'istantanea del volume con l'ID r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4. L'istantanea è denominata example-snapshot. Inoltre, vengono creati due cloni di ripristino rapido dell'istantanea nelle regioni eu-de-1 e eu-de-3.

resource "ibm_is_snapshot" "example_clones" {
   name            = "example-snapshot-clone"
   source_volume   = "r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4"
   clones          = ["eu-de-1", "eu-de-3"]
}

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

La funzione di ripristino rapido viene fatturata a una tariffa oraria aggiuntiva per ogni zona in cui è abilitata, indipendentemente dalla dimensione dell'istantanea. Il mantenimento di cloni di ripristino rapidi è notevolmente più costoso rispetto al mantenimento di istantanee regolari.

Crea una copia interregionale di un'istantanea con Terraform

Per creare una copia dell'istantanea in una regione remota, utilizzare la risorsa ibm_is_snapshot. Il seguente esempio crea una copia nella region di destinazione utilizzando il CRN dell'istantanea di origine. La copia verrà codificata dalla chiave di crittografia specificata dal suo CRN.

resource "ibm_is_snapshot" "snapshot" {
   name 		   = "my-cross-regional-snapshot"
   source_snapshot = "r138-4463eb2c-4913-43b1-b9bf-62a94f74c146"
   encryption_key  = "crn:bluemix:public:kms:us-south:a/df0564dd126042ebb03e0224728ce939:4957299d-0ba0-487f-a1a0-c724a729b8b4:key:0cb88b98-9261-4d07-8329-8f594b6641b5"
}

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

Lo snapshot di origine deve essere in stato Stabile perché la copia venga creata con successo.

Passi successivi

Dopo aver creato un'istantanea, è possibile visualizzarne ulteriori dettagli o ripristinare un volume dall'istantanea.