Afficher les détails du disque

Une fois que vous avez créé un disque persistant ou un hyperdisque dans Compute Engine, vous pouvez consulter des informations sur sa configuration. Vous pouvez utiliser ces informations pour surveiller les performances des disques, renforcer la sécurité des données et optimiser votre stockage et vos coûts. Ce document explique comment afficher les informations essentielles suivantes sur les disques :

  • Liste de tous les disques disponibles dans un projet, y compris ceux qui ne sont pas associés à une instance
  • Instances associées
  • Indique si un disque sera automatiquement supprimé avec son instance.
  • Mode d'accès
  • Métriques de performances concernant le débit et les opérations d'entrée/sortie par seconde (IOPS)
  • Informations sur le chiffrement

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification permet 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. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    2. Set a default region and zone.

    REST

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

      Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

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

Afficher tous les disques d'un projet

Pour obtenir une vue complète de vos ressources de stockage, vous pouvez lister tous les disques d'un projet, y compris ceux qui ne sont pas associés à une instance.

Console

Dans la console Google Cloud , accédez à la page Disques.

Accéder à la page Disques

La page Disques liste tous les disques de votre projet.

gcloud

Exécutez la commande disks list

gcloud compute disks list

Résultat de la commande

Liste de tous les volumes Persistent Disk et Hyperdisk de votre projet.

Pour afficher les disques d'une région ou d'une zone spécifique, utilisez l'option --zone ou --region pour spécifier l'emplacement.

REST

Envoyez une requête POST à la méthode compute.disks.aggregatedList.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/disks/

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.

Réponse de requête

Liste de tous les volumes Persistent Disk et Hyperdisk de votre projet.

Afficher les instances auxquelles un disque est associé

Comprenez comment votre disque est utilisé et évitez d'accumuler des coûts liés aux disques inutilisés en identifiant les instances auxquelles il est associé.

Console

  1. Dans la console Google Cloud , accédez à la page Disques.

    Accéder à la page Disques

  2. Dans la colonne Nom, cliquez sur le nom du disque.

  3. Dans le tableau Propriétés, la ligne Utilisé par liste toutes les instances associées au disque.

gcloud

Exécutez la commande gcloud compute disks describe

    gcloud compute disks describe DISK_NAME 

      --zone=ZONE
      --format="json(users)"

Remplacez les éléments suivants :

  • ZONE : la zone où se trouve le disque.
  • DISK_NAME: Nom du disque.

Résultat de la commande

Si le résultat est null, le disque n'est associé à aucune instance. Sinon, le résultat est un objet JSON contenant un champ nommé users. Le champ users liste les URL de toutes les instances qui utilisent le disque.

REST

Envoyez une requête POST à la méthode compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • ZONE : la zone où se trouve le disque.
  • DISK_NAME: Nom du disque.

Réponse de requête

La réponse REST est un objet JSON contenant un champ nommé users.

Si la valeur du champ users est null, le disque n'est associé à aucune instance. Sinon, l'objet "users" liste les URL de toutes les instances qui utilisent le disque.

Afficher si la suppression automatique est activée pour un disque

Pour éviter toute perte de données accidentelle, vérifiez si votre disque de démarrage ou non sera supprimé lorsque vous supprimerez l'instance associée.

Par défaut, l'option autoDelete est activée pour les disques de démarrage. Cela signifie que la suppression d'une instance entraîne également la suppression du disque de démarrage qui y est associé. Toutefois, vous pouvez remplacer ce paramètre si vous souhaitez conserver le disque de démarrage associé. Les disques non bootables seront également supprimés si l'option autoDelete est activée.

Console

  1. Dans la console Google Cloud , accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Dans la colonne Nom, cliquez sur le nom de l'instance.

  3. Dans la section Stockage, accédez à la colonne Lors de la suppression de l'instance. When deleting instance peut avoir l'une des valeurs suivantes :

    • Supprimer le disque : le disque sera supprimé avec l'instance.
    • Conserver le disque : le disque ne sera pas supprimé avec l'instance.

gcloud

Exécutez la commande gcloud compute disks describe

    gcloud compute disks describe DISK_NAME 

      --zone=ZONE

Remplacez les éléments suivants :

  • ZONE : la zone où se trouve le disque.
  • DISK_NAME: Nom du disque.

Résultat de la commande

Objet JSON contenant un champ nommé autoDelete. autoDelete indique si le disque sera supprimé avec l'instance à laquelle il est associé. Il peut prendre l'une des valeurs suivantes :

  • true : le disque sera supprimé avec l'instance.
  • false : le disque ne sera pas supprimé avec l'instance.

REST

Envoyez une requête POST à la méthode compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • ZONE : la zone où se trouve le disque.
  • DISK_NAME: Nom du disque.

Réponse de requête

Objet JSON contenant un champ nommé autoDelete. autodelete indique si le disque sera supprimé avec l'instance à laquelle il est associé. Il peut prendre l'une des valeurs suivantes :

  • true : le disque sera supprimé avec l'instance.
  • false : le disque ne sera pas supprimé avec l'instance.

Afficher l'espace disque restant

