REST Resource: services.consumerQuotaMetrics.limits.consumerOverrides

Resource: QuotaOverride

A quota override

JSON representation
{
  "name": string,
  "overrideValue": string,
  "dimensions": {
    string: string,
    ...
  },
  "metric": string,
  "unit": string,
  "adminOverrideAncestor": string
}
Fields
name

string

The resource name of the override. This name is generated by the server when the override is created.

Example names would be: projects/123/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/adminOverrides/4a3f2c1d projects/123/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/consumerOverrides/4a3f2c1d

The resource name is intended to be opaque and should not be parsed for its component strings, since its representation could change in the future.

overrideValue

string (int64 format)

The overriding quota limit value. Can be any nonnegative integer, or -1 (unlimited quota).

dimensions

map (key: string, value: string)

If this map is nonempty, then this override applies only to specific values for dimensions defined in the limit unit.

For example, an override on a limit with the unit 1/{project}/{region} could contain an entry with the key region and the value us-east-1; the override is only applied to quota consumed in that region.

This map has the following restrictions:

  • Keys that are not defined in the limit's unit are not valid keys. Any string appearing in {brackets} in the unit (besides {project} or {user}) is a defined key.
  • project is not a valid key; the project is already specified in the parent resource name.
  • user is not a valid key; the API does not support quota overrides that apply only to a specific user.
  • If region appears as a key, its value must be a valid Cloud region.
  • If zone appears as a key, its value must be a valid Cloud zone.
  • If any valid key other than region or zone appears in the map, then all valid keys other than region or zone must also appear in the map.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

metric

string

The name of the metric to which this override applies.

An example name would be: compute.googleapis.com/cpus

unit

string

The limit unit of the limit to which this override applies.

An example unit would be: 1/{project}/{region} Note that {project} and {region} are not placeholders in this example; the literal characters { and } occur in the string.

adminOverrideAncestor

string

The resource name of the ancestor that requested the override. For example: organizations/12345 or folders/67890. Used by admin overrides only.

Methods

create

Creates a consumer override.

delete

Deletes a consumer override.

list

Lists all consumer overrides on this limit.

patch

Updates a consumer override.