Afficher les réservations

Ce document explique comment afficher les réservations.

Avant de commencer

  • Consultez les exigences et restrictions applicables aux réservations.
  • 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 comme suit :

    Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

    Console

    Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.

    gcloud

    1. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init
    2. Définissez une région et une zone par défaut.

    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.

      Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher des réservations partagées, demandez à votre administrateur de vous accorder le rôle IAM Administrateur de Compute (roles/compute.admin) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ce rôle prédéfini contient les autorisations requises pour afficher les réservations. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les réservations :

  • Pour afficher la liste des réservations : compute.reservations.list sur le projet
  • Pour afficher les détails d'une réservation : compute.reservations.get sur le projet

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

Afficher les réservations

Vous ne pouvez afficher que les réservations qui ont été créées par votre projet actuel.

Seul le projet propriétaire peut afficher une réservation partagée. Si vous souhaitez afficher les projets avec lesquels une réservation partagée est partagée, affichez les détails de la réservation.

Afficher la liste de vos réservations

Pour afficher la liste de vos réservations, utilisez la console Google Cloud, la CLI gcloud ou REST.

Console

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

Accéder à la page "Réservations"

La page Réservations s'affiche.

Dans le tableau, chaque ligne décrit une réservation et chaque colonne décrit une propriété. Par exemple, la colonne Machines utilisées décrit l'utilisation et la capacité totale de chaque réservation. La valeur de 25 (50) représente une réservation pour 50 VM sur lesquelles 25 de ces VM ont été consommés.

Facultatif : Pour modifier les réservations et les propriétés affichées, utilisez respectivement Filtre et Options d'affichage des colonnes.

gcloud

Pour afficher la liste de vos réservations, utilisez la commande gcloud compute reservations list :

gcloud compute reservations list \
    --project=PROJECT_ID

Remplacez PROJECT_ID par l'ID du projet dans lequel se trouvent vos réservations.

La sortie devrait ressembler à l'exemple suivant :

NAME: r-01
IN_USE_COUNT: 0
COUNT: 5
ZONE: us-central1-a
SHARE_TYPE: LOCAL

NAME: r-02
IN_USE_COUNT: 3
COUNT: 10
ZONE: us-central1-f
SHARE_TYPE: LOCAL

Vous pouvez également spécifier l'option --filter pour affiner une liste de réservations à l'aide d'une expression de filtre.

gcloud compute reservations list \
    --filter="FILTER_EXPRESSION" \
    --project=PROJECT_ID

Remplacez les éléments suivants :

  • FILTER_EXPRESSION : expression de filtre.

  • PROJECT_ID : ID du projet dans lequel se trouvent vos réservations.

Par exemple, pour n'afficher que les réservations dont le nom commence par prefix et qui se trouvent dans la zone us-central1-a, exécutez la commande suivante:

gcloud compute reservations list \
    --filter="name~prefix AND zone=us-central1-a" \
    --project=example-project

REST

Pour afficher la liste de vos réservations, envoyez une requête GET à la méthode reservations.list.

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouvent vos réservations.

  • ZONE : zone où se trouvent vos réservations.

Le résultat ressemble à celui de l'exemple ci-dessous.

{
  "id": "4100668622331754141",
  "creationTimestamp": "2019-09-27T08:21:14.707-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-05",
  "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a",
  "name": "reservation-05",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2",
      "minCpuPlatform": "Any CPU Platform",
    },
    "count": "100",
    "inUseCount": "0"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation"
},
{
  "id": "2533514314332214789",
  "creationTimestamp": "2019-09-27T08:21:14.707-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04",
  "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a",
  "name": "reservation-04",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-tesla-k80",
          "acceleratorCount": 1
        }
      ],
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation"
}

Vous pouvez éventuellement affiner la liste des réservations à l'aide d'une expression de filtre en exécutant la requête GET suivante:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouvent vos réservations.

  • ZONE : zone où se trouvent vos réservations.

  • FILTER_EXPRESSION : expression de filtre.

Par exemple, pour n'afficher que les réservations dont le nom commence par prefix et qui se trouvent dans la zone us-central1-a, exécutez la requête GET suivante en utilisant les valeurs encodées en URL:

GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations?filter=name%7Eprefix%20AND%20zone=us-central1-a

Afficher les détails d'une réservation

Pour afficher les détails d'une réservation, utilisez la console Google Cloud, la CLI gcloud ou REST.

Console

Pour afficher les détails d'une réservation, procédez comme suit :

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

    Accéder à la page "Réservations"

    La page Réservations s'affiche.

  2. Dans la colonne Nom, cliquez sur le nom de la réservation que vous souhaitez décrire.

    La page de détails de la réservation s'affiche. Pour déterminer l'utilisation d'une réservation, consultez les champs Nombre total de machines réservées et Nombre de machines utilisées.

gcloud

Pour afficher les détails d'une réservation, utilisez la commande gcloud compute reservations describe.

gcloud compute reservations describe RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Remplacez les éléments suivants :

  • RESERVATION_NAME : nom d'une réservation existante.

  • PROJECT_ID : ID du projet dans lequel se trouve la réservation.

  • ZONE : zone où se trouve la réservation.

La sortie devrait ressembler à l'exemple suivant :

kind: compute#reservation
name: reservation-04
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04
specificReservation:
  count: '50'
  inUseCount: '25'
  instanceProperties:
    guestAccelerators:
    - acceleratorCount: 1
      acceleratorType: nvidia-tesla-k80
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-2
    minCpuPlatform: Any CPU Platform
specificReservationRequired: false
status: READY
zone: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a

Pour déterminer l'utilisation d'une réservation, consultez les champs count et inUseCount. Dans cet exemple, 50 VM sont réservées et 25 VM ont été consommées.

REST

Pour afficher les détails d'une réservation, envoyez une requête GET à la méthode reservations.get.

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouve la réservation.

  • ZONE : zone où se trouve la réservation.

  • RESERVATION_NAME : nom d'une réservation existante.

La sortie devrait ressembler à l'exemple suivant :

{
  "id": "2533514314332214789",
  "creationTimestamp": "2019-09-27T08:21:14.707-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04",
  "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-centra1-a",
  "name": "reservation-04",
  "specificReservationRequired": false,
  "status": "READY",
  "kind": "compute#reservation",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n1-standard-2",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-tesla-k80",
          "acceleratorCount": 1
        }
      ],
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25"
  }
}

Pour déterminer l'utilisation d'une réservation, consultez les champs count et inUseCount. Dans cet exemple, 50 VM sont réservées et 25 VM ont été consommées.

Étapes suivantes