Remplacer, retirer ou supprimer des stratégies d'emplacement

Ce document explique comment remplacer, retirer ou supprimer des stratégies d'emplacement.

Remplacer, retirer ou supprimer des stratégies d'emplacement est utile dans les cas suivants :

• Remplacer une stratégie d'emplacement dans une instance de machine virtuelle (VM) pour déplacer la VM à une position différente par rapport aux autres VM.

• Retirer une stratégie d'emplacement d'une VM lorsque vous n'êtes plus intéressé par sa position par rapport aux autres VM.

• Supprimer une stratégie d'emplacement lorsque vous n'en avez plus besoin.

Avant de commencer

• Consultez les restrictions applicables aux stratégies d'emplacement.
• 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 :

  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 remplacer, retirer ou supprimer des stratégies d'emplacement, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur votre 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 remplacer, retirer ou supprimer des stratégies d'emplacement. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

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

Remplacer une stratégie d'emplacement dans une VM

Avant de remplacer une stratégie d'emplacement par répartition dans une VM par une stratégie d'emplacement compact, assurez-vous que la VM utilise un type de machine et une stratégie de maintenance de l'hôte compatibles. Si vous devez mettre à jour la VM avant de remplacer sa stratégie d'emplacement, effectuez l'une des opérations suivantes, ou les deux :

• Modifiez la stratégie de maintenance d'hôte de la VM.

• Modifiez le type de machine de la VM.

Après avoir remplacé la stratégie d'emplacement dans une VM, vous devez redémarrer la VM pour que la nouvelle stratégie d'emplacement appliquée soit effective.

Pour remplacer une stratégie d'emplacement dans une VM, sélectionnez l'une des options suivantes :

Retirer une stratégie d'emplacement d'une VM

Si vous souhaitez retirer une stratégie d'emplacement par répartition d'une VM avec deux domaines de disponibilité ou plus, vous pouvez le faire sans arrêter la VM. Si vous souhaitez retirer une stratégie d'emplacement compact ou une stratégie d'emplacement par répartition avec un seul domaine de disponibilité, vous devez d'abord arrêter la VM avant de retirer la stratégie d'emplacement qui lui est associée.

Le fait de retirer une stratégie d'emplacement d'une VM n'a aucune incidence sur son emplacement physique. Toutefois, si la VM migre à chaud, Compute Engine peut la déplacer vers un autre emplacement physique.

Pour retirer une stratégie d'emplacement d'une VM, sélectionnez l'une des options suivantes :

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/removeResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

Supprimer une stratégie d'emplacement

Vous ne pouvez supprimer une stratégie d'emplacement que si elle n'est appliquée à aucune ressource Compute Engine. Sinon, la suppression de la stratégie d'emplacement échoue. Si vous souhaitez supprimer une stratégie d'emplacement appliquée à une ou plusieurs ressources Compute Engine, effectuez l'une des opérations suivantes :

• Si la stratégie est appliquée uniquement à des VM et que vous souhaitez conserver les VM, procédez comme suit :

  1. Retirez la stratégie d'emplacement des VM, comme décrit dans ce document.

  2. Supprimez la stratégie d'emplacement comme décrit dans cette section.

• Sinon, procédez comme suit :

  1. Facultatif : Retirez la stratégie d'emplacement de toute VM que vous souhaitez conserver, comme décrit dans ce document.

  2. Supprimez toutes les autres ressources Compute Engine auxquelles la stratégie d'emplacement est appliquée dans l'ordre suivant :

     1. VM

     2. Réservations

     3. Modèles d'instance

  3. Supprimez la stratégie d'emplacement comme décrit dans cette section.

Pour supprimer une stratégie d'emplacement, sélectionnez l'une des options suivantes :

gcloud compute resource-policies delete POLICY_NAME \
    --region=REGION

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

Étape suivante

• Découvrez comment afficher les stratégies d'emplacement.

• Découvrez comment effectuer les opérations suivantes avec une VM qui spécifie une stratégie d'emplacement :

  • Affichez l'état de la VM.

  • Connectez-vous à la VM.