Google Cloud Quotas V1 Client - Class QuotaPreference (1.1.0)

Reference documentation and code samples for the Google Cloud Quotas V1 Client class QuotaPreference.

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.

Generated from protobuf message google.api.cloudquotas.v1.QuotaPreference

Namespace

Google \ Cloud \ CloudQuotas \ V1

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ name string

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

↳ dimensions array|Google\Protobuf\Internal\MapField

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. Example: {"provider", "Foo Inc"} where "provider" is a service specific dimension.

↳ quota_config QuotaConfig

Required. Preferred quota configuration.

↳ etag string

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.

↳ create_time Google\Protobuf\Timestamp

Output only. Create time stamp

↳ update_time Google\Protobuf\Timestamp

Output only. Update time stamp

↳ service string

Required. The name of the service to which the quota preference is applied.

↳ quota_id string

Required. The id of the quota to which the quota preference is applied. A quota name is unique in the service. Example: CpusPerProjectPerRegion

↳ reconciling bool

Output only. Is the quota preference pending Google Cloud approval and fulfillment.

↳ justification string

The reason / justification for this quota preference.

↳ contact_email string

Input only. An email address that can be used to contact the 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.

getName

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

Returns
Type Description
string

setName

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

Parameter
Name Description
var string
Returns
Type Description
$this

getDimensions

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. Example: {"provider", "Foo Inc"} where "provider" is a service specific dimension.

Returns
Type Description
Google\Protobuf\Internal\MapField

setDimensions

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. Example: {"provider", "Foo Inc"} where "provider" is a service specific dimension.

Parameter
Name Description
var array|Google\Protobuf\Internal\MapField
Returns
Type Description
$this

getQuotaConfig

Required. Preferred quota configuration.

Returns
Type Description
QuotaConfig|null

hasQuotaConfig

clearQuotaConfig

setQuotaConfig

Required. Preferred quota configuration.

Parameter
Name Description
var QuotaConfig
Returns
Type Description
$this

getEtag

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.

Returns
Type Description
string

setEtag

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.

Parameter
Name Description
var string
Returns
Type Description
$this

getCreateTime

Output only. Create time stamp

Returns
Type Description
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Create time stamp

Parameter
Name Description
var Google\Protobuf\Timestamp
Returns
Type Description
$this

getUpdateTime

Output only. Update time stamp

Returns
Type Description
Google\Protobuf\Timestamp|null

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. Update time stamp

Parameter
Name Description
var Google\Protobuf\Timestamp
Returns
Type Description
$this

getService

Required. The name of the service to which the quota preference is applied.

Returns
Type Description
string

setService

Required. The name of the service to which the quota preference is applied.

Parameter
Name Description
var string
Returns
Type Description
$this

getQuotaId

Required. The id of the quota to which the quota preference is applied. A quota name is unique in the service. Example: CpusPerProjectPerRegion

Returns
Type Description
string

setQuotaId

Required. The id of the quota to which the quota preference is applied. A quota name is unique in the service. Example: CpusPerProjectPerRegion

Parameter
Name Description
var string
Returns
Type Description
$this

getReconciling

Output only. Is the quota preference pending Google Cloud approval and fulfillment.

Returns
Type Description
bool

setReconciling

Output only. Is the quota preference pending Google Cloud approval and fulfillment.

Parameter
Name Description
var bool
Returns
Type Description
$this

getJustification

The reason / justification for this quota preference.

Returns
Type Description
string

setJustification

The reason / justification for this quota preference.

Parameter
Name Description
var string
Returns
Type Description
$this

getContactEmail

Input only. An email address that can be used to contact the 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.

Returns
Type Description
string

setContactEmail

Input only. An email address that can be used to contact the 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.

Parameter
Name Description
var string
Returns
Type Description
$this