Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Afficher, mettre à jour et supprimer des ressources d'état composite

Cette page explique comment gérer vos ressources d'état de santé composite après les avoir créées. Vous pouvez lister, décrire, mettre à jour et supprimer les règles d'agrégation des données d'état, les sources d'état et les vérifications d'état composites.

Gérer les règles d'agrégation des données d'état

Cette section explique comment gérer les règles d'agrégation de l'état de santé.

Lister les règles d'agrégation des données d'état

Vous pouvez lister les règles d'agrégation des données d'état que vous avez configurées.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Règles d'agrégation des données d'état.

gcloud

Pour lister toutes les règles d'agrégation de l'état d'une région, utilisez la commande gcloud compute health-aggregation-policies list.

gcloud compute health-aggregation-policies list \
    --regions=REGION

Remplacez REGION par la région des règles d'agrégation de l'état.

API

Pour répertorier toutes les règles d'agrégation de l'état dans une région, envoyez une requête à la méthode regionHealthAggregationPolicies.list.

Méthode HTTP et URL :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour la règle d'agrégation de l'état.
REGION : région des règles d'agrégation de l'état.

Décrire une règle d'agrégation des données d'état

Vous pouvez décrire une règle d'agrégation des données d'état pour en afficher les détails.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Règles d'agrégation des données d'état.
Cliquez sur le nom de la règle d'agrégation des données d'état que vous souhaitez décrire.

gcloud

Utilisez la commande gcloud compute health-aggregation-policies describe.

gcloud compute health-aggregation-policies describe POLICY \
    --region=REGION

Remplacez les éléments suivants :

POLICY : nom de la règle d'agrégation de l'état
REGION : région de la règle d'agrégation de l'état

API

Envoyez une requête à la méthode regionHealthAggregationPolicies.get.

Méthode HTTP et URL :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour la règle d'agrégation de l'état.
REGION : région de la règle d'agrégation de l'état.
POLICY : nom de la stratégie d'agrégation de l'état.

Mettre à jour une règle d'agrégation des données d'état

Vous pouvez modifier la description, le seuil de pourcentage d'état sain ou le seuil minimal d'état sain d'une règle d'agrégation des données d'état.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Règles d'agrégation des données d'état.
Cliquez sur le nom de la règle d'agrégation des données d'état que vous souhaitez mettre à jour.
Cliquez sur Modifier.
Modifiez les champs que vous souhaitez modifier.
Cliquez sur Enregistrer.

gcloud

Utilisez la commande gcloud compute health-aggregation-policies update. Ignorez les options des propriétés que vous ne souhaitez pas mettre à jour.

gcloud compute health-aggregation-policies update POLICY \
    --region=REGION \
    --description="DESCRIPTION" \
    --healthy-percent-threshold=PERCENT_HEALTHY \
    --min-healthy-threshold=MINIMUM_HEALTHY

Remplacez les éléments suivants :

POLICY : nom de la règle d'agrégation de l'état de santé à mettre à jour
REGION : région de la règle d'agrégation de l'état
DESCRIPTION : description mise à jour de la règle
PERCENT_HEALTHY : pourcentage minimal mis à jour de points de terminaison d'un service de backend qui doivent être opérationnels pour que la source d'informations sur l'état soit considérée comme opérationnelle (par exemple, 75)
MINIMUM_HEALTHY : nombre minimal mis à jour de points de terminaison d'un service de backend qui doivent être opérationnels pour que la source d'état soit considérée comme opérationnelle (par exemple, 2)

API

Décrivez la règle d'agrégation de l'état et notez la valeur de la clé fingerprint, que vous utiliserez à l'étape suivante.
Envoyez une requête à la méthode regionHealthAggregationPolicies.patch. Ignorez les champs des propriétés que vous ne souhaitez pas mettre à jour.

