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

Consulta, actualiza y borra recursos de Composite Health

En esta página, se describe cómo administrar tus recursos de Composite Health después de crearlos. Puedes enumerar, describir, actualizar y borrar políticas de agregación de estado, fuentes de estado y verificaciones de estado compuestas.

Administra las políticas de agregación de estado

En esta sección, se describe cómo administrar las políticas de agregación de la salud.

Enumera las políticas de agregación de estado

Puedes enumerar las políticas de agregación de estado que configuraste.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Políticas de agregación de estado.

gcloud

Para enumerar todas las políticas de agregación de estado en una región, usa el comando gcloud compute health-aggregation-policies list.

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

Reemplaza REGION por la región de las políticas de agregación de datos de salud.

API

Para enumerar todas las políticas de agregación de estado en una región, envía una solicitud al método regionHealthAggregationPolicies.list.

Método HTTP y URL:

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

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la política de agregación de datos de salud.
REGION: Es la región de las políticas de agregación de estado.

Describe una política de agregación de estado

Puedes describir una política de agregación de estado para ver sus detalles.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Políticas de agregación de estado.
Haz clic en el nombre de la política de agregación de estado que deseas describir.

gcloud

Usa el comando gcloud compute health-aggregation-policies describe

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

Reemplaza lo siguiente:

POLICY: el nombre de la política de agregación de estado
REGION: Es la región de la política de agregación de estado.

API

Envía una solicitud al método regionHealthAggregationPolicies.get.

Método HTTP y URL:

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

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la política de agregación de datos de salud.
REGION: Es la región de la política de agregación de estado.
POLICY: Es el nombre de la política de agregación de estado.

Actualiza una política de agregación de estado

Puedes actualizar la descripción, el umbral de porcentaje de buen estado o el umbral mínimo de buen estado de una política de agregación de estado.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Políticas de agregación de estado.
Haz clic en el nombre de la política de agregación de estado que deseas actualizar.
Haz clic en Editar.
Actualiza los campos que deseas cambiar.
Haz clic en Guardar.

gcloud

Usa el comando gcloud compute health-aggregation-policies update. Omite las marcas de las propiedades que no deseas actualizar.

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

Reemplaza lo siguiente:

POLICY: Es el nombre de la política de agregación de la salud que se actualizará.
REGION: Es la región de la política de agregación de estado.
DESCRIPTION: una descripción actualizada de la política
PERCENT_HEALTHY: Es el porcentaje mínimo actualizado de extremos en un servicio de backend que deben estar en buen estado para que la fuente de estado se considere en buen estado, por ejemplo, 75.
MINIMUM_HEALTHY: Es la cantidad mínima actualizada de extremos en un servicio de backend que deben estar en buen estado para que la fuente de estado se considere en buen estado, por ejemplo, 2.

API

Describe la política de agregación de estado y anota el valor de la clave fingerprint, que usarás en el siguiente paso.
Envía una solicitud al método regionHealthAggregationPolicies.patch. Omite los campos de las propiedades que no quieras actualizar.

