Avant de commencer

Avant de pouvoir utiliser l'interface de ligne de commande, vous devez installer l'interface de ligne de commande d'IBM Cloud et le plug-in de l'interface de ligne de commande du VPC. Pour plus d'informations, reportez-vous à la rubrique Configuration requise pour l'interface de ligne de commande.

Connectez-vous sur IBM Cloud®.

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

Cette commande renvoie une URL et des invites pour un code d'accès. Accédez à cette URL dans votre navigateur et connectez-vous. En cas de réussite, vous obtenez un code d'accès à usage unique. Copiez ce code et collez-le en réponse à l'invite. Une fois l'authentification réussie, vous êtes invité à choisir votre compte. Si vous avez accès à plusieurs comptes, sélectionnez celui avec lequel vous souhaitez vous connecter. Répondez à toutes les invites restantes pour terminer la connexion.

Avant de commencer, rassemblez les informations suivantes :

• Un nom unique pour l'instantané. Le nom de l'instantané du partage doit être unique au niveau du partage. Pour des recommandations de désignation de vos instantanés, voir Désignation des instantanés.
• Le nom ou l'ID du partage source.
• Toutes les étiquettes que vous souhaitez attacher à l'instantané.

Utilisez les commandes CLI suivantes pour collecter les informations dont vous avez besoin.

• ibmcloud is shares- Cette commande dresse la liste de tous les partages disponibles dans la région que vous avez sélectionnée. Localisez le partage dans la liste, vérifiez l'état ( available ).
• ibmcloud is share SHARE_ID- Utilisez cette commande avec l'ID de partage de la sortie de la commande précédente pour examiner les détails du partage. Si la sortie montre que le partage est disponible, attaché à une instance et non occupé, vous pouvez créer un instantané.

Conditions préalables à la création d'un instantané avec l'API

Vous pouvez créer une image instantanée en appelant l'API VPC. Avant de commencer, rassemblez les informations suivantes :

• Un nom unique pour l'instantané. Le nom de l'instantané du partage doit être unique au niveau du partage. Pour des recommandations de désignation de vos instantanés, voir Désignation des instantanés.
• L'ID du partage source.
• Toutes les étiquettes que vous souhaitez attacher à l'instantané.

Création d'un instantané à l'aide de l'API

Vous pouvez créer par programme un instantané d'un partage de fichiers en appelant la méthode de l'API shares/{share-id}/snapshots. L'exemple suivant crée un instantané d'un partage en utilisant l'ID du partage, et spécifie les balises utilisateur qui peuvent être associées à une politique de sauvegarde.

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"
  ]
}'

Une réponse réussie ressemble à celle de l'exemple ci-après. L'état du cycle de vie de l'image instantanée est pending lors de la création de l'image instantanée. Une fois la création effectuée, le statut passe à « 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"
  }
}

Pour les instantanés de partages de fichiers régionaux, la valeur de la zone est vide dans les réponses de la CLI et de l'API.