Google Cloud Native v0.32.0, Nov 29 23

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

google-native.compute/alpha.getReservation

Explore with Pulumi AI

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

Using getReservation

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

TypeScript
Python
Go
C#
Java
YAML

function getReservation(args: GetReservationArgs, opts?: InvokeOptions): Promise<GetReservationResult>
function getReservationOutput(args: GetReservationOutputArgs, opts?: InvokeOptions): Output<GetReservationResult>

def get_reservation(project: Optional[str] = None,
                    reservation: Optional[str] = None,
                    zone: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetReservationResult
def get_reservation_output(project: Optional[pulumi.Input[str]] = None,
                    reservation: Optional[pulumi.Input[str]] = None,
                    zone: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetReservationResult]

func LookupReservation(ctx *Context, args *LookupReservationArgs, opts ...InvokeOption) (*LookupReservationResult, error)
func LookupReservationOutput(ctx *Context, args *LookupReservationOutputArgs, opts ...InvokeOption) LookupReservationResultOutput

> Note: This function is named LookupReservation in the Go SDK.

public static class GetReservation 
{
    public static Task<GetReservationResult> InvokeAsync(GetReservationArgs args, InvokeOptions? opts = null)
    public static Output<GetReservationResult> Invoke(GetReservationInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetReservationResult> getReservation(GetReservationArgs args, InvokeOptions options)
public static Output<GetReservationResult> getReservation(GetReservationArgs args, InvokeOptions options)

fn::invoke:
  function: google-native:compute/alpha:getReservation
  arguments:
    # arguments dictionary

The following arguments are supported:

Reservation string
Zone string
Project string

Reservation string
Zone string
Project string

reservation String
zone String
project String

reservation string
zone string
project string

reservation str
zone str
project str

reservation String
zone String
project String

getReservation Result

The following output properties are available:

AggregateReservation Pulumi.GoogleNative.Compute.Alpha.Outputs.AllocationAggregateReservationResponse: Reservation for aggregated resources, providing shape flexibility.
Commitment string: Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.
CreationTimestamp string: Creation timestamp in RFC3339 text format.
DeleteAfterDuration Pulumi.GoogleNative.Compute.Alpha.Outputs.DurationResponse: Duration time relative to reservation creation when GCE will automatically delete this resource.
DeleteAtTime string: Absolute time in future when the reservation will be auto-deleted by GCE. Timestamp is represented in RFC3339 text format.
Description string: An optional description of this resource. Provide this property when you create the resource.
Kind string: Type of the resource. Always compute#reservations for 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 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.
ResourcePolicies Dictionary<string, string>: Resource 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.
ResourceStatus Pulumi.GoogleNative.Compute.Alpha.Outputs.AllocationResourceStatusResponse: Status information for Reservation resource.
SatisfiesPzs bool: Reserved for future use.
SelfLink string: Server-defined fully-qualified URL for this resource.
SelfLinkWithId string: Server-defined URL for this resource with the resource id.
ShareSettings Pulumi.GoogleNative.Compute.Alpha.Outputs.ShareSettingsResponse: Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.
SpecificReservation Pulumi.GoogleNative.Compute.Alpha.Outputs.AllocationSpecificSKUReservationResponse: Reservation for instances with specific machine shapes.
SpecificReservationRequired bool: Indicates 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.
Status string: The status of the reservation.
Zone string: Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.

AggregateReservation AllocationAggregateReservationResponse: Reservation for aggregated resources, providing shape flexibility.
Commitment string: Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.
CreationTimestamp string: Creation timestamp in RFC3339 text format.
DeleteAfterDuration DurationResponse: Duration time relative to reservation creation when GCE will automatically delete this resource.
DeleteAtTime string: Absolute time in future when the reservation will be auto-deleted by GCE. Timestamp is represented in RFC3339 text format.
Description string: An optional description of this resource. Provide this property when you create the resource.
Kind string: Type of the resource. Always compute#reservations for 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 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.
ResourcePolicies map[string]string: Resource 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.
ResourceStatus AllocationResourceStatusResponse: Status information for Reservation resource.
SatisfiesPzs bool: Reserved for future use.
SelfLink string: Server-defined fully-qualified URL for this resource.
SelfLinkWithId string: Server-defined URL for this resource with the resource id.
ShareSettings ShareSettingsResponse: Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.
SpecificReservation AllocationSpecificSKUReservationResponse: Reservation for instances with specific machine shapes.
SpecificReservationRequired bool: Indicates 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.
Status string: The status of the reservation.
Zone string: Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.

aggregateReservation AllocationAggregateReservationResponse: Reservation for aggregated resources, providing shape flexibility.
commitment String: Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.
creationTimestamp String: Creation timestamp in RFC3339 text format.
deleteAfterDuration DurationResponse: Duration time relative to reservation creation when GCE will automatically delete this resource.
deleteAtTime String: Absolute time in future when the reservation will be auto-deleted by GCE. Timestamp is represented in RFC3339 text format.
description String: An optional description of this resource. Provide this property when you create the resource.
kind String: Type of the resource. Always compute#reservations for 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 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.
resourcePolicies Map<String,String>: Resource 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.
resourceStatus AllocationResourceStatusResponse: Status information for Reservation resource.
satisfiesPzs Boolean: Reserved for future use.
selfLink String: Server-defined fully-qualified URL for this resource.
selfLinkWithId String: Server-defined URL for this resource with the resource id.
shareSettings ShareSettingsResponse: Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.
specificReservation AllocationSpecificSKUReservationResponse: Reservation for instances with specific machine shapes.
specificReservationRequired Boolean: Indicates 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.
status String: The status of the reservation.
zone String: Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.

aggregateReservation AllocationAggregateReservationResponse: Reservation for aggregated resources, providing shape flexibility.
commitment string: Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.
creationTimestamp string: Creation timestamp in RFC3339 text format.
deleteAfterDuration DurationResponse: Duration time relative to reservation creation when GCE will automatically delete this resource.
deleteAtTime string: Absolute time in future when the reservation will be auto-deleted by GCE. Timestamp is represented in RFC3339 text format.
description string: An optional description of this resource. Provide this property when you create the resource.
kind string: Type of the resource. Always compute#reservations for 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 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.
resourcePolicies {[key: string]: string}: Resource 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.
resourceStatus AllocationResourceStatusResponse: Status information for Reservation resource.
satisfiesPzs boolean: Reserved for future use.
selfLink string: Server-defined fully-qualified URL for this resource.
selfLinkWithId string: Server-defined URL for this resource with the resource id.
shareSettings ShareSettingsResponse: Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.
specificReservation AllocationSpecificSKUReservationResponse: Reservation for instances with specific machine shapes.
specificReservationRequired boolean: Indicates 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.
status string: The status of the reservation.
zone string: Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.

aggregate_reservation AllocationAggregateReservationResponse: Reservation for aggregated resources, providing shape flexibility.
commitment str: Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.
creation_timestamp str: Creation timestamp in RFC3339 text format.
delete_after_duration DurationResponse: Duration time relative to reservation creation when GCE will automatically delete this resource.
delete_at_time str: Absolute time in future when the reservation will be auto-deleted by GCE. Timestamp is represented in RFC3339 text format.
description str: An optional description of this resource. Provide this property when you create the resource.
kind str: Type of the resource. Always compute#reservations for reservations.
name str: 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.
resource_policies Mapping[str, str]: Resource 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.
resource_status AllocationResourceStatusResponse: Status information for Reservation resource.
satisfies_pzs bool: Reserved for future use.
self_link str: Server-defined fully-qualified URL for this resource.
self_link_with_id str: Server-defined URL for this resource with the resource id.
share_settings ShareSettingsResponse: Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.
specific_reservation AllocationSpecificSKUReservationResponse: Reservation for instances with specific machine shapes.
specific_reservation_required bool: Indicates 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.
status str: The status of the reservation.
zone str: Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.

aggregateReservation Property Map: Reservation for aggregated resources, providing shape flexibility.
commitment String: Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.
creationTimestamp String: Creation timestamp in RFC3339 text format.
deleteAfterDuration Property Map: Duration time relative to reservation creation when GCE will automatically delete this resource.
deleteAtTime String: Absolute time in future when the reservation will be auto-deleted by GCE. Timestamp is represented in RFC3339 text format.
description String: An optional description of this resource. Provide this property when you create the resource.
kind String: Type of the resource. Always compute#reservations for 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 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.
resourcePolicies Map<String>: Resource 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.
resourceStatus Property Map: Status information for Reservation resource.
satisfiesPzs Boolean: Reserved for future use.
selfLink String: Server-defined fully-qualified URL for this resource.
selfLinkWithId String: Server-defined URL for this resource with the resource id.
shareSettings Property Map: Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.
specificReservation Property Map: Reservation for instances with specific machine shapes.
specificReservationRequired Boolean: Indicates 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.
status String: The status of the reservation.
zone String: Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.

Supporting Types

AcceleratorConfigResponse

AcceleratorCount int: The number of the guest accelerator cards exposed to this instance.
AcceleratorType string: Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types.

AcceleratorCount int: The number of the guest accelerator cards exposed to this instance.
AcceleratorType string: Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types.

acceleratorCount Integer: The number of the guest accelerator cards exposed to this instance.
acceleratorType String: Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types.

acceleratorCount number: The number of the guest accelerator cards exposed to this instance.
acceleratorType string: Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types.

accelerator_count int: The number of the guest accelerator cards exposed to this instance.
accelerator_type str: Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types.

acceleratorCount Number: The number of the guest accelerator cards exposed to this instance.
acceleratorType String: Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types.

AllocationAggregateReservationReservedResourceInfoAcceleratorResponse

AcceleratorCount int: Number of accelerators of specified type.
AcceleratorType string: Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"

AcceleratorCount int: Number of accelerators of specified type.
AcceleratorType string: Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"

acceleratorCount Integer: Number of accelerators of specified type.
acceleratorType String: Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"

acceleratorCount number: Number of accelerators of specified type.
acceleratorType string: Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"

accelerator_count int: Number of accelerators of specified type.
accelerator_type str: Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"

acceleratorCount Number: Number of accelerators of specified type.
acceleratorType String: Full or partial URL to accelerator type. e.g. "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l"

AllocationAggregateReservationReservedResourceInfoResponse

Accelerator Pulumi.GoogleNative.Compute.Alpha.Inputs.AllocationAggregateReservationReservedResourceInfoAcceleratorResponse: Properties of accelerator resources in this reservation.

Accelerator AllocationAggregateReservationReservedResourceInfoAcceleratorResponse: Properties of accelerator resources in this reservation.

accelerator AllocationAggregateReservationReservedResourceInfoAcceleratorResponse: Properties of accelerator resources in this reservation.

accelerator AllocationAggregateReservationReservedResourceInfoAcceleratorResponse: Properties of accelerator resources in this reservation.

accelerator AllocationAggregateReservationReservedResourceInfoAcceleratorResponse: Properties of accelerator resources in this reservation.

accelerator Property Map: Properties of accelerator resources in this reservation.

AllocationAggregateReservationResponse

InUseResources List<Pulumi.GoogleNative.Compute.Alpha.Inputs.AllocationAggregateReservationReservedResourceInfoResponse>: [Output only] List of resources currently in use.
ReservedResources List<Pulumi.GoogleNative.Compute.Alpha.Inputs.AllocationAggregateReservationReservedResourceInfoResponse>: List of reserved resources (CPUs, memory, accelerators).
VmFamily string: The VM family that all instances scheduled against this reservation must belong to.
WorkloadType string: The workload type of the instances that will target this reservation.

InUseResources []AllocationAggregateReservationReservedResourceInfoResponse: [Output only] List of resources currently in use.
ReservedResources []AllocationAggregateReservationReservedResourceInfoResponse: List of reserved resources (CPUs, memory, accelerators).
VmFamily string: The VM family that all instances scheduled against this reservation must belong to.
WorkloadType string: The workload type of the instances that will target this reservation.

inUseResources List<AllocationAggregateReservationReservedResourceInfoResponse>: [Output only] List of resources currently in use.
reservedResources List<AllocationAggregateReservationReservedResourceInfoResponse>: List of reserved resources (CPUs, memory, accelerators).
vmFamily String: The VM family that all instances scheduled against this reservation must belong to.
workloadType String: The workload type of the instances that will target this reservation.

inUseResources AllocationAggregateReservationReservedResourceInfoResponse[]: [Output only] List of resources currently in use.
reservedResources AllocationAggregateReservationReservedResourceInfoResponse[]: List of reserved resources (CPUs, memory, accelerators).
vmFamily string: The VM family that all instances scheduled against this reservation must belong to.
workloadType string: The workload type of the instances that will target this reservation.

in_use_resources Sequence[AllocationAggregateReservationReservedResourceInfoResponse]: [Output only] List of resources currently in use.
reserved_resources Sequence[AllocationAggregateReservationReservedResourceInfoResponse]: List of reserved resources (CPUs, memory, accelerators).
vm_family str: The VM family that all instances scheduled against this reservation must belong to.
workload_type str: The workload type of the instances that will target this reservation.

inUseResources List<Property Map>: [Output only] List of resources currently in use.
reservedResources List<Property Map>: List of reserved resources (CPUs, memory, accelerators).
vmFamily String: The VM family that all instances scheduled against this reservation must belong to.
workloadType String: The workload type of the instances that will target this reservation.

AllocationResourceStatusResponse

SpecificSkuAllocation Pulumi.GoogleNative.Compute.Alpha.Inputs.AllocationResourceStatusSpecificSKUAllocationResponse: Allocation Properties of this reservation.

SpecificSkuAllocation AllocationResourceStatusSpecificSKUAllocationResponse: Allocation Properties of this reservation.

specificSkuAllocation AllocationResourceStatusSpecificSKUAllocationResponse: Allocation Properties of this reservation.

specificSkuAllocation AllocationResourceStatusSpecificSKUAllocationResponse: Allocation Properties of this reservation.

specific_sku_allocation AllocationResourceStatusSpecificSKUAllocationResponse: Allocation Properties of this reservation.

specificSkuAllocation Property Map: Allocation Properties of this reservation.

AllocationResourceStatusSpecificSKUAllocationResponse

SourceInstanceTemplateId string: ID of the instance template used to populate reservation properties.

SourceInstanceTemplateId string: ID of the instance template used to populate reservation properties.

sourceInstanceTemplateId String: ID of the instance template used to populate reservation properties.

sourceInstanceTemplateId string: ID of the instance template used to populate reservation properties.

source_instance_template_id str: ID of the instance template used to populate reservation properties.

sourceInstanceTemplateId String: ID of the instance template used to populate reservation properties.

AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDiskResponse

DiskSizeGb string: Specifies the size of the disk in base-2 GB.
Interface string: Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.

DiskSizeGb string: Specifies the size of the disk in base-2 GB.
Interface string: Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.

diskSizeGb String: Specifies the size of the disk in base-2 GB.
interface_ String: Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.

diskSizeGb string: Specifies the size of the disk in base-2 GB.
interface string: Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.

disk_size_gb str: Specifies the size of the disk in base-2 GB.
interface str: Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.

diskSizeGb String: Specifies the size of the disk in base-2 GB.
interface String: Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.

AllocationSpecificSKUAllocationReservedInstancePropertiesResponse

GuestAccelerators List<Pulumi.GoogleNative.Compute.Alpha.Inputs.AcceleratorConfigResponse>: Specifies accelerator type and count.
LocalSsds List<Pulumi.GoogleNative.Compute.Alpha.Inputs.AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDiskResponse>: Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd.
LocationHint string: An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API.
MachineType string: Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
MaintenanceFreezeDurationHours int: Specifies the number of hours after reservation creation where instances using the reservation won't be scheduled for maintenance.
MaintenanceInterval string: Specifies the frequency of planned maintenance events. The accepted values are: PERIODIC.
MinCpuPlatform string: Minimum cpu platform the reservation.

GuestAccelerators []AcceleratorConfigResponse: Specifies accelerator type and count.
LocalSsds []AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDiskResponse: Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd.
LocationHint string: An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API.
MachineType string: Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
MaintenanceFreezeDurationHours int: Specifies the number of hours after reservation creation where instances using the reservation won't be scheduled for maintenance.
MaintenanceInterval string: Specifies the frequency of planned maintenance events. The accepted values are: PERIODIC.
MinCpuPlatform string: Minimum cpu platform the reservation.

guestAccelerators List<AcceleratorConfigResponse>: Specifies accelerator type and count.
localSsds List<AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDiskResponse>: Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd.
locationHint String: An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API.
machineType String: Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
maintenanceFreezeDurationHours Integer: Specifies the number of hours after reservation creation where instances using the reservation won't be scheduled for maintenance.
maintenanceInterval String: Specifies the frequency of planned maintenance events. The accepted values are: PERIODIC.
minCpuPlatform String: Minimum cpu platform the reservation.

guestAccelerators AcceleratorConfigResponse[]: Specifies accelerator type and count.
localSsds AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDiskResponse[]: Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd.
locationHint string: An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API.
machineType string: Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
maintenanceFreezeDurationHours number: Specifies the number of hours after reservation creation where instances using the reservation won't be scheduled for maintenance.
maintenanceInterval string: Specifies the frequency of planned maintenance events. The accepted values are: PERIODIC.
minCpuPlatform string: Minimum cpu platform the reservation.

guest_accelerators Sequence[AcceleratorConfigResponse]: Specifies accelerator type and count.
local_ssds Sequence[AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDiskResponse]: Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd.
location_hint str: An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API.
machine_type str: Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
maintenance_freeze_duration_hours int: Specifies the number of hours after reservation creation where instances using the reservation won't be scheduled for maintenance.
maintenance_interval str: Specifies the frequency of planned maintenance events. The accepted values are: PERIODIC.
min_cpu_platform str: Minimum cpu platform the reservation.

guestAccelerators List<Property Map>: Specifies accelerator type and count.
localSsds List<Property Map>: Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd.
locationHint String: An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API.
machineType String: Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
maintenanceFreezeDurationHours Number: Specifies the number of hours after reservation creation where instances using the reservation won't be scheduled for maintenance.
maintenanceInterval String: Specifies the frequency of planned maintenance events. The accepted values are: PERIODIC.
minCpuPlatform String: Minimum cpu platform the reservation.

AllocationSpecificSKUReservationResponse

AssuredCount string: Indicates how many instances are actually usable currently.
Count string: Specifies the number of resources that are allocated.
InUseCount string: Indicates how many instances are in use.
InstanceProperties Pulumi.GoogleNative.Compute.Alpha.Inputs.AllocationSpecificSKUAllocationReservedInstancePropertiesResponse: The instance properties for the reservation.
SourceInstanceTemplate string: Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate

AssuredCount string: Indicates how many instances are actually usable currently.
Count string: Specifies the number of resources that are allocated.
InUseCount string: Indicates how many instances are in use.
InstanceProperties AllocationSpecificSKUAllocationReservedInstancePropertiesResponse: The instance properties for the reservation.
SourceInstanceTemplate string: Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate

assuredCount String: Indicates how many instances are actually usable currently.
count String: Specifies the number of resources that are allocated.
inUseCount String: Indicates how many instances are in use.
instanceProperties AllocationSpecificSKUAllocationReservedInstancePropertiesResponse: The instance properties for the reservation.
sourceInstanceTemplate String: Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate

assuredCount string: Indicates how many instances are actually usable currently.
count string: Specifies the number of resources that are allocated.
inUseCount string: Indicates how many instances are in use.
instanceProperties AllocationSpecificSKUAllocationReservedInstancePropertiesResponse: The instance properties for the reservation.
sourceInstanceTemplate string: Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate

assured_count str: Indicates how many instances are actually usable currently.
count str: Specifies the number of resources that are allocated.
in_use_count str: Indicates how many instances are in use.
instance_properties AllocationSpecificSKUAllocationReservedInstancePropertiesResponse: The instance properties for the reservation.
source_instance_template str: Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate

assuredCount String: Indicates how many instances are actually usable currently.
count String: Specifies the number of resources that are allocated.
inUseCount String: Indicates how many instances are in use.
instanceProperties Property Map: The instance properties for the reservation.
sourceInstanceTemplate String: Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate

DurationResponse

Nanos int: Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 seconds field and a positive nanos field. Must be from 0 to 999,999,999 inclusive.
Seconds string: Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

Nanos int: Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 seconds field and a positive nanos field. Must be from 0 to 999,999,999 inclusive.
Seconds string: Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

nanos Integer: Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 seconds field and a positive nanos field. Must be from 0 to 999,999,999 inclusive.
seconds String: Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

nanos number: Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 seconds field and a positive nanos field. Must be from 0 to 999,999,999 inclusive.
seconds string: Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

nanos int: Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 seconds field and a positive nanos field. Must be from 0 to 999,999,999 inclusive.
seconds str: Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

nanos Number: Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 seconds field and a positive nanos field. Must be from 0 to 999,999,999 inclusive.
seconds String: Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years

ShareSettingsResponse

FolderMap Dictionary<string, string>: A map of folder id and folder config to specify consumer projects for this shared-reservation. This is only valid when share_type's value is DIRECT_PROJECTS_UNDER_SPECIFIC_FOLDERS. Folder id should be a string of number, and without "folders/" prefix.
ProjectMap Dictionary<string, string>: A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS.
Projects List<string>: A List of Project names to specify consumer projects for this shared-reservation. This is only valid when share_type's value is SPECIFIC_PROJECTS.
ShareType string: Type of sharing for this shared-reservation

FolderMap map[string]string: A map of folder id and folder config to specify consumer projects for this shared-reservation. This is only valid when share_type's value is DIRECT_PROJECTS_UNDER_SPECIFIC_FOLDERS. Folder id should be a string of number, and without "folders/" prefix.
ProjectMap map[string]string: A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS.
Projects []string: A List of Project names to specify consumer projects for this shared-reservation. This is only valid when share_type's value is SPECIFIC_PROJECTS.
ShareType string: Type of sharing for this shared-reservation

folderMap Map<String,String>: A map of folder id and folder config to specify consumer projects for this shared-reservation. This is only valid when share_type's value is DIRECT_PROJECTS_UNDER_SPECIFIC_FOLDERS. Folder id should be a string of number, and without "folders/" prefix.
projectMap Map<String,String>: A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS.
projects List<String>: A List of Project names to specify consumer projects for this shared-reservation. This is only valid when share_type's value is SPECIFIC_PROJECTS.
shareType String: Type of sharing for this shared-reservation

folderMap {[key: string]: string}: A map of folder id and folder config to specify consumer projects for this shared-reservation. This is only valid when share_type's value is DIRECT_PROJECTS_UNDER_SPECIFIC_FOLDERS. Folder id should be a string of number, and without "folders/" prefix.
projectMap {[key: string]: string}: A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS.
projects string[]: A List of Project names to specify consumer projects for this shared-reservation. This is only valid when share_type's value is SPECIFIC_PROJECTS.
shareType string: Type of sharing for this shared-reservation

folder_map Mapping[str, str]: A map of folder id and folder config to specify consumer projects for this shared-reservation. This is only valid when share_type's value is DIRECT_PROJECTS_UNDER_SPECIFIC_FOLDERS. Folder id should be a string of number, and without "folders/" prefix.
project_map Mapping[str, str]: A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS.
projects Sequence[str]: A List of Project names to specify consumer projects for this shared-reservation. This is only valid when share_type's value is SPECIFIC_PROJECTS.
share_type str: Type of sharing for this shared-reservation

folderMap Map<String>: A map of folder id and folder config to specify consumer projects for this shared-reservation. This is only valid when share_type's value is DIRECT_PROJECTS_UNDER_SPECIFIC_FOLDERS. Folder id should be a string of number, and without "folders/" prefix.
projectMap Map<String>: A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS.
projects List<String>: A List of Project names to specify consumer projects for this shared-reservation. This is only valid when share_type's value is SPECIFIC_PROJECTS.
shareType String: Type of sharing for this shared-reservation

Package Details

Repository: Google Cloud Native pulumi/pulumi-google-native
License: Apache-2.0

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

pulumi/pulumi-google-native

google-native.compute/alpha.getReservation

On this page

On this page

Using getReservation

getReservation Result

Supporting Types

AcceleratorConfigResponse

AllocationAggregateReservationReservedResourceInfoAcceleratorResponse

AllocationAggregateReservationReservedResourceInfoResponse

AllocationAggregateReservationResponse

AllocationResourceStatusResponse

AllocationResourceStatusSpecificSKUAllocationResponse

AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDiskResponse

AllocationSpecificSKUAllocationReservedInstancePropertiesResponse

AllocationSpecificSKUReservationResponse

DurationResponse

ShareSettingsResponse

Package Details

On this page

On this page