Compute V1 Client - Class Reservation (1.12.1)

Version 1.12.1

• 1.19.0 (latest)
• 1.18.1
• 1.17.0
• 1.16.2
• 1.14.0
• 1.13.0
• 1.12.1
• 1.11.1
• 1.10.1
• 1.9.1
• 1.8.3
• 1.7.1
• 1.6.1
• 1.5.0

Reference documentation and code samples for the Compute V1 Client class Reservation.

Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.

Generated from protobuf message google.cloud.compute.v1.Reservation

Namespace

Google \ Cloud \ Compute \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
data	array Optional. Data for populating the Message object.
↳ commitment	string [Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.
↳ creation_timestamp	string [Output Only] Creation timestamp in RFC3339 text format.
↳ description	string An optional description of this resource. Provide this property when you create the resource.
↳ id	int|string [Output Only] The unique identifier for the resource. This identifier is defined by the server.
↳ kind	string [Output Only] Type of the resource. Always compute#reservations for reservations.
↳ name	string The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
↳ resource_policies	array|Google\Protobuf\Internal\MapField Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation.
↳ resource_status	Google\Cloud\Compute\V1\AllocationResourceStatus [Output Only] Status information for Reservation resource.
↳ satisfies_pzs	bool [Output Only] Reserved for future use.
↳ self_link	string [Output Only] Server-defined fully-qualified URL for this resource.
↳ share_settings	Google\Cloud\Compute\V1\ShareSettings Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.
↳ specific_reservation	Google\Cloud\Compute\V1\AllocationSpecificSKUReservation Reservation for instances with specific machine shapes.
↳ specific_reservation_required	bool Indicates whether the reservation can be consumed by VMs with affinity for "any" reservation. If the field is set, then only VMs that target the reservation by name can consume from this reservation.
↳ status	string [Output Only] The status of the reservation. Check the Status enum for the list of possible values.
↳ zone	string Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.

getCommitment

[Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.

Returns
Type	Description
string

hasCommitment

clearCommitment

setCommitment

[Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getCreationTimestamp

[Output Only] Creation timestamp in RFC3339 text format.

Returns
Type	Description
string

hasCreationTimestamp

clearCreationTimestamp

setCreationTimestamp

[Output Only] Creation timestamp in RFC3339 text format.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getDescription

An optional description of this resource. Provide this property when you create the resource.

Returns
Type	Description
string

hasDescription

clearDescription

setDescription

An optional description of this resource. Provide this property when you create the resource.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getId

[Output Only] The unique identifier for the resource. This identifier is defined by the server.

Returns
Type	Description
int|string

hasId

clearId

setId

[Output Only] The unique identifier for the resource. This identifier is defined by the server.

Parameter
Name	Description
var	int|string

Returns
Type	Description
$this

getKind

[Output Only] Type of the resource. Always compute#reservations for reservations.

Returns
Type	Description
string

hasKind

clearKind

setKind

[Output Only] Type of the resource. Always compute#reservations for reservations.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getName

The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

Returns
Type	Description
string

hasName

clearName

setName

The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getResourcePolicies

Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation.

Returns
Type	Description
Google\Protobuf\Internal\MapField

setResourcePolicies

Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation.

Parameter
Name	Description
var	array|Google\Protobuf\Internal\MapField

Returns
Type	Description
$this

getResourceStatus

[Output Only] Status information for Reservation resource.

Returns
Type	Description
Google\Cloud\Compute\V1\AllocationResourceStatus|null

hasResourceStatus

clearResourceStatus

setResourceStatus

[Output Only] Status information for Reservation resource.

Parameter
Name	Description
var	Google\Cloud\Compute\V1\AllocationResourceStatus

Returns
Type	Description
$this

getSatisfiesPzs

[Output Only] Reserved for future use.

Returns
Type	Description
bool

hasSatisfiesPzs

clearSatisfiesPzs

setSatisfiesPzs

[Output Only] Reserved for future use.

Parameter
Name	Description
var	bool

Returns
Type	Description
$this

getSelfLink

[Output Only] Server-defined fully-qualified URL for this resource.

Returns
Type	Description
string

hasSelfLink

clearSelfLink

setSelfLink

[Output Only] Server-defined fully-qualified URL for this resource.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getShareSettings

Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.

Returns
Type	Description
Google\Cloud\Compute\V1\ShareSettings|null

hasShareSettings

clearShareSettings

setShareSettings

Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.

Parameter
Name	Description
var	Google\Cloud\Compute\V1\ShareSettings

Returns
Type	Description
$this

getSpecificReservation

Reservation for instances with specific machine shapes.

Returns
Type	Description
Google\Cloud\Compute\V1\AllocationSpecificSKUReservation|null

hasSpecificReservation

clearSpecificReservation

setSpecificReservation

Reservation for instances with specific machine shapes.

Parameter
Name	Description
var	Google\Cloud\Compute\V1\AllocationSpecificSKUReservation

Returns
Type	Description
$this

getSpecificReservationRequired

Indicates whether the reservation can be consumed by VMs with affinity for "any" reservation. If the field is set, then only VMs that target the reservation by name can consume from this reservation.

Returns
Type	Description
bool

hasSpecificReservationRequired

clearSpecificReservationRequired

setSpecificReservationRequired

Indicates whether the reservation can be consumed by VMs with affinity for "any" reservation. If the field is set, then only VMs that target the reservation by name can consume from this reservation.

Parameter
Name	Description
var	bool

Returns
Type	Description
$this

getStatus

[Output Only] The status of the reservation.

Check the Status enum for the list of possible values.

Returns
Type	Description
string

hasStatus

clearStatus

setStatus

[Output Only] The status of the reservation.

Check the Status enum for the list of possible values.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getZone

Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.

Returns
Type	Description
string

hasZone

clearZone

setZone

Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.

Parameter
Name	Description
var	string

Returns
Type	Description
$this