{ "rootUrl": "https://cloudquotas.s3nsapis.fr/", "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." } } } }, "discoveryVersion": "v1", "id": "cloudquotas:v1", "resources": { "organizations": { "resources": { "locations": { "resources": { "services": { "resources": { "quotaInfos": { "methods": { "list": { "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/services/{servicesId}/quotaInfos", "response": { "$ref": "ListQuotaInfosResponse" }, "parameters": { "pageSize": { "type": "integer", "format": "int32", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query" }, "pageToken": { "type": "string", "description": "Optional. A token identifying a page of results the server should return.", "location": "query" }, "parent": { "pattern": "^organizations/[^/]+/locations/[^/]+/services/[^/]+$", "required": true, "type": "string", "description": "Required. Identifier. 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`", "location": "path" } }, "id": "cloudquotas.organizations.locations.services.quotaInfos.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists QuotaInfos of all quotas for a given project, folder or organization.", "path": "v1/{+parent}/quotaInfos", "httpMethod": "GET" }, "get": { "description": "Retrieve the QuotaInfo of a quota for a project, folder or organization.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+/services/[^/]+/quotaInfos/[^/]+$", "required": true, "description": "Required. Identifier. The resource name of the quota info. An example name: `projects/123/locations/global/services/compute.googleapis.com/quotaInfos/CpusPerProjectPerRegion`", "type": "string" } }, "path": "v1/{+name}", "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/services/{servicesId}/quotaInfos/{quotaInfosId}", "response": { "$ref": "QuotaInfo" }, "id": "cloudquotas.organizations.locations.services.quotaInfos.get" } } } } }, "quotaPreferences": { "methods": { "create": { "parameterOrder": [ "parent" ], "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/quotaPreferences", "response": { "$ref": "QuotaPreference" }, "httpMethod": "POST", "id": "cloudquotas.organizations.locations.quotaPreferences.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "QuotaPreference" }, "path": "v1/{+parent}/quotaPreferences", "description": "Creates a new QuotaPreference that declares the desired value for a quota.", "parameters": { "quotaPreferenceId": { "type": "string", "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." }, "parent": { "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/locations/[^/]+$", "description": "Required. Identifier. Value for parent. Example: `projects/123/locations/global`" }, "ignoreSafetyChecks": { "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" ], "repeated": true, "location": "query", "type": "string", "description": "The list of quota safety checks to be ignored." } } }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "id": "cloudquotas.organizations.locations.quotaPreferences.list", "description": "Lists QuotaPreferences in a given project, folder or organization.", "parameters": { "parent": { "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, "description": "Required. Identifier. 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`", "type": "string" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "location": "query", "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`", "type": "string", "location": "query" }, "filter": { "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", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "format": "int32" } }, "path": "v1/{+parent}/quotaPreferences", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/quotaPreferences", "response": { "$ref": "ListQuotaPreferencesResponse" }, "parameterOrder": [ "parent" ] }, "get": { "id": "cloudquotas.organizations.locations.quotaPreferences.get", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "response": { "$ref": "QuotaPreference" }, "description": "Gets details of a single QuotaPreference.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "required": true, "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$", "description": "Required. Identifier. Name of the resource Example name: `projects/123/locations/global/quota_preferences/my-config-for-us-east1`" } } }, "patch": { "parameters": { "updateMask": { "format": "google-fieldmask", "location": "query", "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." }, "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.", "type": "boolean", "location": "query" }, "ignoreSafetyChecks": { "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "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." ], "repeated": true, "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`", "type": "string", "location": "path", "required": true, "pattern": "^organizations/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$" }, "allowMissing": { "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.", "location": "query", "type": "boolean" } }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "response": { "$ref": "QuotaPreference" }, "httpMethod": "PATCH", "parameterOrder": [ "name" ], "description": "Updates the parameters of a single QuotaPreference. It can updates the config in any states, not just the ones pending approval.", "id": "cloudquotas.organizations.locations.quotaPreferences.patch", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "QuotaPreference" } } } } } } } }, "folders": { "resources": { "locations": { "resources": { "services": { "resources": { "quotaInfos": { "methods": { "list": { "parameters": { "pageToken": { "location": "query", "description": "Optional. A token identifying a page of results the server should return.", "type": "string" }, "parent": { "required": true, "type": "string", "location": "path", "pattern": "^folders/[^/]+/locations/[^/]+/services/[^/]+$", "description": "Required. Identifier. 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`" }, "pageSize": { "type": "integer", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "format": "int32" } }, "id": "cloudquotas.folders.locations.services.quotaInfos.list", "httpMethod": "GET", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/quotaInfos", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/services/{servicesId}/quotaInfos", "response": { "$ref": "ListQuotaInfosResponse" }, "description": "Lists QuotaInfos of all quotas for a given project, folder or organization." }, "get": { "parameters": { "name": { "location": "path", "pattern": "^folders/[^/]+/locations/[^/]+/services/[^/]+/quotaInfos/[^/]+$", "required": true, "type": "string", "description": "Required. Identifier. The resource name of the quota info. An example name: `projects/123/locations/global/services/compute.googleapis.com/quotaInfos/CpusPerProjectPerRegion`" } }, "httpMethod": "GET", "description": "Retrieve the QuotaInfo of a quota for a project, folder or organization.", "parameterOrder": [ "name" ], "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "cloudquotas.folders.locations.services.quotaInfos.get", "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/services/{servicesId}/quotaInfos/{quotaInfosId}", "response": { "$ref": "QuotaInfo" } } } } } }, "quotaPreferences": { "methods": { "patch": { "path": "v1/{+name}", "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "response": { "$ref": "QuotaPreference" }, "parameterOrder": [ "name" ], "id": "cloudquotas.folders.locations.quotaPreferences.patch", "request": { "$ref": "QuotaPreference" }, "description": "Updates the parameters of a single QuotaPreference. It can updates the config in any states, not just the ones pending approval.", "parameters": { "validateOnly": { "type": "boolean", "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." }, "ignoreSafetyChecks": { "description": "The list of quota safety checks to be ignored.", "type": "string", "repeated": true, "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "location": "query", "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." ] }, "updateMask": { "type": "string", "format": "google-fieldmask", "location": "query", "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." }, "name": { "type": "string", "required": true, "location": "path", "pattern": "^folders/[^/]+/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`" }, "allowMissing": { "type": "boolean", "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.", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH" }, "get": { "parameters": { "name": { "pattern": "^folders/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$", "description": "Required. Identifier. Name of the resource Example name: `projects/123/locations/global/quota_preferences/my-config-for-us-east1`", "type": "string", "location": "path", "required": true } }, "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "response": { "$ref": "QuotaPreference" }, "path": "v1/{+name}", "httpMethod": "GET", "parameterOrder": [ "name" ], "id": "cloudquotas.folders.locations.quotaPreferences.get", "description": "Gets details of a single QuotaPreference.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "location": "query", "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": { "format": "int32", "location": "query", "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", "required": true, "pattern": "^folders/[^/]+/locations/[^/]+$", "location": "path", "description": "Required. Identifier. 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`" }, "filter": { "location": "query", "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`" } }, "path": "v1/{+parent}/quotaPreferences", "description": "Lists QuotaPreferences in a given project, folder or organization.", "id": "cloudquotas.folders.locations.quotaPreferences.list", "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/quotaPreferences", "response": { "$ref": "ListQuotaPreferencesResponse" }, "parameterOrder": [ "parent" ] }, "create": { "parameterOrder": [ "parent" ], "description": "Creates a new QuotaPreference that declares the desired value for a quota.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/quotaPreferences", "httpMethod": "POST", "request": { "$ref": "QuotaPreference" }, "id": "cloudquotas.folders.locations.quotaPreferences.create", "parameters": { "parent": { "required": true, "description": "Required. Identifier. Value for parent. Example: `projects/123/locations/global`", "pattern": "^folders/[^/]+/locations/[^/]+$", "type": "string", "location": "path" }, "quotaPreferenceId": { "type": "string", "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." }, "ignoreSafetyChecks": { "repeated": true, "description": "The list of quota safety checks to be ignored.", "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" ], "type": "string" } }, "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/quotaPreferences", "response": { "$ref": "QuotaPreference" } } } } } } } }, "projects": { "resources": { "locations": { "resources": { "quotaPreferences": { "methods": { "list": { "id": "cloudquotas.projects.locations.quotaPreferences.list", "path": "v1/{+parent}/quotaPreferences", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists QuotaPreferences in a given project, folder or organization.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/quotaPreferences", "response": { "$ref": "ListQuotaPreferencesResponse" }, "httpMethod": "GET", "parameters": { "pageSize": { "type": "integer", "format": "int32", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query" }, "parent": { "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "description": "Required. Identifier. 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`", "type": "string" }, "filter": { "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", "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`", "type": "string", "location": "query" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "cloudquotas.projects.locations.quotaPreferences.get", "description": "Gets details of a single QuotaPreference.", "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "response": { "$ref": "QuotaPreference" }, "path": "v1/{+name}", "parameters": { "name": { "type": "string", "description": "Required. Identifier. Name of the resource Example name: `projects/123/locations/global/quota_preferences/my-config-for-us-east1`", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/quotaPreferences/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ] }, "create": { "httpMethod": "POST", "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/quotaPreferences", "response": { "$ref": "QuotaPreference" }, "path": "v1/{+parent}/quotaPreferences", "parameters": { "ignoreSafetyChecks": { "description": "The list of quota safety checks to be ignored.", "location": "query", "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "repeated": true, "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": { "location": "query", "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." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "description": "Required. Identifier. Value for parent. Example: `projects/123/locations/global`", "type": "string", "location": "path" } }, "id": "cloudquotas.projects.locations.quotaPreferences.create", "request": { "$ref": "QuotaPreference" }, "description": "Creates a new QuotaPreference that declares the desired value for a quota.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "parameters": { "name": { "location": "path", "required": true, "type": "string", "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`" }, "ignoreSafetyChecks": { "type": "string", "location": "query", "description": "The list of quota safety checks to be ignored.", "repeated": true, "enum": [ "QUOTA_SAFETY_CHECK_UNSPECIFIED", "QUOTA_DECREASE_BELOW_USAGE", "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH" ], "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." ] }, "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" }, "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": { "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.", "location": "query", "type": "string" } }, "description": "Updates the parameters of a single QuotaPreference. It can updates the config in any states, not just the ones pending approval.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/quotaPreferences/{quotaPreferencesId}", "response": { "$ref": "QuotaPreference" }, "httpMethod": "PATCH", "path": "v1/{+name}", "request": { "$ref": "QuotaPreference" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "cloudquotas.projects.locations.quotaPreferences.patch" } } }, "services": { "resources": { "quotaInfos": { "methods": { "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/quotaInfos", "response": { "$ref": "ListQuotaInfosResponse" }, "httpMethod": "GET", "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", "description": "Required. Identifier. 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`", "location": "path", "required": true }, "pageToken": { "location": "query", "type": "string", "description": "Optional. A token identifying a page of results the server should return." }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "cloudquotas.projects.locations.services.quotaInfos.list", "path": "v1/{+parent}/quotaInfos", "description": "Lists QuotaInfos of all quotas for a given project, folder or organization." }, "get": { "path": "v1/{+name}", "id": "cloudquotas.projects.locations.services.quotaInfos.get", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/quotaInfos/{quotaInfosId}", "response": { "$ref": "QuotaInfo" }, "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+/quotaInfos/[^/]+$", "location": "path", "required": true, "description": "Required. Identifier. The resource name of the quota info. An example name: `projects/123/locations/global/services/compute.googleapis.com/quotaInfos/CpusPerProjectPerRegion`" } }, "description": "Retrieve the QuotaInfo of a quota for a project, folder or organization.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } } } } } } } } }, "version": "v1", "revision": "20261012", "servicePath": "", "batchPath": "batch", "kind": "discovery#restDescription", "icons": { "x16": "", "x32": "" }, "schemas": { "QuotaDetails": { "id": "QuotaDetails", "description": "The quota details for a map of dimensions.", "type": "object", "properties": { "value": { "format": "int64", "description": "The value currently in effect and being enforced.", "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" } } }, "QuotaConfig": { "id": "QuotaConfig", "type": "object", "properties": { "grantedValue": { "description": "Output only. Granted quota value.", "readOnly": true, "type": "string", "format": "int64" }, "stateDetail": { "readOnly": true, "type": "string", "description": "Output only. Optional details about the state of this quota preference. For example, it may contain a description of a partially approved request or explain why the request was denied." }, "annotations": { "type": "object", "additionalProperties": { "type": "string" }, "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" }, "requestOrigin": { "type": "string", "description": "Output only. The origin of the quota preference request.", "readOnly": true, "enum": [ "ORIGIN_UNSPECIFIED", "CLOUD_CONSOLE", "AUTO_ADJUSTER" ], "enumDescriptions": [ "The unspecified value.", "Created through Cloud Console.", "Generated by automatic quota adjustment." ] }, "preferredValue": { "format": "int64", "type": "string", "description": "Required. The preferred value. Must be greater than or equal to -1. If set to -1, it means the value is \"unlimited\"." }, "traceId": { "readOnly": true, "description": "Output only. The trace id that the Cloud de Confiance 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.", "type": "string" } }, "description": "The preferred quota configuration." }, "DimensionsInfo": { "description": "The detailed quota information such as effective quota value for a combination of dimensions.", "id": "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": { "type": "object", "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" }, "QuotaPreference": { "type": "object", "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": { "quotaConfig": { "description": "Required. Preferred quota configuration.", "$ref": "QuotaConfig" }, "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." }, "updateTime": { "type": "string", "readOnly": true, "description": "Output only. Update time stamp", "format": "google-datetime" }, "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" }, "contactEmail": { "description": "Input only. An email address that can be used to contact the user, in case Cloud de Confiance 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" }, "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" }, "createTime": { "type": "string", "description": "Output only. Create time stamp", "readOnly": true, "format": "google-datetime" }, "justification": { "description": "The reason / justification for this quota preference.", "type": "string" }, "reconciling": { "type": "boolean", "readOnly": true, "description": "Output only. Is the quota preference pending Cloud de Confiance approval and fulfillment." }, "service": { "type": "string", "description": "Required. The name of the service to which the quota preference is applied." }, "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" } } }, "RolloutInfo": { "id": "RolloutInfo", "properties": { "ongoingRollout": { "description": "Whether there is an ongoing rollout for a quota or not.", "type": "boolean" } }, "description": "[Output only] Rollout information of a quota.", "type": "object" }, "ListQuotaInfosResponse": { "description": "Message for response to listing QuotaInfos", "id": "ListQuotaInfosResponse", "type": "object", "properties": { "quotaInfos": { "description": "The list of QuotaInfo", "items": { "$ref": "QuotaInfo" }, "type": "array" }, "nextPageToken": { "type": "string", "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." } } }, "QuotaInfo": { "description": "QuotaInfo represents information about a particular quota for a given project, folder or organization.", "properties": { "quotaId": { "description": "The id of the quota, which is unique within the service. For example, `CpusPerProjectPerRegion`", "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" }, "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" }, "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" }, "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." }, "isFixed": { "type": "boolean", "description": "Whether the quota value is fixed or adjustable" }, "metricUnit": { "type": "string", "description": "The unit in which the metric value is reported, e.g., \"MByte\"." }, "isPrecise": { "type": "boolean", "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." }, "service": { "type": "string", "description": "The name of the service in which the quota is defined. For example, `compute.googleapis.com`" }, "quotaIncreaseEligibility": { "description": "Whether it is eligible to request a higher quota value for this quota.", "$ref": "QuotaIncreaseEligibility" }, "containerType": { "description": "The container type of the QuotaInfo.", "enumDescriptions": [ "Unspecified container type.", "consumer project", "folder", "organization" ], "enum": [ "CONTAINER_TYPE_UNSPECIFIED", "PROJECT", "FOLDER", "ORGANIZATION" ], "type": "string" }, "name": { "type": "string", "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`" }, "dimensionsInfos": { "type": "array", "items": { "$ref": "DimensionsInfo" }, "description": "The collection of dimensions info ordered by their dimensions from more specific ones to less specific ones." }, "serviceRequestQuotaUri": { "type": "string", "description": "URI to the page where users can request more quota for the cloud service—for example, https://console.documentation.s3ns.fr/iam-admin/quotas." }, "quotaDisplayName": { "type": "string", "description": "The display name of the quota." } }, "id": "QuotaInfo", "type": "object" }, "ListQuotaPreferencesResponse": { "type": "object", "description": "Message for response to listing QuotaPreferences", "properties": { "unreachable": { "description": "Locations that could not be reached.", "items": { "type": "string" }, "type": "array" }, "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" }, "quotaPreferences": { "items": { "$ref": "QuotaPreference" }, "description": "The list of QuotaPreference", "type": "array" } }, "id": "ListQuotaPreferencesResponse" }, "QuotaIncreaseEligibility": { "description": "Eligibility information regarding requesting increase adjustment of a quota.", "properties": { "ineligibilityReason": { "enum": [ "INELIGIBILITY_REASON_UNSPECIFIED", "NO_VALID_BILLING_ACCOUNT", "NOT_SUPPORTED", "NOT_ENOUGH_USAGE_HISTORY", "OTHER" ], "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.", "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." ] }, "isEligible": { "description": "Whether a higher quota value can be requested for the quota.", "type": "boolean" } }, "id": "QuotaIncreaseEligibility", "type": "object" } }, "name": "cloudquotas", "protocol": "rest", "fullyEncodeReservedExpansion": true, "version_module": true, "ownerDomain": "google.com", "title": "Cloud Quotas API", "parameters": { "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" }, "upload_protocol": { "location": "query", "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\")." }, "key": { "type": "string", "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.", "location": "query" }, "alt": { "type": "string", "description": "Data format for response.", "enum": [ "json", "media", "proto" ], "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query", "default": "json" }, "access_token": { "location": "query", "type": "string", "description": "OAuth access token." }, "$.xgafv": { "location": "query", "enumDescriptions": [ "v1 error format", "v2 error format" ], "type": "string", "enum": [ "1", "2" ], "description": "V1 error format." }, "uploadType": { "type": "string", "location": "query", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")." }, "oauth_token": { "description": "OAuth 2.0 token for the current user.", "location": "query", "type": "string" }, "callback": { "type": "string", "description": "JSONP", "location": "query" }, "prettyPrint": { "description": "Returns response with indentations and line breaks.", "type": "boolean", "default": "true", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" } }, "description": "Cloud Quotas API provides GCP service consumers with management and observability for resource usage, quotas, and restrictions of the services they consume.", "canonicalName": "Cloud Quotas", "ownerName": "Google", "basePath": "", "baseUrl": "https://cloudquotas.s3nsapis.fr/", "documentationLink": "https://documentation.s3ns.fr/docs/quotas" }