Faça a gestão do acesso ao Personalized Service Health

Este documento aborda como definir autorizações e ativar o acesso para que possa:

• Veja eventos de estado do serviço através do painel de controlo do Service Health.
• Extraia informações sobre o estado de funcionamento do serviço através da API Service Health.
• Configure alertas relevantes para os seus projetos.

Antes de começar

Verify that billing is enabled for your Google Cloud project.

Aceda à API e ao painel de controlo do estado do serviço

O Personalized Service Health fornece uma função servicehealth.viewer predefinida que pode usar para conceder acesso aos membros do projeto. Use esta função para aceder à API Service Health e ao painel de controlo.

Nome da função	Descrição	Autorizações do Personalized Service Health
roles/servicehealth.viewer Visualizador do Personalized Service Health	Acesso só de leitura a eventos de estado de funcionamento do serviço.	servicehealth.location.list servicehealth.location.get servicehealth.events.list servicehealth.events.get servicehealth.organizationEvents.list servicehealth.organizationEvents.get servicehealth.organizationImpacts.list servicehealth.organizationImpacts.get

Sugestão: para obter as autorizações de acesso à Saúde do serviço personalizada, seguindo o princípio do menor privilégio, peça ao seu administrador para lhe conceder a função roles/servicehealth.viewer (Visualizador da Saúde do serviço personalizada). Se já lhe tiver sido concedida uma das funções básicas (funções de leitor, editor ou proprietário), já tem as autorizações necessárias para aceder ao estado de funcionamento do serviço personalizado.

Pode usar as funções e as autorizações diretamente através da CLI gcloud para configurar controlos de acesso adequados. Por exemplo, pode conceder a função diretamente com o seguinte comando:

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

Pode ver a política de gestão de identidade e de acesso (IAM) para o projeto especificado com o seguinte comando:

gcloud projects get-iam-policy PROJECT_ID

Em alternativa, pode adicionar as autorizações diretamente a uma função existente:

gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.events.list
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.events.get
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.locations.list
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.locations.get

Use APIs e serviços nos seus projetos

1. Ative a API Service Health para o projeto.
2. Conceda a função Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).

Aceda aos registos e configure alertas de registo

Faça o seguinte:

1. Ative a API Service Health para o projeto.
2. Obtenha autorizações para alertas baseados em registos.

Se não quiser conceder a função Monitoring NotificationChannel Editor (roles/monitoring.notificationChannelEditor), pode conceder a função Monitoring NotificationChannel Viewer (roles/monitoring.notificationChannelViewer) para permitir a associação de um canal de notificação a uma política de alerta.

Para mais informações sobre a atribuição de funções, consulte o artigo Gerir acesso.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Ative a API Service Health para um único projeto

A configuração de alertas e a obtenção de informações sobre o estado de funcionamento do serviço requerem a ativação da API Service Health. Pode ativar a API através da Google Cloud consola ou da CLI do Google Cloud.

Consola

1. Na biblioteca de APIs e serviços, aceda à API Service Health.

   Aceda à API Service Health

   Em alternativa, pode aceder à API Library e pesquisar "API Service Health".

2. Selecione o projeto.

3. Selecione o botão Ativar.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. Certifique-se de que tem instalada a versão mais recente da Google Cloud CLI. Execute o seguinte comando a partir do Cloud Shell:

     gcloud components update

3. Crie ou selecione um novo projeto, PROJECT_ID.

   • Crie um Google Cloud projeto:

     gcloud projects create PROJECT_ID

   • Selecione o Google Cloud projeto que criou:

     gcloud projects config set project PROJECT_ID

4. Ative a API Service Health no projeto que acabou de criar.

   gcloud services enable servicehealth.googleapis.com \
    --project PROJECT_ID
   

Script

Pode usar um script para ativar a API Service Health para projetos na sua organização ou pasta.

Para informações gerais, consulte o artigo Ativar uma API no seu Google Cloud projeto.

A API Service Health e os alertas vão reconhecer novos eventos algumas horas após a ativação da API.