Visualizzare, aggiornare ed eliminare le risorse di Composite Health

Questa pagina descrive come gestire le risorse Composite Health dopo averle create. Puoi elencare, descrivere, aggiornare ed eliminare le policy di aggregazione dell'integrità, le origini di integrità e i controlli di integrità compositi.

Gestisci le policy di aggregazione dell'integrità

Questa sezione descrive come gestire le norme di aggregazione dei dati sanitari.

Elenca le policy di aggregazione dell'integrità

Puoi elencare le policy di aggregazione dell'integrità che hai configurato.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Policy di aggregazione dell'integrità.

gcloud

Per elencare tutte le policy di aggregazione dell'integrità in una regione, utilizza il comando gcloud compute health-aggregation-policies list.

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

Sostituisci REGION con la regione delle policy di aggregazione dell'integrità.

API

Per elencare tutte le policy di aggregazione dell'integrità in una regione, invia una richiesta al metodo regionHealthAggregationPolicies.list.

Metodo HTTP e URL:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per la policy di aggregazione dello stato.
  • REGION: la regione delle policy di aggregazione dello stato.

Descrivi una policy di aggregazione dell'integrità

Puoi descrivere una policy di aggregazione dell'integrità per visualizzarne i dettagli.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Policy di aggregazione dell'integrità.

  3. Fai clic sul nome della policy di aggregazione dell'integrità che vuoi descrivere.

gcloud

Utilizza il comando gcloud compute health-aggregation-policies describe.

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

Sostituisci quanto segue:

  • POLICY: il nome della policy di aggregazione dello stato
  • REGION: la regione della policy di aggregazione dell'integrità

API

Invia una richiesta al metodo regionHealthAggregationPolicies.get.

Metodo HTTP e URL:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per la policy di aggregazione dello stato.
  • REGION: la regione della policy di aggregazione dello stato.
  • POLICY: il nome della policy di aggregazione dello stato.

Aggiornare una policy di aggregazione dell'integrità

Puoi aggiornare la descrizione, la soglia di percentuale di integrità o la soglia di integrità minima di una policy di aggregazione dell'integrità.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Policy di aggregazione dell'integrità.

  3. Fai clic sul nome della policy di aggregazione dell'integrità da aggiornare.

  4. Fai clic su Modifica.

  5. Aggiorna i campi che vuoi modificare.

  6. Fai clic su Salva.

gcloud

Utilizza il comando gcloud compute health-aggregation-policies update. Ometti i flag per le proprietà che non vuoi aggiornare.

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

Sostituisci quanto segue:

  • POLICY: il nome della policy di aggregazione dello stato di salute da aggiornare
  • REGION: la regione della policy di aggregazione dell'integrità
  • DESCRIPTION: una descrizione aggiornata della policy
  • PERCENT_HEALTHY: la percentuale minima aggiornata di endpoint in un servizio di backend che devono essere integri affinché l'origine di integrità sia considerata integra, ad esempio 75
  • MINIMUM_HEALTHY: il numero minimo aggiornato di endpoint in un servizio di backend che devono essere integri affinché l'origine di integrità sia considerata integra, ad esempio 2

API

  1. Descrivi la norma di aggregazione dei dati sanitari e annota il valore della chiave fingerprint, che utilizzerai nel passaggio successivo.

  2. Invia una richiesta al metodo regionHealthAggregationPolicies.patch. Ometti i campi per le proprietà che non vuoi aggiornare.

    Metodo HTTP e URL:

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

    Corpo JSON della richiesta:

    {
      "description": "DESCRIPTION",
      "healthyPercentThreshold": PERCENT_HEALTHY,
      "minHealthyThreshold": MINIMUM_HEALTHY,
      "fingerprint": "FINGERPRINT"
    }
    

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto per la policy di aggregazione dello stato.
    • REGION: la regione della policy di aggregazione dello stato.
    • POLICY: il nome della policy di aggregazione dello stato da aggiornare.
    • DESCRIPTION: una descrizione aggiornata della policy.
    • PERCENT_HEALTHY: la percentuale minima aggiornata di endpoint in un servizio di backend che devono essere integri affinché l'origine di controllo di integrità sia considerata integra, ad esempio 75.
    • MINIMUM_HEALTHY: il numero minimo aggiornato di endpoint in un servizio di backend che devono essere integri affinché l'origine di integrità sia considerata integra, ad esempio 2.
    • FINGERPRINT: il valore aggiornato della chiave fingerprint che hai trovato nel passaggio precedente.

