Gérer les pools Hyperdisk

Ce document explique comment lister, décrire, modifier et supprimer des pools Hyperdisk.

Avant de commencer

Rôles et autorisations nécessaires

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

  • Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1)
  • Pour vous 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 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. 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 :

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

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

Limites

Limites concernant la gestion des pools :

  • Vous ne pouvez pas modifier le modèle de provisionnement d'un pool. Par exemple, vous ne pouvez pas 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.
  • Vous ne pouvez pas déplacer des disques dans un pool ni les déplacer hors d'un pool. Pour déplacer un disque dans un pool 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 dans un pool.

Limites spécifiques aux pools de stockage :

  • Vous pouvez modifier la capacité ou les performances provisionnées d'un pool de stockage au maximum deux fois au cours d'une période de 24 heures.
  • 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.

Limites spécifiques aux Exapools :

  • Vous devez contacter l'équipe responsable de votre compte pour modifier la capacité, les IOPS ou le débit provisionnés d'un Exapool.
  • Vous devez contacter l'équipe chargée de votre compte pour supprimer un Exapool.

Pour obtenir la liste complète des limites, consultez les sections Limites des pools de stockage et Limites des exapools.

Plages de valeurs lors de la modification des pools

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 Limites applicables aux pools de stockage et Limites de taille et de performances pour les exapools.

Répertorier les pools d'un projet

Pour afficher les pools créés dans un projet, utilisez la consoleGoogle Cloud , la 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. Sélectionnez l'onglet Exapools ou Pools de stockage.

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

  3. Facultatif : Utilisez la barre Filtre pour n'afficher que les pools 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 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 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, par exemple us-central1-a.

Lister les disques d'un pool

Pour obtenir la liste des disques créés dans un pool, utilisez la consoleGoogle Cloud , la 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. Sélectionnez l'onglet Exapools ou Pools de stockage.

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

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

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

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

gcloud

Pour répertorier les disques créés dans un pool, 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.
  • ZONE : facultatif. Zone dans laquelle se trouve le pool, par exemple us-central1-a.

REST

Pour répertorier les disques qui utilisent un pool, 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, par exemple us-central1-a.
  • STORAGE_POOL_NAME : nom du pool.

Décrire un pool

Pour afficher les détails d'un pool, 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. Sélectionnez l'onglet Exapools ou Pools de stockage.

  3. Pour chaque pool listé 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

  4. Dans le champ Nom, cliquez sur le nom du pool que vous souhaitez afficher.

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

  5. 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.

  6. Dans la section Paramètres du pool de stockage, vous pouvez afficher des propriétés supplémentaires du pool, 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 et les pourcentages d'utilisation pour la capacité, le débit et les IOPS.

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

  8. Facultatif : Pour obtenir des informations supplémentaires sur l'utilisation du pool, vous pouvez cliquer sur l'onglet Surveillance pour afficher les graphiques de différentes métriques du pool. Pour en savoir plus, consultez Surveiller les pools.

gcloud

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

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

Remplacez les éléments suivants :

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

REST

Pour récupérer des détails sur un pool, 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
  • ZONE : zone où se trouve le pool, par exemple us-central1-a
  • STORAGE_POOL_NAME : nom du pool

Modifier un pool

Vous pouvez augmenter ou diminuer la capacité, les IOPS ou le débit provisionnés d'un pool.

Modifier 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. L'affichage des nouvelles valeurs de provisionnement pour le pool de stockage peut prendre jusqu'à 30 minutes.

Console

  1. Accédez à la page Pools de stockage de la console Google Cloud .
    Accéder à la page Pools de stockage
  2. Sélectionnez l'onglet Pools de stockage.

  3. 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.

  4. Cliquez sur Modifier.

    La page Modifier le pool de stockage s'ouvre.

  5. 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 différente de la valeur actuelle d'au moins 1 Tio et d'au plus 100 Tio. La nouvelle valeur peut être supérieure ou inférieure à la valeur actuelle. La taille minimale ne peut pas être inférieure à 10 Tio et la taille maximale ne peut pas dépasser 5 Pio.

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

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

  8. 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.
  • ZONE (facultatif) : zone dans laquelle se trouve le pool, par exemple us-central1-a.
  • POOL_SIZE : (facultatif) capacité provisionnée du pool, en Tio.
  • IOPS : (facultatif) IOPS provisionnées pour le pool. Vous ne pouvez utiliser cette option qu'avec des pools de stockage "Hyperdisk équilibré".
  • THROUGHPUT : (facultatif) débit provisionné du pool, en Mio/s.
  • DESCRIPTION : (facultatif) chaîne descriptive pour le pool.

REST

Pour mettre à jour un pool, 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, par exemple us-central1-a.
  • STORAGE_POOL_NAME : nom du pool.
  • DESCRIPTION : (facultatif) champ de texte permettant de décrire le pool.
  • SIZE : (facultatif) nouvelle capacité provisionnée du pool, en Gio.
  • IOPS : (facultatif) nouvelle valeur des IOPS provisionnées pour le pool. Vous ne pouvez spécifier cette propriété que lorsque le pool contient des disques de type hyperdisk-balanced.
  • THROUGHPUT : (facultatif) nouvelle valeur du débit provisionné du pool, spécifiée en Mio/s.

Modifier un Exapool

Pour modifier la capacité, les IOPS ou le débit provisionnés d'un Exapool, contactez l'équipe chargée de votre compte.

Supprimer un pool

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

Supprimer un pool de stockage

Pour supprimer un pool de stockage, vous devez d'abord supprimer tous les disques qu'il contient. Ensuite, utilisez la console Google Cloud , la Google Cloud CLI ou REST pour supprimer le pool de stockage.

Console

  1. Accédez à la page Pools de stockage de la console Google Cloud .
    Accéder à la page Pools de stockage
  2. 1. Sélectionnez l'onglet Pools de stockage.

  3. 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.

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

  5. Cliquez sur Supprimer le pool.

gcloud

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

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

Remplacez les éléments suivants :

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

REST

Pour supprimer un pool, 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, par exemple us-central1-a.
  • STORAGE_POOL_NAME : nom unique du pool.

Supprimer un Exapool

Pour supprimer un Exapool, contactez votre équipe chargée du compte.

Étape suivante