Afficher, modifier et supprimer les configurations d'état Private Service Connect

Cette page explique comment gérer vos ressources d'état Private Service Connect après les avoir créées. Vous pouvez lister, décrire, mettre à jour et supprimer les règles d'agrégation de l'é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.

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

Vous pouvez lister toutes les règles d'agrégation des données d'état dans une région.

gcloud

Exécutez la commande gcloud beta compute health-aggregation-policies list.

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

Remplacez REGION par la 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.

gcloud

Exécutez la commande gcloud beta compute health-aggregation-policies describe.

gcloud beta 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

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.

gcloud

Exécutez la commande gcloud beta compute health-aggregation-policies update.

gcloud beta 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'é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)

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

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

gcloud

Exécutez la commande gcloud beta compute health-aggregation-policies delete.

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

Remplacez les éléments suivants :

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

Gérer les sources de santé

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

Lister les sources de données d'état

Vous pouvez lister les sources d'état d'une région.

gcloud

Exécutez la commande gcloud beta compute health-sources list.

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

Remplacez REGION par la région des sources de données sur la santé.

Décrire une source de santé

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

gcloud

Exécutez la commande gcloud beta compute health-sources describe.

gcloud beta 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 sur la santé

Mettre à jour une source de santé

Vous pouvez modifier la description, le service de backend ou la stratégie d'agrégation de l'état d'une source d'état existante.

gcloud

Exécutez la commande gcloud beta compute health-sources update.

gcloud beta 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 de données sur l'état à mettre à jour
  • REGION : région de la source de données sur la santé
  • DESCRIPTION : description mise à jour de la source de données de santé
  • BACKEND_SERVICE : service de backend mis à jour à 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 : règle d'agrégation de données de santé mise à jour à appliquer à cette source de données de santé.

Supprimer une source de données de santé

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

gcloud

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

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

Remplacez les éléments suivants :

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

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 dans une région.

gcloud

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

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

Remplacez REGION par la région des vérifications de l'é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.

gcloud

Exécutez la commande gcloud beta compute composite-health-checks describe.

gcloud beta 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.

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

Vous pouvez modifier la description, les sources médicales ou la destination médicale d'une vérification d'état composite.

gcloud

Exécutez la commande gcloud beta compute composite-health-checks update.

gcloud beta 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 l'état 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 l'état Private Service Connect 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.

Supprimer une vérification de l'état composite

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

gcloud

Exécutez la commande gcloud beta compute composite-health-checks delete.

gcloud beta 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.