Eliminare una policy di aggregazione dell'integrità

Puoi eliminare una policy di aggregazione dell'integrità se non è associata a un'origine dell'integrità esistente.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Policy di aggregazione dell'integrità.

  3. Seleziona la casella di controllo accanto alla policy di aggregazione dell'integrità che vuoi eliminare.

  4. Fai clic su Elimina.

  5. Per confermare, fai clic su Elimina.

gcloud

Utilizza il comando gcloud compute health-aggregation-policies delete.

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

Sostituisci quanto segue:

  • POLICY: il nome della policy di aggregazione dell'integrità da eliminare
  • REGION: la regione della policy di aggregazione dell'integrità

API

Invia una richiesta al metodo regionHealthAggregationPolicies.delete.

Metodo HTTP e URL:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per la policy di aggregazione dello stato.
  • REGION: la regione della policy di aggregazione dello stato.
  • POLICY: il nome della policy di aggregazione dello stato da eliminare.

Gestire le origini di salute

Le sezioni seguenti descrivono come gestire le fonti di dati sanitari.

Elenca le origini integrità

Puoi elencare le fonti sanitarie che hai configurato.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Origini salute.

gcloud

Per elencare tutte le origini di dati sanitari in una regione, utilizza il comando gcloud compute health-sources list.

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

Sostituisci REGION con la regione delle origini di integrità.

API

Per elencare tutte le origini di dati sanitari in una regione, invia una richiesta al metodo regionHealthSources.list.

Metodo HTTP e URL:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per l'origine dei dati sanitari.
  • REGION: la regione delle origini di dati sanitari.

Descrivere un'origine integrità

Puoi descrivere una fonte di salute per visualizzarne i dettagli.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Origini salute.

  3. Fai clic sul nome dell'origine di salute che vuoi descrivere.

gcloud

Utilizza il comando gcloud compute health-sources describe.

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

Sostituisci quanto segue:

  • HEALTH_SOURCE: il nome dell'origine dati per la salute
  • REGION: la regione dell'origine di integrità

API

Invia una richiesta al metodo regionHealthSources.get.

Metodo HTTP e URL:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per l'origine dei dati sanitari.
  • REGION: la regione dell'origine di integrità.
  • HEALTH_SOURCE: il nome dell'origine di integrità.

Aggiornare un'origine integrità

Puoi aggiornare la descrizione, il servizio di backend o la policy di aggregazione dell'integrità di una fonte sanitaria esistente.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Origini salute.

  3. Fai clic sul nome dell'origine di salute da aggiornare.

  4. Fai clic su Modifica.

  5. Aggiorna i campi che vuoi modificare.

  6. Fai clic su Salva.

gcloud

Utilizza il comando gcloud compute health-sources update. Ometti i flag per le proprietà che non vuoi aggiornare.

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

Sostituisci quanto segue:

  • HEALTH_SOURCE: il nome dell'origine di integrità da aggiornare
  • REGION: la regione dell'origine di integrità
  • DESCRIPTION: una descrizione aggiornata dell'origine dati sanitari
  • BACKEND_SERVICE: il nome di un servizio di backend da utilizzare come origine dell'integrità

    Il servizio di backend deve soddisfare i seguenti requisiti:

    • Deve avere uno schema di bilanciamento del carico di INTERNAL o INTERNAL_MANAGED.
    • Deve trovarsi nella stessa regione dell'origine dati sanitari che stai creando.
    • I relativi backend devono essere gruppi di istanze o gruppi di endpoint di rete di tipo GCE_VM_IP o GCE_VM_IP_PORT.
  • POLICY: il nome di una policy di aggregazione aggiornata da applicare a questa origine di dati sanitari.

