Gérer le pool de stockage Hyperdisk

Ce document explique comment répertorier, décrire, modifier et supprimer des pools de stockage.

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

Rôles et autorisations requis

Pour obtenir les autorisations nécessaires pour gérer un pool de stockage, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

  • Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1)
  • Pour se connecter à une instance de VM pouvant être exécutée en tant que compte de service : Utilisateur du compte de service (v1) (rôle roles/iam.serviceAccountUser)

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour gérer un pool de stockage. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour gérer un pool de stockage :

  • Pour répertorier les pools de stockage d'un projet et d'une zone : compute.storagePools.list
  • Pour répertorier les disques d'un pool de stockage : compute.storagePools.get
  • Pour afficher les propriétés d'un pool de stockage : compute.storagePools.get
  • Pour mettre à jour la capacité ou les performances provisionnées d'un pool de stockage :
    • compute.storagePools.get
    • compute.storagePools.update
  • Pour supprimer un pool de stockage : compute.storagePools.delete

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Limites

Tenez compte des limites suivantes lors de la gestion des pools de stockage Hyperdisk :

  • Vous pouvez modifier la performance ou la capacité provisionnée d'un pool de stockage au maximum deux fois au cours d'une période de 24 heures.
  • Vous ne pouvez pas modifier le modèle de provisionnement d'un pool, ni modifier un pool de stockage de capacité Standard en un pool de stockage de capacité Advanced, ni un pool de stockage de performances Advanced en un pool de stockage de performances Standard.
  • Il n'est pas possible de déplacer des disques dans ou hors d'un pool de stockage. Pour déplacer un disque dans un pool de stockage ou en dehors, vous devez le recréer à partir d'un instantané. Pour en savoir plus, consultez la page Modifier le type de disque.
  • Vous ne pouvez pas cloner de disques, en créer des instantanés immédiats ni en configurer la réplication asynchrone sur disque persistant dans un pool de stockage.
  • Vous pouvez supprimer au maximum cinq pools de stockage par heure.
  • La commande de gestion du pool de stockage réussit ou échoue immédiatement, mais l'exécution de l'action peut prendre jusqu'à 5 minutes, et jusqu'à 30 minutes pour que les modifications apparaissent.

Pour obtenir la liste complète des limites des pools de stockage Hyperdisk, consultez la page Limites des pools de stockage.

Plages de valeurs lors de la modification des pools de stockage

Lorsque vous créez un pool de stockage, les nouvelles valeurs de taille, d'IOPS et de débit doivent être comprises dans les limites du type de pool de stockage que vous modifiez. De plus, vous ne pouvez spécifier de nouvelles valeurs qu'à l'aide de valeurs incrémentielles acceptées.

Pour connaître les limites détaillées de provisionnement des performances, consultez la section Limites applicables aux pools de stockage.

Répertorier les pools de stockage d'un projet

Pour afficher les pools de stockage créés dans un projet, utilisez la console Google Cloud, Google Cloud CLI ou REST.

Console

  1. Accédez à la page Pools de stockage de la console Google Cloud.
    Accéder à la page Pools de stockage

    La page affiche les pools de stockage créés dans le projet sélectionné.

  2. Facultatif : Utilisez la barre Filtre pour n'afficher que les pools de stockage qui correspondent aux paramètres de filtre, tels que l'emplacement, le type, le nom et la capacité restante du pool.

gcloud

Pour répertorier tous les pools de stockage créés dans le projet actuel, utilisez la commande gcloud compute storage-pools list.

gcloud compute storage-pools list

Pour limiter les résultats à une région ou une zone spécifique, vous pouvez utiliser l'option --filter, par exemple :

  • --filter="zone ~ us
  • --filter="zone=us-east4-c"

REST

Pour afficher les pools de stockage créés dans un projet et une zone, envoyez une requête GET à l'aide de la méthode storagePools.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet contenant le pool de stockage
  • ZONE : zone où se trouve le pool de stockage, par exemple, us-central1-a.

Répertorier les disques d'un pool de stockage

Pour obtenir la liste des disques créés dans un pool de stockage, utilisez la console Google Cloud, Google Cloud CLI ou REST.