Méthode HTTP et URL :
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY
```
Corps JSON de la requête :
```
{
  "description": "DESCRIPTION",
  "healthyPercentThreshold": PERCENT_HEALTHY,
  "minHealthyThreshold": MINIMUM_HEALTHY,
  "fingerprint": "FINGERPRINT"
}
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet pour la règle d'agrégation de l'état.
- REGION : région de la règle d'agrégation de l'état.
- POLICY : nom de la stratégie d'agrégation de l'état de santé à mettre à jour.
- DESCRIPTION : description mise à jour de la règle.
- PERCENT_HEALTHY : pourcentage minimal mis à jour de points de terminaison d'un service de backend qui doivent être opérationnels pour que la source d'état soit considérée comme opérationnelle (par exemple, 75).
- MINIMUM_HEALTHY : nombre minimal mis à jour de points de terminaison d'un service de backend qui doivent être opérationnels pour que la source d'état soit considérée comme opérationnelle (par exemple, 2).
- FINGERPRINT : valeur à jour de la clé fingerprint que vous avez trouvée à l'étape précédente.

Supprimer une règle d'agrégation des données d'état

Vous pouvez supprimer une règle d'agrégation des données d'état si elle n'est pas associée à une source de données d'état existante.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Règles d'agrégation des données d'état.
Cochez la case située à côté de la règle d'agrégation de l'état que vous souhaitez supprimer.
Cliquez sur Supprimer.
Pour confirmer l'opération, cliquez sur Supprimer.

gcloud

Utilisez la commande gcloud compute health-aggregation-policies delete.

gcloud compute health-aggregation-policies delete POLICY \
    --region=REGION

Remplacez les éléments suivants :

POLICY : nom de la règle d'agrégation des données d'état à supprimer
REGION : région de la règle d'agrégation de l'état

API

Envoyez une requête à la méthode regionHealthAggregationPolicies.delete.

Méthode HTTP et URL :

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour la règle d'agrégation de l'état.
REGION : région de la règle d'agrégation de l'état.
POLICY : nom de la règle d'agrégation de l'état de santé à supprimer.

Gérer les sources de données de santé

Les sections suivantes expliquent comment gérer vos sources de données de santé.

Lister les sources de données d'état

Vous pouvez lister les sources de données de santé que vous avez configurées.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Sources de santé.

gcloud

Pour répertorier toutes les sources d'état d'une région, utilisez la commande gcloud compute health-sources list.

gcloud compute health-sources list \
    --regions=REGION

Remplacez REGION par la région des sources de données d'état.

API

Pour lister toutes les sources de données de santé dans une région, envoyez une requête à la méthode regionHealthSources.list.

Méthode HTTP et URL :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour la source de données sur la santé.
REGION : région des sources de données sur la santé.

Décrire une source de données d'état

Vous pouvez décrire une source de données sur l'état de santé pour en afficher les détails.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Sources de santé.
Cliquez sur le nom de la source de données sur la santé que vous souhaitez décrire.

gcloud

Utilisez la commande gcloud compute health-sources describe.

gcloud compute health-sources describe HEALTH_SOURCE \
    --region=REGION

Remplacez les éléments suivants :

HEALTH_SOURCE : nom de la source de données de santé
REGION : région de la source de données de santé

API

Envoyez une requête à la méthode regionHealthSources.get.

Méthode HTTP et URL :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour la source de données sur la santé.
REGION : région de la source de données sur la santé.
HEALTH_SOURCE : nom de la source de données sur la santé.

Mettre à jour une source de données d'état

Vous pouvez modifier la description, le service de backend ou la règle d'agrégation des données d'état d'une source d'état existante.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Sources de santé.
Cliquez sur le nom de la source de données de santé que vous souhaitez modifier.
Cliquez sur Modifier.
Modifiez les champs que vous souhaitez modifier.
Cliquez sur Enregistrer.

gcloud

Exécutez la commande gcloud compute health-sources update. Ignorez les options des propriétés que vous ne souhaitez pas mettre à jour.

gcloud compute health-sources update HEALTH_SOURCE \
    --region=REGION \
    --description="DESCRIPTION" \
    --sources=BACKEND_SERVICE \
    --health-aggregation-policy=POLICY

Remplacez les éléments suivants :

HEALTH_SOURCE : nom de la source d'état à mettre à jour
REGION : région de la source de données de santé
DESCRIPTION : description mise à jour de la source de données de santé
BACKEND_SERVICE : nom d'un service de backend à utiliser comme source d'état

