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 \ V1Methods
__construct
Constructor.
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
↳ 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
↳ update_time
↳ 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
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
var
string
$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.
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.
$this
getQuotaConfig
Required. Preferred quota configuration.
hasQuotaConfig
clearQuotaConfig
setQuotaConfig
Required. Preferred quota configuration.
$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.
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.
var
string
$this
getCreateTime
Output only. Create time stamp
hasCreateTime
clearCreateTime
setCreateTime
Output only. Create time stamp
$this
getUpdateTime
Output only. Update time stamp
hasUpdateTime
clearUpdateTime
setUpdateTime
Output only. Update time stamp
$this
getService
Required. The name of the service to which the quota preference is applied.
string
setService
Required. The name of the service to which the quota preference is applied.
var
string
$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
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
var
string
$this
getReconciling
Output only. Is the quota preference pending Google Cloud approval and fulfillment.
bool
setReconciling
Output only. Is the quota preference pending Google Cloud approval and fulfillment.
var
bool
$this
getJustification
The reason / justification for this quota preference.
string
setJustification
The reason / justification for this quota preference.
var
string
$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
.
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
.
var
string
$this