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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- 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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
Rôles requis
Pour obtenir les autorisations nécessaires pour modifier des réservations, 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-t4",
"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 une liste de 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 :
Dans la console Google Cloud, accédez à la page Réservations.
Accéder à la page "Réservations"
La page Réservations s'affiche.
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-t4
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-t4",
"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
- Découvrez comment associer des réservations à des engagements.
- Découvrez comment utiliser des réservations.
- Découvrez comment modifier des réservations.
- Découvrez comment supprimer des réservations.