Reference documentation and code samples for the Compute V1 Client class FutureReservation.
Generated from protobuf message google.cloud.compute.v1.FutureReservation
Namespace
Google \ Cloud \ Compute \ V1Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ aggregate_reservation
↳ auto_created_reservations_delete_time
string
Future timestamp when the FR auto-created reservations will be deleted by Compute Engine. Format of this field must be a valid href=" RFC3339">https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value.
↳ auto_created_reservations_duration
Duration
Specifies the duration of auto-created reservations. It represents relative time to future reservation start_time when auto-created reservations will be automatically deleted by Compute Engine. Duration time unit is represented as a count of seconds and fractions of seconds at nanosecond resolution.
↳ auto_delete_auto_created_reservations
bool
Setting for enabling or disabling automatic deletion for auto-created reservation. If set to true, auto-created reservations will be deleted at Future Reservation's end time (default) or at user's defined timestamp if any of the [auto_created_reservations_delete_time, auto_created_reservations_duration] values is specified. For keeping auto-created reservation indefinitely, this value should be set to false.
↳ commitment_info
FutureReservationCommitmentInfo
If not present, then FR will not deliver a new commitment or update an existing commitment.
↳ creation_timestamp
string
[Output Only] The creation timestamp for this future reservation inRFC3339 text format.
↳ deployment_type
string
Type of the deployment requested as part of future reservation. Check the DeploymentType enum for the list of possible values.
↳ description
string
An optional description of this resource. Provide this property when you create the future reservation.
↳ enable_emergent_maintenance
bool
Indicates if this group of VMs have emergent maintenance enabled.
↳ id
int|string
[Output Only] A unique identifier for this future reservation. The server defines this identifier.
↳ kind
string
[Output Only] Type of the resource. Alwayscompute#futureReservation for future 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 withRFC1035. 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.
↳ name_prefix
string
Name prefix for the reservations to be created at the time of delivery. The name prefix must comply with RFC1035. Maximum allowed length for name prefix is 20. Automatically created reservations name format will be -date-####.
↳ planning_status
string
Planning state before being submitted for evaluation Check the PlanningStatus enum for the list of possible values.
↳ reservation_mode
string
The reservation mode which determines reservation-termination behavior and expected pricing. Check the ReservationMode enum for the list of possible values.
↳ reservation_name
string
Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix.
↳ scheduling_type
string
Maintenance information for this reservation Check the SchedulingType enum for the list of possible values.
↳ self_link
string
[Output Only] Server-defined fully-qualified URL for this resource.
↳ self_link_with_id
string
[Output Only] Server-defined URL for this resource with the resource id.
↳ share_settings
↳ specific_reservation_required
bool
Indicates whether the auto-created 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 the delivered reservation.
↳ specific_sku_properties
FutureReservationSpecificSKUProperties
Future Reservation configuration to indicate instance properties and total count.
↳ status
↳ time_window
↳ zone
string
[Output Only] URL of the Zone where this future reservation resides.
getAggregateReservation
Aggregate reservation details for the future reservation.
hasAggregateReservation
clearAggregateReservation
setAggregateReservation
Aggregate reservation details for the future reservation.
$this
getAutoCreatedReservationsDeleteTime
Future timestamp when the FR auto-created reservations will be deleted by Compute Engine. Format of this field must be a valid href=" RFC3339">https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value.
string
hasAutoCreatedReservationsDeleteTime
clearAutoCreatedReservationsDeleteTime
setAutoCreatedReservationsDeleteTime
Future timestamp when the FR auto-created reservations will be deleted by Compute Engine. Format of this field must be a valid href=" RFC3339">https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value.
var
string
$this
getAutoCreatedReservationsDuration
Specifies the duration of auto-created reservations.
It represents relative time to future reservation start_time when auto-created reservations will be automatically deleted by Compute Engine. Duration time unit is represented as a count of seconds and fractions of seconds at nanosecond resolution.
hasAutoCreatedReservationsDuration
clearAutoCreatedReservationsDuration
setAutoCreatedReservationsDuration
Specifies the duration of auto-created reservations.
It represents relative time to future reservation start_time when auto-created reservations will be automatically deleted by Compute Engine. Duration time unit is represented as a count of seconds and fractions of seconds at nanosecond resolution.
$this
getAutoDeleteAutoCreatedReservations
Setting for enabling or disabling automatic deletion for auto-created reservation. If set to true, auto-created reservations will be deleted at Future Reservation's end time (default) or at user's defined timestamp if any of the [auto_created_reservations_delete_time, auto_created_reservations_duration] values is specified.
For keeping auto-created reservation indefinitely, this value should be set to false.
bool
hasAutoDeleteAutoCreatedReservations
clearAutoDeleteAutoCreatedReservations
setAutoDeleteAutoCreatedReservations
Setting for enabling or disabling automatic deletion for auto-created reservation. If set to true, auto-created reservations will be deleted at Future Reservation's end time (default) or at user's defined timestamp if any of the [auto_created_reservations_delete_time, auto_created_reservations_duration] values is specified.
For keeping auto-created reservation indefinitely, this value should be set to false.
var
bool
$this
getCommitmentInfo
If not present, then FR will not deliver a new commitment or update an existing commitment.
hasCommitmentInfo
clearCommitmentInfo
setCommitmentInfo
If not present, then FR will not deliver a new commitment or update an existing commitment.
$this
getCreationTimestamp
[Output Only] The creation timestamp for this future reservation inRFC3339 text format.
string
hasCreationTimestamp
clearCreationTimestamp
setCreationTimestamp
[Output Only] The creation timestamp for this future reservation inRFC3339 text format.
var
string
$this
getDeploymentType
Type of the deployment requested as part of future reservation.
Check the DeploymentType enum for the list of possible values.
string
hasDeploymentType
clearDeploymentType
setDeploymentType
Type of the deployment requested as part of future reservation.
Check the DeploymentType enum for the list of possible values.
var
string
$this
getDescription
An optional description of this resource. Provide this property when you create the future reservation.
string
hasDescription
clearDescription
setDescription
An optional description of this resource. Provide this property when you create the future reservation.
var
string
$this
getEnableEmergentMaintenance
Indicates if this group of VMs have emergent maintenance enabled.
bool
hasEnableEmergentMaintenance
clearEnableEmergentMaintenance
setEnableEmergentMaintenance
Indicates if this group of VMs have emergent maintenance enabled.
var
bool
$this
getId
[Output Only] A unique identifier for this future reservation. The server defines this identifier.
int|string
hasId
clearId
setId
[Output Only] A unique identifier for this future reservation. The server defines this identifier.
var
int|string
$this
getKind
[Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations.
string
hasKind
clearKind
setKind
[Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations.
var
string
$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 withRFC1035.
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.
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 withRFC1035.
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.
var
string
$this
getNamePrefix
Name prefix for the reservations to be created at the time of delivery. The name prefix must comply with RFC1035.
Maximum allowed length for name prefix is 20. Automatically created reservations name format will be -date-####.
string
hasNamePrefix
clearNamePrefix
setNamePrefix
Name prefix for the reservations to be created at the time of delivery. The name prefix must comply with RFC1035.
Maximum allowed length for name prefix is 20. Automatically created reservations name format will be -date-####.
var
string
$this
getPlanningStatus
Planning state before being submitted for evaluation Check the PlanningStatus enum for the list of possible values.
string
hasPlanningStatus
clearPlanningStatus
setPlanningStatus
Planning state before being submitted for evaluation Check the PlanningStatus enum for the list of possible values.
var
string
$this
getReservationMode
The reservation mode which determines reservation-termination behavior and expected pricing.
Check the ReservationMode enum for the list of possible values.
string
hasReservationMode
clearReservationMode
setReservationMode
The reservation mode which determines reservation-termination behavior and expected pricing.
Check the ReservationMode enum for the list of possible values.
var
string
$this
getReservationName
Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix.
string
hasReservationName
clearReservationName
setReservationName
Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix.
var
string
$this
getSchedulingType
Maintenance information for this reservation Check the SchedulingType enum for the list of possible values.
string
hasSchedulingType
clearSchedulingType
setSchedulingType
Maintenance information for this reservation Check the SchedulingType enum for the list of possible values.
var
string
$this
getSelfLink
[Output Only] Server-defined fully-qualified URL for this resource.
string
hasSelfLink
clearSelfLink
setSelfLink
[Output Only] Server-defined fully-qualified URL for this resource.
var
string
$this
getSelfLinkWithId
[Output Only] Server-defined URL for this resource with the resource id.
string
hasSelfLinkWithId
clearSelfLinkWithId
setSelfLinkWithId
[Output Only] Server-defined URL for this resource with the resource id.
var
string
$this
getShareSettings
List of Projects/Folders to share with.
hasShareSettings
clearShareSettings
setShareSettings
List of Projects/Folders to share with.
$this
getSpecificReservationRequired
Indicates whether the auto-created 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 the delivered reservation.
bool
hasSpecificReservationRequired
clearSpecificReservationRequired
setSpecificReservationRequired
Indicates whether the auto-created 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 the delivered reservation.
var
bool
$this
getSpecificSkuProperties
Future Reservation configuration to indicate instance properties and total count.
hasSpecificSkuProperties
clearSpecificSkuProperties
setSpecificSkuProperties
Future Reservation configuration to indicate instance properties and total count.
$this
getStatus
[Output only] Status of the Future Reservation
hasStatus
clearStatus
setStatus
[Output only] Status of the Future Reservation
$this
getTimeWindow
Time window for this Future Reservation.
hasTimeWindow
clearTimeWindow
setTimeWindow
Time window for this Future Reservation.
$this
getZone
[Output Only] URL of the Zone where this future reservation resides.
string
hasZone
clearZone
setZone
[Output Only] URL of the Zone where this future reservation resides.
var
string
$this