Console

  1. Accédez à la page Pools de stockage de la console Google Cloud.
    Accéder à la page Pools de stockage

    La page affiche les pools de stockage créés dans le projet sélectionné.

  2. Dans le champ Nom, cliquez sur le nom du pool de stockage que vous souhaitez afficher.

    La page Gérer le pool de stockage s'ouvre.

  3. Dans la section Disques de pool de stockage, vous pouvez voir les disques créés dans le pool de stockage.

gcloud

Pour répertorier les disques créés dans un pool de stockage, utilisez la commande gcloud compute storage-pools list-disks.

gcloud compute storage-pools list-disks STORAGE_POOL_NAME  \
    [--zone=ZONE]

Remplacez les éléments suivants :

  • STORAGE_POOL_NAME : nom du pool de stockage.
  • ZONE : facultatif. Zone dans laquelle se trouve le pool de stockage, par exemple, us-central1-a.

REST

Pour répertorier les disques qui utilisent un pool de stockage, envoyez une requête GET à l'aide de la méthode storagePools.listDisks.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME/listDisks

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet contenant le pool de stockage
  • ZONE : zone où se trouve le pool de stockage, par exemple, us-central1-a.
  • STORAGE_POOL_NAME : nom du pool de stockage.

Décrire un pool de stockage

Pour afficher les détails d'un pool de stockage, vous pouvez utiliser la console Google Cloud, Google Cloud CLI ou REST.

Console

  1. Accédez à la page Pools de stockage de la console Google Cloud.
    Accéder à la page Pools de stockage

  2. Pour chaque pool de stockage répertorié sur la page, vous pouvez afficher les informations suivantes :

    • État
    • Nom
    • Emplacement
    • Type de pool
    • Capacité du pool
    • Capacité restante du pool
    • IOPS du pool
    • IOPS de pool restants
    • Nombre de disques créés dans le pool

  3. Dans le champ Nom, cliquez sur le nom du pool de stockage que vous souhaitez afficher.

    La page Gérer le pool de stockage s'ouvre.

  4. Dans les tuiles situées en haut de la page, vous pouvez afficher la capacité provisionnée et utilisée, ainsi que le débit et les IOPS provisionnés et utilisés pour le pool de stockage.

  5. Dans la section Paramètres du pool de stockage, vous pouvez afficher des propriétés supplémentaires du pool de stockage, telles que l'heure de création, le type de provisionnement de capacité, le type de provisionnement de performances, le nombre total de disques dans le pool de stockage et les pourcentages d'utilisation pour la capacité, le débit et les IOPS.

  6. Dans la section Disques de pool de stockage, vous pouvez afficher des informations sur les disques créés dans le pool de stockage.

gcloud

Exécutez la commande gcloud compute storage-pools describe pour afficher les détails d'un pool de stockage.

gcloud compute storage-pools describe STORAGE_POOL_NAME  \
    [--zone=ZONE]

Remplacez les éléments suivants :

  • STORAGE_POOL_NAME : nom unique du pool de stockage.
  • ZONE : facultatif. Zone dans laquelle se trouve le pool de stockage, par exemple, us-central1-a.

REST

Pour récupérer des détails sur un pool de stockage, envoyez une requête GET à l'aide de la méthode storagePools.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet contenant le pool de stockage
  • ZONE : zone où se trouve le pool de stockage, par exemple us-central1-a
  • STORAGE_POOL_NAME : nom du pool de stockage

Mettre à jour la capacité, les IOPS ou le débit provisionnés d'un pool de stockage

Vous pouvez augmenter ou diminuer la capacité provisionnée, les IOPS ou le débit d'un pool de stockage. Pour augmenter la capacité, les IOPS ou le débit d'un pool de stockage, vous devez disposer d'un quota pour le projet et la région.

Console

  1. Accédez à la page Pools de stockage de la console Google Cloud.
    Accéder à la page Pools de stockage

  2. Dans le champ Nom, cliquez sur le nom du pool de stockage que vous souhaitez modifier.

    La page Gérer le pool de stockage s'ouvre.

  3. Cliquez sur Modifier.

    La page Modifier le pool de stockage s'ouvre.

  4. Facultatif : dans le champ Capacité du pool de stockage, saisissez la nouvelle valeur de la capacité provisionnée du pool. La nouvelle valeur doit être au moins égale à 1 Tio et inférieure ou égale à 100 Tio par rapport à la valeur actuelle. La taille minimale ne peut pas être inférieure à 10 Tio et la taille maximale ne peut pas dépasser 1 024 Tio.

  5. Facultatif : dans le champ Débit provisionné, saisissez la nouvelle valeur du débit provisionné.

  6. Facultatif : pour les pools de stockage de type Hyperdisk Balanced, dans le champ IOPS provisionnées, saisissez la nouvelle valeur des IOPS provisionnées.

  7. Cliquez sur Enregistrer pour mettre à jour le pool de stockage.

