Cette page explique comment afficher les images du système d'exploitation (OS) disponibles pour les instances de machines virtuelles (VM) qui exécutent des jobs Batch.
Plus précisément, cette page explique comment afficher la liste et les détails des images d'OS de VM. à partir de Batch. Pour en savoir plus sur les images d'OS de VM et pour les images d'OS de VM que vous pouvez utiliser avec Batch, consultez Présentation de l'environnement d'OS de VM Si vous souhaitez afficher d'autres images d'OS de VM, de Compute Engine ou d'images personnalisées, consultez la documentation sur les images Compute Engine.
Avant de commencer
- Si vous n'avez jamais utilisé Batch auparavant, consultez Premiers pas avec Batch et activez Batch en suivant la les conditions préalables pour les projets et les utilisateurs.
Afficher une liste d'images d'OS de VM issues de Batch
Vous pouvez afficher la liste de toutes les images d'OS de VM issues de Batch à l'aide de la gcloud CLI ou l'API Batch.
gcloud
Pour répertorier toutes les images d'OS de VM compatibles à partir de Batch, utilisez le
la commande gcloud compute images list
suivante:
gcloud compute images list \
--project=batch-custom-image \
--no-standard-images
- L'option
--project=batch-custom-image
est requise pour répertorier les images. à partir de Batch. - L'option
--no-standard-images
omet les images standards des Compute Engine. - Facultatif: si vous souhaitez afficher les données Batch obsolètes
images, incluez également l'option
--show-deprecated
.
Le résultat de chaque image d'OS de VM est semblable à celui-ci:
NAME: IMAGE_NAME
PROJECT: IMAGE_PROJECT_ID
FAMILY: IMAGE_FAMILY
...
Ce résultat inclut les valeurs suivantes :
IMAGE_NAME
: nom de l'image. Un nom d'image représente une version spécifique d'une image d'OS de VM. Par exemple, le nom d'imagebatch-debian-11-official-20230802-00-p00
Représente la version d'image-20230802-00-p00
(version du 2 août 2023) pour la famille d'imagesbatch-debian-11-official
IMAGE_PROJECT_ID
: le ID du projet du projet qui contient l'image. Par exemple, toutes les images de Les images par lot se trouvent dans le projetbatch-custom-image
.IMAGE_FAMILY
: famille de l'image. Une famille d'images comprend une ou plusieurs images spécifiques et représente type et version majeure de l'OS. Par exemple, la famille d'imagesbatch-debian-11-official
contient des images Batch basées sur la version 11 du système d'exploitation Debian depuis Compute Engine.
API
Pour répertorier toutes les images d'OS de VM compatibles à partir de Batch, assurez-vous que
la requête suivante à la méthode images.list
:
GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
- Le projet
batch-custom-image
est nécessaire pour répertorier les images par lot. - La
?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
omet les images obsolètes en utilisant Encodage sous forme d'URL pour définir le champfilter
sur(-deprecated:*) OR (deprecated.state="ACTIVE")
.- Facultatif: si vous souhaitez afficher les données Batch obsolètes
des images, supprimez le
?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22)
de requête.
- Facultatif: si vous souhaitez afficher les données Batch obsolètes
des images, supprimez le
Le résultat de chaque image d'OS de VM est semblable à celui-ci:
{
...
"name": "IMAGE_NAME",
...
"family": "IMAGE_FAMILY",
"selfLink": "https://www.googleapis.com/compute/v1/projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME",
...
}
Ce résultat inclut les valeurs suivantes :
IMAGE_NAME
: nom de l'image. Un nom d'image représente une version spécifique d'une image d'OS de VM. Par exemple, le nom d'imagebatch-debian-11-official-20230802-00-p00
Représente la version d'image-20230802-00-p00
(version du 2 août 2023) pour la famille d'imagesbatch-debian-11-official
IMAGE_PROJECT_ID
: le ID du projet du projet qui contient l'image. Par exemple, toutes les images de Les images par lot se trouvent dans le projetbatch-custom-image
.IMAGE_FAMILY
: famille de l'image. Une famille d'images comprend une ou plusieurs images spécifiques et représente type et version majeure de l'OS. Par exemple, la famille d'imagesbatch-debian-11-official
contient des images Batch basées sur la version 11 du système d'exploitation Debian depuis Compute Engine.
Afficher les détails d'une image d'OS de VM à partir de Batch
Vous pouvez afficher tous les détails d'une image d'OS de VM à l'aide de gcloud CLI ou de l'API Batch.
gcloud
Pour afficher les détails d'une image d'OS de VM à partir de Batch, utilisez le
Commande gcloud compute images describe
et spécifiez batch-custom-image
comme projet d'image:
gcloud compute images describe IMAGE_NAME --project=batch-custom-image
Remplacez IMAGE_NAME
par le nom du
l'image d'OS de VM de Batch que vous souhaitez décrire.
API
Pour afficher les détails d'une image d'OS de VM à partir de Batch, effectuez une
à
Méthode images.get
et spécifiez batch-custom-image
comme projet d'image:
GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/IMAGE_NAME
Remplacez IMAGE_NAME
par le nom du
l'image d'OS de VM de Batch que vous souhaitez décrire.
Étape suivante
- En savoir plus sur les images d'OS de VM pour Batch: