Remplacer, retirer ou supprimer des règles de charge de travail

Ce document explique comment remplacer, retirer ou supprimer des stratégies de charge de travail des groupes d'instances gérés (MIG). Ces actions sont utiles dans les scénarios suivants :

Remplacer une stratégie de charge de travail : vous pouvez modifier la façon dont les instances Compute Engine sont situées dans votre MIG ou passer à une autre stratégie de charge de travail qui correspond mieux aux exigences de votre charge de travail.
Supprimer une règle de charge de travail : vous pouvez cesser d'utiliser des règles d'emplacement spécifiques si votre charge de travail n'en a plus besoin, ce qui rétablit le comportement par défaut de placement des instances de calcul du MIG.
Supprimer une règle de charge de travail : vous pouvez supprimer définitivement les règles de charge de travail dont vous n'avez plus besoin.

Pour savoir comment créer une règle de charge de travail, consultez Créer des règles de charge de travail pour les MIG.

Limites

Vous ne pouvez remplacer ou supprimer une stratégie de charge de travail d'un MIG que si celui-ci ne contient aucune instance de calcul.

Avant de commencer

Si ce n'est pas déjà fait, configurez l'authentification. L'authentification permet 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 en sélectionnant l'une des options suivantes :
Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :
gcloud
1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :
  gcloud init
  Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
  
  Remarque : Si vous avez déjà installé la gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.
Définissez une région et une zone par défaut.

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.

Si 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 pour remplacer, retirer ou supprimer des stratégies de charge de travail, 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 Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour remplacer, retirer ou supprimer des règles de charge de travail. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour remplacer, retirer ou supprimer des règles de charge de travail :

Pour remplacer ou retirer une stratégie de charge de travail d'un MIG : compute.instances.update on the project
Pour supprimer une règle de charge de travail : compute.resourcePolicies.delete on the project

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

Remplacer une règle de charge de travail dans un MIG

Pour remplacer une stratégie de charge de travail dans un MIG par une autre stratégie de charge de travail existante, sélectionnez l'une des options suivantes :

gcloud

Définissez manuellement la taille du MIG sur 0.
Pour remplacer la règle de charge de travail dans votre MIG, utilisez la commande gcloud compute instance-groups managed update avec l'option --workload-policy. En fonction du type de MIG, incluez l'un des indicateurs suivants :
- Pour remplacer la stratégie de charge de travail dans un MIG zonal, incluez l'indicateur --zone :
```
gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --zone=ZONE
```
- Pour remplacer la règle de charge de travail dans un MIG régional, incluez l'indicateur --region :
```
gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --region=REGION
```
Remplacez les éléments suivants :
- MIG_NAME : nom du MIG.
- WORKLOAD_POLICY : nom de la règle de charge de travail que vous souhaitez appliquer à votre MIG.
- ZONE : zone où se trouve votre MIG zonal.
- REGION : région où se trouvent votre MIG régional et la stratégie de charge de travail.

REST

Définissez manuellement la taille du MIG sur 0.
Pour remplacer la stratégie de charge de travail dans votre MIG, envoyez une requête PATCH à l'une des méthodes suivantes :
- Pour remplacer la règle de charge de travail dans un MIG zonal, envoyez une requête PATCH à la méthode compute.instanceGroupManagers.patch :
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": "projects/PROJECT_ID/regions/REGION/resourcePolicies/WORKLOAD_POLICY"
}
```
- Pour remplacer la règle de charge de travail dans un MIG régional, envoyez une requête PATCH à la méthode compute.regionInstanceGroupManagers.patch :
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": "projects/PROJECT_ID/regions/REGION/resourcePolicies/WORKLOAD_POLICY"
}
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet dans lequel se trouvent votre MIG et la stratégie de charge de travail.
- ZONE : zone où se trouve votre MIG zonal.
- REGION : région où se trouvent votre MIG régional et la stratégie de charge de travail.
- MIG_NAME : nom de votre MIG.
- WORKLOAD_POLICY : nom de la règle de charge de travail que vous souhaitez appliquer à votre MIG.

Supprimer une stratégie de charge de travail d'un MIG

Pour supprimer une règle de charge de travail d'un MIG, sélectionnez l'une des options suivantes :

gcloud

Définissez manuellement la taille du MIG sur 0.
Pour supprimer une règle de charge de travail d'un MIG, utilisez la commande gcloud compute instance-groups managed update avec l'option --remove-workload-policy. En fonction du type de MIG, incluez l'un des indicateurs suivants :
- Pour supprimer une règle de charge de travail d'un MIG zonal, incluez l'indicateur --zone :
```
gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --zone=ZONE
```
- Pour supprimer une règle de charge de travail d'un MIG régional, incluez l'indicateur --region :
```
gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --region=REGION
```
Remplacez les éléments suivants :
- MIG_NAME : nom de votre MIG.
- WORKLOAD_POLICY : nom de la règle de charge de travail appliquée à votre MIG.
- ZONE : zone où se trouve votre MIG zonal.
- REGION : région où se trouve votre MIG régional.

REST

Définissez manuellement la taille du MIG sur 0.
Pour supprimer une stratégie de charge de travail d'un MIG, envoyez une requête PATCH à l'une des méthodes suivantes :
- Pour supprimer une stratégie de charge de travail d'un MIG zonal, envoyez une requête à la méthode compute.instanceGroupManagers.patch :
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}
```
- Pour supprimer une règle de charge de travail d'un MIG régional, envoyez une requête à la méthode compute.regionInstanceGroupManagers.patch :
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet dans lequel se trouvent votre MIG et la stratégie de charge de travail.
- ZONE : zone où se trouve votre MIG zonal.
- REGION : région où se trouvent votre MIG régional et la stratégie de charge de travail.
- MIG_NAME : nom de votre MIG.

Supprimer une règle de charge de travail

Vous ne pouvez pas supprimer une stratégie de charge de travail appliquée à un MIG. Avant de supprimer la stratégie, vous devez la supprimer du GM.

Pour supprimer une règle de charge de travail, sélectionnez l'une des options suivantes :

gcloud

Pour supprimer une règle de charge de travail, utilisez la commande gcloud compute resource-policies delete :

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

Remplacez les éléments suivants :

WORKLOAD_POLICY : nom d'une stratégie de charge de travail existante.
REGION : région où se trouve la règle de charge de travail.

REST

Pour supprimer une règle de charge de travail, envoyez une requête DELETE à la méthode resourcePolicies.delete :

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet dans lequel existe la règle de charge de travail.
REGION : région où se trouve la règle de charge de travail.
POLICY_NAME : nom d'une stratégie de charge de travail existante.

Étapes suivantes

Découvrez comment afficher les règles de charge de travail.
Découvrez comment créer des stratégies de charge de travail pour les MIG.

Remplacer, retirer ou supprimer des règles de charge de travail Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Limites

Avant de commencer

gcloud

REST

Rôles requis

Autorisations requises

Remplacer une règle de charge de travail dans un MIG

gcloud

REST

Supprimer une stratégie de charge de travail d'un MIG

gcloud

REST

Supprimer une règle de charge de travail

gcloud

REST

Étapes suivantes

Remplacer, retirer ou supprimer des règles de charge de travail