Documentation ¶
Index ¶
- Variables
- type ErrorReason
- func (ErrorReason) Descriptor() protoreflect.EnumDescriptor
- func (x ErrorReason) Enum() *ErrorReason
- func (ErrorReason) EnumDescriptor() ([]byte, []int)deprecated
- func (x ErrorReason) Number() protoreflect.EnumNumber
- func (x ErrorReason) String() string
- func (ErrorReason) Type() protoreflect.EnumType
Constants ¶
This section is empty.
Variables ¶
var ( ErrorReason_name = map[int32]string{ 0: "ERROR_REASON_UNSPECIFIED", 1: "SERVICE_DISABLED", 2: "BILLING_DISABLED", 3: "API_KEY_INVALID", 4: "API_KEY_SERVICE_BLOCKED", 7: "API_KEY_HTTP_REFERRER_BLOCKED", 8: "API_KEY_IP_ADDRESS_BLOCKED", 9: "API_KEY_ANDROID_APP_BLOCKED", 13: "API_KEY_IOS_APP_BLOCKED", 5: "RATE_LIMIT_EXCEEDED", 6: "RESOURCE_QUOTA_EXCEEDED", 10: "LOCATION_TAX_POLICY_VIOLATED", 11: "USER_PROJECT_DENIED", 12: "CONSUMER_SUSPENDED", 14: "CONSUMER_INVALID", 15: "SECURITY_POLICY_VIOLATED", 16: "ACCESS_TOKEN_EXPIRED", 17: "ACCESS_TOKEN_SCOPE_INSUFFICIENT", 18: "ACCOUNT_STATE_INVALID", 19: "ACCESS_TOKEN_TYPE_UNSUPPORTED", 20: "CREDENTIALS_MISSING", 21: "RESOURCE_PROJECT_INVALID", 23: "SESSION_COOKIE_INVALID", 24: "USER_BLOCKED_BY_ADMIN", 25: "RESOURCE_USAGE_RESTRICTION_VIOLATED", 26: "SYSTEM_PARAMETER_UNSUPPORTED", 27: "ORG_RESTRICTION_VIOLATION", 28: "ORG_RESTRICTION_HEADER_INVALID", 29: "SERVICE_NOT_VISIBLE", 30: "GCP_SUSPENDED", 31: "LOCATION_POLICY_VIOLATED", } ErrorReason_value = map[string]int32{ "ERROR_REASON_UNSPECIFIED": 0, "SERVICE_DISABLED": 1, "BILLING_DISABLED": 2, "API_KEY_INVALID": 3, "API_KEY_SERVICE_BLOCKED": 4, "API_KEY_HTTP_REFERRER_BLOCKED": 7, "API_KEY_IP_ADDRESS_BLOCKED": 8, "API_KEY_ANDROID_APP_BLOCKED": 9, "API_KEY_IOS_APP_BLOCKED": 13, "RATE_LIMIT_EXCEEDED": 5, "RESOURCE_QUOTA_EXCEEDED": 6, "LOCATION_TAX_POLICY_VIOLATED": 10, "USER_PROJECT_DENIED": 11, "CONSUMER_SUSPENDED": 12, "CONSUMER_INVALID": 14, "SECURITY_POLICY_VIOLATED": 15, "ACCESS_TOKEN_EXPIRED": 16, "ACCESS_TOKEN_SCOPE_INSUFFICIENT": 17, "ACCOUNT_STATE_INVALID": 18, "ACCESS_TOKEN_TYPE_UNSUPPORTED": 19, "CREDENTIALS_MISSING": 20, "RESOURCE_PROJECT_INVALID": 21, "SESSION_COOKIE_INVALID": 23, "USER_BLOCKED_BY_ADMIN": 24, "RESOURCE_USAGE_RESTRICTION_VIOLATED": 25, "SYSTEM_PARAMETER_UNSUPPORTED": 26, "ORG_RESTRICTION_VIOLATION": 27, "ORG_RESTRICTION_HEADER_INVALID": 28, "SERVICE_NOT_VISIBLE": 29, "GCP_SUSPENDED": 30, "LOCATION_POLICY_VIOLATED": 31, } )
Enum value maps for ErrorReason.
var File_google_api_error_reason_proto protoreflect.FileDescriptor
Functions ¶
This section is empty.
Types ¶
type ErrorReason ¶
type ErrorReason int32
Defines the supported values for `google.rpc.ErrorInfo.reason` for the `googleapis.com` error domain. This error domain is reserved for [Service Infrastructure](https://cloud.google.com/service-infrastructure/docs/overview). For each error info of this domain, the metadata key "service" refers to the logical identifier of an API service, such as "pubsub.googleapis.com". The "consumer" refers to the entity that consumes an API Service. It typically is a Google project that owns the client application or the server resource, such as "projects/123". Other metadata keys are specific to each error reason. For more information, see the definition of the specific error reason.
const ( // Do not use this default value. ErrorReason_ERROR_REASON_UNSPECIFIED ErrorReason = 0 // The request is calling a disabled service for a consumer. // // Example of an ErrorInfo when the consumer "projects/123" contacting // "pubsub.googleapis.com" service which is disabled: // // { "reason": "SERVICE_DISABLED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "pubsub.googleapis.com" // } // } // // This response indicates the "pubsub.googleapis.com" has been disabled in // "projects/123". ErrorReason_SERVICE_DISABLED ErrorReason = 1 // The request whose associated billing account is disabled. // // Example of an ErrorInfo when the consumer "projects/123" fails to contact // "pubsub.googleapis.com" service because the associated billing account is // disabled: // // { "reason": "BILLING_DISABLED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "pubsub.googleapis.com" // } // } // // This response indicates the billing account associated has been disabled. ErrorReason_BILLING_DISABLED ErrorReason = 2 // The request is denied because the provided [API // key](https://cloud.google.com/docs/authentication/api-keys) is invalid. It // may be in a bad format, cannot be found, or has been expired). // // Example of an ErrorInfo when the request is contacting // "storage.googleapis.com" service with an invalid API key: // // { "reason": "API_KEY_INVALID", // "domain": "googleapis.com", // "metadata": { // "service": "storage.googleapis.com", // } // } ErrorReason_API_KEY_INVALID ErrorReason = 3 // The request is denied because it violates [API key API // restrictions](https://cloud.google.com/docs/authentication/api-keys#adding_api_restrictions). // // Example of an ErrorInfo when the consumer "projects/123" fails to call the // "storage.googleapis.com" service because this service is restricted in the // API key: // // { "reason": "API_KEY_SERVICE_BLOCKED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com" // } // } ErrorReason_API_KEY_SERVICE_BLOCKED ErrorReason = 4 // The request is denied because it violates [API key HTTP // restrictions](https://cloud.google.com/docs/authentication/api-keys#adding_http_restrictions). // // Example of an ErrorInfo when the consumer "projects/123" fails to call // "storage.googleapis.com" service because the http referrer of the request // violates API key HTTP restrictions: // // { "reason": "API_KEY_HTTP_REFERRER_BLOCKED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com", // } // } ErrorReason_API_KEY_HTTP_REFERRER_BLOCKED ErrorReason = 7 // The request is denied because it violates [API key IP address // restrictions](https://cloud.google.com/docs/authentication/api-keys#adding_application_restrictions). // // Example of an ErrorInfo when the consumer "projects/123" fails to call // "storage.googleapis.com" service because the caller IP of the request // violates API key IP address restrictions: // // { "reason": "API_KEY_IP_ADDRESS_BLOCKED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com", // } // } ErrorReason_API_KEY_IP_ADDRESS_BLOCKED ErrorReason = 8 // The request is denied because it violates [API key Android application // restrictions](https://cloud.google.com/docs/authentication/api-keys#adding_application_restrictions). // // Example of an ErrorInfo when the consumer "projects/123" fails to call // "storage.googleapis.com" service because the request from the Android apps // violates the API key Android application restrictions: // // { "reason": "API_KEY_ANDROID_APP_BLOCKED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com" // } // } ErrorReason_API_KEY_ANDROID_APP_BLOCKED ErrorReason = 9 // The request is denied because it violates [API key iOS application // restrictions](https://cloud.google.com/docs/authentication/api-keys#adding_application_restrictions). // // Example of an ErrorInfo when the consumer "projects/123" fails to call // "storage.googleapis.com" service because the request from the iOS apps // violates the API key iOS application restrictions: // // { "reason": "API_KEY_IOS_APP_BLOCKED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com" // } // } ErrorReason_API_KEY_IOS_APP_BLOCKED ErrorReason = 13 // The request is denied because there is not enough rate quota for the // consumer. // // Example of an ErrorInfo when the consumer "projects/123" fails to contact // "pubsub.googleapis.com" service because consumer's rate quota usage has // reached the maximum value set for the quota limit // "ReadsPerMinutePerProject" on the quota metric // "pubsub.googleapis.com/read_requests": // // { "reason": "RATE_LIMIT_EXCEEDED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "pubsub.googleapis.com", // "quota_metric": "pubsub.googleapis.com/read_requests", // "quota_limit": "ReadsPerMinutePerProject" // } // } // // Example of an ErrorInfo when the consumer "projects/123" checks quota on // the service "dataflow.googleapis.com" and hits the organization quota // limit "DefaultRequestsPerMinutePerOrganization" on the metric // "dataflow.googleapis.com/default_requests". // // { "reason": "RATE_LIMIT_EXCEEDED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "dataflow.googleapis.com", // "quota_metric": "dataflow.googleapis.com/default_requests", // "quota_limit": "DefaultRequestsPerMinutePerOrganization" // } // } ErrorReason_RATE_LIMIT_EXCEEDED ErrorReason = 5 // The request is denied because there is not enough resource quota for the // consumer. // // Example of an ErrorInfo when the consumer "projects/123" fails to contact // "compute.googleapis.com" service because consumer's resource quota usage // has reached the maximum value set for the quota limit "VMsPerProject" // on the quota metric "compute.googleapis.com/vms": // // { "reason": "RESOURCE_QUOTA_EXCEEDED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "compute.googleapis.com", // "quota_metric": "compute.googleapis.com/vms", // "quota_limit": "VMsPerProject" // } // } // // Example of an ErrorInfo when the consumer "projects/123" checks resource // quota on the service "dataflow.googleapis.com" and hits the organization // quota limit "jobs-per-organization" on the metric // "dataflow.googleapis.com/job_count". // // { "reason": "RESOURCE_QUOTA_EXCEEDED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "dataflow.googleapis.com", // "quota_metric": "dataflow.googleapis.com/job_count", // "quota_limit": "jobs-per-organization" // } // } ErrorReason_RESOURCE_QUOTA_EXCEEDED ErrorReason = 6 // The request whose associated billing account address is in a tax restricted // location, violates the local tax restrictions when creating resources in // the restricted region. // // Example of an ErrorInfo when creating the Cloud Storage Bucket in the // container "projects/123" under a tax restricted region // "locations/asia-northeast3": // // { "reason": "LOCATION_TAX_POLICY_VIOLATED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com", // "location": "locations/asia-northeast3" // } // } // // This response indicates creating the Cloud Storage Bucket in // "locations/asia-northeast3" violates the location tax restriction. ErrorReason_LOCATION_TAX_POLICY_VIOLATED ErrorReason = 10 // The request is denied because the caller does not have required permission // on the user project "projects/123" or the user project is invalid. For more // information, check the [userProject System // Parameters](https://cloud.google.com/apis/docs/system-parameters). // // Example of an ErrorInfo when the caller is calling Cloud Storage service // with insufficient permissions on the user project: // // { "reason": "USER_PROJECT_DENIED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com" // } // } ErrorReason_USER_PROJECT_DENIED ErrorReason = 11 // The request is denied because the consumer "projects/123" is suspended due // to Terms of Service(Tos) violations. Check [Project suspension // guidelines](https://cloud.google.com/resource-manager/docs/project-suspension-guidelines) // for more information. // // Example of an ErrorInfo when calling Cloud Storage service with the // suspended consumer "projects/123": // // { "reason": "CONSUMER_SUSPENDED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com" // } // } ErrorReason_CONSUMER_SUSPENDED ErrorReason = 12 // The request is denied because the associated consumer is invalid. It may be // in a bad format, cannot be found, or have been deleted. // // Example of an ErrorInfo when calling Cloud Storage service with the // invalid consumer "projects/123": // // { "reason": "CONSUMER_INVALID", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com" // } // } ErrorReason_CONSUMER_INVALID ErrorReason = 14 // The request is denied because it violates [VPC Service // Controls](https://cloud.google.com/vpc-service-controls/docs/overview). // The 'uid' field is a random generated identifier that customer can use it // to search the audit log for a request rejected by VPC Service Controls. For // more information, please refer [VPC Service Controls // Troubleshooting](https://cloud.google.com/vpc-service-controls/docs/troubleshooting#unique-id) // // Example of an ErrorInfo when the consumer "projects/123" fails to call // Cloud Storage service because the request is prohibited by the VPC Service // Controls. // // { "reason": "SECURITY_POLICY_VIOLATED", // "domain": "googleapis.com", // "metadata": { // "uid": "123456789abcde", // "consumer": "projects/123", // "service": "storage.googleapis.com" // } // } ErrorReason_SECURITY_POLICY_VIOLATED ErrorReason = 15 // The request is denied because the provided access token has expired. // // Example of an ErrorInfo when the request is calling Cloud Storage service // with an expired access token: // // { "reason": "ACCESS_TOKEN_EXPIRED", // "domain": "googleapis.com", // "metadata": { // "service": "storage.googleapis.com", // "method": "google.storage.v1.Storage.GetObject" // } // } ErrorReason_ACCESS_TOKEN_EXPIRED ErrorReason = 16 // The request is denied because the provided access token doesn't have at // least one of the acceptable scopes required for the API. Please check // [OAuth 2.0 Scopes for Google // APIs](https://developers.google.com/identity/protocols/oauth2/scopes) for // the list of the OAuth 2.0 scopes that you might need to request to access // the API. // // Example of an ErrorInfo when the request is calling Cloud Storage service // with an access token that is missing required scopes: // // { "reason": "ACCESS_TOKEN_SCOPE_INSUFFICIENT", // "domain": "googleapis.com", // "metadata": { // "service": "storage.googleapis.com", // "method": "google.storage.v1.Storage.GetObject" // } // } ErrorReason_ACCESS_TOKEN_SCOPE_INSUFFICIENT ErrorReason = 17 // The request is denied because the account associated with the provided // access token is in an invalid state, such as disabled or deleted. // For more information, see https://cloud.google.com/docs/authentication. // // Warning: For privacy reasons, the server may not be able to disclose the // email address for some accounts. The client MUST NOT depend on the // availability of the `email` attribute. // // Example of an ErrorInfo when the request is to the Cloud Storage API with // an access token that is associated with a disabled or deleted [service // account](http://cloud/iam/docs/service-accounts): // // { "reason": "ACCOUNT_STATE_INVALID", // "domain": "googleapis.com", // "metadata": { // "service": "storage.googleapis.com", // "method": "google.storage.v1.Storage.GetObject", // "email": "user@123.iam.gserviceaccount.com" // } // } ErrorReason_ACCOUNT_STATE_INVALID ErrorReason = 18 // The request is denied because the type of the provided access token is not // supported by the API being called. // // Example of an ErrorInfo when the request is to the Cloud Storage API with // an unsupported token type. // // { "reason": "ACCESS_TOKEN_TYPE_UNSUPPORTED", // "domain": "googleapis.com", // "metadata": { // "service": "storage.googleapis.com", // "method": "google.storage.v1.Storage.GetObject" // } // } ErrorReason_ACCESS_TOKEN_TYPE_UNSUPPORTED ErrorReason = 19 // The request is denied because the request doesn't have any authentication // credentials. For more information regarding the supported authentication // strategies for Google Cloud APIs, see // https://cloud.google.com/docs/authentication. // // Example of an ErrorInfo when the request is to the Cloud Storage API // without any authentication credentials. // // { "reason": "CREDENTIALS_MISSING", // "domain": "googleapis.com", // "metadata": { // "service": "storage.googleapis.com", // "method": "google.storage.v1.Storage.GetObject" // } // } ErrorReason_CREDENTIALS_MISSING ErrorReason = 20 // The request is denied because the provided project owning the resource // which acts as the [API // consumer](https://cloud.google.com/apis/design/glossary#api_consumer) is // invalid. It may be in a bad format or empty. // // Example of an ErrorInfo when the request is to the Cloud Functions API, // but the offered resource project in the request in a bad format which can't // perform the ListFunctions method. // // { "reason": "RESOURCE_PROJECT_INVALID", // "domain": "googleapis.com", // "metadata": { // "service": "cloudfunctions.googleapis.com", // "method": // "google.cloud.functions.v1.CloudFunctionsService.ListFunctions" // } // } ErrorReason_RESOURCE_PROJECT_INVALID ErrorReason = 21 // The request is denied because the provided session cookie is missing, // invalid or failed to decode. // // Example of an ErrorInfo when the request is calling Cloud Storage service // with a SID cookie which can't be decoded. // // { "reason": "SESSION_COOKIE_INVALID", // "domain": "googleapis.com", // "metadata": { // "service": "storage.googleapis.com", // "method": "google.storage.v1.Storage.GetObject", // "cookie": "SID" // } // } ErrorReason_SESSION_COOKIE_INVALID ErrorReason = 23 // The request is denied because the user is from a Google Workspace customer // that blocks their users from accessing a particular service. // // Example scenario: https://support.google.com/a/answer/9197205?hl=en // // Example of an ErrorInfo when access to Google Cloud Storage service is // blocked by the Google Workspace administrator: // // { "reason": "USER_BLOCKED_BY_ADMIN", // "domain": "googleapis.com", // "metadata": { // "service": "storage.googleapis.com", // "method": "google.storage.v1.Storage.GetObject", // } // } ErrorReason_USER_BLOCKED_BY_ADMIN ErrorReason = 24 // The request is denied because the resource service usage is restricted // by administrators according to the organization policy constraint. // For more information see // https://cloud.google.com/resource-manager/docs/organization-policy/restricting-services. // // Example of an ErrorInfo when access to Google Cloud Storage service is // restricted by Resource Usage Restriction policy: // // { "reason": "RESOURCE_USAGE_RESTRICTION_VIOLATED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/project-123", // "service": "storage.googleapis.com" // } // } ErrorReason_RESOURCE_USAGE_RESTRICTION_VIOLATED ErrorReason = 25 // Unimplemented. Do not use. // // The request is denied because it contains unsupported system parameters in // URL query parameters or HTTP headers. For more information, // see https://cloud.google.com/apis/docs/system-parameters // // Example of an ErrorInfo when access "pubsub.googleapis.com" service with // a request header of "x-goog-user-ip": // // { "reason": "SYSTEM_PARAMETER_UNSUPPORTED", // "domain": "googleapis.com", // "metadata": { // "service": "pubsub.googleapis.com" // "parameter": "x-goog-user-ip" // } // } ErrorReason_SYSTEM_PARAMETER_UNSUPPORTED ErrorReason = 26 // The request is denied because it violates Org Restriction: the requested // resource does not belong to allowed organizations specified in // "X-Goog-Allowed-Resources" header. // // Example of an ErrorInfo when accessing a GCP resource that is restricted by // Org Restriction for "pubsub.googleapis.com" service. // // { // reason: "ORG_RESTRICTION_VIOLATION" // domain: "googleapis.com" // metadata { // "consumer":"projects/123456" // "service": "pubsub.googleapis.com" // } // } ErrorReason_ORG_RESTRICTION_VIOLATION ErrorReason = 27 // The request is denied because "X-Goog-Allowed-Resources" header is in a bad // format. // // Example of an ErrorInfo when // accessing "pubsub.googleapis.com" service with an invalid // "X-Goog-Allowed-Resources" request header. // // { // reason: "ORG_RESTRICTION_HEADER_INVALID" // domain: "googleapis.com" // metadata { // "consumer":"projects/123456" // "service": "pubsub.googleapis.com" // } // } ErrorReason_ORG_RESTRICTION_HEADER_INVALID ErrorReason = 28 // Unimplemented. Do not use. // // The request is calling a service that is not visible to the consumer. // // Example of an ErrorInfo when the consumer "projects/123" contacting // // "pubsub.googleapis.com" service which is not visible to the consumer. // // { "reason": "SERVICE_NOT_VISIBLE", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "pubsub.googleapis.com" // } // } // // This response indicates the "pubsub.googleapis.com" is not visible to // "projects/123" (or it may not exist). ErrorReason_SERVICE_NOT_VISIBLE ErrorReason = 29 // The request is related to a project for which GCP access is suspended. // // Example of an ErrorInfo when the consumer "projects/123" fails to contact // "pubsub.googleapis.com" service because GCP access is suspended: // // { "reason": "GCP_SUSPENDED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "pubsub.googleapis.com" // } // } // // This response indicates the associated GCP account has been suspended. ErrorReason_GCP_SUSPENDED ErrorReason = 30 // The request violates the location policies when creating resources in // the restricted region. // // Example of an ErrorInfo when creating the Cloud Storage Bucket by // "projects/123" for service storage.googleapis.com: // // { "reason": "LOCATION_POLICY_VIOLATED", // "domain": "googleapis.com", // "metadata": { // "consumer": "projects/123", // "service": "storage.googleapis.com", // } // } // // This response indicates creating the Cloud Storage Bucket in // "locations/asia-northeast3" violates at least one location policy. // The troubleshooting guidance is provided in the Help links. ErrorReason_LOCATION_POLICY_VIOLATED ErrorReason = 31 )
func (ErrorReason) Descriptor ¶
func (ErrorReason) Descriptor() protoreflect.EnumDescriptor
func (ErrorReason) Enum ¶
func (x ErrorReason) Enum() *ErrorReason
func (ErrorReason) EnumDescriptor
deprecated
func (ErrorReason) EnumDescriptor() ([]byte, []int)
Deprecated: Use ErrorReason.Descriptor instead.
func (ErrorReason) Number ¶
func (x ErrorReason) Number() protoreflect.EnumNumber
func (ErrorReason) String ¶
func (x ErrorReason) String() string
func (ErrorReason) Type ¶
func (ErrorReason) Type() protoreflect.EnumType