Método HTTP y URL:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY
```
Cuerpo JSON de la solicitud:
```
{
  "description": "DESCRIPTION",
  "healthyPercentThreshold": PERCENT_HEALTHY,
  "minHealthyThreshold": MINIMUM_HEALTHY,
  "fingerprint": "FINGERPRINT"
}
```
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto de la política de agregación de datos de salud.
- REGION: Es la región de la política de agregación de estado.
- POLICY: Es el nombre de la política de agregación de estado que se actualizará.
- DESCRIPTION: Es una descripción actualizada de la política.
- PERCENT_HEALTHY: Es el porcentaje mínimo actualizado de extremos en un servicio de backend que deben estar en buen estado para que la fuente de estado se considere en buen estado, por ejemplo, 75.
- MINIMUM_HEALTHY: Es la cantidad mínima actualizada de extremos en un servicio de backend que deben estar en buen estado para que la fuente de estado se considere en buen estado, por ejemplo, 2.
- FINGERPRINT: Es el valor actualizado de la clave fingerprint que encontraste en el paso anterior.

Borra una política de agregación de estado

Puedes borrar una política de agregación de estado si no está asociada a una fuente de estado existente.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Políticas de agregación de estado.
Selecciona la casilla de verificación junto a la política de agregación de la salud que deseas borrar.
Haz clic en Borrar.
Para confirmar la acción, haz clic en Borrar.

gcloud

Usa el comando gcloud compute health-aggregation-policies delete

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

Reemplaza lo siguiente:

POLICY: el nombre de la política de agregación de estado que se borrará
REGION: Es la región de la política de agregación de estado.

API

Envía una solicitud al método regionHealthAggregationPolicies.delete.

Método HTTP y URL:

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

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la política de agregación de datos de salud.
REGION: Es la región de la política de agregación de estado.
POLICY: Es el nombre de la política de agregación de estado que se borrará.

Cómo administrar las fuentes de estado

En las siguientes secciones, se describe cómo administrar tus fuentes de datos de salud.

Enumera las fuentes de estado

Puedes enumerar las fuentes de datos de salud que configuraste.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Fuentes de datos de salud.

gcloud

Para enumerar todas las fuentes de estado de una región, usa el comando gcloud compute health-sources list.

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

Reemplaza REGION por la región de las fuentes de estado.

API

Para enumerar todas las fuentes de datos de salud en una región, envía una solicitud al método regionHealthSources.list.

Método HTTP y URL:

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

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la fuente de datos de salud.
REGION: Es la región de las fuentes de estado.

Cómo describir una fuente de estado

Puedes describir una fuente de datos de salud para ver sus detalles.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Fuentes de datos de salud.
Haz clic en el nombre de la fuente de datos de salud que deseas describir.

gcloud

Usa el comando gcloud compute health-sources describe

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

Reemplaza lo siguiente:

HEALTH_SOURCE: el nombre de la fuente de datos de salud
REGION: Es la región de la fuente de datos de salud.

API

Envía una solicitud al método regionHealthSources.get.

Método HTTP y URL:

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

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la fuente de datos de salud.
REGION: Es la región de la fuente de estado.
HEALTH_SOURCE: Es el nombre de la fuente de datos de salud.

Actualiza una fuente de estado

Puedes actualizar la descripción, el servicio de backend o la política de agregación de estado de una fuente de estado existente.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Fuentes de datos de salud.
Haz clic en el nombre de la fuente de datos de salud que deseas actualizar.
Haz clic en Editar.
Actualiza los campos que deseas cambiar.
Haz clic en Guardar.

gcloud

Usa el comando gcloud compute health-sources update. Omite las marcas de las propiedades que no deseas actualizar.

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

Reemplaza lo siguiente:

HEALTH_SOURCE: Es el nombre de la fuente de estado que se actualizará.
REGION: Es la región de la fuente de datos de salud.
DESCRIPTION: Es una descripción actualizada de la fuente de datos de salud.
BACKEND_SERVICE: Es el nombre de un servicio de backend que se usará como fuente de estado.

El servicio de backend debe cumplir con los siguientes requisitos:
- Debe tener un esquema de balanceo de cargas de INTERNAL o INTERNAL_MANAGED.
- Debe estar en la misma región que la fuente de datos de salud que creas.
- Sus backends deben ser grupos de instancias o grupos de extremos de red de tipo GCE_VM_IP o GCE_VM_IP_PORT.
POLICY: Es el nombre de una política de agregación de salud actualizada que se aplicará a esta fuente de datos de salud.

API

Describe la fuente de datos de salud y anota el valor de la clave fingerprint, que usarás en el siguiente paso.
Envía una solicitud al método regionHealthSources.patch. Omite los campos de las propiedades que no quieras actualizar.

Método HTTP y URL:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE
```
Cuerpo JSON de la solicitud:
```
{
  "description": "DESCRIPTION",
  "sources": [
    "projects/PROJECT_ID/regions/REGION/backendServices/BACKEND_SERVICE"
  ],
  "healthAggregationPolicy": "projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY",
  "fingerprint": "FINGERPRINT"
}
```
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto de la fuente de datos de salud.
- REGION: Es la región de la fuente de estado.
- HEALTH_SOURCE: Es el nombre de la fuente de estado que se actualizará.
- DESCRIPTION: Es una descripción actualizada de la fuente de datos de salud.
- BACKEND_SERVICE: Es el nombre de un servicio de backend que se usará como fuente de estado.
  
  El servicio de backend debe cumplir con los siguientes requisitos:
  - Debe tener un esquema de balanceo de cargas de INTERNAL o INTERNAL_MANAGED.
  - Debe estar en la misma región que la fuente de datos de salud que creas.
  - Sus backends deben ser grupos de instancias o grupos de extremos de red de tipo GCE_VM_IP o GCE_VM_IP_PORT.
- POLICY: Es una política de agregación de salud actualizada que se aplicará a esta fuente de salud.
- FINGERPRINT: Es el valor actualizado de la clave fingerprint que encontraste en el paso anterior.

Cómo borrar una fuente de información de estado

Puedes borrar una fuente de datos de salud si no está asociada a una verificación de estado compuesta existente.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Fuentes de datos de salud.
Selecciona la casilla de verificación junto a la fuente de datos de salud que deseas borrar.
Haz clic en Borrar.
Para confirmar la acción, haz clic en Borrar.

gcloud

Usa el comando gcloud compute health-sources delete.

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

Reemplaza lo siguiente:

HEALTH_SOURCE: Es el nombre de la fuente de estado que se borrará.
REGION: Es la región de la fuente de datos de salud.

API

Envía una solicitud al método regionHealthSources.delete.

Método HTTP y URL:

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

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto de la fuente de datos de salud.
REGION: Es la región de la fuente de estado.
HEALTH_SOURCE: Es el nombre de la fuente de datos de salud que se borrará.

Administra las verificaciones de estado compuestas

En las siguientes secciones, se describe cómo administrar tus verificaciones de estado compuestas.

Enumera las verificaciones de estado compuestas

