Ce document décrit la procédure à suivre pour créer des instances de machines virtuelles (VM) autonomes qui utilisent les types de machines A3 High ou A3 Mega optimisés pour les accélérateurs. Pour en savoir plus sur les types de machines, consultez A3 High et A3 Mega dans la documentation Compute Engine.
Pour découvrir d'autres méthodes de création de VM ou de clusters, consultez la page Présentation.
Avant de commencer
Avant de créer des VM, si vous ne l'avez pas déjà fait, procédez comme suit :
- Choisissez une option de consommation : l'option de consommation que vous choisissez détermine comment vous obtenez et utilisez les ressources GPU.
Pour en savoir plus, consultez Choisir une option de consommation.
- Obtenir de la capacité : le processus d'obtention de la capacité diffère pour chaque option de consommation.
Pour en savoir plus sur la procédure à suivre pour obtenir de la capacité pour l'option de consommation choisie, consultez Présentation de la capacité.
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
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
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 initSi 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 .
Rôles requis
Pour obtenir les autorisations nécessaires à la création de VM, demandez à votre administrateur de vous attribuer le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur le projet.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ce rôle prédéfini contient les autorisations requises pour créer des VM. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour créer des VM :
compute.instances.createsur le projet-
Pour créer la VM à l'aide d'une image personnalisée :
compute.images.useReadOnlysur l'image -
Pour créer la VM à l'aide d'un instantané :
compute.snapshots.useReadOnlysur l'instantané -
Pour créer la VM à l'aide d'un modèle d'instance :
compute.instanceTemplates.useReadOnlysur le modèle d'instance -
Pour spécifier un sous-réseau pour la VM :
compute.subnetworks.usesur le projet ou sur le sous-réseau choisi -
Pour spécifier une adresse IP statique pour la VM :
compute.addresses.usesur le projet -
Pour attribuer une adresse IP externe à la VM en cas d'utilisation d'un réseau VPC :
compute.subnetworks.useExternalIpsur le projet ou sur le sous-réseau choisi -
Pour attribuer un ancien réseau à la VM :
compute.networks.usesur le projet -
Pour attribuer une adresse IP externe à la VM en cas d'utilisation d'un ancien réseau :
compute.networks.useExternalIpsur le projet -
Pour définir les métadonnées d'instance de VM pour la VM :
compute.instances.setMetadatasur le projet -
Pour définir des tags pour la VM :
compute.instances.setTagssur la VM -
Pour définir des étiquettes pour la VM :
compute.instances.setLabelssur la VM -
Pour définir un compte de service que doit utiliser la VM :
compute.instances.setServiceAccountsur la VM -
Pour créer un disque pour la VM :
compute.disks.createsur le projet -
Pour associer un disque existant en mode lecture seule ou en mode lecture-écriture :
compute.disks.usesur le disque -
Pour associer un disque existant en mode lecture seule :
compute.disks.useReadOnlysur le disque
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Présentation
La création d'une instance avec le type de machine a3h-or-a3m comprend les étapes suivantes :
Créer des réseaux VPC
Pour permettre une communication efficace pour vos VM GPU, vous devez créer un réseau de gestion et un ou plusieurs réseaux de données. Le réseau de gestion est utilisé pour l'accès externe (SSH, par exemple) et pour la plupart des communications réseau générales. Les réseaux de données sont utilisés pour la communication à hautes performances entre les GPU de différentes VM, par exemple pour le trafic RDMA (Remote Direct Memory Access).
Pour ces réseaux VPC, nous vous recommandons de définir l'unité de transmission maximale (MTU) sur une valeur plus élevée. Des valeurs de MTU plus élevées augmentent la taille des paquets et réduisent la surcharge de l'en-tête du paquet, ce qui augmente le débit des données de charge utile. Pour en savoir plus sur la création de réseaux VPC, consultez Créer et vérifier un réseau avec une MTU de trame géante.
Créer un réseau de gestion, un sous-réseau et une règle de pare-feu
Pour configurer le réseau de gestion, procédez comme suit :
Créez le réseau de gestion à l'aide de la commande
networks create:gcloud compute networks create NETWORK_NAME_PREFIX-mgmt-net \ --project=PROJECT_ID \ --subnet-mode=custom \ --mtu=8244Créez le sous-réseau de gestion à l'aide de la commande
networks subnets create:gcloud compute networks subnets create NETWORK_NAME_PREFIX-mgmt-sub \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --region=REGION \ --range=192.168.0.0/24Créez des règles de pare-feu à l'aide de la commande
firewall-rules create.Créez une règle de pare-feu pour le réseau de gestion.
gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-internal \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --action=ALLOW \ --rules=tcp:0-65535,udp:0-65535,icmp \ --source-ranges=192.168.0.0/16Créez la règle de pare-feu
tcp:22pour limiter les adresses IP sources qui peuvent se connecter à votre VM à l'aide de SSH.gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ssh \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --action=ALLOW \ --rules=tcp:22 \ --source-ranges=SSH_SOURCE_IP_RANGECréez la règle de pare-feu
icmppermettant de vérifier les problèmes de transmission de données sur le réseau.gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ping \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --action=ALLOW \ --rules=icmp \ --source-ranges=0.0.0.0/0
Remplacez les éléments suivants :
NETWORK_NAME_PREFIX: préfixe de nom à utiliser pour les réseaux et sous-réseaux VPC.PROJECT_ID: ID de votre projet.REGION: région dans laquelle vous souhaitez créer les réseaux.SSH_SOURCE_IP_RANGE: plage d'adresses IP au format CIDR. Ce paramètre spécifie les adresses IP sources qui peuvent se connecter à votre VM à l'aide de SSH.
Créer des réseaux de données, des sous-réseaux et une règle de pare-feu
Le nombre de réseaux de données varie en fonction du type de machine GPU que vous créez.A3 Mega
A3 Mega nécessite huit réseaux de données. Pour créer huit réseaux de données, chacun avec des sous-réseaux et des règles de pare-feu, utilisez la commande suivante.
for N in $(seq 1 8); do
gcloud compute networks create NETWORK_NAME_PREFIX-data-net-$N \
--project=PROJECT_ID \
--subnet-mode=custom \
--mtu=8244
gcloud compute networks subnets create NETWORK_NAME_PREFIX-data-sub-$N \
--project=PROJECT_ID \
--network=NETWORK_NAME_PREFIX-data-net-$N \
--region=REGION \
--range=192.168.$N.0/24
gcloud compute firewall-rules create NETWORK_NAME_PREFIX-data-internal-$N \
--project=PROJECT_ID \
--network=NETWORK_NAME_PREFIX-data-net-$N \
--action=ALLOW \
--rules=tcp:0-65535,udp:0-65535,icmp \
--source-ranges=192.168.0.0/16
done
A3 High
Les A3 High nécessitent quatre réseaux de données. Exécutez la commande suivante pour créer quatre réseaux de données, chacun avec des sous-réseaux et des règles de pare-feu.
for N in $(seq 1 4); do
gcloud compute networks create NETWORK_NAME_PREFIX-data-net-$N \
--project=PROJECT_ID \
--subnet-mode=custom \
--mtu=8244
gcloud compute networks subnets create NETWORK_NAME_PREFIX-data-sub-$N \
--project=PROJECT_ID \
--network=NETWORK_NAME_PREFIX-data-net-$N \
--region=REGION \
--range=192.168.$N.0/24
gcloud compute firewall-rules create NETWORK_NAME_PREFIX-data-internal-$N \
--project=PROJECT_ID \
--network=NETWORK_NAME_PREFIX-data-net-$N \
--action=ALLOW \
--rules=tcp:0-65535,udp:0-65535,icmp \
--source-ranges=192.168.0.0/16
done
Facultatif : Créer une stratégie d'emplacement compact
Vous pouvez spécifier l'emplacement des VM en créant une stratégie de concentration. Lorsque vous appliquez une stratégie d'emplacement compact à vos VM, Compute Engine s'efforce de créer des VM aussi proches les unes des autres que possible. Si votre application est sensible à la latence et que vous souhaitez que les VM soient plus proches les unes des autres (concentration maximale), spécifiez le champ maxDistance (aperçu) lors de la création d'une stratégie de concentration. Une valeur maxDistance inférieure garantit un placement plus proche des VM, mais augmente également le risque que certaines VM ne soient pas créées.
gcloud
Pour créer une stratégie de concentration, utilisez la
commande gcloud beta compute resource-policies create group-placement :
gcloud beta compute resource-policies create group-placement POLICY_NAME \
--collocation=collocated \
--max-distance=MAX_DISTANCE \
--region=REGION
Remplacez les éléments suivants :
POLICY_NAME: nom de la stratégie d'emplacement compact.MAX_DISTANCE: configuration de distance maximale pour vos VM. La valeur doit être3pour placer les VM dans les blocs adjacents ou2pour les placer dans le même bloc. Pour en savoir plus sur le nombre maximal de VM compatibles avec chaquemaxDistancepar série de machines, consultez À propos des stratégies d'emplacement compact dans la documentation Compute Engine.REGION: région dans laquelle vous souhaitez créer la stratégie de concentration. Spécifiez une région dans laquelle le type de machine que vous souhaitez utiliser est disponible. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.
REST
Pour créer une stratégie de concentration, envoyez une requête POST à la méthode resourcePolicies.insert en version bêta.
Dans le corps de la requête, incluez le champ collocation défini sur COLLOCATED, ainsi que le champ maxDistance.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies
{
"name": "POLICY_NAME",
"groupPlacementPolicy": {
"collocation": "COLLOCATED",
"maxDistance": MAX_DISTANCE
}
}
Remplacez les éléments suivants :
PROJECT_ID: ID de votre projetPOLICY_NAME: nom de la stratégie d'emplacement compact.MAX_DISTANCE: configuration de distance maximale pour vos VM. La valeur doit être3pour placer les VM dans les blocs adjacents ou2pour les placer dans le même bloc. Pour en savoir plus sur le nombre maximal de VM compatibles avec chaquemaxDistancepar série de machines, consultez À propos des stratégies d'emplacement compact dans la documentation Compute Engine.REGION: région dans laquelle vous souhaitez créer la stratégie de concentration. Spécifiez une région dans laquelle le type de machine que vous souhaitez utiliser est disponible. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.
Créer une instance A3 High ou A3 Mega
Pour créer une VM A3 High ou A3 Mega, utilisez l'une des méthodes suivantes. Si vous choisissez d'utiliser une stratégie d'emplacement compact, vous devez utiliser la Google Cloud CLI ou REST pour créer la VM.
Les commandes suivantes définissent également le niveau d'accès pour vos instances. Pour simplifier la gestion des autorisations, Google vous recommande de définir le niveau d'accès d'une instance surcloud-platform, puis d'utiliser des rôles IAM pour définir les services auxquels l'instance peut accéder. Pour en savoir plus, consultez les bonnes pratiques concernant les niveaux d'accès.
Console
Accédez à la page Créer une instance dans la console Google Cloud .
Spécifiez un nom pour votre VM. Consultez la convention d'attribution de noms des ressources.
Sélectionnez la région et la zone dans lesquelles vous souhaitez réserver de la capacité. Consultez la liste des régions et zones où les GPU sont disponibles.
Cliquez sur l'onglet GPU, puis procédez comme suit :
- Dans la liste Type de GPU, sélectionnez le type de GPU.
- Pour les VM A3 High, sélectionnez
NVIDIA H100 80GB. - Pour les VM A3 Mega, sélectionnez
NVIDIA H100 MEGA 80GB.
- Pour les VM A3 High, sélectionnez
- Dans la liste Nombre de GPU, sélectionnez
8.
- Dans la liste Type de GPU, sélectionnez le type de GPU.
Dans le menu de navigation, cliquez sur OS et stockage, puis procédez comme suit :
- Cliquez sur Modifier. Le volet Configuration du disque de démarrage s'ouvre.
- Dans l'onglet Images publiques, sélectionnez une image recommandée. Pour obtenir la liste des images recommandées, consultez Systèmes d'exploitation.
- Cliquez sur Sélectionner pour confirmer vos options de disque de démarrage.
Configurez le compte de service et les niveaux d'accès comme suit. Les charges de travail exécutées sur l'instance utilisent le compte de service associé pour autoriser les requêtes adressées à d'autres services Google Cloud .
- Dans le menu de navigation, cliquez sur Sécurité.
- Dans la liste Compte de service, sélectionnez le compte de service à utiliser.
- Pour Niveaux d'accès, sélectionnez l'option Autoriser l'accès complet à l'ensemble des API Cloud. Cette bonne pratique est recommandée, car elle vous permet de gérer les accès en ajoutant ou en supprimant des rôles IAM du compte de service. Pour en savoir plus, consultez Associer un compte de service à une instance.
Pour créer une VM multi-NIC, procédez comme suit. Sinon, ignorez ces étapes pour créer une VM à une seule interface réseau.
Dans le menu de navigation, cliquez sur Mise en réseau.
Dans la section Interfaces réseau, procédez comme suit :
- Supprimez l'interface réseau par défaut. Pour supprimer l'interface, cliquez sur Supprimer.
- Cliquez sur Ajouter une interface réseau. Utilisez cette option pour ajouter des interfaces réseau qui se connectent aux réseaux VPC que vous avez créés dans la section précédente. Lorsque vous ajoutez des interfaces réseau, n'oubliez pas les points suivants :
- Pour une interface réseau utilisée pour la communication d'hôte à hôte, sélectionnez un réseau et un sous-réseau VPC standards dans les listes Réseau et Sous-réseau, puis définissez la liste Carte d'interface réseau sur gVNIC.
- Pour une interface réseau utilisée pour la communication entre GPU à l'aide de GPUDirect-TCPXO (A3 Mega) ou GPUDirect-TCPX (A3 High), sélectionnez les réseaux et sous-réseaux VPC spécialisés correspondants pour chaque interface, puis définissez la liste Carte d'interface réseau sur gVNIC pour ces interfaces réseau également.
Dans le menu de navigation, cliquez sur Avancé. Ensuite, suivez les étapes ci-dessous pour le modèle de provisionnement que vous souhaitez utiliser.
Flex-start
- Dans la section Modèle de provisionnement, dans la liste Modèle de provisionnement de VM, sélectionnez Flex-start.
Dans Saisissez le nombre d'heures, saisissez la durée maximale d'exécution de la VM. La valeur doit être comprise entre 46 secondes (
0.01) et sept jours (168, soit 168 heures).Sélectionnez Définir un temps d'attente pour la création de la VM
En fonction des exigences zonales de votre charge de travail, spécifiez l'une des durées suivantes pour augmenter vos chances de voir aboutir votre demande de création de VM :
- Charges de travail avec des exigences zonales strictes : si votre charge de travail vous oblige à créer la VM dans une zone spécifique, spécifiez une durée comprise entre 90 secondes et 2 heures. Plus la durée est longue, plus vous avez de chances d'obtenir des ressources.
- Charges de travail sans exigences strictes concernant les zones : si la VM peut s'exécuter dans n'importe quelle zone de la région, spécifiez une durée de 0 seconde ou décochez la case Définir un temps d'attente pour la création de VM. Cette action indique que Compute Engine n'alloue des ressources que si elles sont immédiatement disponibles. Si la requête de création de VM échoue parce que les ressources ne sont pas disponibles, réessayez dans une autre zone.
Dans le champ À l'arrêt de la VM, sélectionnez si vous souhaitez arrêter ou supprimer la VM à la fin de sa durée d'exécution :
- Pour supprimer la VM, sélectionnez Supprimer.
- Pour arrêter la VM, sélectionnez Arrêter.
Lié à la réservation
Cliquez sur Choisir une réservation. Cette action ouvre un volet contenant la liste des réservations disponibles dans la zone sélectionnée. Dans la liste des réservations, procédez comme suit :
- Sélectionnez la réservation que vous souhaitez utiliser pour la VM. Vous pouvez également sélectionner un bloc spécifique dans la réservation.
- Cliquez sur Choisir.
Spot
- Dans la section Modèle de provisionnement, sélectionnez Spot dans la liste Modèle de provisionnement de VM.
Facultatif : Pour sélectionner l'action de terminaison qui se produit lorsque Compute Engine préempte la VM, procédez comme suit :
- Développez la section Paramètres avancés du modèle de provisionnement de la VM.
- Dans la liste À l'arrêt de la VM, sélectionnez l'une des options suivantes :
- Pour arrêter la VM pendant la préemption, sélectionnez Arrêter (sélection par défaut).
- Pour supprimer la VM pendant la préemption, sélectionnez Supprimer.
Pour créer et démarrer la VM, cliquez sur Créer.
gcloud
Pour créer une VM A3 High ou A3 Mega, utilisez la commande gcloud compute instances create.
A3 Mega
Pour créer la VM, utilisez la
commande gcloud compute instances create.
Les paramètres que vous devez spécifier dépendent de l'option de consommation que vous utilisez pour ce déploiement. Sélectionnez l'onglet correspondant au modèle de provisionnement de votre option de consommation.
Flex-start
gcloud compute instances create VM_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-5,subnet=GVNIC_NAME_PREFIX-sub-5,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-6,subnet=GVNIC_NAME_PREFIX-sub-6,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-7,subnet=GVNIC_NAME_PREFIX-sub-7,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-8,subnet=GVNIC_NAME_PREFIX-sub-8,no-address \
--reservation-affinity=none \
--provisioning-model=FLEX_START \
--request-valid-for-duration=REQUEST_VALID_FOR_DURATION \
--max-run-duration=MAX_RUN_DURATION \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE
Remplacez les éléments suivants :
VM_NAME: nom de la VM.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la gamme de machines A3 Mega, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou une version ultérieure et de désactiver les mises à jour automatiques, ou d'utiliser l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure, ou utilisezrocky-linux-accelerator-cloudpour l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.DISK_SIZE: taille du disque de démarrage en Go.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).REQUEST_VALID_FOR_DURATION: durée de validité de la requête de création de la VM. Vous devez formater la valeur en nombre de jours, d'heures, de minutes ou de secondes, suivis respectivement ded,h,mets. Par exemple, spécifiez30mpour 30 minutes ou1h2m3spour une heure, deux minutes et trois secondes.En fonction des exigences zonales de votre charge de travail, spécifiez l'une des durées suivantes pour augmenter vos chances de voir aboutir votre demande de création de VM :
- Charges de travail avec des exigences zonales strictes : si votre charge de travail vous oblige à créer la VM dans une zone spécifique, spécifiez une durée comprise entre 90 secondes (
90s) et deux heures (2h). Plus la durée est longue, plus vous avez de chances d'obtenir des ressources. - Charges de travail sans exigences strictes concernant les zones : si la VM peut s'exécuter dans n'importe quelle zone de la région, spécifiez une durée de zéro seconde (
0s). Cette action indique que Compute Engine n'alloue des ressources que si elles sont immédiatement disponibles. Si la requête de création de VM échoue en raison de l'indisponibilité des ressources, réessayez dans une autre zone.
- Charges de travail avec des exigences zonales strictes : si votre charge de travail vous oblige à créer la VM dans une zone spécifique, spécifiez une durée comprise entre 90 secondes (
MAX_RUN_DURATION: durée d'exécution des VM demandées. Vous devez formater la valeur en nombre de jours, d'heures, de minutes ou de secondes, suivis respectivement ded,h,mets. Cette valeur doit être comprise entre 10 minutes et 7 jours.TERMINATION_ACTION: indique si Compute Engine arrête (STOP) ou supprime (DELETE) la VM à la fin de sa durée d'exécution.
Lié à la réservation
Avant d'exécuter la commande, vous pouvez éventuellement ajouter l'indicateur pour une stratégie de placement compacte.
gcloud compute instances create VM_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-5,subnet=GVNIC_NAME_PREFIX-sub-5,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-6,subnet=GVNIC_NAME_PREFIX-sub-6,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-7,subnet=GVNIC_NAME_PREFIX-sub-7,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-8,subnet=GVNIC_NAME_PREFIX-sub-8,no-address \
--reservation-affinity=specific \
--reservation=RESERVATION \
--provisioning-model=RESERVATION_BOUND \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE \
--restart-on-failure
Procédez comme suit :
-
Remplacez les éléments suivants :
VM_NAME: nom de la VM.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la gamme de machines A3 Mega, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou une version ultérieure et de désactiver les mises à jour automatiques, ou d'utiliser l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure, ou utilisezrocky-linux-accelerator-cloudpour l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.DISK_SIZE: taille du disque de démarrage en Go.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).-
RESERVATION: nom de la réservation ou d'un bloc spécifique dans une réservation. Pour obtenir le nom de la réservation ou les blocs disponibles, consultez Afficher la capacité réservée. En fonction de vos exigences concernant l'emplacement des instances, choisissez l'une des options suivantes :Pour créer l'instance sur un bloc :
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
De plus, pour créer plusieurs instances dans le même bloc, appliquez la même stratégie d'emplacement compact qui spécifie une colocation de bloc (
maxDistance=2) lors de la création de chaque instance. Compute Engine applique ensuite la règle à la réservation et crée des instances sur le même bloc.Pour créer l'instance sur un bloc spécifique :
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
TERMINATION_ACTION: indique si Compute Engine arrête (STOP) ou supprime (DELETE) la VM à la fin de la période de réservation.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez l'indicateur suivant à la commande :
--resource-policies=POLICY_NAME
Remplacez les éléments suivants :
POLICY_NAME: nom de la stratégie d'emplacement compact.
- Exécutez la commande.
Spot
Avant d'exécuter la commande, vous pouvez éventuellement ajouter l'indicateur pour une stratégie de placement compacte.
gcloud compute instances create VM_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-5,subnet=GVNIC_NAME_PREFIX-sub-5,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-6,subnet=GVNIC_NAME_PREFIX-sub-6,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-7,subnet=GVNIC_NAME_PREFIX-sub-7,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-8,subnet=GVNIC_NAME_PREFIX-sub-8,no-address \
--provisioning-model=SPOT \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE \
--no-restart-on-failure
Procédez comme suit :
-
Remplacez les éléments suivants :
VM_NAME: nom de la VM.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la gamme de machines A3 Mega, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou une version ultérieure et de désactiver les mises à jour automatiques, ou d'utiliser l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure, ou utilisezrocky-linux-accelerator-cloudpour l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.DISK_SIZE: taille du disque de démarrage en Go.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).TERMINATION_ACTION: action à effectuer lorsque Compute Engine préempte l'instance, soitSTOP(par défaut), soitDELETE.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez l'indicateur suivant à la commande :
--resource-policies=POLICY_NAME
Remplacez les éléments suivants :
POLICY_NAME: nom de la stratégie d'emplacement compact.
- Exécutez la commande.
A3 High
Pour créer la VM, utilisez la
commande gcloud compute instances create.
Les paramètres que vous devez spécifier dépendent de l'option de consommation que vous utilisez pour ce déploiement. Sélectionnez l'onglet correspondant au modèle de provisionnement de votre option de consommation.
Flex-start
gcloud compute instances create VM_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--reservation-affinity=none \
--provisioning-model=FLEX_START \
--request-valid-for-duration=REQUEST_VALID_FOR_DURATION \
--max-run-duration=MAX_RUN_DURATION \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE
Remplacez les éléments suivants :
VM_NAME: nom de la VM.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la série de machines A3 High, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou version ultérieure et de désactiver les mises à jour automatiques. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.DISK_SIZE: taille du disque de démarrage en Go.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).REQUEST_VALID_FOR_DURATION: durée de validité de la requête de création de la VM. Vous devez formater la valeur en nombre de jours, d'heures, de minutes ou de secondes, suivis respectivement ded,h,mets. Par exemple, spécifiez30mpour 30 minutes ou1h2m3spour une heure, deux minutes et trois secondes.En fonction des exigences zonales de votre charge de travail, spécifiez l'une des durées suivantes pour augmenter vos chances de voir aboutir votre demande de création de VM :
- Charges de travail avec des exigences zonales strictes : si votre charge de travail vous oblige à créer la VM dans une zone spécifique, spécifiez une durée comprise entre 90 secondes (
90s) et deux heures (2h). Plus la durée est longue, plus vous avez de chances d'obtenir des ressources. - Charges de travail sans exigences strictes concernant les zones : si la VM peut s'exécuter dans n'importe quelle zone de la région, spécifiez une durée de zéro seconde (
0s). Cette action indique que Compute Engine n'alloue des ressources que si elles sont immédiatement disponibles. Si la requête de création de VM échoue en raison de l'indisponibilité des ressources, réessayez dans une autre zone.
- Charges de travail avec des exigences zonales strictes : si votre charge de travail vous oblige à créer la VM dans une zone spécifique, spécifiez une durée comprise entre 90 secondes (
MAX_RUN_DURATION: durée d'exécution des VM demandées. Vous devez formater la valeur en nombre de jours, d'heures, de minutes ou de secondes, suivis respectivement ded,h,mets. Cette valeur doit être comprise entre 10 minutes et 7 jours.TERMINATION_ACTION: indique si Compute Engine arrête (STOP) ou supprime (DELETE) la VM à la fin de sa durée d'exécution.
Lié à la réservation
Avant d'exécuter la commande, vous pouvez éventuellement ajouter l'indicateur pour une stratégie de placement compacte.
gcloud compute instances create VM_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--reservation-affinity=specific \
--reservation=RESERVATION \
--provisioning-model=RESERVATION_BOUND \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE \
--restart-on-failure
Procédez comme suit :
-
Remplacez les éléments suivants :
VM_NAME: nom de la VM.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la série de machines A3 High, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou version ultérieure et de désactiver les mises à jour automatiques. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.DISK_SIZE: taille du disque de démarrage en Go.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).-
RESERVATION: nom de la réservation ou d'un bloc spécifique dans une réservation. Pour obtenir le nom de la réservation ou les blocs disponibles, consultez Afficher la capacité réservée. En fonction de vos exigences concernant l'emplacement des instances, choisissez l'une des options suivantes :Pour créer l'instance sur un bloc :
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
De plus, pour créer plusieurs instances dans le même bloc, appliquez la même stratégie d'emplacement compact qui spécifie une colocation de bloc (
maxDistance=2) lors de la création de chaque instance. Compute Engine applique ensuite la règle à la réservation et crée des instances sur le même bloc.Pour créer l'instance sur un bloc spécifique :
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
TERMINATION_ACTION: indique si Compute Engine arrête (STOP) ou supprime (DELETE) la VM à la fin de la période de réservation.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez l'indicateur suivant à la commande :
--resource-policies=POLICY_NAME
Remplacez les éléments suivants :
POLICY_NAME: nom de la stratégie d'emplacement compact.
- Exécutez la commande.
Spot
Avant d'exécuter la commande, vous pouvez éventuellement ajouter l'indicateur pour une stratégie de placement compacte.
gcloud compute instances create VM_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--provisioning-model=SPOT \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE \
--no-restart-on-failure
Procédez comme suit :
-
Remplacez les éléments suivants :
VM_NAME: nom de la VM.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la série de machines A3 High, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou version ultérieure et de désactiver les mises à jour automatiques. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.DISK_SIZE: taille du disque de démarrage en Go.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).TERMINATION_ACTION: action à effectuer lorsque Compute Engine préempte l'instance, soitSTOP(par défaut), soitDELETE.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez l'indicateur suivant à la commande :
--resource-policies=POLICY_NAME
Remplacez les éléments suivants :
POLICY_NAME: nom de la stratégie d'emplacement compact.
- Exécutez la commande.
REST
Pour créer une VM A3 High ou A3 Mega, envoyez une requête POST à la méthode instances.insert.
A3 Mega
Pour renommer la VM, envoyez une requête POST à la méthode instances.insert.
Les paramètres que vous devez spécifier dépendent de l'option de consommation que vous utilisez pour ce déploiement. Sélectionnez l'onglet correspondant au modèle de provisionnement de votre option de consommation.
Flex-start
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "VM_NAME",
"disks":[
{
"boot":true,
"initializeParams":{
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-5",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-5"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-6",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-6"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-7",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-7"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-8",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-8"
}
],
"reservationAffinity":{
"consumeReservationType": "NO_RESERVATION",
},
"scheduling":{
"provisioningModel": "FLEX_START",
"requestValidForDuration": {
"seconds": REQUEST_VALID_FOR_DURATION
},
"maxRunDuration": {
"seconds": MAX_RUN_DURATION
},
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
}
}
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel vous souhaitez créer la VM.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.VM_NAME: nom de la VM.DISK_SIZE: taille du disque de démarrage en Go.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure, ou utilisezrocky-linux-accelerator-cloudpour l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la gamme de machines A3 Mega, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou une version ultérieure et de désactiver les mises à jour automatiques, ou d'utiliser l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.NETWORK_PROJECT_ID: ID du projet du réseau.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).REGION: région du sous-réseau.REQUEST_VALID_FOR_DURATION: durée, en secondes, pendant laquelle la requête de création de la VM reste valide.En fonction des exigences zonales de votre charge de travail, spécifiez l'une des durées suivantes pour augmenter vos chances de voir aboutir votre demande de création de VM :
- Charges de travail avec des exigences zonales strictes : si votre charge de travail vous oblige à créer la VM dans une zone spécifique, spécifiez une durée comprise entre 90 secondes (
90) et deux heures (7200). Plus la durée est longue, plus vous avez de chances d'obtenir des ressources. - Charges de travail sans exigences strictes concernant les zones : si la VM peut s'exécuter dans n'importe quelle zone de la région, spécifiez une durée de zéro seconde (
0). Cette action indique que Compute Engine n'alloue des ressources que si elles sont immédiatement disponibles. Si la requête de création de VM échoue en raison de l'indisponibilité des ressources, réessayez dans une autre zone.
- Charges de travail avec des exigences zonales strictes : si votre charge de travail vous oblige à créer la VM dans une zone spécifique, spécifiez une durée comprise entre 90 secondes (
MAX_RUN_DURATION: durée d'exécution des VM demandées. Vous devez mettre en forme la valeur en tant que nombre de secondes. Par exemple, spécifiez86400pour 86 400 secondes (24 heures). Cette valeur doit être comprise entre 10 minutes et 7 jours.TERMINATION_ACTION: indique si Compute Engine arrête (STOP) ou supprime (DELETE) la VM à la fin de sa durée d'exécution.
Lié à la réservation
Avant d'envoyer la requête, vous pouvez ajouter le champ pour une stratégie d'emplacement compact au corps de la requête.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "VM_NAME",
"disks":[
{
"boot":true,
"initializeParams":{
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-5",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-5"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-6",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-6"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-7",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-7"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-8",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-8"
}
],
"reservationAffinity":{
"consumeReservationType": "SPECIFIC_RESERVATION",
"key": "compute.googleapis.com/reservation-name",
"values":[
"RESERVATION"
]
},
"scheduling":{
"provisioningModel": "RESERVATION_BOUND",
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
"automaticRestart": true
}
}
Procédez comme suit :
-
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel vous souhaitez créer la VM.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.VM_NAME: nom de la VM.DISK_SIZE: taille du disque de démarrage en Go.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure, ou utilisezrocky-linux-accelerator-cloudpour l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la gamme de machines A3 Mega, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou une version ultérieure et de désactiver les mises à jour automatiques, ou d'utiliser l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.NETWORK_PROJECT_ID: ID du projet du réseau.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).REGION: région du sous-réseau.-
RESERVATION: nom de la réservation ou d'un bloc spécifique dans une réservation. Pour obtenir le nom de la réservation ou les blocs disponibles, consultez Afficher la capacité réservée. En fonction de vos exigences concernant l'emplacement des instances, choisissez l'une des options suivantes :Pour créer l'instance sur un bloc :
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
De plus, pour créer plusieurs instances dans le même bloc, appliquez la même stratégie d'emplacement compact qui spécifie une colocation de bloc (
maxDistance=2) lors de la création de chaque instance. Compute Engine applique ensuite la règle à la réservation et crée des instances sur le même bloc.Pour créer l'instance sur un bloc spécifique :
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
TERMINATION_ACTION: indique si Compute Engine arrête (STOP) ou supprime (DELETE) la VM à la fin de la période de réservation.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez le champ suivant au corps de la requête :
"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]Remplacez les éléments suivants :
PROJECT_ID: ID du projet de la stratégie d'emplacement compact.REGION: région de la stratégie d'emplacement compact.POLICY_NAME: nom de la stratégie d'emplacement compact.
- Envoyez la demande.
Spot
Avant d'envoyer la requête, vous pouvez ajouter le champ pour une stratégie d'emplacement compact au corps de la requête.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "VM_NAME",
"disks":[
{
"boot":true,
"initializeParams":{
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-5",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-5"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-6",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-6"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-7",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-7"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-8",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-8"
}
],
"scheduling":
{
"provisioningModel": "SPOT",
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
"automaticRestart": false
}
}
Procédez comme suit :
-
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel vous souhaitez créer la VM.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.VM_NAME: nom de la VM.DISK_SIZE: taille du disque de démarrage en Go.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure, ou utilisezrocky-linux-accelerator-cloudpour l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la gamme de machines A3 Mega, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou une version ultérieure et de désactiver les mises à jour automatiques, ou d'utiliser l'image Rocky Linuxrocky-linux-8-optimized-gcp-nvidia-580. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.NETWORK_PROJECT_ID: ID du projet du réseau.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).REGION: région du sous-réseau.TERMINATION_ACTION: action à effectuer lorsque Compute Engine préempte l'instance, soitSTOP(par défaut), soitDELETE.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez le champ suivant au corps de la requête :
"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]Remplacez les éléments suivants :
PROJECT_ID: ID du projet de la stratégie d'emplacement compact.REGION: région de la stratégie d'emplacement compact.POLICY_NAME: nom de la stratégie d'emplacement compact.
- Envoyez la demande.
A3 High
Pour renommer la VM, envoyez une requête POST à la méthode instances.insert.
Les paramètres que vous devez spécifier dépendent de l'option de consommation que vous utilisez pour ce déploiement. Sélectionnez l'onglet correspondant au modèle de provisionnement de votre option de consommation.
Flex-start
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "VM_NAME",
"disks":[
{
"boot":true,
"initializeParams":{
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
}
],
"reservationAffinity":{
"consumeReservationType": "NO_RESERVATION",
},
"scheduling":{
"provisioningModel": "FLEX_START",
"requestValidForDuration": {
"seconds": REQUEST_VALID_FOR_DURATION
},
"maxRunDuration": {
"seconds": MAX_RUN_DURATION
},
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
}
}
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel vous souhaitez créer la VM.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.VM_NAME: nom de la VM.DISK_SIZE: taille du disque de démarrage en Go.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la série de machines A3 High, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou version ultérieure et de désactiver les mises à jour automatiques. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.NETWORK_PROJECT_ID: ID du projet du réseau.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).REGION: région du sous-réseau.REQUEST_VALID_FOR_DURATION: durée, en secondes, pendant laquelle la requête de création de la VM reste valide.En fonction des exigences zonales de votre charge de travail, spécifiez l'une des durées suivantes pour augmenter vos chances de voir aboutir votre demande de création de VM :
- Charges de travail avec des exigences zonales strictes : si votre charge de travail vous oblige à créer la VM dans une zone spécifique, spécifiez une durée comprise entre 90 secondes (
90) et deux heures (7200). Plus la durée est longue, plus vous avez de chances d'obtenir des ressources. - Charges de travail sans exigences strictes concernant les zones : si la VM peut s'exécuter dans n'importe quelle zone de la région, spécifiez une durée de zéro seconde (
0). Cette action indique que Compute Engine n'alloue des ressources que si elles sont immédiatement disponibles. Si la requête de création de VM échoue en raison de l'indisponibilité des ressources, réessayez dans une autre zone.
- Charges de travail avec des exigences zonales strictes : si votre charge de travail vous oblige à créer la VM dans une zone spécifique, spécifiez une durée comprise entre 90 secondes (
MAX_RUN_DURATION: durée d'exécution des VM demandées. Vous devez mettre en forme la valeur en tant que nombre de secondes. Par exemple, spécifiez86400pour 86 400 secondes (24 heures). Cette valeur doit être comprise entre 10 minutes et 7 jours.TERMINATION_ACTION: indique si Compute Engine arrête (STOP) ou supprime (DELETE) la VM à la fin de sa durée d'exécution.
Lié à la réservation
Avant d'envoyer la requête, vous pouvez ajouter le champ pour une stratégie d'emplacement compact au corps de la requête.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "VM_NAME",
"disks":[
{
"boot":true,
"initializeParams":{
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
}
],
"reservationAffinity":{
"consumeReservationType": "SPECIFIC_RESERVATION",
"key": "compute.googleapis.com/reservation-name",
"values":[
"RESERVATION"
]
},
"scheduling":{
"provisioningModel": "RESERVATION_BOUND",
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
"automaticRestart": true
}
}
Procédez comme suit :
-
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel vous souhaitez créer la VM.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.VM_NAME: nom de la VM.DISK_SIZE: taille du disque de démarrage en Go.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la série de machines A3 High, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou version ultérieure et de désactiver les mises à jour automatiques. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.NETWORK_PROJECT_ID: ID du projet du réseau.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).REGION: région du sous-réseau.-
RESERVATION: nom de la réservation ou d'un bloc spécifique dans une réservation. Pour obtenir le nom de la réservation ou les blocs disponibles, consultez Afficher la capacité réservée. En fonction de vos exigences concernant l'emplacement des instances, choisissez l'une des options suivantes :Pour créer l'instance sur un bloc :
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
De plus, pour créer plusieurs instances dans le même bloc, appliquez la même stratégie d'emplacement compact qui spécifie une colocation de bloc (
maxDistance=2) lors de la création de chaque instance. Compute Engine applique ensuite la règle à la réservation et crée des instances sur le même bloc.Pour créer l'instance sur un bloc spécifique :
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
TERMINATION_ACTION: indique si Compute Engine arrête (STOP) ou supprime (DELETE) la VM à la fin de la période de réservation.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez le champ suivant au corps de la requête :
"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]Remplacez les éléments suivants :
PROJECT_ID: ID du projet de la stratégie d'emplacement compact.REGION: région de la stratégie d'emplacement compact.POLICY_NAME: nom de la stratégie d'emplacement compact.
- Envoyez la demande.
Spot
Avant d'envoyer la requête, vous pouvez ajouter le champ pour une stratégie d'emplacement compact au corps de la requête.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "VM_NAME",
"disks":[
{
"boot":true,
"initializeParams":{
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
}
],
"scheduling":
{
"provisioningModel": "SPOT",
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
"automaticRestart": false
}
}
Procédez comme suit :
-
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel vous souhaitez créer la VM.ZONE: zone dans laquelle le type de machine que vous souhaitez utiliser est disponible. Si vous souhaitez spécifier une stratégie d'emplacement compact, vous devez utiliser une zone située dans la même région que la stratégie d'emplacement compact. Pour en savoir plus sur les régions, consultez Disponibilité des GPU par région et par zone.MACHINE_TYPE: type de machine à utiliser pour la VM. Pour en savoir plus, consultez Types de machines GPU.VM_NAME: nom de la VM.DISK_SIZE: taille du disque de démarrage en Go.DISK_TYPE: type de disque de démarrage. Nous vous recommandons d'utiliserhyperdisk-balanced.IMAGE_PROJECT: ID du projet de l'image de l'OS. Par exemple, utilisezcos-cloudpour l'image Container-Optimized OScos-121-ltsou version ultérieure.IMAGE_FAMILY: famille d'images à laquelle appartient l'image de l'OS que vous souhaitez utiliser. Pour la série de machines A3 High, nous vous recommandons vivement d'utiliser l'image Container-Optimized OScos-121-ltsou version ultérieure et de désactiver les mises à jour automatiques. Pour obtenir la liste des systèmes d'exploitation compatibles, consultez la section Détails des systèmes d'exploitation.NETWORK_PROJECT_ID: ID du projet du réseau.GVNIC_NAME_PREFIX: préfixe de nom que vous avez spécifié lors de la création des réseaux et sous-réseaux VPC standards qui utilisent des cartes d'interface réseau virtuelles Google (gVNIC).REGION: région du sous-réseau.TERMINATION_ACTION: action à effectuer lorsque Compute Engine préempte l'instance, soitSTOP(par défaut), soitDELETE.
-
Facultatif : Si vous avez choisi d'utiliser une stratégie d'emplacement compact, ajoutez le champ suivant au corps de la requête :
"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]Remplacez les éléments suivants :
PROJECT_ID: ID du projet de la stratégie d'emplacement compact.REGION: région de la stratégie d'emplacement compact.POLICY_NAME: nom de la stratégie d'emplacement compact.
- Envoyez la demande.
Étapes suivantes
- Vérifier la consommation des réservations
- Afficher la topologie d'une instance de calcul
- Présentation de l'exécution des charges de travail
- Résoudre les problèmes de consommation de réservations
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2026/02/24 (UTC).