이 페이지에는 다음 Service Infrastructure API의 각 버전에 대한 문제해결 정보가 나와 있습니다.
Service Management API
Service Control API
Service Consumer Management API
일반적으로 Service Control API 오류를 해결하는 방법
Service Control API는 로깅, 모니터링 등 관리형 서비스의 컨트롤 플레인 기능을 제공합니다. 따라서 Service Control API의 호출자는 일반적으로 서버 애플리케이션입니다. 다음은 REST/RPC API 수준에서 오류를 처리하는 방법에 대한 일반적인 권장사항입니다.
서버는 Service Control API에서 반환하는 모든 오류를 로깅해야 하며, 이 데이터를 사용하여 관리형 서비스의 문제를 해결할 수 있어야 합니다.
서버가 Service Control API로부터 429 오류를 수신한 경우에는 429 오류를 클라이언트에 반환해야 합니다.
서버가 Service Control API에 액세스할 수 없는 경우에는 fail-open(오류 무시) 또는 fail-close(클라이언트에 503 반환) 중에 선택할 수 있습니다.
서버가 Service Control API로부터 500 오류를 수신한 경우에는 500 오류를 클라이언트에 반환해야 합니다. 이러한 오류는 일반적으로 Service Control API 내에 버그가 있음을 의미합니다.
서버가 Service Control API로부터 다른 오류를 수신한 경우에는 500 오류를 클라이언트에 반환해야 합니다. 이러한 오류는 일반적으로 관리형 서비스 내에 버그가 있음을 의미합니다.
'서비스 사용 설정되지 않음' 오류가 의미하는 내용
Google API 서비스를 사용하려면 Google Cloud 프로젝트를 준비하고, 이 프로젝트에 대해 서비스를 사용 설정하고 각 API 요청에 대해 프로젝트와 연결된 API 키 또는 OAuth 액세스 토큰을 전달해야 합니다. 자세한 내용은 인증 가이드를 참조하세요. 이 오류를 해결하려면 Google Cloud Console, Google Cloud CLI, Service Usage API를 사용하여 프로젝트에 대해 서비스를 사용 설정해야 합니다. 서비스를 사용 설정하는 방법은 서비스 사용 설정 및 중지를 참조하세요.
권한 거부 오류를 수정하는 방법
이러한 오류는 일반적으로 특정 리소스에서 호출자에게 올바른 Identity and Access Management 권한이 없다는 것을 의미입니다. 다음의 각 Service Infrastructure API에 필요한 권한에 대한 정보는 각각의 액세스 제어 페이지를 참조하세요.
지수에 임의성을 더한 간격으로 재시도하는 것이 좋습니다.
최소 재시도 간격은 429 할당량 오류의 경우 30초, 500 및 503 서버 오류의 경우 1초여야 합니다. 다른 오류의 경우에는 반드시 추가적인 오류 정보를 바탕으로 해서 재시도를 수행해야 합니다. 자세한
내용은 google.rpc.Code를 참고하세요.
더 높은 API 할당량을 요청하는 방법
다음의 각 Service Infrastructure API에 더 높은 할당량을 신청하는 방법을 알아보려면 할당량 및 제한 페이지의 관련 섹션을 방문하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-04-21(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."]]
