{ "ownerName": "Google", "canonicalName": "Cloud Quotas", "rootUrl": "https://cloudquotas.googleapis.com/", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } } }, "mtlsRootUrl": "https://cloudquotas.mtls.googleapis.com/", "schemas": { "GdcQuotaDetails": { "id": "GdcQuotaDetails", "description": "The quota details for a map of dimensions.", "properties": { "value": { "format": "int64", "description": "The value currently in effect and being enforced.", "type": "string" }, "resetValue": { "description": "The Google Cloud defined quota value that the quota will be reset to if a quota decrease preference is deleted", "format": "int64", "type": "string" } }, "type": "object" }, "QuotaDetails": { "description": "The quota details for a map of dimensions.", "id": "QuotaDetails", "type": "object", "properties": { "value": { "description": "The value currently in effect and being enforced.", "format": "int64", "type": "string" }, "rolloutInfo": { "description": "Rollout information of this quota. This field is present only if the effective limit will change due to the ongoing rollout of the service config.", "$ref": "RolloutInfo" } } }, "ListQuotaInfosResponse": { "id": "ListQuotaInfosResponse", "description": "Message for response to listing QuotaInfos", "properties": { "quotaInfos": { "type": "array", "items": { "$ref": "QuotaInfo" }, "description": "The list of QuotaInfo" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "type": "object" }, "DimensionsInfo": { "properties": { "details": { "description": "Quota details for the specified dimensions.", "$ref": "QuotaDetails" }, "applicableLocations": { "description": "The applicable regions or zones of this dimension. The field is set to ['global'] for quotas that are not per region or per zone. Otherwise, it will be set to the list of locations this dimension info is applicable to.", "type": "array", "items": { "type": "string" } }, "dimensions": { "description": "The map of dimensions in key-value pairs. The key of a map entry is \"region\", \"zone\", or the name of a service-specific dimension, and the value of a map entry is the value of the dimension. If a dimension does not appear in the map of dimensions, the dimensions info applies to all the dimension values except for those that have another DimensionInfo instance configured for the specific value. For example: `{\"provider\" : \"Example Organization\"}` where `provider` is a service-specific quota dimension and `Example Organization` is the provider name.", "additionalProperties": { "type": "string" }, "type": "object" } }, "type": "object", "id": "DimensionsInfo", "description": "The detailed quota information such as effective quota value for a combination of dimensions." }, "ListQuotaPreferencesResponse": { "id": "ListQuotaPreferencesResponse", "description": "Message for response to listing QuotaPreferences", "properties": { "quotaPreferences": { "description": "The list of QuotaPreference", "type": "array", "items": { "$ref": "QuotaPreference" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations that could not be reached." } }, "type": "object" }, "QuotaPreference": { "id": "QuotaPreference", "description": "QuotaPreference represents the preferred quota configuration specified for a project, folder or organization. There is only one QuotaPreference resource for a quota value targeting a unique set of dimensions.", "properties": { "quotaId": { "description": "Required. The id of the quota to which the quota preference is applied. A quota name is unique in the service. For example, `CpusPerProjectPerRegion`", "type": "string" }, "name": { "description": "Required except in the CREATE requests. The resource name of the quota preference. The path that follows `/locations` must be `/global`. For example: `projects/123/locations/global/quotaPreferences/my-config-for-us-east1`", "type": "string" }, "service": { "description": "Required. The name of the service to which the quota preference is applied.", "type": "string" }, "contactEmail": { "description": "Input only. An email address that can be used to contact the user, in case Google Cloud needs more information to make a decision before additional quota can be granted. When requesting a quota increase, the email address is required. When requesting a quota decrease, the email address is optional. For example, the email address is optional when the `QuotaConfig.preferred_value` is smaller than the `QuotaDetails.reset_value`.", "type": "string" }, "createTime": { "format": "google-datetime", "description": "Output only. Create time stamp", "readOnly": true, "type": "string" }, "justification": { "description": "The reason / justification for this quota preference.", "type": "string" }, "etag": { "description": "Optional. The current etag of the quota preference. If an etag is provided on update and does not match the current server's etag of the quota preference, the request will be blocked and an ABORTED error will be returned. See https://google.aip.dev/134#etags for more details on etags.", "type": "string" }, "updateTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. Update time stamp" }, "dimensions": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Immutable. The dimensions that this quota preference applies to. The key of the map entry is the name of a dimension, such as `region`, `zone`, `network_id`, and the value of the map entry is the dimension value. If a dimension is missing from the map of dimensions, the quota preference applies to all the dimension values except for those that have other quota preferences configured for the specific value. Note: QuotaPreferences can only be applied across all values of `user` and `resource` dimension. Do not set values for `user` or `resource` in the dimension map. For example: `{\"provider\" : \"Example Organization\"}` where `provider` is a service-specific quota dimension and `Example Organization` is the provider name." }, "reconciling": { "readOnly": true, "type": "boolean", "description": "Output only. Is the quota preference pending Google Cloud approval and fulfillment." }, "quotaConfig": { "description": "Required. Preferred quota configuration.", "$ref": "QuotaConfig" } }, "type": "object" }, "QuotaConfig": { "description": "The preferred quota configuration.", "id": "QuotaConfig", "type": "object", "properties": { "annotations": { "description": "Optional. The annotations map for clients to store small amounts of arbitrary data. Do not put PII or other sensitive information here. See https://google.aip.dev/128#annotations", "type": "object", "additionalProperties": { "type": "string" } }, "requestOrigin": { "description": "Output only. The origin of the quota preference request.", "readOnly": true, "type": "string", "enumDescriptions": [ "The unspecified value.", "Created through Cloud Console.", "Generated by automatic quota adjustment." ], "enum": [ "ORIGIN_UNSPECIFIED", "CLOUD_CONSOLE", "AUTO_ADJUSTER" ] }, "stateDetail": { "readOnly": true, "type": "string", "description": "Output only. Optional details about the state of this quota preference." }, "grantedValue": { "format": "int64", "description": "Output only. Granted quota value.", "readOnly": true, "type": "string" }, "traceId": { "description": "Output only. The trace id that the Google Cloud uses to provision the requested quota. This trace id may be used by the client to contact Cloud support to track the state of a quota preference request. The trace id is only produced for increase requests and is unique for each request. The quota decrease requests do not have a trace id.", "readOnly": true, "type": "string" }, "preferredValue": { "format": "int64", "description": "Required. The preferred value. Must be greater than or equal to -1. If set to -1, it means the value is \"unlimited\".", "type": "string" } } }, "ListGdcQuotaInfosResponse": { "id": "ListGdcQuotaInfosResponse", "description": "Message for response to listing GdcQuotaInfos", "properties": { "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "gdcQuotaInfos": { "type": "array", "items": { "$ref": "GdcQuotaInfo" }, "description": "The list of GdcQuotaInfo" } }, "type": "object" }, "QuotaIncreaseEligibility": { "id": "QuotaIncreaseEligibility", "description": "Eligibility information regarding requesting increase adjustment of a quota.", "properties": { "isEligible": { "description": "Whether a higher quota value can be requested for the quota.", "type": "boolean" }, "ineligibilityReason": { "type": "string", "enumDescriptions": [ "Default value when is_eligible is true.", "The container is not linked with a valid billing account.", "Quota increase is not supported for the quota.", "There is not enough usage history to determine the eligibility.", "Other reasons." ], "description": "The reason of why it is ineligible to request increased value of the quota. If the is_eligible field is true, it defaults to INELIGIBILITY_REASON_UNSPECIFIED.", "enum": [ "INELIGIBILITY_REASON_UNSPECIFIED", "NO_VALID_BILLING_ACCOUNT", "NOT_SUPPORTED", "NOT_ENOUGH_USAGE_HISTORY", "OTHER" ] } }, "type": "object" }, "GdcQuotaInfo": { "properties": { "name": { "readOnly": true, "type": "string", "description": "Output only. Identifier. Resource name of this GdcQuotaInfo. For example, `projects/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com/gdcQuotaInfos/gdc-quota-1` `organizations/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com/gdcQuotaInfos/gdc-quota-1`" }, "service": { "readOnly": true, "type": "string", "description": "Output only. The name of the service in which the quota is defined. For example, `compute.googleapis.com`" }, "containerType": { "enum": [ "GDC_CONTAINER_TYPE_UNSPECIFIED", "GDC_PROJECT", "GDC_ORGANIZATION" ], "readOnly": true, "type": "string", "enumDescriptions": [ "Unspecified container type.", "consumer project", "organization" ], "description": "Output only. The type of a cloud resource container that the quota is defined for." }, "quotaId": { "readOnly": true, "type": "string", "description": "Output only. The id of the quota, which is unique within the service. For example, `CpusPerProjectPerRegion`" }, "gdcDimensionsInfos": { "readOnly": true, "type": "array", "items": { "$ref": "GdcDimensionsInfo" }, "description": "Output only. The collection of dimensions info ordered by their dimensions from more specific ones to less specific ones." }, "precise": { "description": "Output only. Whether this is a precise quota. A precise quota is tracked with absolute precision. In contrast, an imprecise quota is not tracked with precision.", "readOnly": true, "type": "boolean" }, "dimensions": { "readOnly": true, "type": "array", "items": { "type": "string" }, "description": "Output only. The dimensions the quota is defined on." }, "metric": { "readOnly": true, "type": "string", "description": "Output only. The metric of the quota. It specifies the resources consumption the quota is defined for. For example, `compute.googleapis.com/cpus`" }, "refreshInterval": { "description": "Output only. The reset time interval for the quota. Refresh interval applies to rate quota only. For example, \"minute\" for per minute, \"day\" for per day, or \"10 seconds\" for every 10 seconds.", "readOnly": true, "type": "string" } }, "type": "object", "id": "GdcQuotaInfo", "description": "GdcQuotaInfo represents information about a particular quota for a given project, folder or organization in GDC." }, "GdcDimensionsInfo": { "type": "object", "properties": { "dimensions": { "description": "The map of dimensions in key-value pairs. The key of a map entry is \"region\", \"zone\", or the name of a service-specific dimension, and the value of a map entry is the value of the dimension. If a dimension does not appear in the map of dimensions, the dimensions info applies to all the dimension values except for those that have another DimensionInfo instance configured for the specific value. For example: `{\"provider\" : \"Example Organization\"}` where `provider` is a service-specific quota dimension and `Example Organization` is the provider name.", "type": "object", "additionalProperties": { "type": "string" } }, "details": { "description": "Quota details for the specified dimensions.", "$ref": "GdcQuotaDetails" } }, "description": "The detailed quota information such as effective quota value for a combination of dimensions.", "id": "GdcDimensionsInfo" }, "QuotaInfo": { "type": "object", "properties": { "service": { "description": "The name of the service in which the quota is defined. For example, `compute.googleapis.com`", "type": "string" }, "containerType": { "description": "The container type of the QuotaInfo.", "enum": [ "CONTAINER_TYPE_UNSPECIFIED", "PROJECT", "FOLDER", "ORGANIZATION" ], "type": "string", "enumDescriptions": [ "Unspecified container type.", "consumer project", "folder", "organization" ] }, "quotaId": { "description": "The id of the quota, which is unique within the service. For example, `CpusPerProjectPerRegion`", "type": "string" }, "quotaDisplayName": { "description": "The display name of the quota.", "type": "string" }, "isConcurrent": { "description": "Whether the quota is a concurrent quota. Concurrent quotas are enforced on the total number of concurrent operations in flight at any given time.", "type": "boolean" }, "serviceRequestQuotaUri": { "description": "URI to the page where users can request more quota for the cloud service—for example, https://console.cloud.google.com/iam-admin/quotas.", "type": "string" }, "metricUnit": { "description": "The unit in which the metric value is reported, e.g., \"MByte\".", "type": "string" }, "dimensionsInfos": { "type": "array", "items": { "$ref": "DimensionsInfo" }, "description": "The collection of dimensions info ordered by their dimensions from more specific ones to less specific ones." }, "metric": { "description": "The metric of the quota. It specifies the resources consumption the quota is defined for. For example, `compute.googleapis.com/cpus`", "type": "string" }, "name": { "description": "Resource name of this QuotaInfo. The ID component following \"locations/\" must be \"global\". For example, `projects/123/locations/global/services/compute.googleapis.com/quotaInfos/CpusPerProjectPerRegion`", "type": "string" }, "isFixed": { "description": "Whether the quota value is fixed or adjustable", "type": "boolean" }, "isPrecise": { "description": "Whether this is a precise quota. A precise quota is tracked with absolute precision. In contrast, an imprecise quota is not tracked with precision.", "type": "boolean" }, "quotaIncreaseEligibility": { "description": "Whether it is eligible to request a higher quota value for this quota.", "$ref": "QuotaIncreaseEligibility" }, "metricDisplayName": { "description": "The display name of the quota metric", "type": "string" }, "dimensions": { "type": "array", "items": { "type": "string" }, "description": "The dimensions the quota is defined on." }, "refreshInterval": { "description": "The reset time interval for the quota. Refresh interval applies to rate quota only. For example, \"minute\" for per minute, \"day\" for per day, or \"10 seconds\" for every 10 seconds.", "type": "string" } }, "description": "QuotaInfo represents information about a particular quota for a given project, folder or organization.", "id": "QuotaInfo" }, "RolloutInfo": { "type": "object", "properties": { "ongoingRollout": { "description": "Whether there is an ongoing rollout for a quota or not.", "type": "boolean" } }, "description": "[Output only] Rollout information of a quota.", "id": "RolloutInfo" } }, "parameters": { "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query", "type": "string" }, "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "alt": { "type": "string", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "enum": [ "json", "media", "proto" ], "location": "query", "default": "json", "description": "Data format for response." }, "prettyPrint": { "location": "query", "description": "Returns response with indentations and line breaks.", "type": "boolean", "default": "true" }, "callback": { "type": "string", "location": "query", "description": "JSONP" }, "key": { "type": "string", "location": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." }, "quotaUser": { "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query" }, "fields": { "description": "Selector specifying which fields to include in a partial response.", "location": "query", "type": "string" }, "oauth_token": { "location": "query", "description": "OAuth 2.0 token for the current user.", "type": "string" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "$.xgafv": { "enum": [ "1", "2" ], "location": "query", "type": "string", "enumDescriptions": [ "v1 error format", "v2 error format" ], "description": "V1 error format." } }, "description": "Cloud Quotas API provides Google Cloud service consumers with management and observability for resource usage, quotas, and restrictions of the services they consume.", "ownerDomain": "google.com", "name": "cloudquotas", "servicePath": "", "id": "cloudquotas:v1", "fullyEncodeReservedExpansion": true, "protocol": "rest", "version_module": true, "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "revision": "20260423", "kind": "discovery#restDescription", "batchPath": "batch", "title": "Cloud Quotas API", "resources": { "projects": { "resources": { "locations": { "resources": { "gdcZones": { "resources": { "gdcServices": { "resources": { "gdcQuotaInfos": { "methods": { "list": { "path": "v1/{+parent}/gdcQuotaInfos", "parameterOrder": [ "parent" ], "id": "cloudquotas.projects.locations.gdcZones.gdcServices.gdcQuotaInfos.list", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/gdcZones/{gdcZonesId}/gdcServices/{gdcServicesId}/gdcQuotaInfos", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ListGdcQuotaInfosResponse" }, "parameters": { "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, the default page size is 50. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "format": "int32", "type": "integer" }, "parent": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/gdcZones/[^/]+/gdcServices/[^/]+$", "description": "Required. Parent value of GdcQuotaInfo resources. Listing across different resource containers (such as 'projects/-') is not allowed. Example parents: `projects/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com` `organizations/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com`", "type": "string", "location": "path" }, "pageToken": { "type": "string", "description": "Optional. A token identifying a page of results the server should return.", "location": "query" } }, "httpMethod": "GET", "description": "Lists GdcQuotaInfos in a given project and location." }, "get": { "path": "v1/{+name}", "id": "cloudquotas.projects.locations.gdcZones.gdcServices.gdcQuotaInfos.get", "parameterOrder": [ "name" ], "response": { "$ref": "GdcQuotaInfo" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/gdcZones/{gdcZonesId}/gdcServices/{gdcServicesId}/gdcQuotaInfos/{gdcQuotaInfosId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Gets details of a single GdcQuotaInfo.", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The resource name of the GdcQuotaInfo. An example name: `projects/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com/gdcQuotaInfos/gdc-quota-1` `organizations/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com/gdcQuotaInfos/gdc-quota-1`", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/gdcZones/[^/]+/gdcServices/[^/]+/gdcQuotaInfos/[^/]+$" } } } } } } } } }, "services": { "resources": { "quotaInfos": { "methods": { "get": { "httpMethod": "GET", "description": "Retrieve the QuotaInfo of a quota for a project, folder or organization.", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The resource name of the quota info. An example name: `projects/123/locations/global/services/compute.googleapis.com/quotaInfos/CpusPerProjectPerRegion`", "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+/quotaInfos/[^/]+$", "required": true } }, "response": { "$ref": "QuotaInfo" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/quotaInfos/{quotaInfosId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "cloudquotas.projects.locations.services.quotaInfos.get", "parameterOrder": [ "name" ], "path": "v1/{+name}" }, "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/quotaInfos", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ListQuotaInfosResponse" }, "httpMethod": "GET", "description": "Lists QuotaInfos of all quotas for a given project, folder or organization.", "parameters": { "parent": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", "required": true, "description": "Required. Parent value of QuotaInfo resources. Listing across different resource containers (such as 'projects/-') is not allowed. Example names: `projects/123/locations/global/services/compute.googleapis.com` `folders/234/locations/global/services/compute.googleapis.com` `organizations/345/locations/global/services/compute.googleapis.com`" }, "pageToken": { "type": "string", "description": "Optional. A token identifying a page of results the server should return.", "location": "query" }, "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "format": "int32", "type": "integer" } }, "path": "v1/{+parent}/quotaInfos", "id": "cloudquotas.projects.locations.services.quotaInfos.list", "parameterOrder": [ "parent" ] } } } } }, "quotaPreferences": { "methods": { "list": { "parameters": { "filter": { "type": "string", "location": "query", "description": "Optional. Filter result QuotaPreferences by their state, type, create/update time range. Example filters: `reconciling=true AND request_type=CLOUD_CONSOLE`, `reconciling=true OR creation_time\u003e2022-12-03T10:30:00`" }, "pageToken": { "location": "query", "description": "Optional. A token identifying a page of results the server should return.", "type": "string" }, "orderBy": { "description": "Optional. How to order of the results. By default, the results are ordered by create time. Example orders: `quota_id`, `service, create_time`", "location": "query", "type": "string" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default." }, "parent": { "description": "Required. Parent value of QuotaPreference resources. Listing across different resource containers (such as 'projects/-') is not allowed. When the value starts with 'folders' or 'organizations', it lists the QuotaPreferences for org quotas in the container. It does not list the QuotaPreferences in the descendant projects of the container. Example parents: `projects/123/locations/global`", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "location": "path", "type": "string" } }, "httpMethod": "GET", "description": "Lists QuotaPreferences in a given project, folder or organization.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/quotaPreferences", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ListQuotaPreferencesResponse" }, "parameterOrder": [ "parent" ], "id": "cloudquotas.projects.locations.quotaPreferences.list", "path": "v1/{+parent}/quotaPreferences" }, "patch": { "parameters": { "allowMissing": { "type": "boolean", "location": "query", "description": "Optional. If set to true, and the quota preference is not found, a new one will be created. In this situation, `update_mask` is ignored." }, "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$", "description": "Required except in the CREATE requests. The resource name of the quota preference. The path that follows `/locations` must be `/global`. For example: `projects/123/locations/global/quotaPreferences/my-config-for-us-east1`", "type": "string", "location": "path" }, "ignoreSafetyChecks": { "type": "string", "enumDescriptions": [ "Unspecified quota safety check.", "Validates that a quota mutation would not cause the consumer's effective limit to be lower than the consumer's quota usage.", "Validates that a quota mutation would not cause the consumer's effective limit to decrease by more than 10 percent." ], "location": "query", "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "repeated": true, "description": "The list of quota safety checks to be ignored." }, "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Optional. Field mask is used to specify the fields to be overwritten in the QuotaPreference resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "type": "string" }, "validateOnly": { "description": "Optional. If set to true, validate the request, but do not actually update. Note that a request being valid does not mean that the request is guaranteed to be fulfilled.", "location": "query", "type": "boolean" } }, "request": { "$ref": "QuotaPreference" }, "httpMethod": "PATCH", "description": "Updates the parameters of a single QuotaPreference. It can updates the config in any states, not just the ones pending approval.", "response": { "$ref": "QuotaPreference" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "cloudquotas.projects.locations.quotaPreferences.patch", "path": "v1/{+name}" }, "get": { "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$", "description": "Required. Name of the resource Example name: `projects/123/locations/global/quota_preferences/my-config-for-us-east1`" } }, "httpMethod": "GET", "description": "Gets details of a single QuotaPreference.", "response": { "$ref": "QuotaPreference" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "cloudquotas.projects.locations.quotaPreferences.get", "path": "v1/{+name}" }, "create": { "id": "cloudquotas.projects.locations.quotaPreferences.create", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/quotaPreferences", "request": { "$ref": "QuotaPreference" }, "httpMethod": "POST", "description": "Creates a new QuotaPreference that declares the desired value for a quota.", "parameters": { "ignoreSafetyChecks": { "description": "The list of quota safety checks to be ignored.", "repeated": true, "location": "query", "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "type": "string", "enumDescriptions": [ "Unspecified quota safety check.", "Validates that a quota mutation would not cause the consumer's effective limit to be lower than the consumer's quota usage.", "Validates that a quota mutation would not cause the consumer's effective limit to decrease by more than 10 percent." ] }, "parent": { "location": "path", "type": "string", "description": "Required. Value for parent. Example: `projects/123/locations/global`", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true }, "quotaPreferenceId": { "location": "query", "description": "Optional. Id of the requesting object, must be unique under its parent. If client does not set this field, the service will generate one.", "type": "string" } }, "response": { "$ref": "QuotaPreference" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/quotaPreferences", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } } } } }, "organizations": { "resources": { "locations": { "resources": { "services": { "resources": { "quotaInfos": { "methods": { "get": { "id": "cloudquotas.organizations.locations.services.quotaInfos.get", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "description": "Retrieve the QuotaInfo of a quota for a project, folder or organization.", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The resource name of the quota info. An example name: `projects/123/locations/global/services/compute.googleapis.com/quotaInfos/CpusPerProjectPerRegion`", "required": true, "pattern": "^organizations/[^/]+/locations/[^/]+/services/[^/]+/quotaInfos/[^/]+$" } }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/services/{servicesId}/quotaInfos/{quotaInfosId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "QuotaInfo" } }, "list": { "id": "cloudquotas.organizations.locations.services.quotaInfos.list", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/quotaInfos", "httpMethod": "GET", "description": "Lists QuotaInfos of all quotas for a given project, folder or organization.", "parameters": { "parent": { "pattern": "^organizations/[^/]+/locations/[^/]+/services/[^/]+$", "required": true, "description": "Required. Parent value of QuotaInfo resources. Listing across different resource containers (such as 'projects/-') is not allowed. Example names: `projects/123/locations/global/services/compute.googleapis.com` `folders/234/locations/global/services/compute.googleapis.com` `organizations/345/locations/global/services/compute.googleapis.com`", "type": "string", "location": "path" }, "pageToken": { "location": "query", "description": "Optional. A token identifying a page of results the server should return.", "type": "string" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default." } }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/services/{servicesId}/quotaInfos", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ListQuotaInfosResponse" } } } } } }, "quotaPreferences": { "methods": { "list": { "path": "v1/{+parent}/quotaPreferences", "parameterOrder": [ "parent" ], "id": "cloudquotas.organizations.locations.quotaPreferences.list", "response": { "$ref": "ListQuotaPreferencesResponse" }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/quotaPreferences", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "filter": { "type": "string", "location": "query", "description": "Optional. Filter result QuotaPreferences by their state, type, create/update time range. Example filters: `reconciling=true AND request_type=CLOUD_CONSOLE`, `reconciling=true OR creation_time\u003e2022-12-03T10:30:00`" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. A token identifying a page of results the server should return." }, "orderBy": { "location": "query", "description": "Optional. How to order of the results. By default, the results are ordered by create time. Example orders: `quota_id`, `service, create_time`", "type": "string" }, "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "format": "int32", "type": "integer" }, "parent": { "location": "path", "type": "string", "description": "Required. Parent value of QuotaPreference resources. Listing across different resource containers (such as 'projects/-') is not allowed. When the value starts with 'folders' or 'organizations', it lists the QuotaPreferences for org quotas in the container. It does not list the QuotaPreferences in the descendant projects of the container. Example parents: `projects/123/locations/global`", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true } }, "httpMethod": "GET", "description": "Lists QuotaPreferences in a given project, folder or organization." }, "patch": { "parameters": { "ignoreSafetyChecks": { "repeated": true, "description": "The list of quota safety checks to be ignored.", "type": "string", "enumDescriptions": [ "Unspecified quota safety check.", "Validates that a quota mutation would not cause the consumer's effective limit to be lower than the consumer's quota usage.", "Validates that a quota mutation would not cause the consumer's effective limit to decrease by more than 10 percent." ], "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "location": "query" }, "name": { "description": "Required except in the CREATE requests. The resource name of the quota preference. The path that follows `/locations` must be `/global`. For example: `projects/123/locations/global/quotaPreferences/my-config-for-us-east1`", "required": true, "pattern": "^organizations/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$", "location": "path", "type": "string" }, "allowMissing": { "type": "boolean", "location": "query", "description": "Optional. If set to true, and the quota preference is not found, a new one will be created. In this situation, `update_mask` is ignored." }, "validateOnly": { "location": "query", "description": "Optional. If set to true, validate the request, but do not actually update. Note that a request being valid does not mean that the request is guaranteed to be fulfilled.", "type": "boolean" }, "updateMask": { "description": "Optional. Field mask is used to specify the fields to be overwritten in the QuotaPreference resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "location": "query", "format": "google-fieldmask", "type": "string" } }, "httpMethod": "PATCH", "description": "Updates the parameters of a single QuotaPreference. It can updates the config in any states, not just the ones pending approval.", "request": { "$ref": "QuotaPreference" }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "QuotaPreference" }, "parameterOrder": [ "name" ], "id": "cloudquotas.organizations.locations.quotaPreferences.patch", "path": "v1/{+name}" }, "get": { "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "QuotaPreference" }, "parameters": { "name": { "required": true, "pattern": "^organizations/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$", "description": "Required. Name of the resource Example name: `projects/123/locations/global/quota_preferences/my-config-for-us-east1`", "type": "string", "location": "path" } }, "httpMethod": "GET", "description": "Gets details of a single QuotaPreference.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "id": "cloudquotas.organizations.locations.quotaPreferences.get" }, "create": { "id": "cloudquotas.organizations.locations.quotaPreferences.create", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/quotaPreferences", "request": { "$ref": "QuotaPreference" }, "httpMethod": "POST", "description": "Creates a new QuotaPreference that declares the desired value for a quota.", "parameters": { "ignoreSafetyChecks": { "description": "The list of quota safety checks to be ignored.", "repeated": true, "location": "query", "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "type": "string", "enumDescriptions": [ "Unspecified quota safety check.", "Validates that a quota mutation would not cause the consumer's effective limit to be lower than the consumer's quota usage.", "Validates that a quota mutation would not cause the consumer's effective limit to decrease by more than 10 percent." ] }, "quotaPreferenceId": { "type": "string", "description": "Optional. Id of the requesting object, must be unique under its parent. If client does not set this field, the service will generate one.", "location": "query" }, "parent": { "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, "description": "Required. Value for parent. Example: `projects/123/locations/global`", "type": "string", "location": "path" } }, "response": { "$ref": "QuotaPreference" }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/quotaPreferences", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "gdcZones": { "resources": { "gdcServices": { "resources": { "gdcQuotaInfos": { "methods": { "list": { "httpMethod": "GET", "description": "Lists GdcQuotaInfos in a given project and location.", "parameters": { "parent": { "description": "Required. Parent value of GdcQuotaInfo resources. Listing across different resource containers (such as 'projects/-') is not allowed. Example parents: `projects/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com` `organizations/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com`", "pattern": "^organizations/[^/]+/locations/[^/]+/gdcZones/[^/]+/gdcServices/[^/]+$", "required": true, "location": "path", "type": "string" }, "pageToken": { "type": "string", "description": "Optional. A token identifying a page of results the server should return.", "location": "query" }, "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, the default page size is 50. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "format": "int32", "type": "integer" } }, "response": { "$ref": "ListGdcQuotaInfosResponse" }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/gdcZones/{gdcZonesId}/gdcServices/{gdcServicesId}/gdcQuotaInfos", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "cloudquotas.organizations.locations.gdcZones.gdcServices.gdcQuotaInfos.list", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/gdcQuotaInfos" }, "get": { "response": { "$ref": "GdcQuotaInfo" }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/gdcZones/{gdcZonesId}/gdcServices/{gdcServicesId}/gdcQuotaInfos/{gdcQuotaInfosId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. The resource name of the GdcQuotaInfo. An example name: `projects/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com/gdcQuotaInfos/gdc-quota-1` `organizations/123/locations/us-west2/gdcZones/us-west2-edge-lga1/gdcServices/edgecontainer.googleapis.com/gdcQuotaInfos/gdc-quota-1`", "required": true, "pattern": "^organizations/[^/]+/locations/[^/]+/gdcZones/[^/]+/gdcServices/[^/]+/gdcQuotaInfos/[^/]+$", "location": "path", "type": "string" } }, "httpMethod": "GET", "description": "Gets details of a single GdcQuotaInfo.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "id": "cloudquotas.organizations.locations.gdcZones.gdcServices.gdcQuotaInfos.get" } } } } } } } } } } }, "folders": { "resources": { "locations": { "resources": { "services": { "resources": { "quotaInfos": { "methods": { "get": { "parameters": { "name": { "description": "Required. The resource name of the quota info. An example name: `projects/123/locations/global/services/compute.googleapis.com/quotaInfos/CpusPerProjectPerRegion`", "pattern": "^folders/[^/]+/locations/[^/]+/services/[^/]+/quotaInfos/[^/]+$", "required": true, "location": "path", "type": "string" } }, "httpMethod": "GET", "description": "Retrieve the QuotaInfo of a quota for a project, folder or organization.", "response": { "$ref": "QuotaInfo" }, "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/services/{servicesId}/quotaInfos/{quotaInfosId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "cloudquotas.folders.locations.services.quotaInfos.get", "path": "v1/{+name}" }, "list": { "path": "v1/{+parent}/quotaInfos", "id": "cloudquotas.folders.locations.services.quotaInfos.list", "parameterOrder": [ "parent" ], "response": { "$ref": "ListQuotaInfosResponse" }, "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/services/{servicesId}/quotaInfos", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Lists QuotaInfos of all quotas for a given project, folder or organization.", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. Parent value of QuotaInfo resources. Listing across different resource containers (such as 'projects/-') is not allowed. Example names: `projects/123/locations/global/services/compute.googleapis.com` `folders/234/locations/global/services/compute.googleapis.com` `organizations/345/locations/global/services/compute.googleapis.com`", "pattern": "^folders/[^/]+/locations/[^/]+/services/[^/]+$", "required": true }, "pageToken": { "location": "query", "description": "Optional. A token identifying a page of results the server should return.", "type": "string" }, "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "format": "int32", "type": "integer" } } } } } } }, "quotaPreferences": { "methods": { "list": { "httpMethod": "GET", "description": "Lists QuotaPreferences in a given project, folder or organization.", "parameters": { "pageToken": { "type": "string", "description": "Optional. A token identifying a page of results the server should return.", "location": "query" }, "orderBy": { "location": "query", "description": "Optional. How to order of the results. By default, the results are ordered by create time. Example orders: `quota_id`, `service, create_time`", "type": "string" }, "filter": { "type": "string", "description": "Optional. Filter result QuotaPreferences by their state, type, create/update time range. Example filters: `reconciling=true AND request_type=CLOUD_CONSOLE`, `reconciling=true OR creation_time\u003e2022-12-03T10:30:00`", "location": "query" }, "pageSize": { "location": "query", "format": "int32", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "type": "integer" }, "parent": { "type": "string", "location": "path", "pattern": "^folders/[^/]+/locations/[^/]+$", "required": true, "description": "Required. Parent value of QuotaPreference resources. Listing across different resource containers (such as 'projects/-') is not allowed. When the value starts with 'folders' or 'organizations', it lists the QuotaPreferences for org quotas in the container. It does not list the QuotaPreferences in the descendant projects of the container. Example parents: `projects/123/locations/global`" } }, "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/quotaPreferences", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ListQuotaPreferencesResponse" }, "id": "cloudquotas.folders.locations.quotaPreferences.list", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/quotaPreferences" }, "patch": { "response": { "$ref": "QuotaPreference" }, "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "allowMissing": { "location": "query", "description": "Optional. If set to true, and the quota preference is not found, a new one will be created. In this situation, `update_mask` is ignored.", "type": "boolean" }, "ignoreSafetyChecks": { "type": "string", "enumDescriptions": [ "Unspecified quota safety check.", "Validates that a quota mutation would not cause the consumer's effective limit to be lower than the consumer's quota usage.", "Validates that a quota mutation would not cause the consumer's effective limit to decrease by more than 10 percent." ], "location": "query", "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "repeated": true, "description": "The list of quota safety checks to be ignored." }, "name": { "pattern": "^folders/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$", "required": true, "description": "Required except in the CREATE requests. The resource name of the quota preference. The path that follows `/locations` must be `/global`. For example: `projects/123/locations/global/quotaPreferences/my-config-for-us-east1`", "type": "string", "location": "path" }, "updateMask": { "type": "string", "description": "Optional. Field mask is used to specify the fields to be overwritten in the QuotaPreference resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "location": "query", "format": "google-fieldmask" }, "validateOnly": { "description": "Optional. If set to true, validate the request, but do not actually update. Note that a request being valid does not mean that the request is guaranteed to be fulfilled.", "location": "query", "type": "boolean" } }, "request": { "$ref": "QuotaPreference" }, "httpMethod": "PATCH", "description": "Updates the parameters of a single QuotaPreference. It can updates the config in any states, not just the ones pending approval.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "id": "cloudquotas.folders.locations.quotaPreferences.patch" }, "get": { "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "QuotaPreference" }, "httpMethod": "GET", "description": "Gets details of a single QuotaPreference.", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^folders/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$", "required": true, "description": "Required. Name of the resource Example name: `projects/123/locations/global/quota_preferences/my-config-for-us-east1`" } }, "path": "v1/{+name}", "id": "cloudquotas.folders.locations.quotaPreferences.get", "parameterOrder": [ "name" ] }, "create": { "path": "v1/{+parent}/quotaPreferences", "parameterOrder": [ "parent" ], "id": "cloudquotas.folders.locations.quotaPreferences.create", "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/quotaPreferences", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "QuotaPreference" }, "parameters": { "ignoreSafetyChecks": { "location": "query", "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "type": "string", "enumDescriptions": [ "Unspecified quota safety check.", "Validates that a quota mutation would not cause the consumer's effective limit to be lower than the consumer's quota usage.", "Validates that a quota mutation would not cause the consumer's effective limit to decrease by more than 10 percent." ], "description": "The list of quota safety checks to be ignored.", "repeated": true }, "quotaPreferenceId": { "description": "Optional. Id of the requesting object, must be unique under its parent. If client does not set this field, the service will generate one.", "location": "query", "type": "string" }, "parent": { "pattern": "^folders/[^/]+/locations/[^/]+$", "required": true, "description": "Required. Value for parent. Example: `projects/123/locations/global`", "type": "string", "location": "path" } }, "httpMethod": "POST", "description": "Creates a new QuotaPreference that declares the desired value for a quota.", "request": { "$ref": "QuotaPreference" } } } } } } } } }, "basePath": "", "baseUrl": "https://cloudquotas.googleapis.com/", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/docs/quotas", "version": "v1" }