Le service de backend doit répondre aux exigences suivantes :
- Il doit avoir un schéma d'équilibrage de charge de type INTERNAL ou INTERNAL_MANAGED.
- Il doit se trouver dans la même région que la source de données de santé que vous créez.
- Ses backends doivent être des groupes d'instances ou des groupes de points de terminaison du réseau de type GCE_VM_IP ou GCE_VM_IP_PORT.
POLICY : nom d'une règle d'agrégation de données de santé mise à jour à appliquer à cette source de données de santé.

API

Décrivez la source de données de santé et notez la valeur de la clé fingerprint, que vous utiliserez à l'étape suivante.
Envoyez une requête à la méthode regionHealthSources.patch. Ignorez les champs des propriétés que vous ne souhaitez pas mettre à jour.

Méthode HTTP et URL :
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE
```
Corps JSON de la requête :
```
{
  "description": "DESCRIPTION",
  "sources": [
    "projects/PROJECT_ID/regions/REGION/backendServices/BACKEND_SERVICE"
  ],
  "healthAggregationPolicy": "projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY",
  "fingerprint": "FINGERPRINT"
}
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet pour la source de données sur la santé.
- REGION : région de la source de données sur la santé.
- HEALTH_SOURCE : nom de la source d'état à mettre à jour.
- DESCRIPTION : description mise à jour de la source de données de santé.
- BACKEND_SERVICE : nom d'un service de backend à utiliser comme source d'état.
  
  Le service de backend doit répondre aux exigences suivantes :
  - Il doit avoir un schéma d'équilibrage de charge de type INTERNAL ou INTERNAL_MANAGED.
  - Il doit se trouver dans la même région que la source de données de santé que vous créez.
  - Ses backends doivent être des groupes d'instances ou des groupes de points de terminaison du réseau de type GCE_VM_IP ou GCE_VM_IP_PORT.
- POLICY : stratégie d'agrégation de l'état de santé mise à jour à appliquer à cette source d'état de santé.
- FINGERPRINT : valeur à jour de la clé fingerprint que vous avez trouvée à l'étape précédente.

Supprimer une source de données d'état

Vous pouvez supprimer une source d'état si elle n'est pas associée à une vérification de l'état composite existante.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Sources de santé.
Cochez la case à côté de la source de données de santé que vous souhaitez supprimer.
Cliquez sur Supprimer.
Pour confirmer l'opération, cliquez sur Supprimer.

gcloud

Exécutez la commande gcloud compute health-sources delete.

gcloud compute health-sources delete HEALTH_SOURCE \
    --region=REGION

Remplacez les éléments suivants :

HEALTH_SOURCE : nom de la source de données sur l'état de santé à supprimer
REGION : région de la source de données de santé

API

Envoyez une requête à la méthode regionHealthSources.delete.

Méthode HTTP et URL :

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour la source de données sur la santé.
REGION : région de la source de données sur la santé.
HEALTH_SOURCE : nom de la source de données sur la santé à supprimer.

Gérer les vérifications d'état composites

Les sections suivantes expliquent comment gérer vos vérifications d'état composites.

Lister les vérifications d'état composites

Vous pouvez lister les vérifications d'état composites que vous avez configurées.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Vérifications d'état composites.

gcloud

Pour répertorier toutes les vérifications d'état composites dans une région, utilisez la commande gcloud compute composite-health-checks list.

gcloud compute composite-health-checks list \
    --regions=REGION

Remplacez REGION par la région des vérifications d'état composites.

API

Pour répertorier toutes les vérifications d'état composites dans une région, envoyez une requête à la méthode regionCompositeHealthChecks.list.

Méthode HTTP et URL :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour le vérification de l'état composite.
REGION : région des vérifications d'état composites.

Décrire une vérification de l'état composite

Vous pouvez décrire une vérification de l'état composite pour en afficher les détails.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Vérifications d'état composites.
Cliquez sur le nom de la vérification de l'état composite que vous souhaitez décrire.

gcloud

Utilisez la commande gcloud compute composite-health-checks describe.

gcloud compute composite-health-checks describe COMPOSITE_HEALTH_CHECK \
    --region=REGION

Remplacez les éléments suivants :

COMPOSITE_HEALTH_CHECK : nom de la vérification de l'état composite
REGION : région de la vérification de l'état composite.

API

Envoyez une requête à la méthode regionCompositeHealthChecks.get.

