Obtenir des informations sur les snapshots de worker nodes

Vous pouvez obtenir des informations sur les snapshots de vos worker nodes au niveau d’un projet, avec l’une de nos CLI.

Obtenir des informations sur les snapshots de worker nodes avec octl

À ce jour, cette section est disponible en anglais uniquement.

The GetProjectSnapshots command retrieves the snapshot details for a specific project by its ID. Returns the snapshot information associated with the specified project.

Request sample
$ octl kube api GetProjectSnapshots <project_id> --profile "default"

The GetProjectSnapshots command returns the following elements:

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the API request.

  • Snapshots: Snapshot details associated with the project.

    • VolumeSize: The size of the volume used to create the snapshot, in gibibytes (GiB).

    • AccountId: The account ID of the owner of the snapshot.

    • VolumeId: The ID of the volume used to create the snapshot.

    • CreationDate: The date and time (UTC) at which the snapshot was created.

    • Progress: The progress of the snapshot, as a percentage.

    • SnapshotId: The ID of the snapshot.

    • State: The state of the snapshot (in-queue | pending | completed | error | deleting).

    • Description: The description of the snapshot.

    • Tags: One or more tags associated with the snapshot.

      • Key: The key for the tag.

      • Value: The value for the tag.

    • PermissionsToCreateVolume: Permissions for the resource.

      • GlobalPermission: A global permission for all accounts.

      • AccountIds: One or more account IDs that the permission is associated with.

Result sample
{
  "ResponseContext": {
    "RequestId": "string"
  },
  "Snapshots": [
    {
      "VolumeSize": 0,
      "AccountId": "string",
      "VolumeId": "string",
      "CreationDate": "string",
      "Progress": 0,
      "SnapshotId": "string",
      "State": "string",
      "Description": "string",
      "Tags": [
        {
          "Key": "string",
          "Value": "string"
        }
      ],
      "PermissionsToCreateVolume": {
        "GlobalPermission": 0,
        "AccountIds": [
          "string"
        ]
      }
    }
  ]
}

Obtenir des informations sur les snapshots de worker nodes avec OKS CLI

Avant de commencer : Installez et configurez OKS CLI. Pour en savoir plus, voir Installer et configurer OKS CLI.

La commande project snapshots vous permet de récupérer la liste des snapshots de vos worker nodes au niveau d’un projet :

Exemple de requête
$ oks-cli project snapshots \
    --project-name NAME_OF_PROJECT

Cette commande contient l’option suivante que vous devez spécifier :

  • project-name : Le nom du projet depuis lequel vous souhaitez obtenir des informations sur les snapshots.

  • (optionnel) output : Le format de sortie de la réponse (json| yaml). Par défaut, le format de la réponse est JSON.

La commande project snapshots renvoie les éléments suivants :

  • VolumeSize : La taille du volume, en gibioctets (Gio).

  • AccountId : L’identifiant unique du compte OUTSCALE où l’infrastructure du projet (comme le VPC et les node pools) est déployée.

  • VolumeId : L’ID du volume.

  • CreationDate : La date et l’heure de la création du snapshot, au format ISO 8601.

  • Progress : La progression du snapshot (en pourcentage).

  • SnapshotId : L’ID du snapshot.

  • State : L’état du snapshot (in-queue | pending | completed).

  • Description : La description du snapshot.

  • Tags : Un ou plusieurs tags associés au volume. Cet élément contient les informations suivantes :

    • Key : La clé du tag.

    • Value : La valeur du tag.

  • PermissionsToCreateVolume : Les permissions pour la ressource. Cet élément contient les informations suivantes :

    • GlobalPermission : Le nombre de permissions globales pour tous les comptes OUTSCALE.

    • AccountIds : Un ou plusieurs ID de comptes OUTSCALE qui sont associés à la permission.

Exemple de résultat
[
    {
        "VolumeSize": 4,
        "AccountId": "123456789012",
        "VolumeId": "vol-12345678",
        "CreationDate": "2025-07-08T11:38:03.131Z",
        "Progress": 100,
        "SnapshotId": "snap-87654321",
        "State": "completed",
        "Description": "Created by Outscale BSU CSI driver for volume vol-12345678",
        "Tags": [
            {
                "Key": "CSIVolumeSnapshotName",
                "Value": "snapshot-12345678-1234-4321-1234-123456789123"
            }
        ],
        "PermissionsToCreateVolume": {
            "GlobalPermission": 0,
            "AccountIds": []
        }
    }
]

Pages connexes

Méthode API correspondante