future_reservations
Creates, updates, deletes, gets or lists a future_reservations resource.
Overview
| Name | future_reservations |
| Type | Resource |
| Id | google.compute.future_reservations |
Fields
The following fields are returned by SELECT queries:
- get
- list
- aggregated_list
| Name | Datatype | Description |
|---|---|---|
id | string (uint64) | Output only. [Output Only] A unique identifier for this future reservation. The server defines this identifier. |
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. (pattern: [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?) |
aggregateReservation | object | Aggregate reservation details for the future reservation. (id: AllocationAggregateReservation) |
autoCreatedReservationsDeleteTime | string | Future timestamp when the FR auto-created reservations will be deleted by Compute Engine. Format of this field must be a valid href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. |
autoCreatedReservationsDuration | object | 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. (id: Duration) |
autoDeleteAutoCreatedReservations | boolean | 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. |
commitmentInfo | object | If not present, then FR will not deliver a new commitment or update an existing commitment. (id: FutureReservationCommitmentInfo) |
confidentialComputeType | string | (CONFIDENTIAL_COMPUTE_TYPE_TDX, CONFIDENTIAL_COMPUTE_TYPE_UNSPECIFIED) |
creationTimestamp | string | Output only. [Output Only] The creation timestamp for this future reservation inRFC3339 text format. |
deploymentType | string | Type of the deployment requested as part of future reservation. (DENSE, DEPLOYMENT_TYPE_UNSPECIFIED) |
description | string | An optional description of this resource. Provide this property when you create the future reservation. |
enableEmergentMaintenance | boolean | Indicates if this group of VMs have emergent maintenance enabled. |
kind | string | Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. (default: compute#futureReservation) |
namePrefix | 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-####. |
params | object | Input only. Additional params passed with the request, but not persisted as part of resource payload. (id: FutureReservationParams) |
planningStatus | string | Planning state before being submitted for evaluation (DRAFT, PLANNING_STATUS_UNSPECIFIED, SUBMITTED) |
reservationMode | string | The reservation mode which determines reservation-termination behavior and expected pricing. (CALENDAR, DEFAULT, RESERVATION_MODE_UNSPECIFIED) |
reservationName | 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. |
resourceMetadata | object | Output only. Contains standard resource metadata for an FutureReservation resource. It is populated for each instance of the FutureReservation resource, and includes the api_version the instance was retrieved through, and its canonical resource_type name. (id: ResourceMetadata) |
resourceName | string | Name of the resource intended to be delivered. Name should conform to RFC1035. This will be the name of storage pool or Exapool for persistent disk FRs. |
schedulingType | string | Maintenance information for this reservation (GROUPED, GROUP_MAINTENANCE_TYPE_UNSPECIFIED, INDEPENDENT) |
selfLink | string | Output only. [Output Only] Server-defined fully-qualified URL for this resource. |
selfLinkWithId | string | Output only. [Output Only] Server-defined URL for this resource with the resource id. |
shareSettings | object | List of Projects/Folders to share with. (id: ShareSettings) |
specificReservationRequired | boolean | 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. |
specificSkuProperties | object | Future Reservation configuration to indicate instance properties and total count. (id: FutureReservationSpecificSKUProperties) |
status | object | Output only. [Output only] Status of the Future Reservation (id: FutureReservationStatus) |
storagePoolProperties | object | Storage pool details for the future reservation. (id: FutureReservationStoragePoolProperties) |
timeWindow | object | Time window for this Future Reservation. (id: FutureReservationTimeWindow) |
zone | string | Output only. [Output Only] URL of the Zone where this future reservation resides. |
| Name | Datatype | Description |
|---|---|---|
id | string | [Output Only] The unique identifier for the resource. This identifier is defined by the server. |
etag | string | |
items | array | [Output Only] A list of future reservation resources. |
kind | string | Output only. [Output Only] Type of resource.Alwayscompute#FutureReservationsListResponse for lists of reservations (default: compute#futureReservationsListResponse) |
nextPageToken | string | [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. |
selfLink | string | Output only. [Output Only] Server-defined URL for this resource. |
unreachables | array | Output only. [Output Only] Unreachable resources. |
warning | object | [Output Only] Informational warning message. |
| Name | Datatype | Description |
|---|---|---|
id | string (uint64) | Output only. [Output Only] A unique identifier for this future reservation. The server defines this identifier. |
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. (pattern: [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?) |
aggregateReservation | object | Aggregate reservation details for the future reservation. (id: AllocationAggregateReservation) |
autoCreatedReservationsDeleteTime | string | Future timestamp when the FR auto-created reservations will be deleted by Compute Engine. Format of this field must be a valid href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. |
autoCreatedReservationsDuration | object | 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. (id: Duration) |
autoDeleteAutoCreatedReservations | boolean | 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. |
commitmentInfo | object | If not present, then FR will not deliver a new commitment or update an existing commitment. (id: FutureReservationCommitmentInfo) |
confidentialComputeType | string | (CONFIDENTIAL_COMPUTE_TYPE_TDX, CONFIDENTIAL_COMPUTE_TYPE_UNSPECIFIED) |
creationTimestamp | string | Output only. [Output Only] The creation timestamp for this future reservation inRFC3339 text format. |
deploymentType | string | Type of the deployment requested as part of future reservation. (DENSE, DEPLOYMENT_TYPE_UNSPECIFIED) |
description | string | An optional description of this resource. Provide this property when you create the future reservation. |
enableEmergentMaintenance | boolean | Indicates if this group of VMs have emergent maintenance enabled. |
kind | string | Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. (default: compute#futureReservation) |
namePrefix | 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-####. |
params | object | Input only. Additional params passed with the request, but not persisted as part of resource payload. (id: FutureReservationParams) |
planningStatus | string | Planning state before being submitted for evaluation (DRAFT, PLANNING_STATUS_UNSPECIFIED, SUBMITTED) |
reservationMode | string | The reservation mode which determines reservation-termination behavior and expected pricing. (CALENDAR, DEFAULT, RESERVATION_MODE_UNSPECIFIED) |
reservationName | 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. |
resourceMetadata | object | Output only. Contains standard resource metadata for an FutureReservation resource. It is populated for each instance of the FutureReservation resource, and includes the api_version the instance was retrieved through, and its canonical resource_type name. (id: ResourceMetadata) |
resourceName | string | Name of the resource intended to be delivered. Name should conform to RFC1035. This will be the name of storage pool or Exapool for persistent disk FRs. |
schedulingType | string | Maintenance information for this reservation (GROUPED, GROUP_MAINTENANCE_TYPE_UNSPECIFIED, INDEPENDENT) |
selfLink | string | Output only. [Output Only] Server-defined fully-qualified URL for this resource. |
selfLinkWithId | string | Output only. [Output Only] Server-defined URL for this resource with the resource id. |
shareSettings | object | List of Projects/Folders to share with. (id: ShareSettings) |
specificReservationRequired | boolean | 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. |
specificSkuProperties | object | Future Reservation configuration to indicate instance properties and total count. (id: FutureReservationSpecificSKUProperties) |
status | object | Output only. [Output only] Status of the Future Reservation (id: FutureReservationStatus) |
storagePoolProperties | object | Storage pool details for the future reservation. (id: FutureReservationStoragePoolProperties) |
timeWindow | object | Time window for this Future Reservation. (id: FutureReservationTimeWindow) |
zone | string | Output only. [Output Only] URL of the Zone where this future reservation resides. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | project, zone, futureReservation | Retrieves information about the specified future reservation. | |
list | select | project, zone | filter, maxResults, orderBy, pageToken, returnPartialSuccess | A list of all the future reservations that have been configured for the specified project in specified zone. |
aggregated_list | select | project | filter, includeAllScopes, maxResults, orderBy, pageToken, returnPartialSuccess, serviceProjectNumber | Retrieves an aggregated list of future reservations. To prevent failure, it is recommended that you set the returnPartialSuccess parameter to true. |
insert | insert | project, zone | requestId | Creates a new Future Reservation. |
update | update | project, zone, futureReservation | requestId, updateMask | Updates the specified future reservation. |
delete | delete | project, zone, futureReservation | requestId | Deletes the specified future reservation. |
cancel | exec | project, zone, futureReservation | requestId | Cancel the specified future reservation. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
futureReservation | string | |
project | string | |
zone | string | |
filter | string | |
includeAllScopes | boolean | |
maxResults | integer (uint32) | |
orderBy | string | |
pageToken | string | |
requestId | string | |
returnPartialSuccess | boolean | |
serviceProjectNumber | string (int64) | |
updateMask | string (google-fieldmask) |
SELECT examples
- get
- list
- aggregated_list
Retrieves information about the specified future reservation.
SELECT
id,
name,
aggregateReservation,
autoCreatedReservationsDeleteTime,
autoCreatedReservationsDuration,
autoDeleteAutoCreatedReservations,
commitmentInfo,
confidentialComputeType,
creationTimestamp,
deploymentType,
description,
enableEmergentMaintenance,
kind,
namePrefix,
params,
planningStatus,
reservationMode,
reservationName,
resourceMetadata,
resourceName,
schedulingType,
selfLink,
selfLinkWithId,
shareSettings,
specificReservationRequired,
specificSkuProperties,
status,
storagePoolProperties,
timeWindow,
zone
FROM google.compute.future_reservations
WHERE project = '{{ project }}' -- required
AND zone = '{{ zone }}' -- required
AND futureReservation = '{{ futureReservation }}' -- required
;
A list of all the future reservations that have been configured for the
specified project in specified zone.
SELECT
id,
etag,
items,
kind,
nextPageToken,
selfLink,
unreachables,
warning
FROM google.compute.future_reservations
WHERE project = '{{ project }}' -- required
AND zone = '{{ zone }}' -- required
AND filter = '{{ filter }}'
AND maxResults = '{{ maxResults }}'
AND orderBy = '{{ orderBy }}'
AND pageToken = '{{ pageToken }}'
AND returnPartialSuccess = '{{ returnPartialSuccess }}'
;
Retrieves an aggregated list of future reservations.
To prevent failure, it is recommended that you set thereturnPartialSuccess parameter to true.
SELECT
id,
name,
aggregateReservation,
autoCreatedReservationsDeleteTime,
autoCreatedReservationsDuration,
autoDeleteAutoCreatedReservations,
commitmentInfo,
confidentialComputeType,
creationTimestamp,
deploymentType,
description,
enableEmergentMaintenance,
kind,
namePrefix,
params,
planningStatus,
reservationMode,
reservationName,
resourceMetadata,
resourceName,
schedulingType,
selfLink,
selfLinkWithId,
shareSettings,
specificReservationRequired,
specificSkuProperties,
status,
storagePoolProperties,
timeWindow,
zone
FROM google.compute.future_reservations
WHERE project = '{{ project }}' -- required
AND filter = '{{ filter }}'
AND includeAllScopes = '{{ includeAllScopes }}'
AND maxResults = '{{ maxResults }}'
AND orderBy = '{{ orderBy }}'
AND pageToken = '{{ pageToken }}'
AND returnPartialSuccess = '{{ returnPartialSuccess }}'
AND serviceProjectNumber = '{{ serviceProjectNumber }}'
;
INSERT examples
- insert
- Manifest
Creates a new Future Reservation.
INSERT INTO google.compute.future_reservations (
data__aggregateReservation,
data__autoCreatedReservationsDeleteTime,
data__autoCreatedReservationsDuration,
data__autoDeleteAutoCreatedReservations,
data__commitmentInfo,
data__confidentialComputeType,
data__deploymentType,
data__description,
data__enableEmergentMaintenance,
data__name,
data__namePrefix,
data__params,
data__planningStatus,
data__reservationMode,
data__reservationName,
data__resourceName,
data__schedulingType,
data__shareSettings,
data__specificReservationRequired,
data__specificSkuProperties,
data__storagePoolProperties,
data__timeWindow,
project,
zone,
requestId
)
SELECT
'{{ aggregateReservation }}',
'{{ autoCreatedReservationsDeleteTime }}',
'{{ autoCreatedReservationsDuration }}',
{{ autoDeleteAutoCreatedReservations }},
'{{ commitmentInfo }}',
'{{ confidentialComputeType }}',
'{{ deploymentType }}',
'{{ description }}',
{{ enableEmergentMaintenance }},
'{{ name }}',
'{{ namePrefix }}',
'{{ params }}',
'{{ planningStatus }}',
'{{ reservationMode }}',
'{{ reservationName }}',
'{{ resourceName }}',
'{{ schedulingType }}',
'{{ shareSettings }}',
{{ specificReservationRequired }},
'{{ specificSkuProperties }}',
'{{ storagePoolProperties }}',
'{{ timeWindow }}',
'{{ project }}',
'{{ zone }}',
'{{ requestId }}'
RETURNING
id,
name,
clientOperationId,
creationTimestamp,
description,
endTime,
error,
getVersionOperationMetadata,
httpErrorMessage,
httpErrorStatusCode,
insertTime,
instancesBulkInsertOperationMetadata,
kind,
operationGroupId,
operationType,
progress,
region,
selfLink,
setCommonInstanceMetadataOperationMetadata,
startTime,
status,
statusMessage,
targetId,
targetLink,
user,
warnings,
zone
;
# Description fields are for documentation purposes
- name: future_reservations
props:
- name: project
value: "{{ project }}"
description: Required parameter for the future_reservations resource.
- name: zone
value: "{{ zone }}"
description: Required parameter for the future_reservations resource.
- name: aggregateReservation
description: |
Aggregate reservation details for the future reservation.
value:
inUseResources:
- accelerator:
acceleratorCount: {{ acceleratorCount }}
acceleratorType: "{{ acceleratorType }}"
reservedResources:
- accelerator:
acceleratorCount: {{ acceleratorCount }}
acceleratorType: "{{ acceleratorType }}"
vmFamily: "{{ vmFamily }}"
workloadType: "{{ workloadType }}"
- name: autoCreatedReservationsDeleteTime
value: "{{ autoCreatedReservationsDeleteTime }}"
description: |
Future timestamp when the FR auto-created reservations will be deleted by
Compute Engine. Format of this field must be a valid
href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value.
- name: autoCreatedReservationsDuration
description: |
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.
value:
nanos: {{ nanos }}
seconds: "{{ seconds }}"
- name: autoDeleteAutoCreatedReservations
value: {{ autoDeleteAutoCreatedReservations }}
description: |
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.
- name: commitmentInfo
description: |
If not present, then FR will not deliver a new commitment or update an
existing commitment.
value:
commitmentName: "{{ commitmentName }}"
commitmentPlan: "{{ commitmentPlan }}"
previousCommitmentTerms: "{{ previousCommitmentTerms }}"
- name: confidentialComputeType
value: "{{ confidentialComputeType }}"
valid_values: ['CONFIDENTIAL_COMPUTE_TYPE_TDX', 'CONFIDENTIAL_COMPUTE_TYPE_UNSPECIFIED']
- name: deploymentType
value: "{{ deploymentType }}"
description: |
Type of the deployment requested as part of future reservation.
valid_values: ['DENSE', 'DEPLOYMENT_TYPE_UNSPECIFIED']
- name: description
value: "{{ description }}"
description: |
An optional description of this resource. Provide this property when you
create the future reservation.
- name: enableEmergentMaintenance
value: {{ enableEmergentMaintenance }}
description: |
Indicates if this group of VMs have emergent maintenance enabled.
- name: name
value: "{{ name }}"
description: |
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: namePrefix
value: "{{ namePrefix }}"
description: |
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-####.
- name: params
description: |
Input only. Additional params passed with the request, but not persisted
as part of resource payload.
value:
resourceManagerTags: "{{ resourceManagerTags }}"
- name: planningStatus
value: "{{ planningStatus }}"
description: |
Planning state before being submitted for evaluation
valid_values: ['DRAFT', 'PLANNING_STATUS_UNSPECIFIED', 'SUBMITTED']
- name: reservationMode
value: "{{ reservationMode }}"
description: |
The reservation mode which determines reservation-termination behavior and
expected pricing.
valid_values: ['CALENDAR', 'DEFAULT', 'RESERVATION_MODE_UNSPECIFIED']
- name: reservationName
value: "{{ reservationName }}"
description: |
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.
- name: resourceName
value: "{{ resourceName }}"
description: |
Name of the resource intended to be delivered. Name should conform to
RFC1035. This will be the name of storage pool or Exapool for persistent
disk FRs.
- name: schedulingType
value: "{{ schedulingType }}"
description: |
Maintenance information for this reservation
valid_values: ['GROUPED', 'GROUP_MAINTENANCE_TYPE_UNSPECIFIED', 'INDEPENDENT']
- name: shareSettings
description: |
List of Projects/Folders to share with.
value:
projectMap: "{{ projectMap }}"
shareType: "{{ shareType }}"
- name: specificReservationRequired
value: {{ specificReservationRequired }}
description: |
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.
- name: specificSkuProperties
description: |
Future Reservation configuration to indicate instance properties and
total count.
value:
instanceProperties:
guestAccelerators:
- acceleratorCount: {{ acceleratorCount }}
acceleratorType: "{{ acceleratorType }}"
localSsds:
- diskSizeGb: "{{ diskSizeGb }}"
interface: "{{ interface }}"
locationHint: "{{ locationHint }}"
machineType: "{{ machineType }}"
minCpuPlatform: "{{ minCpuPlatform }}"
sourceInstanceTemplate: "{{ sourceInstanceTemplate }}"
totalCount: "{{ totalCount }}"
- name: storagePoolProperties
description: |
Storage pool details for the future reservation.
value:
requestedExapoolProvisionedCapacityGb:
capacityOptimized: "{{ capacityOptimized }}"
readOptimized: "{{ readOptimized }}"
writeOptimized: "{{ writeOptimized }}"
requestedStoragePoolProvisionedCapacity:
poolProvisionedCapacityGb: "{{ poolProvisionedCapacityGb }}"
poolProvisionedIops: "{{ poolProvisionedIops }}"
poolProvisionedThroughput: "{{ poolProvisionedThroughput }}"
storagePoolType: "{{ storagePoolType }}"
- name: timeWindow
description: |
Time window for this Future Reservation.
value:
duration:
nanos: {{ nanos }}
seconds: "{{ seconds }}"
endTime: "{{ endTime }}"
startTime: "{{ startTime }}"
- name: requestId
value: "{{ requestId }}"
UPDATE examples
- update
Updates the specified future reservation.
UPDATE google.compute.future_reservations
SET
data__aggregateReservation = '{{ aggregateReservation }}',
data__autoCreatedReservationsDeleteTime = '{{ autoCreatedReservationsDeleteTime }}',
data__autoCreatedReservationsDuration = '{{ autoCreatedReservationsDuration }}',
data__autoDeleteAutoCreatedReservations = {{ autoDeleteAutoCreatedReservations }},
data__commitmentInfo = '{{ commitmentInfo }}',
data__confidentialComputeType = '{{ confidentialComputeType }}',
data__deploymentType = '{{ deploymentType }}',
data__description = '{{ description }}',
data__enableEmergentMaintenance = {{ enableEmergentMaintenance }},
data__name = '{{ name }}',
data__namePrefix = '{{ namePrefix }}',
data__params = '{{ params }}',
data__planningStatus = '{{ planningStatus }}',
data__reservationMode = '{{ reservationMode }}',
data__reservationName = '{{ reservationName }}',
data__resourceName = '{{ resourceName }}',
data__schedulingType = '{{ schedulingType }}',
data__shareSettings = '{{ shareSettings }}',
data__specificReservationRequired = {{ specificReservationRequired }},
data__specificSkuProperties = '{{ specificSkuProperties }}',
data__storagePoolProperties = '{{ storagePoolProperties }}',
data__timeWindow = '{{ timeWindow }}'
WHERE
project = '{{ project }}' --required
AND zone = '{{ zone }}' --required
AND futureReservation = '{{ futureReservation }}' --required
AND requestId = '{{ requestId}}'
AND updateMask = '{{ updateMask}}'
RETURNING
id,
name,
clientOperationId,
creationTimestamp,
description,
endTime,
error,
getVersionOperationMetadata,
httpErrorMessage,
httpErrorStatusCode,
insertTime,
instancesBulkInsertOperationMetadata,
kind,
operationGroupId,
operationType,
progress,
region,
selfLink,
setCommonInstanceMetadataOperationMetadata,
startTime,
status,
statusMessage,
targetId,
targetLink,
user,
warnings,
zone;
DELETE examples
- delete
Deletes the specified future reservation.
DELETE FROM google.compute.future_reservations
WHERE project = '{{ project }}' --required
AND zone = '{{ zone }}' --required
AND futureReservation = '{{ futureReservation }}' --required
AND requestId = '{{ requestId }}'
;
Lifecycle Methods
- cancel
Cancel the specified future reservation.
EXEC google.compute.future_reservations.cancel
@project='{{ project }}' --required,
@zone='{{ zone }}' --required,
@futureReservation='{{ futureReservation }}' --required,
@requestId='{{ requestId }}'
;