Méthode HTTP et URL :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour le vérification de l'état composite.
REGION : région de la vérification de l'état composite.
COMPOSITE_HEALTH_CHECK : nom de la vérification de l'état composite.

Mettre à jour une vérification de l'état composite

Vous pouvez modifier la description, les sources d'état ou la destination d'état d'une vérification de l'état'état composite.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Vérifications d'état composites.
Cliquez sur le nom de la vérification de l'état composite que vous souhaitez mettre à jour.
Cliquez sur Modifier.
Modifiez les champs que vous souhaitez modifier.
Cliquez sur Enregistrer.

gcloud

Utilisez la commande gcloud compute composite-health-checks update. Ignorez les options des propriétés que vous ne souhaitez pas mettre à jour.

gcloud compute composite-health-checks update COMPOSITE_HEALTH_CHECK \
    --region=REGION \
    --description="DESCRIPTION" \
    --health-sources=HEALTH_SOURCES \
    --health-destination=HEALTH_DESTINATION

Remplacez les éléments suivants :

COMPOSITE_HEALTH_CHECK : nom de la vérification de l'état composite à mettre à jour
REGION : région de la vérification de l'état composite.
DESCRIPTION : description mise à jour
HEALTH_SOURCES : noms d'une ou de plusieurs sources d'état à associer à la vérification de l'état d'état composite

Vous pouvez inclure plusieurs sources de données de santé dans une liste séparée par des virgules.
HEALTH_DESTINATION : URI de la règle de transfert qui reçoit l'état de santé composite de ce contrôle de santé composite (par exemple, projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE).

La règle de transfert doit être associée à un équilibreur de charge du producteur compatible avec les vérifications d'état composites et qui répond aux exigences suivantes :
- Il doit avoir un schéma d'équilibrage de charge de type INTERNAL ou INTERNAL_MANAGED.
- Elle doit se trouver dans la même région que la vérification de l'état composite.

API

Décrivez la vérification d'état composite et notez la valeur de la clé fingerprint, que vous utiliserez à l'étape suivante.
Envoyez une requête à la méthode regionCompositeHealthChecks.patch. Ignorez les champs des propriétés que vous ne souhaitez pas mettre à jour.

Méthode HTTP et URL :
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK
```
Corps JSON de la requête :
```
{
  "description": "DESCRIPTION",
  "healthSources": [
    "projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE"
  ],
  "healthDestination": "projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE",
  "fingerprint": "FINGERPRINT"
}
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet pour le vérification de l'état composite.
- REGION : région de la vérification de l'état composite.
- COMPOSITE_HEALTH_CHECK : nom de la vérification de l'état composite à mettre à jour.
- DESCRIPTION : description mise à jour.
- HEALTH_SOURCE : nom d'une source d'état de santé à associer à la vérification de l'état d'état composite. Pour associer plusieurs sources de données d'état, ajoutez chaque source au tableau healthSources.
- FORWARDING_RULE : règle de transfert qui reçoit l'état de fonctionnement composite de cette vérification de l'état composite.
- FINGERPRINT : valeur à jour de la clé fingerprint que vous avez trouvée à l'étape précédente.

Supprimer une vérification de l'état composite

Vous pouvez supprimer une vérification de l'état composite.

Console

Dans la console Google Cloud , accédez à la page État de santé composite :

Accéder à l'état de santé composite
Cliquez sur Vérifications d'état composites.
Cochez la case à côté du vérification de l'état composite que vous souhaitez supprimer.
Cliquez sur Supprimer.
Pour confirmer l'opération, cliquez sur Supprimer.

gcloud

Utilisez la commande gcloud compute composite-health-checks delete.

gcloud compute composite-health-checks delete COMPOSITE_HEALTH_CHECK \
    --region=REGION

Remplacez les éléments suivants :

COMPOSITE_HEALTH_CHECK : nom du vérification de l'état composite à supprimer
REGION : région de la vérification de l'état composite.

API

Envoyez une requête à la méthode regionCompositeHealthChecks.delete.

Méthode HTTP et URL :

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour le vérification de l'état composite.
COMPOSITE_HEALTH_CHECK : nom du vérification de l'état composite à supprimer.
REGION : région de la vérification de l'état composite.