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.

Prima di iniziare, raccogliere le seguenti informazioni:

• Un nome univoco per l'istantanea. Il nome dello snapshot della condivisione deve essere unico a livello di condivisione. Per suggerimenti su come denominare le istantanee, vedere Denominazione delle istantanee.
• Il nome o l'ID della condivisione di origine.
• Eventuali tag da allegare all'istantanea.

Per raccogliere le informazioni necessarie, utilizzare i seguenti comandi CLI.

• ibmcloud is shares- Questo comando elenca tutte le condivisioni disponibili nella regione selezionata. Individuare la condivisione nell'elenco, verificare lo stato ( available ).
• ibmcloud is share SHARE_ID- Usare questo comando con l'ID della condivisione ricavato dall'output del comando precedente per esaminare i dettagli della condivisione. Se l'output mostra che la condivisione è disponibile, collegata a un'istanza e non occupata, è possibile creare un'istantanea.

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

È possibile creare un'istantanea chiamando l'API VPC. Prima di iniziare, raccogliere le seguenti informazioni:

• Un nome univoco per l'istantanea. Il nome dello snapshot della condivisione deve essere unico a livello di condivisione. Per suggerimenti su come denominare le istantanee, vedere Denominazione delle istantanee.
• L'ID della condivisione di origine.
• Eventuali tag da allegare all'istantanea.

Creazione di uno snapshot tramite l'API

È possibile creare programmaticamente un'istantanea di una condivisione di file chiamando il metodo API shares/{share-id}/snapshots. L'esempio seguente crea un'istantanea di una condivisione utilizzando l'ID della condivisione e specifica i tag utente che possono essere associati a un criterio di backup.

curl -X POST \
"$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
-d '{
  "name": "my-first-share-snapshot",
  "user_tags": [
    "env:test"
  ]
}'

Una risposta corretta è simile all'esempio riportato di seguito. Lo stato del ciclo di vita dell'istantanea è pending durante la creazione dell'istantanea. Quando viene creato con successo, lo stato cambia in stable.

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

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