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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. Clique em Políticas de agregação de integridade.

  3. 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. Clique em Políticas de agregação de integridade.

  3. Clique no nome da política de agregação de integridade que você quer atualizar.

  4. Clique em Editar.

  5. Atualize os campos que você quer mudar.

  6. 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í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.

API

  1. Descreva a política de agregação de integridade e anote o valor da chave fingerprint, que será usada na próxima etapa.

  2. 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 chave fingerprint que 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. Clique em Políticas de agregação de integridade.

  3. Marque a caixa de seleção ao lado da política de agregação de integridade que você quer excluir.

  4. Clique em Excluir.

  5. 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. Clique em Fontes de integridade.

  3. 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. Clique em Fontes de integridade.

  3. Clique no nome da fonte de integridade que você quer atualizar.

  4. Clique em Editar.

  5. Atualize os campos que você quer mudar.

  6. 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úde
  • 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 INTERNAL ou INTERNAL_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_IP ou GCE_VM_IP_PORT.
  • POLICY: o nome de uma política de agregação de integridade atualizada a ser aplicada a essa origem de integridade.

API

  1. Descreva a origem de integridade e anote o valor da chave fingerprint, que será usada na próxima etapa.
  2. 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 INTERNAL ou INTERNAL_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_IP ou GCE_VM_IP_PORT.
    • POLICY: uma política de agregação de integridade atualizada a ser aplicada a essa origem de integridade.

    • FINGERPRINT: o valor atualizado da chave fingerprint que 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. Clique em Fontes de integridade.

  3. Marque a caixa de seleção ao lado da origem de integridade que você quer excluir.

  4. Clique em Excluir.

  5. 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ída
  • REGION: 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. Clique em Verificações de integridade compostas.

  3. 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 composta
  • REGION: 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

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. Clique em Verificações de integridade compostas.

  3. Clique no nome da verificação de integridade composta que você quer atualizar.

  4. Clique em Editar.

  5. Atualize os campos que você quer mudar.

  6. 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 composta
  • DESCRIPTION: uma descrição atualizada
  • HEALTH_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 INTERNAL ou INTERNAL_MANAGED.
    • Ele precisa estar na mesma região que a verificação de integridade composta.

API

  1. Descreva a verificação de integridade composta e anote o valor da chave fingerprint, que será usada na próxima etapa.

  2. 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 à matriz healthSources.
    • FORWARDING_RULE: a regra de encaminhamento que recebe o estado de integridade composto dessa verificação de integridade composta.
    • FINGERPRINT: o valor atualizado da chave fingerprint que você encontrou na etapa anterior.

Excluir uma verificação de integridade composta

É possível excluir uma verificação de integridade composta.

Console

  1. No console Google Cloud , acesse a página Integridade combinada:

    Acesse "Integridade composta".

  2. Clique em Verificações de integridade compostas.

  3. Marque a caixa de seleção ao lado da verificação de integridade composta que você quer excluir.

  4. Clique em Excluir.

  5. 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ída
  • REGION: 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.