Skip to main content

reservations

Overview

Namereservations
TypeResource
Idgoogle.compute.reservations

Fields

NameDatatypeDescription
idstring[Output Only] The unique identifier for the resource. This identifier is defined by the server.
namestringThe 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.
descriptionstringAn optional description of this resource. Provide this property when you create the resource.
kindstring[Output Only] Type of the resource. Always compute#reservations for reservations.
satisfiesPzsboolean[Output Only] Reserved for future use.
zonestringZone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.
shareSettingsobjectThe share setting for reservations and sole tenancy node groups.
commitmentstring[Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.
statusstring[Output Only] The status of the reservation.
specificReservationRequiredbooleanIndicates 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.
resourcePoliciesobjectResource 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.
specificReservationobjectThis reservation type allows to pre allocate specific instance configuration. Next ID: 6
creationTimestampstring[Output Only] Creation timestamp in RFC3339 text format.
resourceStatusobject[Output Only] Contains output only fields.
selfLinkstring[Output Only] Server-defined fully-qualified URL for this resource.

Methods

NameAccessible byRequired ParamsDescription
aggregated_listSELECTprojectRetrieves an aggregated list of reservations.
getSELECTproject, reservation, zoneRetrieves information about the specified reservation.
listSELECTproject, zoneA list of all the reservations that have been configured for the specified project in specified zone.
insertINSERTproject, zoneCreates a new reservation. For more information, read Reserving zonal resources.
deleteDELETEproject, reservation, zoneDeletes the specified reservation.
_aggregated_listEXECprojectRetrieves an aggregated list of reservations.
resizeEXECproject, reservation, zoneResizes the reservation (applicable to standalone reservations only). For more information, read Modifying reservations.
updateEXECproject, reservation, zoneUpdate share settings of the reservation.