Method: folders.locations.quotaPreferences.patch

Updates the parameters of a single QuotaPreference. It can updates the config in any states, not just the ones pending approval.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required except in the CREATE requests. The resource name of the quota preference. The ID component following "locations/" must be "global". Example: projects/123/locations/global/quotaPreferences/my-config-for-us-east1

Query parameters


string (FieldMask format)

Optional. Field mask is used to specify the fields to be overwritten in the QuotaPreference resource by the update. The fields specified in the updateMask 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.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".



Optional. If set to true, and the quota preference is not found, a new one will be created. In this situation, updateMask is ignored.



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.


enum (QuotaSafetyCheck)

The list of quota safety checks to be ignored.

Request body

The request body contains an instance of QuotaPreference.

Response body

If successful, the response body contains an instance of QuotaPreference.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • cloudquotas.quotas.update

For more information, see the IAM documentation.