Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina contiene informazioni sulla risoluzione dei problemi per ogni versione delle seguenti API Service Infrastructure:
API Service Management
API Service Control
API Service Consumer Management
Come faccio a gestire gli errori dell'API Service Control in generale?
L'API Service Control fornisce funzionalità del piano di controllo, come logging e monitoraggio, ai servizi gestiti. Pertanto, gli utenti che chiamano l'API Service Control sono in genere applicazioni server. Di seguito sono riportati alcuni consigli generali su come gestire gli errori a livello di API REST/RPC:
Il server deve registrare tutti gli errori restituiti dall'API Service Control
e puoi utilizzare i dati per risolvere i problemi del
servizio gestito.
Se il server riceve errori 429 dall'API Service Control, deve restituire errori 429 ai client.
Se il server non può accedere all'API Service Control, può scegliere tra il comportamento fail-open (ignora l'errore) o fail-close (restituisce 503 al suo cliente).
Se il server riceve errori 500 dall'API Service Control, deve restituire l'errore 500 ai client. Questi errori di solito indicano bug
all'interno dell'API Service Control.
Se il server riceve altri errori dall'API Service Control, deve restituire l'errore 500 ai clienti. In genere, questi errori indicano bug
all'interno del servizio gestito.
Che cosa significa l'errore "Servizio non abilitato"?
Per utilizzare qualsiasi servizio API di Google, devi disporre di un Google Cloud progetto, attivare il servizio per quel progetto e passare una chiave API o un token di accesso OAuth associato al progetto per ogni richiesta API. Per maggiori dettagli, consulta la guida all'autenticazione. Per risolvere questo errore, devi attivare il servizio per il tuo progetto utilizzando la Google Cloud console,
Google Cloud CLI o l'API Service Usage. Per scoprire come attivare un servizio, consulta
Abilitazione e disattivazione dei servizi.
Come faccio a correggere gli errori di autorizzazione negata?
In genere, questi errori indicano che il chiamante non dispone dell'autorizzazione Identity and Access Management corretta per determinate risorse. Per informazioni sulle autorizzazioni richieste per ciascuna delle seguenti API Service Infrastructure, consulta la rispettiva pagina di controllo dell'accesso:
Come faccio a eseguire un nuovo tentativo in caso di errori dell'API?
Ti consigliamo di eseguire un nuovo tentativo con intervalli esponenziali più casualità.
L'intervallo di ripetizione minimo deve essere di 30 secondi per gli errori di quota 429; 1 secondo per gli errori di server 500
e 503. Per altri errori, il nuovo tentativo deve essere eseguito solo in base a informazioni aggiuntive sull'errore. Per ulteriori dettagli, consulta
google.rpc.Code.
Come faccio a richiedere una quota API più alta?
Per scoprire come richiedere una quota superiore per ciascuna delle seguenti API Service Infrastructure, visita la rispettiva sezione della pagina Quote e limiti:
Come faccio a correggere gli errori "Impossibile verificare la proprietà del nome di dominio"?
Questo errore indica che chi chiama non possiede il nome di dominio utilizzato per il nome del servizio gestito specificato in una configurazione del servizio.
Segui la guida per utilizzare un dominio valido.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-11 UTC."],[],[],null,["# Troubleshooting\n\nThis page contains troubleshooting information for each version of the following\nService Infrastructure APIs:\n\n- The Service Management API\n- The Service Control API\n- The Service Consumer Management API\n\n| **Note:** For Service Infrastructure troubleshooting information for the Service Usage API, see [Troubleshooting](/service-usage/docs/troubleshooting).\n\n### How do I handle Service Control API errors in general?\n\nThe Service Control API provides control plane functionality, such as\nlogging, monitoring, to managed services. Therefore, the callers of the\nService Control API typically are server applications. Here are general\nrecommendations on how to handle errors at the REST/RPC API level:\n\n- Your server should log all errors returned by the Service Control API and you can use the data to toubleshoot your [managed service](/service-infrastructure/docs/glossary#managed).\n- If your server receives `429` errors from the Service Control API, it should return `429` errors to its clients.\n- If your server cannot access the Service Control API, it can choose to either fail-open (ignore the error) or fail-close (return `503` to its client).\n- If your server receives `500` errors from the Service Control API, it should return `500` error to its clients. Such errors typically mean bugs within the Service Control API.\n- If your server receives other errors from the Service Control API, it should return `500` error to its clients. Such errors typically mean bugs within your managed service.\n\n### What does the \"service not enabled\" error mean?\n\nTo use any Google API service, you need to have a Google Cloud project,\nenable the service for that project, and pass an API key or an OAuth access\ntoken associated with the project for each API request. See\n[Auth Guide](/docs/authentication) for details. To fix this error, you need\nto enable the service for your project using the Google Cloud console,\nGoogle Cloud CLI, or Service Usage API. To learn how to enable a service, see\n[Enabling and Disabling Services](/service-usage/docs/enable-disable).\n\n### How do I fix permission denied errors?\n\nSuch errors typically mean the caller doesn't have the right\n[Identity and Access Management](/iam) permission on certain resources. For information on the\nrequired permissions for each of the following Service Infrastructure APIs, see the\nrespective Access Control page:\n\n- [Service Control API Access Control](/service-infrastructure/docs/service-control/access-control)\n- [Service Management API Access Control](/service-infrastructure/docs/service-management/access-control)\n\n### How do I perform a retry on API errors?\n\nIt is recommended to perform a retry with exponential intervals plus randomness.\nThe minimum retry interval should be 30s for `429` quota errors; 1s for `500`\nand `503` server errors. For other errors, retry should only be performed based\non additional error information. See\n[`google.rpc.Code`](https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto)\nfor more details.\n\n### How do I request higher API quota?\n\nTo learn how to apply for higher quota for each of the following\nService Infrastructure APIs, visit the respective section of the\n[Quotas and Limits](/service-infrastructure/docs/quotas) page:\n\n- [Service Control API Quota](/service-infrastructure/docs/quotas#control)\n- [Service Consumer Management API Quota](/service-infrastructure/docs/quotas#consumer)\n- [Service Management API Quota](/service-infrastructure/docs/quotas#management)\n\n### How do I fix \"Ownership for domain name cannot be verified\" errors?\n\nThis error indicates the caller does not have the ownership of the domain\nname used for the [managed service](/service-infrastructure/docs/glossary#managed) name\nspecified in a\n[service configuration](/service-infrastructure/docs/service-management/reference/rpc/google.api#google.api.Service).\nFollow the [guide](/endpoints/docs/custom-domain) to use a valid domain."]]