API

  1. Descrivi l'origine dei dati sanitari e annota il valore della chiave fingerprint, che utilizzerai nel passaggio successivo.
  2. Invia una richiesta al metodo regionHealthSources.patch. Ometti i campi per le proprietà che non vuoi aggiornare.

    Metodo HTTP e URL:

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

    Corpo JSON della richiesta:

    {
      "description": "DESCRIPTION",
      "sources": [
        "projects/PROJECT_ID/regions/REGION/backendServices/BACKEND_SERVICE"
      ],
      "healthAggregationPolicy": "projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY",
      "fingerprint": "FINGERPRINT"
    }
    

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto per l'origine dei dati sanitari.
    • REGION: la regione dell'origine di integrità.
    • HEALTH_SOURCE: il nome dell'origine di integrità da aggiornare.
    • DESCRIPTION: una descrizione aggiornata dell'origine dati sanitari.
    • BACKEND_SERVICE: il nome di un servizio di backend da utilizzare come origine dell'integrità.

      Il servizio di backend deve soddisfare i seguenti requisiti:

      • Deve avere uno schema di bilanciamento del carico di INTERNAL o INTERNAL_MANAGED.
      • Deve trovarsi nella stessa regione dell'origine dati sanitari che stai creando.
      • I relativi backend devono essere gruppi di istanze o gruppi di endpoint di rete di tipo GCE_VM_IP o GCE_VM_IP_PORT.
    • POLICY: una policy di aggregazione dello stato aggiornata da applicare a questa origine dello stato.

    • FINGERPRINT: il valore aggiornato della chiave fingerprint che hai trovato nel passaggio precedente.

Eliminare una fonte di integrità

Puoi eliminare un'origine di controllo di integrità se non è associata a un controllo di integrità composito esistente.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Origini salute.

  3. Seleziona la casella di controllo accanto all'origine dati di salute da eliminare.

  4. Fai clic su Elimina.

  5. Per confermare, fai clic su Elimina.

gcloud

Utilizza il comando gcloud compute health-sources delete.

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

Sostituisci quanto segue:

  • HEALTH_SOURCE: il nome dell'origine di dati sanitari da eliminare
  • REGION: la regione dell'origine di integrità

API

Invia una richiesta al metodo regionHealthSources.delete.

Metodo HTTP e URL:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per l'origine dei dati sanitari.
  • REGION: la regione dell'origine di integrità.
  • HEALTH_SOURCE: il nome dell'origine salute da eliminare.

Gestire i controlli di integrità compositi

Le sezioni seguenti descrivono come gestire i controlli di integrità compositi.

Elenca i controlli di integrità compositi

Puoi elencare i controlli di integrità compositi che hai configurato.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Controlli di integrità compositi.

gcloud

Per elencare tutti i controlli di integrità compositi in una regione, utilizza il comando gcloud compute composite-health-checks list.

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

Sostituisci REGION con la regione dei controlli di integrità compositi.

API

Per elencare tutti i controlli di integrità compositi in una regione, invia una richiesta al metodo regionCompositeHealthChecks.list.

Metodo HTTP e URL:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per il controllo di integrità composito.
  • REGION: la regione dei controlli di integrità compositi.

Descrivere un controllo di integrità composito

Puoi descrivere un controllo di integrità composito per visualizzarne i dettagli.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Controlli di integrità compositi.

  3. Fai clic sul nome del controllo di integrità composito che vuoi descrivere.

gcloud

Utilizza il comando gcloud compute composite-health-checks describe.

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

Sostituisci quanto segue:

  • COMPOSITE_HEALTH_CHECK: il nome del controllo di integrità composito
  • REGION: la regione del controllo di integrità composito

API

