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
Nella console Google Cloud , vai alla pagina Integrità composita:
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
Nella console Google Cloud , vai alla pagina Integrità composita:
Fai clic su Policy di aggregazione dell'integrità.
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 statoREGION: 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
Nella console Google Cloud , vai alla pagina Integrità composita:
Fai clic su Policy di aggregazione dell'integrità.
Fai clic sul nome della policy di aggregazione dell'integrità da aggiornare.
Fai clic su Modifica.
Aggiorna i campi che vuoi modificare.
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 aggiornareREGION: la regione della policy di aggregazione dell'integritàDESCRIPTION: una descrizione aggiornata della policyPERCENT_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 esempio75MINIMUM_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 esempio2
API
Descrivi la norma di aggregazione dei dati sanitari e annota il valore della chiave
fingerprint, che utilizzerai nel passaggio successivo.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 esempio75.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 esempio2.FINGERPRINT: il valore aggiornato della chiavefingerprintche 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
Nella console Google Cloud , vai alla pagina Integrità composita:
Fai clic su Policy di aggregazione dell'integrità.
Seleziona la casella di controllo accanto alla policy di aggregazione dell'integrità che vuoi eliminare.
Fai clic su Elimina.
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 eliminareREGION: 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
Nella console Google Cloud , vai alla pagina Integrità composita:
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
Nella console Google Cloud , vai alla pagina Integrità composita:
Fai clic su Origini salute.
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 saluteREGION: 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
Nella console Google Cloud , vai alla pagina Integrità composita:
Fai clic su Origini salute.
Fai clic sul nome dell'origine di salute da aggiornare.
Fai clic su Modifica.
Aggiorna i campi che vuoi modificare.
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 aggiornareREGION: la regione dell'origine di integritàDESCRIPTION: una descrizione aggiornata dell'origine dati sanitariBACKEND_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
INTERNALoINTERNAL_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_IPoGCE_VM_IP_PORT.
- Deve avere uno schema di bilanciamento del carico di
POLICY: il nome di una policy di aggregazione aggiornata da applicare a questa origine di dati sanitari.
API
- Descrivi l'origine dei dati sanitari
e annota il valore della chiave
fingerprint, che utilizzerai nel passaggio successivo. 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
INTERNALoINTERNAL_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_IPoGCE_VM_IP_PORT.
- Deve avere uno schema di bilanciamento del carico di
POLICY: una policy di aggregazione dello stato aggiornata da applicare a questa origine dello stato.FINGERPRINT: il valore aggiornato della chiavefingerprintche 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
Nella console Google Cloud , vai alla pagina Integrità composita:
Fai clic su Origini salute.
Seleziona la casella di controllo accanto all'origine dati di salute da eliminare.
Fai clic su Elimina.
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 eliminareREGION: 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
Nella console Google Cloud , vai alla pagina Integrità composita:
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
Nella console Google Cloud , vai alla pagina Integrità composita:
Fai clic su Controlli di integrità compositi.
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à compositoREGION: 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
Nella console Google Cloud , vai alla pagina Integrità composita:
Fai clic su Controlli di integrità compositi.
Fai clic sul nome del controllo di integrità composito che vuoi aggiornare.
Fai clic su Modifica.
Aggiorna i campi che vuoi modificare.
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 aggiornareREGION: la regione del controllo di integrità compositoDESCRIPTION: una descrizione aggiornataHEALTH_SOURCES: i nomi di una o più origini di integrità da associare al controllo di integrità compositoPuoi 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 esempioprojects/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
INTERNALoINTERNAL_MANAGED. - Deve trovarsi nella stessa regione del controllo di integrità composito.
- Deve avere uno schema di bilanciamento del carico di
API
Descrivi il controllo di integrità composito e annota il valore della chiave
fingerprint, che utilizzerai nel passaggio successivo.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'arrayhealthSources.FORWARDING_RULE: la regola di forwarding che riceve lo stato di integrità composito da questo controllo di integrità composito.FINGERPRINT: il valore aggiornato della chiavefingerprintche hai trovato nel passaggio precedente.
Elimina un controllo di integrità composito
Puoi eliminare un controllo di integrità composito.
Console
Nella console Google Cloud , vai alla pagina Integrità composita:
Fai clic su Controlli di integrità compositi.
Seleziona la casella di controllo accanto al controllo di integrità composito che vuoi eliminare.
Fai clic su Elimina.
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 eliminareREGION: 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.