Antes de empezar

Para poder utilizar la CLI, debe instalar la CLI de IBM Cloud y el plugin de la CLI de VPC. Para obtener más información, consulte los Requisitos previos de la CLI.

Inicia sesión en IBM Cloud®.

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

Este mandato devuelve un URL y solicita un código de acceso. Vaya a ese URL en el navegador e inicie la sesión. Si se ejecuta correctamente, recibe un código de acceso de un solo uso. Copie este código de acceso y péguelo como respuesta en la solicitud. Tras autenticarse correctamente, se le pedirá que elija su cuenta. Si tienes acceso a varias cuentas, selecciona la cuenta con la que quieras iniciar sesión. Responda a cualquier solicitud restante para finalizar el inicio de sesión.

Antes de empezar, reúne la siguiente información:

• Un nombre único para la instantánea. El nombre de la instantánea de la acción debe ser único a nivel de la acción. Para obtener sugerencias sobre cómo denominar las instantáneas, consulte Denominación de instantáneas.
• El nombre o ID del recurso compartido de origen.
• Cualquier etiqueta que desee adjuntar a la instantánea.

Utilice los siguientes comandos de la CLI para recopilar la información que necesita.

• ibmcloud is shares- Este comando enumera todas las acciones disponibles en la región seleccionada. Localice el recurso compartido en la lista, compruebe el estado ( available ).
• ibmcloud is share SHARE_ID- Utilice este comando con el ID de recurso compartido de la salida del comando anterior para revisar los detalles del recurso compartido. Si el resultado muestra que el recurso compartido está disponible, conectado a una instancia y no está ocupado, puede crear una instantánea.

Requisitos previos para crear una instantánea con la API

Puede crear una instantánea llamando a la API de VPC. Antes de empezar, reúne la siguiente información:

• Un nombre único para la instantánea. El nombre de la instantánea de la acción debe ser único a nivel de la acción. Para obtener sugerencias sobre cómo denominar las instantáneas, consulte Denominación de instantáneas.
• El ID del recurso compartido de origen.
• Cualquier etiqueta que desee adjuntar a la instantánea.

Creación de una instantánea con la API

Puede crear mediante programación una instantánea de un archivo compartido llamando al método de la API shares/{share-id}/snapshots. El siguiente ejemplo crea una instantánea de un recurso compartido utilizando el ID del recurso compartido y especifica las etiquetas de usuario que se pueden asociar a una política de copia de seguridad.

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 respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente. El estado del ciclo de vida de la instantánea es pending mientras se crea la instantánea. Una vez creado correctamente, el estado cambia a « 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"
  }
}

Para las instantáneas de recursos compartidos de archivos regionales, el valor de zona está en blanco tanto en las respuestas de la CLI como en las de la API.