Invia una richiesta al metodo regionCompositeHealthChecks.get.

Metodo HTTP e URL:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per il controllo di integrità composito.
  • REGION: la regione del controllo di integrità composito.
  • COMPOSITE_HEALTH_CHECK: il nome del controllo di integrità composito.

Aggiorna un controllo di integrità composito

Puoi aggiornare la descrizione, le origini o la destinazione di integrità di un controllo di integrità composito.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Controlli di integrità compositi.

  3. Fai clic sul nome del controllo di integrità composito che vuoi aggiornare.

  4. Fai clic su Modifica.

  5. Aggiorna i campi che vuoi modificare.

  6. Fai clic su Salva.

gcloud

Utilizza il comando gcloud compute composite-health-checks update. Ometti i flag per le proprietà che non vuoi aggiornare.

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

Sostituisci quanto segue:

  • COMPOSITE_HEALTH_CHECK: il nome del controllo di integrità composito da aggiornare
  • REGION: la regione del controllo di integrità composito
  • DESCRIPTION: una descrizione aggiornata
  • HEALTH_SOURCES: i nomi di una o più origini di integrità da associare al controllo di integrità composito

    Puoi includere più fonti di salute in un elenco separato da virgole.

  • HEALTH_DESTINATION: l'URI della regola di forwarding che riceve lo stato di integrità composito da questo controllo di integrità composito, ad esempio projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE.

    La regola di forwarding deve essere associata a un bilanciatore del carico del produttore che supporta il controllo di integrità composito e soddisfa i seguenti requisiti:

    • Deve avere uno schema di bilanciamento del carico di INTERNAL o INTERNAL_MANAGED.
    • Deve trovarsi nella stessa regione del controllo di integrità composito.

API

  1. Descrivi il controllo di integrità composito e annota il valore della chiave fingerprint, che utilizzerai nel passaggio successivo.

  2. Invia una richiesta al metodo regionCompositeHealthChecks.patch. Ometti i campi per le proprietà che non vuoi aggiornare.

    Metodo HTTP e URL:

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

    Corpo JSON della richiesta:

    {
      "description": "DESCRIPTION",
      "healthSources": [
        "projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE"
      ],
      "healthDestination": "projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE",
      "fingerprint": "FINGERPRINT"
    }
    

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto per il controllo di integrità composito.
    • REGION: la regione del controllo di integrità composito.
    • COMPOSITE_HEALTH_CHECK: il nome del controllo di integrità composito da aggiornare.
    • DESCRIPTION: una descrizione aggiornata.
    • HEALTH_SOURCE: il nome di un'origine di controllo di integrità da associare al controllo di integrità composito. Per associare più origini di integrità, aggiungi ogni origine all'array healthSources.
    • FORWARDING_RULE: la regola di forwarding che riceve lo stato di integrità composito da questo controllo di integrità composito.
    • FINGERPRINT: il valore aggiornato della chiave fingerprint che hai trovato nel passaggio precedente.

Elimina un controllo di integrità composito

Puoi eliminare un controllo di integrità composito.

Console

  1. Nella console Google Cloud , vai alla pagina Integrità composita:

    Vai a Integrità composita

  2. Fai clic su Controlli di integrità compositi.

  3. Seleziona la casella di controllo accanto al controllo di integrità composito che vuoi eliminare.

  4. Fai clic su Elimina.

  5. Per confermare, fai clic su Elimina.

gcloud

Utilizza il comando gcloud compute composite-health-checks delete.

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

Sostituisci quanto segue:

  • COMPOSITE_HEALTH_CHECK: il nome del controllo di integrità composito da eliminare
  • REGION: la regione del controllo di integrità composito

API

Invia una richiesta al metodo regionCompositeHealthChecks.delete.

Metodo HTTP e URL:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per il controllo di integrità composito.
  • COMPOSITE_HEALTH_CHECK: il nome del controllo di integrità composito da eliminare.
  • REGION: la regione del controllo di integrità composito.