Faça a gestão de eventos que afetam uma organização

Este documento explica como usar a API Service Health para gerir eventos que afetam a sua organização.

O Service Health personalizado fornece os recursos da API OrganizationEvents e OrganizationImpacts, que lhe permitem obter informações sobre eventos que afetam a sua organização. Estas informações incluem:

  • Eventos de estado de funcionamento do serviço que podem afetar um ou mais projetos numa organização.
  • Lista de projetos que podem ser ou estão a ser afetados por um evento que afeta a sua organização.

Antes de começar

  1. Ative a API Service Health para, pelo menos, um projeto na sua organização. Os recursos da API OrganizationEvents e OrganizationImpacts obtêm informações apenas para projetos que têm a API Service Health ativada.

  2. Verify that billing is enabled for your Google Cloud project.

  3. Defina autorizações para aceder à API Service Health.

  4. Configure as autorizações da gestão de identidade e de acesso (IAM) na sua organização para usar os recursos da API OrganizationEvents e OrganizationImpacts. Execute o seguinte comando: 

    gcloud organizations add-iam-policy-binding $ORGANIZATION_ID \
  --member {USER|GROUP|SERVICE_ACCOUNT} \
  --role roles/servicehealth.viewer

    Para obter o seu ORGANIZATION_ID, consulte o artigo Como obter o ID do recurso da organização.

    As políticas IAM concedidas numa organização são herdadas por todos os projetos na organização. Estas políticas permitem-lhe aceder às APIs de eventos da organização e do projeto em toda a organização.

Referências

Consulte a referência da API OrganizationEvents e OrganizationImpacts para ver os métodos que pode usar e o significado dos campos na resposta.

Quando definir o produto ou a localização, use os valores encontrados em Google Cloud products e locations.

Apresenta projetos de uma organização que podem ser afetados por um evento

Consulte o início rápido.

Liste todos os incidentes ativos de uma organização

Consulte o início rápido.

Obtenha detalhes de um evento que afeta uma organização

Pode usar a API Get para ver informações detalhadas sobre um evento que afeta uma organização.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • API_VERSION: a versão da API a usar. Use v1 ou v1beta.
  • ORGANIZATION_ID: o ID da sua organização do Google Cloud.
  • EVENT_ID: o ID do evento.

Método HTTP e URL: 

GET https://servicehealth.googleapis.com/API VERSION/organizations/ORGANIZATION_ID/locations/global/organizationEvents/EVENT_ID

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "organizations/ORGANIZATION_ID/locations/global/organizationEvents/EVENT_ID",
     "title": "We are experiencing a connectivity issue affecting Google Cloud SQL in us-east1, australia-southeast2.",
      "description": "The issue with Google Cloud SQL has been resolved for all affected projects as of Tuesday, 2022-10-18 11:00 US/Pacific. We thank you for your patience while we worked on resolving the issue.",
      "category": "INCIDENT",
      "detailedCategory": "CONFIRMED_INCIDENT",
      "state": "CLOSED",
      "detailedState": "RESOLVED",
      "eventImpacts": [
        {
          "product": {
            "productName": "Google Cloud SQL",
            "id": "hV87iK5DcEXKgWU2kDri",
          },
          "location": {
            "locationName": "us-central1",
          }
        }
      ],
   "updates": [
    {
      "updateTime": "2022-10-18T17:41:20.112287Z",
              "title": "We are experiencing a connectivity issue affecting Google Cloud SQL in us-east1, australia-southeast2.",
      "description": "We are experiencing an intermittent issue with Google Cloud SQL. Our engineering team continues to investigate the issue.",
      "symptom": "None at this time.",
      "workaround": "None at this time."
    },
    {
      "updateTime": "2022-10-18T18:00:05.690761Z",
      "title": "We are experiencing a connectivity issue affecting Google Cloud SQL in us-east1, australia-southeast2.",
      "description": "The issue with Google Cloud SQL has been resolved for all affected projects as of Tuesday, 2022-10-18 11:00 US/Pacific.\n\nWe thank you for your patience while we worked on resolving the issue.",
      "symptom": "None at this time.",
      "workaround": "None at this time."
    }
  ],
  "updateTime": "2022-10-18T18:00:05.690761Z",
  "startTime": "2022-10-18T17:41:20.112287Z",
  "endTime":  "2022-10-18T18:00:05.690761Z",
}

Se não tiver autorizações para receber eventos, recebe o seguinte erro PERMISSION_DENIED.

{
  "error": {
    "code": 403,
    "message": "Permission 'servicehealth.organizationEvents.get' denied on resource '//servicehealth.googleapis.com/organizations/ORGANIZATION_ID/locations/global/organizationEvents/EVENT_ID' (or it may not exist).",
    "status": "PERMISSION_DENIED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "IAM_PERMISSION_DENIED",
        "domain": "servicehealth.googleapis.com",
        "metadata": {
          "resource": "organizations/ORGANIZATION_ID/locations/global/organizationEvents/EVENT_ID",
          "permission": "servicehealth.organizationEvents.get"
        }
      }
    ]
  }
}

Para corrigir este erro, defina as autorizações necessárias.

Receba detalhes de um projeto de uma organização que possa ser afetado por um evento

Para um determinado evento, o ID do evento permanece igual entre os eventos do projeto e da organização. OrganizationImpact contém um EVENT_ID e um PROJECT_NUMBER, que pode usar para obter detalhes de um evento que afeta o seu projeto. Estes detalhes incluem state e relevance.

PROJECT_NUMBER é intercambiável com PROJECT_ID, que a API Get devolve.