gcloud

Utilisez la commande gcloud compute storage-pools update pour modifier un pool de stockage.

gcloud compute storage-pools update STORAGE_POOL_NAME  \
    --zone=ZONE   \
    --provisioned-capacity=POOL_SIZETiB   \
    --provisioned-iops=IOPS   \
    --provisioned-throughput=THROUGHPUT   \
    --description=DESCRIPTION

Remplacez les éléments suivants :

  • STORAGE_POOL_NAME : nom du pool de stockage.
  • ZONE (facultatif) : zone dans laquelle se trouve le pool de stockage, par exemple us-central1-a.
  • POOL_SIZE : (facultatif) capacité provisionnée du pool de stockage, en Tio.
  • IOPS : (facultatif) IOPS provisionnées par le pool de stockage. Vous ne pouvez utiliser cette option qu'avec des pools de stockage avec équilibrage Hyperdisk.
  • THROUGHPUT : (facultatif) débit provisionné pour le pool de stockage, en Mbit/s.
  • DESCRIPTION : (facultatif) chaîne descriptive pour le pool de stockage.

REST

Pour mettre à jour un pool de stockage, envoyez une requête PATCH à l'aide de la méthode storagePools.update.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

{
    "description": "DESCRIPTION",
    "poolProvisionedCapacityGb": "SIZE",
    "poolProvisionedIops": "IOPS",
    "poolProvisionedThroughput": "THROUGHPUT"
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet
  • ZONE : zone où se trouve le pool de stockage, par exemple, us-central1-a.
  • STORAGE_POOL_NAME : nom du pool de stockage.
  • DESCRIPTION : (facultatif) champ de texte permettant de décrire le pool de stockage.
  • SIZE : (facultatif) nouvelle capacité provisionnée du pool de stockage, en Gio.
  • IOPS : (facultatif) nouvelle valeur des IOPS provisionnées pour le pool de stockage. Vous ne pouvez spécifier cette propriété que lorsque le pool de stockage contient des disques de type hyperdisk-balanced.
  • THROUGHPUT : (facultatif) nouvelle valeur du débit provisionné du pool de stockage, spécifiée en Mbit/s.

Supprimer un pool de stockage

Pour supprimer un pool de stockage, vous devez d'abord supprimer tous les disques qu'il contient. Vous pouvez ensuite supprimer le pool de stockage à l'aide de la console Google Cloud, de Google Cloud CLI ou de REST.

La suppression d'un pool de stockage est irréversible. Toutefois, la suppression d'un pool de stockage ne supprime pas les instantanés créés à partir des disques créés dans le pool de stockage. Vous devez supprimer les instantanés séparément.

Console

  1. Accédez à la page Pool de stockage de la console Google Cloud.
    Accéder à la page Pool de stockage

  2. Dans le champ Nom, cliquez sur le nom du pool de stockage que vous souhaitez supprimer.

    La page Gérer le pool de stockage s'ouvre.

  3. Dans la section Disques de pool de stockage, vérifiez qu'aucun disque n'est répertorié pour le pool de stockage.

  4. Cliquez sur Supprimer le pool.

gcloud

Exécutez la commande gcloud compute storage-pools delete pour supprimer un pool de stockage.

gcloud compute storage-pools delete STORAGE_POOL_NAME  \
    --zone=ZONE   \

Remplacez les éléments suivants :

  • STORAGE_POOL_NAME : nom unique du pool de stockage.
  • ZONE (facultatif) : zone dans laquelle se trouve le pool de stockage, par exemple us-central1-a.

REST

Pour supprimer un pool de stockage, envoyez une requête DELETE pour la méthode storagePools.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet
  • ZONE : zone où se trouve le pool de stockage, par exemple, us-central1-a.
  • STORAGE_POOL_NAME : nom unique du pool de stockage.

Étape suivante