Resolver problemas

Saiba mais sobre as etapas de solução de problemas que podem ser úteis se você tiver dúvidas ao usar a API Cloud Healthcare.

Não é possível ativar a API Cloud Healthcare

Ao ativar a API Cloud Healthcare pela primeira vez no projeto do Google Cloud, é possível que ocorra um erro de permissão indicando que você não tem permissão para ativar as APIs Google Cloud para o projeto.

Consulte Como ativar e desativar APIs para informações sobre como ativar APIs Google Cloud, incluindo a API Cloud Healthcare.

Não é possível autenticar na API Cloud Healthcare

Ao chamar a API Cloud Healthcare, é possível que você receba uma mensagem de erro indicando que suas "credenciais padrão do aplicativo" não estão disponíveis.

Consulte Como autenticar na API para informações sobre como configurar o Application Default Credentials ou passar as credenciais de autenticação manualmente para um aplicativo ou comando.

Conta de serviço da API Cloud Healthcare ou papel de Agente de serviço do Cloud Healthcare

A conta de serviço Agente de serviço do Cloud Healthcare é criada automaticamente quando você ativa a API Cloud Healthcare. Esta é uma conta de serviço gerenciada pelo Google. Não é possível excluir completamente a conta de serviço. No entanto, em determinadas circunstâncias, é possível que ela não apareça na página do Cloud Identity and Access Management e talvez você encontre problemas com a API Cloud Healthcare.

Para que a API Cloud Healthcare funcione corretamente e conclua tarefas como publicar e receber mensagens do Pub/Sub ou gravar métricas no Cloud Logging, a conta de serviço do Agente de serviço do Cloud Healthcare precisa existir e ter o papel Agente de serviço do Cloud Healthcare do Cloud IAM.

É possível recriar a conta de serviço do Agente de serviço do Cloud Healthcare ou conceder a ela o papel Agente de serviço do Cloud Healthcare do Cloud IAM, caso você encontre algum dos seguintes problemas:

  • Não é possível encontrar a conta de serviço do Agente de serviço do Cloud Healthcare na página Cloud Identity and Access Management.
  • É possível encontrar a conta de serviço do Agente de serviço do Cloud Healthcare, mas ela não inclui o papel Agente de serviço do Cloud Healthcare.

Use a ferramenta de linha de comando gcloud para adicionar o papel healthcare.serviceAgent à conta de serviço do Agente de serviço do Cloud Healthcare usando o identificador da conta de serviço, que usa o formato service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.

Para recriar a conta de serviço ou conceder a ela o papel Agente de serviço do Cloud Healthcare do Cloud IAM, execute o comando gcloud projects add-iam-policy-binding. Para encontrar PROJECT_ID e PROJECT_NUMBER, consulte Como identificar projetos.

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \
    --role=roles/healthcare.serviceAgent

Se a solicitação for bem-sucedida, o prompt de comando exibirá uma mensagem semelhante à seguinte amostra:

Updated IAM policy for project [PROJECT_ID].
bindings:
...
- members:
  - serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com
  role: roles/healthcare.serviceAgent
...
etag: VALUE
version: VALUE

Retorne à página do Cloud Identity and Access Management novamente e verifique o seguinte:

  • A coluna Membro contém um identificador de conta de serviço no formato service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.
  • Na mesma linha da coluna Membro, a coluna Nome exibe o Agente de serviço do Cloud Healthcare.
  • Na mesma linha da coluna Membro, a coluna Papel contém o Agente de serviços do Cloud Healthcare.