Ver, atualizar e excluir recursos de verificação de integridade composta
Esta página descreve como gerenciar os recursos de verificação de integridade composta depois de criados. É possível listar, descrever, atualizar e excluir políticas de agregação de integridade, fontes de integridade e verificações de integridade compostas.
Gerenciar políticas de agregação de integridade
Nesta seção, descrevemos como gerenciar políticas de agregação de integridade.
Listar políticas de agregação de integridade
É possível listar as políticas de agregação de integridade que você configurou.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Políticas de agregação de integridade.
gcloud
Para listar todas as políticas de agregação de integridade em uma região, use o
comando gcloud compute health-aggregation-policies list.
gcloud compute health-aggregation-policies list \
--regions=REGION
Substitua REGION pela região das políticas de agregação de integridade.
API
Para listar todas as políticas de agregação de integridade em uma região, envie uma solicitação para o
método regionHealthAggregationPolicies.list.
Método HTTP e URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies
Substitua:
PROJECT_ID: o ID do projeto da política de agregação de integridade.REGION: a região das políticas de agregação de integridade.
Descrever uma política de agregação de integridade
É possível descrever uma política de agregação de integridade para conferir os detalhes.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Políticas de agregação de integridade.
Clique no nome da política de agregação de integridade que você quer descrever.
gcloud
Use o comando gcloud compute health-aggregation-policies describe.
gcloud compute health-aggregation-policies describe POLICY \
--region=REGION
Substitua:
POLICY: o nome da política de agregação de integridade.REGION: a região da política de agregação de integridade.
API
Envie uma solicitação para o
método regionHealthAggregationPolicies.get.
Método HTTP e URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY
Substitua:
PROJECT_ID: o ID do projeto da política de agregação de integridade.REGION: a região da política de agregação de integridade.POLICY: o nome da política de agregação de integridade.
Atualizar uma política de agregação de integridade
É possível atualizar a descrição, a porcentagem de limite de integridade ou o limite mínimo de integridade de uma política de agregação de integridade.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Políticas de agregação de integridade.
Clique no nome da política de agregação de integridade que você quer atualizar.
Clique em Editar.
Atualize os campos que você quer mudar.
Clique em Salvar.
gcloud
Use o
comando gcloud compute health-aggregation-policies update.
Omita as flags das propriedades que você não quer atualizar.
gcloud compute health-aggregation-policies update POLICY \
--region=REGION \
--description="DESCRIPTION" \
--healthy-percent-threshold=PERCENT_HEALTHY \
--min-healthy-threshold=MINIMUM_HEALTHY
Substitua:
POLICY: o nome da política de agregação de integridade a ser atualizada.REGION: a região da política de agregação de integridade.DESCRIPTION: uma descrição atualizada da políticaPERCENT_HEALTHY: a porcentagem mínima atualizada de endpoints em um serviço de back-end que precisam estar íntegros para que a origem de integridade seja considerada íntegra. Por exemplo,75.MINIMUM_HEALTHY: o número mínimo atualizado de endpoints em um serviço de back-end que precisam estar íntegros para que a origem de integridade seja considerada íntegra. Por exemplo,2.
API
Descreva a política de agregação de integridade e anote o valor da chave
fingerprint, que será usada na próxima etapa.Envie uma solicitação para o método
regionHealthAggregationPolicies.patch. Omita os campos das propriedades que você não quer atualizar.Método HTTP e URL:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY
Corpo JSON da solicitação:
{ "description": "DESCRIPTION", "healthyPercentThreshold": PERCENT_HEALTHY, "minHealthyThreshold": MINIMUM_HEALTHY, "fingerprint": "FINGERPRINT" }Substitua:
PROJECT_ID: o ID do projeto da política de agregação de integridade.REGION: a região da política de agregação de integridade.POLICY: o nome da política de agregação de integridade a ser atualizada.DESCRIPTION: uma descrição atualizada da política.PERCENT_HEALTHY: a porcentagem mínima atualizada de endpoints em um serviço de back-end que precisam estar íntegros para que a origem de integridade seja considerada íntegra. Por exemplo,75.MINIMUM_HEALTHY: o número mínimo atualizado de endpoints em um serviço de back-end que precisam estar íntegros para que a origem de integridade seja considerada íntegra. Por exemplo,2.FINGERPRINT: o valor atualizado da chavefingerprintque você encontrou na etapa anterior.
Excluir uma política de agregação de integridade
É possível excluir uma política de agregação de integridade se ela não estiver associada a uma origem de integridade.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Políticas de agregação de integridade.
Marque a caixa de seleção ao lado da política de agregação de integridade que você quer excluir.
Clique em Excluir.
Para confirmar, clique em Excluir.
gcloud
Use o comando gcloud compute health-aggregation-policies delete.
gcloud compute health-aggregation-policies delete POLICY \
--region=REGION
Substitua:
POLICY: o nome da política de agregação de integridade a ser excluída.REGION: a região da política de agregação de integridade.
API
Envie uma solicitação para o
método regionHealthAggregationPolicies.delete.
Método HTTP e URL:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY
Substitua:
PROJECT_ID: o ID do projeto da política de agregação de integridade.REGION: a região da política de agregação de integridade.POLICY: o nome da política de agregação de integridade a ser excluída.
Gerenciar fontes de integridade
As seções a seguir descrevem como gerenciar suas fontes de dados de saúde.
Listar fontes de integridade
É possível listar as fontes de saúde que você configurou.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Fontes de integridade.
gcloud
Para listar todas as fontes de integridade em uma região, use o
comando gcloud compute health-sources list.
gcloud compute health-sources list \
--regions=REGION
Substitua REGION pela região das fontes de integridade.
API
Para listar todas as origens de integridade em uma região, envie uma solicitação ao método regionHealthSources.list.
Método HTTP e URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources
Substitua:
PROJECT_ID: o ID do projeto da origem de dados de saúde.REGION: a região das fontes de integridade.
Descrever uma fonte de integridade
É possível descrever uma fonte de integridade para ver os detalhes dela.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Fontes de integridade.
Clique no nome da fonte de integridade que você quer descrever.
gcloud
Use o comando gcloud compute health-sources describe.
gcloud compute health-sources describe HEALTH_SOURCE \
--region=REGION
Substitua:
HEALTH_SOURCE: o nome da origem de dados de saúde.REGION: a região da fonte de dados de saúde
API
Envie uma solicitação para o
método regionHealthSources.get.
Método HTTP e URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE
Substitua:
PROJECT_ID: o ID do projeto da origem de dados de saúde.REGION: a região da fonte de integridade.HEALTH_SOURCE: o nome da fonte de integridade.
Atualizar uma fonte de integridade
É possível atualizar a descrição, o serviço de back-end ou a política de agregação de integridade de uma origem de integridade atual.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Fontes de integridade.
Clique no nome da fonte de integridade que você quer atualizar.
Clique em Editar.
Atualize os campos que você quer mudar.
Clique em Salvar.
gcloud
Use o comando gcloud compute health-sources update.
Omita as flags das propriedades que você não quer atualizar.
gcloud compute health-sources update HEALTH_SOURCE \
--region=REGION \
--description="DESCRIPTION" \
--sources=BACKEND_SERVICE \
--health-aggregation-policy=POLICY
Substitua:
HEALTH_SOURCE: o nome da origem de dados de saúde a ser atualizada.REGION: a região da fonte de dados de saúdeDESCRIPTION: uma descrição atualizada para a fonte de integridadeBACKEND_SERVICE: o nome de um serviço de back-end a ser usado como origem de integridadeO serviço de back-end precisa atender aos seguintes requisitos:
- Ele precisa ter um esquema de balanceamento de carga de
INTERNALouINTERNAL_MANAGED. - Ela precisa estar na mesma região da origem de dados de saúde que você está criando.
- Os back-ends precisam ser grupos de instâncias ou
grupos de endpoints de rede do tipo
GCE_VM_IPouGCE_VM_IP_PORT.
- Ele precisa ter um esquema de balanceamento de carga de
POLICY: o nome de uma política de agregação de integridade atualizada a ser aplicada a essa origem de integridade.
API
- Descreva a origem de integridade e anote o valor da chave
fingerprint, que será usada na próxima etapa. Envie uma solicitação para o método
regionHealthSources.patch. Omita os campos das propriedades que você não quer atualizar.Método HTTP e URL:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE
Corpo JSON da solicitação:
{ "description": "DESCRIPTION", "sources": [ "projects/PROJECT_ID/regions/REGION/backendServices/BACKEND_SERVICE" ], "healthAggregationPolicy": "projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY", "fingerprint": "FINGERPRINT" }Substitua:
PROJECT_ID: o ID do projeto da origem de dados de saúde.REGION: a região da fonte de integridade.HEALTH_SOURCE: o nome da origem de dados de saúde a ser atualizada.DESCRIPTION: uma descrição atualizada para a fonte de integridade.BACKEND_SERVICE: o nome de um serviço de back-end a ser usado como origem de integridade.O serviço de back-end precisa atender aos seguintes requisitos:
- Ele precisa ter um esquema de balanceamento de carga de
INTERNALouINTERNAL_MANAGED. - Ela precisa estar na mesma região da origem de dados de saúde que você está criando.
- Os back-ends precisam ser grupos de instâncias ou
grupos de endpoints de rede do tipo
GCE_VM_IPouGCE_VM_IP_PORT.
- Ele precisa ter um esquema de balanceamento de carga de
POLICY: uma política de agregação de integridade atualizada a ser aplicada a essa origem de integridade.FINGERPRINT: o valor atualizado da chavefingerprintque você encontrou na etapa anterior.
Excluir uma fonte de integridade
Você pode excluir uma origem de integridade se ela não estiver associada a uma verificação de integridade composta.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Fontes de integridade.
Marque a caixa de seleção ao lado da origem de integridade que você quer excluir.
Clique em Excluir.
Para confirmar, clique em Excluir.
gcloud
Use o comando gcloud compute health-sources delete.
gcloud compute health-sources delete HEALTH_SOURCE \
--region=REGION
Substitua:
HEALTH_SOURCE: o nome da origem de dados de saúde a ser excluídaREGION: a região da fonte de dados de saúde
API
Envie uma solicitação para o
método regionHealthSources.delete.
Método HTTP e URL:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE
Substitua:
PROJECT_ID: o ID do projeto da origem de dados de saúde.REGION: a região da fonte de integridade.HEALTH_SOURCE: o nome da origem de dados de saúde a ser excluída.
Gerenciar verificações de integridade compostas
As seções a seguir descrevem como gerenciar suas verificações de integridade compostas.
Listar verificações de integridade compostas
É possível listar as verificações de integridade compostas que você configurou.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Verificações de integridade compostas.
gcloud
Para listar todas as verificações de integridade compostas em uma região, use o
comando gcloud compute composite-health-checks list.
gcloud compute composite-health-checks list \
--regions=REGION
Substitua REGION pela região das verificações de integridade compostas.
API
Para listar todas as verificações de integridade compostas em uma região, envie uma solicitação ao método regionCompositeHealthChecks.list.
Método HTTP e URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks
Substitua:
PROJECT_ID: o ID do projeto da verificação de integridade composta.REGION: a região das verificações de integridade compostas.
Descrever uma verificação de integridade composta
Você pode descrever uma verificação de integridade composta para ver os detalhes.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Verificações de integridade compostas.
Clique no nome da verificação de integridade composta que você quer descrever.
gcloud
Use o comando gcloud compute composite-health-checks describe.
gcloud compute composite-health-checks describe COMPOSITE_HEALTH_CHECK \
--region=REGION
Substitua:
COMPOSITE_HEALTH_CHECK: o nome da verificação de integridade compostaREGION: a região da verificação de integridade composta
API
Envie uma solicitação para o
método regionCompositeHealthChecks.get.
Método HTTP e URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK
Substitua:
PROJECT_ID: o ID do projeto da verificação de integridade composta.REGION: a região da verificação de integridade composta.COMPOSITE_HEALTH_CHECK: o nome da verificação de integridade composta.
Atualizar uma verificação de integridade composta
É possível atualizar a descrição, as fontes ou o destino de uma verificação de integridade composta.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Verificações de integridade compostas.
Clique no nome da verificação de integridade composta que você quer atualizar.
Clique em Editar.
Atualize os campos que você quer mudar.
Clique em Salvar.
gcloud
Use o
comando gcloud compute composite-health-checks update.
Omita as flags das propriedades que você não quer atualizar.
gcloud compute composite-health-checks update COMPOSITE_HEALTH_CHECK \
--region=REGION \
--description="DESCRIPTION" \
--health-sources=HEALTH_SOURCES \
--health-destination=HEALTH_DESTINATION
Substitua:
COMPOSITE_HEALTH_CHECK: o nome da verificação de integridade composta a ser atualizada.REGION: a região da verificação de integridade compostaDESCRIPTION: uma descrição atualizadaHEALTH_SOURCES: os nomes de uma ou mais fontes de integridade a serem associadas à verificação de integridade composta.É possível incluir várias fontes de integridade em uma lista separada por vírgulas.
HEALTH_DESTINATION: o URI da regra de encaminhamento que recebe o estado de integridade composto dessa verificação de integridade composta. Por exemplo,projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE.A regra de encaminhamento precisa estar associada a um balanceador de carga do produtor que seja compatível com a integridade combinada e atenda aos seguintes requisitos:
- Ele precisa ter um esquema de balanceamento de carga de
INTERNALouINTERNAL_MANAGED. - Ele precisa estar na mesma região que a verificação de integridade composta.
- Ele precisa ter um esquema de balanceamento de carga de
API
Descreva a verificação de integridade composta e anote o valor da chave
fingerprint, que será usada na próxima etapa.Envie uma solicitação para o método
regionCompositeHealthChecks.patch. Omita os campos das propriedades que você não quer atualizar.Método HTTP e URL:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK
Corpo JSON da solicitação:
{ "description": "DESCRIPTION", "healthSources": [ "projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE" ], "healthDestination": "projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE", "fingerprint": "FINGERPRINT" }Substitua:
PROJECT_ID: o ID do projeto da verificação de integridade composta.REGION: a região da verificação de integridade composta.COMPOSITE_HEALTH_CHECK: o nome da verificação de integridade composta a ser atualizada.DESCRIPTION: uma descrição atualizada.HEALTH_SOURCE: o nome de uma origem de integridade a ser associada à verificação de integridade composta. Para associar várias fontes de integridade, adicione cada uma delas à matrizhealthSources.FORWARDING_RULE: a regra de encaminhamento que recebe o estado de integridade composto dessa verificação de integridade composta.FINGERPRINT: o valor atualizado da chavefingerprintque você encontrou na etapa anterior.
Excluir uma verificação de integridade composta
É possível excluir uma verificação de integridade composta.
Console
No console Google Cloud , acesse a página Integridade combinada:
Clique em Verificações de integridade compostas.
Marque a caixa de seleção ao lado da verificação de integridade composta que você quer excluir.
Clique em Excluir.
Para confirmar, clique em Excluir.
gcloud
Use o comando gcloud compute composite-health-checks delete.
gcloud compute composite-health-checks delete COMPOSITE_HEALTH_CHECK \
--region=REGION
Substitua:
COMPOSITE_HEALTH_CHECK: o nome da verificação de integridade composta a ser excluídaREGION: a região da verificação de integridade composta
API
Envie uma solicitação para o
método regionCompositeHealthChecks.delete.
Método HTTP e URL:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK
Substitua:
PROJECT_ID: o ID do projeto da verificação de integridade composta.COMPOSITE_HEALTH_CHECK: o nome da verificação de integridade composta a ser excluída.REGION: a região da verificação de integridade composta.