Puedes enumerar las verificaciones de estado compuestas que configuraste.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Verificaciones de estado compuestas.

gcloud

Para enumerar todas las verificaciones de estado compuestas en una región, usa el comando gcloud compute composite-health-checks list.

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

Reemplaza REGION por la región de las verificaciones de estado compuestas.

API

Para enumerar todas las verificaciones de estado compuestas en una región, envía una solicitud al método regionCompositeHealthChecks.list.

Método HTTP y URL:

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

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto para la verificación de estado compuesta.
REGION: Es la región de las verificaciones de estado compuestas.

Describe una verificación de estado compuesta

Puedes describir una verificación de estado compuesta para ver sus detalles.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Verificaciones de estado compuestas.
Haz clic en el nombre de la verificación de estado compuesta que deseas describir.

gcloud

Usa el comando gcloud compute composite-health-checks describe

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

Reemplaza lo siguiente:

COMPOSITE_HEALTH_CHECK: el nombre de la verificación de estado compuesta
REGION: la región de la verificación de estado compuesta

API

Envía una solicitud al método regionCompositeHealthChecks.get.

Método HTTP y URL:

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

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto para la verificación de estado compuesta.
REGION: Es la región de la verificación de estado compuesta.
COMPOSITE_HEALTH_CHECK: Es el nombre de la verificación de estado compuesta.

Actualiza una verificación de estado compuesta

Puedes actualizar la descripción, las fuentes de estado o el destino de estado de una verificación de estado compuesta.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Verificaciones de estado compuestas.
Haz clic en el nombre de la verificación de estado compuesta que deseas actualizar.
Haz clic en Editar.
Actualiza los campos que deseas cambiar.
Haz clic en Guardar.

gcloud

Usa el comando gcloud compute composite-health-checks update. Omite las marcas de las propiedades que no deseas actualizar.

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

Reemplaza lo siguiente:

COMPOSITE_HEALTH_CHECK: Es el nombre de la verificación de estado compuesta que se actualizará.
REGION: la región de la verificación de estado compuesta
DESCRIPTION: Una descripción actualizada
HEALTH_SOURCES: Son los nombres de una o más fuentes de estado que se asociarán con la verificación de estado compuesta.

Puedes incluir varias fuentes de salud en una lista separada por comas.
HEALTH_DESTINATION: Es el URI de la regla de reenvío que recibe el estado de salud compuesto de esta verificación de estado compuesta, por ejemplo, projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE.

La regla de reenvío debe estar asociada con un balanceador de cargas del productor que admita la verificación de estado compuesta y cumpla con los siguientes requisitos:
- Debe tener un esquema de balanceo de cargas de INTERNAL o INTERNAL_MANAGED.
- Debe estar en la misma región que la verificación de estado compuesta.

API

Describe la verificación de estado compuesta y anota el valor de la clave fingerprint, que usarás en el siguiente paso.
Envía una solicitud al método regionCompositeHealthChecks.patch. Omite los campos de las propiedades que no quieras actualizar.

Método HTTP y URL:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK
```
Cuerpo JSON de la solicitud:
```
{
  "description": "DESCRIPTION",
  "healthSources": [
    "projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE"
  ],
  "healthDestination": "projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE",
  "fingerprint": "FINGERPRINT"
}
```
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto para la verificación de estado compuesta.
- REGION: Es la región de la verificación de estado compuesta.
- COMPOSITE_HEALTH_CHECK: Es el nombre de la verificación de estado compuesta que se actualizará.
- DESCRIPTION: Es una descripción actualizada.
- HEALTH_SOURCE: Es el nombre de una fuente de estado para asociar con la verificación de estado compuesta. Para asociar varias fuentes de estado, agrega cada fuente al array healthSources.
- FORWARDING_RULE: Es la regla de reenvío que recibe el estado de salud compuesto de esta verificación de estado compuesta.
- FINGERPRINT: Es el valor actualizado de la clave fingerprint que encontraste en el paso anterior.

Borra una verificación de estado compuesta

Puedes borrar una verificación de estado compuesta.

Console

En la consola de Google Cloud , ve a la página Estado compuesto:

Ir a Composite Health
Haz clic en Verificaciones de estado compuestas.
Selecciona la casilla de verificación junto a la verificación de estado compuesta que deseas borrar.
Haz clic en Borrar.
Para confirmar la acción, haz clic en Borrar.

gcloud

Usa el comando gcloud compute composite-health-checks delete

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

Reemplaza lo siguiente:

COMPOSITE_HEALTH_CHECK: El nombre de la verificación de estado compuesta que se borrará
REGION: la región de la verificación de estado compuesta

API

Envía una solicitud al método regionCompositeHealthChecks.delete.

Método HTTP y URL:

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

Reemplaza lo siguiente:

PROJECT_ID: Es el ID del proyecto para la verificación de estado compuesta.
COMPOSITE_HEALTH_CHECK: Es el nombre de la verificación de estado compuesta que se borrará.
REGION: Es la región de la verificación de estado compuesta.