Dépannage

Cette page contient des informations de dépannage pour chaque version des API de Service Infrastructure indiquées ci-dessous :

  • API Service Management
  • API Service Control
  • API Service Consumer Management

Globalement, comment gérer les erreurs de l'API Service Control ?

L'API Service Control fournit aux services gérés des fonctionnalités de plan de contrôle, telles que la journalisation et la surveillance. Par conséquent, les appelants de l'API Service Control sont généralement des applications de serveur. Voici quelques recommandations générales sur la gestion des erreurs au niveau de l'API REST/RPC :

  • Votre serveur doit journaliser toutes les erreurs renvoyées par l'API Service Control. Ces données vous permettront ainsi de dépanner votre service géré.
  • Si votre serveur reçoit une erreur 429 de la part de l'API Service Control, il doit renvoyer une erreur 429 à ses clients.
  • Si votre serveur ne peut pas accéder à l'API Service Control, il peut choisir soit d'autoriser la requête (ignorer l'erreur), soit de la refuser (en affichant l'erreur 503 à son client).
  • Si votre serveur reçoit une erreur 500 de la part de l'API Service Control, il doit renvoyer une erreur 500 à ses clients. Une telle erreur indique généralement des bugs au sein de l'API Service Control.
  • Si votre serveur reçoit d'autres erreurs de la part de l'API Service Control, il doit renvoyer une erreur 500 à ses clients. Une telle erreur indique généralement des bugs au sein de votre service géré.

Que signifie l'erreur "Service non activé" ?

Pour utiliser un service API Google, vous devez disposer d'un projet Google Cloud, activer le service pour ce projet et transmettre une clé API ou un jeton d'accès OAuth associé au projet pour chaque requête API. Consultez le guide d'Auth pour plus de détails. Pour corriger cette erreur, vous devez activer le service pour votre projet à l'aide de la console Google Cloud, de Google Cloud CLI ou de l'API Service Usage. Pour savoir comment activer un service, consultez la page Activer et désactiver des services.

Comment corriger les erreurs d'autorisation refusées ?

De telles erreurs signifient généralement que l'appelant ne dispose pas de la bonne autorisation Identity and Access Management sur certaines ressources. Pour en savoir plus sur les autorisations requises pour chacune des API de Service Infrastructure indiquées ci-dessous, consultez la page "Contrôle des accès" correspondante :

Comment effectuer une nouvelle tentative d'exécution après une erreur d'API ?

Il est recommandé d'effectuer une nouvelle tentative à intervalles exponentiels et de manière aléatoire. L'intervalle minimal entre les tentatives doit être de 30 secondes pour l'erreur de quota 429 et d'une seconde pour les erreurs de serveur 500 et 503. Pour les autres erreurs, les nouvelles tentatives ne doivent être effectuées qu'en fonction d'informations supplémentaires sur ces erreurs. Pour plus d'informations, consultez la section google.rpc.Code.

Comment demander l'augmentation d'un quota d'API ?

Pour savoir comment demander l'augmentation d'un quota pour chacune des API de Service Infrastructure indiquées ci-dessous, consultez la section correspondante de la page Quotas et limites :

Comment corriger l'erreur "La propriété du nom de domaine ne peut pas être validée" ?

Cette erreur indique que l'appelant n'est pas propriétaire du nom de domaine utilisé pour le nom du service géré spécifié dans une configuration de service. Pour savoir comment utiliser un domaine valide, suivez ce guide.