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.
| 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: |
↳ dimensions |
array|Google\Protobuf\Internal\MapField
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 |
Google\Cloud\CloudQuotas\V1\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: |
↳ 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
Required. Input only. An email address that can be used for quota related communication between the Google Cloud and the user in case the Google Cloud needs further information to make a decision on whether the user preferred quota can be granted. The Google account for the email address must have quota update permission for the project, folder or organization this quota preference is for. |
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
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
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 |
Google\Cloud\CloudQuotas\V1\QuotaConfig|null | |
hasQuotaConfig
clearQuotaConfig
setQuotaConfig
Required. Preferred quota configuration.
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Cloud\CloudQuotas\V1\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
Required. Input only. An email address that can be used for quota related communication between the Google Cloud and the user in case the Google Cloud needs further information to make a decision on whether the user preferred quota can be granted.
The Google account for the email address must have quota update permission for the project, folder or organization this quota preference is for.
| Returns | |
|---|---|
| Type | Description |
string | |
setContactEmail
Required. Input only. An email address that can be used for quota related communication between the Google Cloud and the user in case the Google Cloud needs further information to make a decision on whether the user preferred quota can be granted.
The Google account for the email address must have quota update permission for the project, folder or organization this quota preference is for.
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this | |