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.

Reservations apply only to Compute Engine, Cloud Dataproc, and Google Kubernetes Engine VM usage.Reservations do not apply to f1-micro or g1-small machine types, preemptible VMs, sole tenant nodes, or other services not listed above like Cloud SQL and Dataflow.

To get more information about Reservation, see:

Example Usage - Reservation Basic

using Pulumi;
using Gcp = Pulumi.Gcp;

class MyStack : Stack
{
public MyStack()
{
    var gceReservation = new Gcp.Compute.Reservation(&quot;gceReservation&quot;, new Gcp.Compute.ReservationArgs
    {
        SpecificReservation = new Gcp.Compute.Inputs.ReservationSpecificReservationArgs
        {
            Count = 1,
            InstanceProperties = new Gcp.Compute.Inputs.ReservationSpecificReservationInstancePropertiesArgs
            {
                MachineType = &quot;n2-standard-2&quot;,
                MinCpuPlatform = &quot;Intel Cascade Lake&quot;,
            },
        },
        Zone = &quot;us-central1-a&quot;,
    });
}

}

Inheritance

System.Object

Resource

CustomResource

Reservation

Inherited Members

CustomResource.Id

Resource.GetResourceType()

Resource.GetResourceName()

Resource.Urn

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: Pulumi.Gcp.Compute

Assembly: Pulumi.Gcp.dll

Syntax

public class Reservation : CustomResource

Constructors

View Source

Reservation(String, ReservationArgs, CustomResourceOptions)

Create a Reservation resource with the given unique name, arguments, and options.

Declaration

public Reservation(string name, ReservationArgs args, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resource
ReservationArgs	args	The arguments used to populate this resource's properties
CustomResourceOptions	options	A bag of options that control this resource's behavior

Properties

View Source

Commitment

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

Declaration

public Output<string> Commitment { get; }

Property Value

Type	Description
Output<System.String>

View Source

CreationTimestamp

Creation timestamp in RFC3339 text format.

Declaration

public Output<string> CreationTimestamp { get; }

Property Value

Type	Description
Output<System.String>

View Source

Description

An optional description of this resource.

Declaration

public Output<string> Description { get; }

Property Value

Type	Description
Output<System.String>

View Source

Name

Name of the resource. Provided by the client when the resource is created. The 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? 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.

Declaration

public Output<string> Name { get; }

Property Value

Type	Description
Output<System.String>

View Source

Project

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Declaration

public Output<string> Project { get; }

Property Value

Type	Description
Output<System.String>

View Source

SelfLink

The URI of the created resource.

Declaration

public Output<string> SelfLink { get; }

Property Value

Type	Description
Output<System.String>

View Source

SpecificReservation

Reservation for instances with specific machine shapes. Structure is documented below.

Declaration

public Output<ReservationSpecificReservation> SpecificReservation { get; }

Property Value

Type	Description
Output<ReservationSpecificReservation>

View Source

SpecificReservationRequired

When set to true, only VMs that target this reservation by name can consume this reservation. Otherwise, it can be consumed by VMs with affinity for any reservation. Defaults to false.

Declaration

public Output<bool?> SpecificReservationRequired { get; }

Property Value

Type	Description
Output<System.Nullable<System.Boolean>>

View Source

Status

The status of the reservation.

Declaration

public Output<string> Status { get; }

Property Value

Type	Description
Output<System.String>

View Source

Zone

The zone where the reservation is made.

Declaration

public Output<string> Zone { get; }

Property Value

Type	Description
Output<System.String>

Methods

View Source

Get(String, Input<String>, ReservationState, CustomResourceOptions)

Get an existing Reservation resource's state with the given name, ID, and optional extra properties used to qualify the lookup.

Declaration

public static Reservation Get(string name, Input<string> id, ReservationState state = null, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resulting resource.
Input<System.String>	id	The unique provider ID of the resource to lookup.
ReservationState	state	Any extra arguments used during the lookup.
CustomResourceOptions	options	A bag of options that control this resource's behavior

Returns

Type	Description
Reservation