future_reservations

Creates, updates, deletes, gets or lists a future_reservations resource.

Overview

Name	future_reservations
Type	Resource
Id	google.compute.future_reservations

Fields

Name	Datatype	Description
id	string	[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 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.
description	string	An optional description of this resource. Provide this property when you create the future reservation.
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	A Duration represents a fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like "day" or "month". Range is approximately 10,000 years.
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.
creationTimestamp	string	[Output Only] The creation timestamp for this future reservation in RFC3339 text format.
kind	string	[Output Only] Type of the resource. Always compute#futureReservation for future reservations.
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-####.
planningStatus	string	Planning state before being submitted for evaluation
selfLink	string	[Output Only] Server-defined fully-qualified URL for this resource.
selfLinkWithId	string	[Output Only] Server-defined URL for this resource with the resource id.
shareSettings	object	The share setting for reservations and sole tenancy node groups.
specificSkuProperties	object
status	object	[Output only] Represents status related to the future reservation.
timeWindow	object
zone	string	[Output Only] URL of the Zone where this future reservation resides.

Methods

Name	Accessible by	Required Params	Description
aggregated_list	SELECT	project	Retrieves an aggregated list of future reservations. To prevent failure, Google recommends that you set the returnPartialSuccess parameter to true.
get	SELECT	futureReservation, project, zone	Retrieves information about the specified future reservation.
list	SELECT	project, zone	A list of all the future reservations that have been configured for the specified project in specified zone.
insert	INSERT	project, zone	Creates a new Future Reservation.
delete	DELETE	futureReservation, project, zone	Deletes the specified future reservation.
update	UPDATE	futureReservation, project, zone	Updates the specified future reservation.
cancel	EXEC	futureReservation, project, zone	Cancel the specified future reservation.

SELECT examples

Retrieves an aggregated list of future reservations. To prevent failure, Google recommends that you set the returnPartialSuccess parameter to true.

SELECT
id,
name,
description,
autoCreatedReservationsDeleteTime,
autoCreatedReservationsDuration,
autoDeleteAutoCreatedReservations,
creationTimestamp,
kind,
namePrefix,
planningStatus,
selfLink,
selfLinkWithId,
shareSettings,
specificSkuProperties,
status,
timeWindow,
zone
FROM google.compute.future_reservations
WHERE project = '{{ project }}';

INSERT example

Use the following StackQL query and manifest file to create a new future_reservations resource.

All Properties

/*+ create */
INSERT INTO google.compute.future_reservations (
project,
zone,
zone,
description,
name,
specificSkuProperties,
timeWindow,
shareSettings,
namePrefix,
status,
planningStatus,
autoCreatedReservationsDeleteTime,
autoCreatedReservationsDuration,
autoDeleteAutoCreatedReservations
)
SELECT 
'{{ project }}',
'{{ zone }}',
'{{ zone }}',
'{{ description }}',
'{{ name }}',
'{{ specificSkuProperties }}',
'{{ timeWindow }}',
'{{ shareSettings }}',
'{{ namePrefix }}',
'{{ status }}',
'{{ planningStatus }}',
'{{ autoCreatedReservationsDeleteTime }}',
'{{ autoCreatedReservationsDuration }}',
{{ autoDeleteAutoCreatedReservations }}
;

Manifest

- name: your_resource_model_name
  props:
    - name: kind
      value: string
    - name: id
      value: string
    - name: creationTimestamp
      value: string
    - name: selfLink
      value: string
    - name: selfLinkWithId
      value: string
    - name: zone
      value: string
    - name: description
      value: string
    - name: name
      value: string
    - name: specificSkuProperties
      value:
        - name: instanceProperties
          value:
            - name: machineType
              value: string
            - name: guestAccelerators
              value:
                - - name: acceleratorType
                    value: string
                  - name: acceleratorCount
                    value: integer
            - name: minCpuPlatform
              value: string
            - name: localSsds
              value:
                - - name: diskSizeGb
                    value: string
                  - name: interface
                    value: string
            - name: locationHint
              value: string
        - name: totalCount
          value: string
        - name: sourceInstanceTemplate
          value: string
    - name: timeWindow
      value:
        - name: startTime
          value: string
        - name: endTime
          value: string
        - name: duration
          value:
            - name: seconds
              value: string
            - name: nanos
              value: integer
    - name: shareSettings
      value:
        - name: shareType
          value: string
        - name: projectMap
          value: object
    - name: namePrefix
      value: string
    - name: status
      value:
        - name: procurementStatus
          value: string
        - name: lockTime
          value: string
        - name: autoCreatedReservations
          value:
            - string
        - name: fulfilledCount
          value: string
        - name: specificSkuProperties
          value:
            - name: sourceInstanceTemplateId
              value: string
        - name: amendmentStatus
          value: string
        - name: lastKnownGoodState
          value:
            - name: futureReservationSpecs
              value: []
            - name: procurementStatus
              value: string
            - name: namePrefix
              value: string
            - name: description
              value: string
            - name: lockTime
              value: string
            - name: existingMatchingUsageInfo
              value:
                - name: count
                  value: string
                - name: timestamp
                  value: string
    - name: planningStatus
      value: string
    - name: autoCreatedReservationsDeleteTime
      value: string
    - name: autoDeleteAutoCreatedReservations
      value: boolean

UPDATE example

Updates a future_reservations resource.

/*+ update */
UPDATE google.compute.future_reservations
SET 
zone = '{{ zone }}',
description = '{{ description }}',
name = '{{ name }}',
specificSkuProperties = '{{ specificSkuProperties }}',
timeWindow = '{{ timeWindow }}',
shareSettings = '{{ shareSettings }}',
namePrefix = '{{ namePrefix }}',
status = '{{ status }}',
planningStatus = '{{ planningStatus }}',
autoCreatedReservationsDeleteTime = '{{ autoCreatedReservationsDeleteTime }}',
autoCreatedReservationsDuration = '{{ autoCreatedReservationsDuration }}',
autoDeleteAutoCreatedReservations = true|false
WHERE 
futureReservation = '{{ futureReservation }}'
AND project = '{{ project }}'
AND zone = '{{ zone }}';

DELETE example

Deletes the specified future_reservations resource.

/*+ delete */
DELETE FROM google.compute.future_reservations
WHERE futureReservation = '{{ futureReservation }}'
AND project = '{{ project }}'
AND zone = '{{ zone }}';