Dépannage

Découvrez les étapes de dépannage qui pourraient vous être utiles si vous rencontrez des problèmes avec l'API Cloud Healthcare.

Impossible d'activer l'API Cloud Healthcare

Lorsque vous activez l'API Cloud Healthcare pour la première fois dans votre projet Google Cloud, vous pouvez rencontrer une erreur d'autorisation indiquant que vous n'êtes pas autorisé à activer les API Google Cloud pour votre projet.

Consultez la section Activer et désactiver des API pour savoir comment activer les API Google Cloud, y compris l'API Cloud Healthcare.

Impossible de s'authentifier auprès de l'API Cloud Healthcare

Lorsque vous appelez l'API Cloud Healthcare, vous pouvez être confronté à un message d'erreur indiquant que vos "Identifiants par défaut de l'application" ne sont pas disponibles.

Consultez la section S'authentifier auprès de l'API pour savoir comment configurer les identifiants par défaut de l'application ou comment transmettre manuellement les identifiants d'authentification à une application ou une commande.

Absence du compte de service de l'API Cloud Healthcare ou du rôle d'agent de service Healthcare

Le compte de service Agent de service Cloud Healthcareest automatiquement créé lorsque vous activez l'API Cloud Healthcare. Il s'agit d'un compte de service géré par Google. Vous ne pouvez pas supprimer intégralement ce compte de service, mais, dans certaines circonstances, il peut ne pas apparaître sur la page Identity and Access Management, et vous pouvez rencontrer des problèmes avec l'API Cloud Healthcare.

Pour que l'API Cloud Healthcare fonctionne correctement et effectue des tâches telles que la publication et la réception publier de messages depuis Pub/Sub ou l'écriture de métriques dans Cloud Logging, le compte de service Agent de service Cloud Healthcare doit exister et disposer du rôle Cloud IAM Agent de service Healthcare.

Vous pouvez recréer le compte de service Agent de service Cloud Healthcare ou lui attribuer le rôle Cloud IAM Agent de service Healthcare si vous rencontrez l'un des problèmes suivants :

  • Vous ne pouvez pas trouver le compte de service Agent de service Cloud Healthcare sur la page Cloud Identity and Access Management.
  • Vous pouvez trouver le compte de service Agent de service Cloud Healthcare, mais il ne contient pas le rôle Agent de service Healthcare.

Utilisez l'outil de ligne de commande gcloud pour ajouter le rôle healthcare.serviceAgent au compte de service Agent de service Cloud Healthcare à l'aide de l'identifiant du compte de service, qui utilise le format service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.

Pour recréer le compte de service ou lui accorder le rôle Cloud IAM Agent de service Healthcare, exécutez la commande gcloud projects add-iam-policy-binding. Pour trouver les informations PROJECT_ID et PROJECT_NUMBER, consultez la section Identifier des projets.

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

Si la requête aboutit, l'invite de commande affiche un message semblable à l'exemple suivant :

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

Revenez à la page Identity and Access Management et vérifiez les éléments suivants :

  • La colonne Membre contient un identifiant de compte de service au format service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.
  • Sur la même ligne que la colonne Membre, la colonne Nom contient Agent de service Cloud Healthcare.
  • Sur la même ligne que celle identifiée à partir de la colonne Membre, la colonne Nom contient Agent de service Cloud Life Sciences.