Pour afficher l'espace restant sur un disque sans vous connecter à l'instance associée, vous devez installer l'agent Ops sur vos instances. L'agent Ops fournit des métriques supplémentaires pour bytes_used (octets de disque utilisés) et percent_used (utilisation du disque).

Pour en savoir plus sur la surveillance de l'espace disque, consultez Métriques de l'agent Ops.

Afficher le mode d'accès d'un volume Hyperdisk

Le mode d'accès détermine si un volume Hyperdisk peut être associé à plusieurs instances et si les instances associées ont un accès en lecture seule ou en lecture/écriture au disque.

Console

  1. Dans la console Google Cloud , accédez à la page Disques.

    Accéder à la page Disques

  2. Dans la colonne Nom, cliquez sur le nom du disque.

  3. Dans le tableau Propriétés, la ligne intitulée Mode d'accès décrit comment les instances peuvent accéder aux données sur le disque. Elle peut prendre l'une des valeurs suivantes :

    • Une seule VM en mode lecture/écriture (par défaut), pour un accès en lecture/écriture à partir d'une instance.
    • Plusieurs VM en mode lecture/écriture, pour un accès en lecture/écriture à partir de plusieurs instances.
    • Plusieurs VM en lecture seule : pour un accès en lecture seule à partir de plusieurs instances.

gcloud

Exécutez la commande gcloud compute disks describe

    gcloud compute disks describe DISK_NAME 

      --zone=ZONE 

      --format="json(accessMode)"

Remplacez les éléments suivants :

  • ZONE : la zone où se trouve le disque.
  • DISK_NAME: Nom du disque.

Résultat de la commande

Objet JSON contenant un champ nommé accessMode. accessMode décrit comment les instances peuvent accéder aux données sur le disque. Il peut s'agir de l'une des valeurs suivantes :

  • READ_ONLY_MANY, pour un accès en lecture seule à partir de plusieurs instances.
  • READ_WRITE_MANY, pour un accès en lecture/écriture à partir de plusieurs instances.
  • READ_WRITE_SINGLE, pour un accès en lecture/écriture à partir d'une instance.

REST

Envoyez une requête POST à la méthode compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • ZONE : la zone où se trouve le disque.
  • DISK_NAME : le nom du disque

Réponse de requête

La réponse REST est un objet JSON contenant un champ nommé accessMode. accessMode décrit comment les instances peuvent accéder aux données sur le disque. Il peut s'agir de l'une des valeurs suivantes :

  • READ_ONLY_MANY, pour un accès en lecture seule à partir de plusieurs instances.
  • READ_WRITE_MANY, pour un accès en lecture/écriture à partir de plusieurs instances.
  • READ_WRITE_SINGLE, pour un accès en lecture/écriture à partir d'une instance.

Déterminer si un disque fonctionne comme prévu

Les disques sont soumis à des limites concernant le nombre maximal d'IOPS et le débit maximal qu'ils peuvent atteindre. Ces limites dépendent de la taille du disque et de l'instance connectée. Les performances maximales d'un disque ne peuvent pas dépasser les limites de l'instance à laquelle il est associé.

Pour déterminer si un volume Hyperdisk ou Persistent Disk fonctionne au niveau attendu en fonction de sa taille et de l'instance à laquelle il est associé, procédez comme suit :

  1. Vérifiez les performances provisionnées ou maximales du disque.
  2. Comparez les performances provisionnées ou maximales aux performances réelles du disque.

La procédure à suivre pour vérifier les performances provisionnées ou maximales d'un disque dépend de son type (Hyperdisk ou Persistent Disk).

Afficher les performances provisionnées d'un Hyperdisk

Pour afficher les valeurs des IOPS et du débit provisionnés pour un volume Hyperdisk, consultez Afficher les paramètres de performances provisionnés pour Hyperdisk.

Afficher les performances maximales d'un disque persistant

Les volumes Persistent Disk sont soumis à des limites de débit et d'IOPS par Gio et par instance qu'ils peuvent gérer. Les sections suivantes fournissent des informations détaillées sur les limites de performances pour les disques persistants zonaux et régionaux :

Les disques persistants avec équilibrage et les disques persistants SSD (performances) offrent également des performances de référence pour les IOPS et le débit soutenus. Pour calculer les valeurs maximales d'IOPS et de débit pour un volume de disque persistant avec équilibrage ou de disque persistant SSD, utilisez l'équation suivante :

Maximum expected performance = Baseline performance + (Per GiB performance limit * Combined disk size in GiB)

Pour en savoir plus, consultez Performances de référence.

Afficher les performances réelles d'un disque

Pour afficher les performances d'IOPS et de débit d'un disque, utilisez la console Google Cloud .

Console

  1. Dans la console Google Cloud , accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Dans la colonne Nom, cliquez sur le nom de la VM à laquelle le disque est associé.

  3. Cliquez sur Observabilité.

  4. Dans le menu, sélectionnez Disque > Performances.

    Des graphiques illustrant les performances d'IOPS et de débit du disque s'affichent. Pour afficher tous les graphiques, vous devez installer l'agent Ops.

Pour afficher un rapport plus détaillé sur les performances d'un disque, consultez Examiner les métriques de performances des disques.

Si le disque ne fonctionne pas comme prévu, consultez les conseils de la section Surveiller l'état d'un disque.

Afficher les informations relatives au chiffrement d'un disque

Les disques Compute Engine sont chiffrés avec l'un des types de clés de chiffrement suivants :

  • Google-owned and managed keys
  • Clés de chiffrement gérées par le client (CMEK)
  • Clés de chiffrement fournies par le client (CSEK)

Par défaut, Compute Engine utilise Google-owned and managed keys.

Console

  1. Dans la console Google Cloud , accédez à la page Disques.

    Accéder à la page Disques

  2. Dans la colonne Nom, cliquez sur le nom du disque.

  3. Dans le tableau Propriétés, la ligne Chiffrement indique le type de chiffrement : géré par Google, géré par le client ou fourni par le client.

gcloud

Exécutez la commande gcloud compute disks describe

    gcloud compute disks describe DISK_NAME 

      --zone=ZONE 

      --format="json(diskEncryptionKey)"

Remplacez les éléments suivants :

  • ZONE : la zone où se trouve le disque.
  • DISK_NAME: Nom du disque.

Résultat de la commande

Si le résultat est null, le disque utilise un Google-owned and managed key.

Sinon, le résultat est un objet JSON.

Si l'objet JSON contient un champ nommé diskEncryptionKey, le disque est chiffré. L'objet diskEncryptionKey contient des informations indiquant si le disque est chiffré avec une clé CMEK ou CSEK :

  • Si la propriété diskEncryptionKey.kmsKeyName est présente, le disque est chiffré avec une CMEK. La propriété kmsKeyName indique le nom de la clé spécifique utilisée pour chiffrer le disque : 
    {
  "diskEncryptionKey": {
    "kmsKeyName": "projects/my-proj/.."
  }
}
  • Si la propriété diskEncryptionKey.sha256 est présente, le disque est chiffré par CSEK. La propriété sha256 correspond au hachage SHA-256 de la clé de chiffrement fournie par le client qui protège le disque. 
      {
    "diskEncryptionKey": {
      "sha256": "abcdefghijk134560459345dssfd"
    }
  }

REST

Envoyez une requête POST à la méthode compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • ZONE : la zone où se trouve le disque.
  • DISK_NAME : le nom du disque

Réponse de requête

Si la réponse est null, le disque utilise un Google-owned and managed key.

Sinon, la réponse est un objet JSON.

Si l'objet JSON contient un champ nommé diskEncryptionKey, le disque est chiffré. L'objet diskEncryptionKey contient des informations indiquant si le disque est chiffré avec une clé CMEK ou CSEK :

  • Si la propriété diskEncryptionKey.kmsKeyName est présente, le disque est chiffré avec une CMEK. La propriété kmsKeyName indique le nom de la clé spécifique utilisée pour chiffrer le disque : 
    {
  "diskEncryptionKey": {
    "kmsKeyName": "projects/my-proj/.."
  }
}
  • Si la propriété diskEncryptionKey.sha256 est présente, le disque est chiffré par CSEK. La propriété sha256 correspond au hachage SHA-256 de la clé de chiffrement fournie par le client qui protège le disque. 
      {
    "diskEncryptionKey": {
      "sha256": "abcdefghijk134560459345dssfd"
    }
  }

Si le disque utilise des CMEK, vous pouvez trouver des informations détaillées sur la clé, son trousseau et son emplacement en suivant les étapes décrites dans la section Afficher les clés par projet.

Si le disque utilise des CSEK, contactez l'administrateur de votre organisation pour plus d'informations sur la clé. En utilisant une CMEK, vous pouvez également voir quelles ressources cette clé protège avec le suivi de l'utilisation des clés. Pour en savoir plus, consultez la section Afficher l'utilisation des clés.

Afficher tous les détails d'un disque

Pour obtenir des informations générales sur votre disque, vous pouvez afficher toutes ses propriétés en même temps.

Console

  1. Dans la console Google Cloud , accédez à la page Disques.

    Accéder à la page Disques

  2. Dans la colonne Nom, cliquez sur le nom du disque.

    Le tableau Propriétés s'affiche avec un récapitulatif des informations de base sur le disque.

  3. Pour afficher des informations supplémentaires sur le disque, cliquez sur REST ÉQUIVALENT.

    Une boîte de dialogue s'affiche avec la réponse REST d'origine de l'API Compute Engine.

gcloud

Exécutez la commande gcloud compute disks describe

  gcloud compute disks describe DISK_NAME \
    --zone=ZONE

Remplacez les éléments suivants :

  • DISK_NAME: Nom du disque.
  • ZONE : la zone où se trouve le disque.

Résultat de la commande

Toutes les données associées au disque Compute Engine.

REST

Envoyez une requête POST à la méthode compute.disks.get.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • ZONE : la zone où se trouve le disque.
  • DISK_NAME : le nom du disque

Réponse de requête

La réponse REST contient toutes les données associées au disque Compute Engine.

Étapes suivantes