Azure Native

Pulumi Official
Package maintained by Pulumi
v1.64.0 published on Wednesday, May 4, 2022 by Pulumi

CapacityReservationGroup

Specifies information about the capacity reservation group that the capacity reservations should be assigned to.

Currently, a capacity reservation can only be added to a capacity reservation group at creation time. An existing capacity reservation cannot be added or moved to another capacity reservation group. API Version: 2021-04-01.

Example Usage

Create or update a capacity reservation group.

using Pulumi;
using AzureNative = Pulumi.AzureNative;

class MyStack : Stack
{
    public MyStack()
    {
        var capacityReservationGroup = new AzureNative.Compute.CapacityReservationGroup("capacityReservationGroup", new AzureNative.Compute.CapacityReservationGroupArgs
        {
            CapacityReservationGroupName = "myCapacityReservationGroup",
            Location = "westus",
            ResourceGroupName = "myResourceGroup",
            Tags = 
            {
                { "department", "finance" },
            },
            Zones = 
            {
                "1",
                "2",
            },
        });
    }

}
package main

import (
	compute "github.com/pulumi/pulumi-azure-native/sdk/go/azure/compute"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := compute.NewCapacityReservationGroup(ctx, "capacityReservationGroup", &compute.CapacityReservationGroupArgs{
			CapacityReservationGroupName: pulumi.String("myCapacityReservationGroup"),
			Location:                     pulumi.String("westus"),
			ResourceGroupName:            pulumi.String("myResourceGroup"),
			Tags: pulumi.StringMap{
				"department": pulumi.String("finance"),
			},
			Zones: pulumi.StringArray{
				pulumi.String("1"),
				pulumi.String("2"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import java.util.*;
import java.io.*;
import java.nio.*;
import com.pulumi.*;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var capacityReservationGroup = new CapacityReservationGroup("capacityReservationGroup", CapacityReservationGroupArgs.builder()        
            .capacityReservationGroupName("myCapacityReservationGroup")
            .location("westus")
            .resourceGroupName("myResourceGroup")
            .tags(Map.of("department", "finance"))
            .zones(            
                "1",
                "2")
            .build());

        }
}
import pulumi
import pulumi_azure_native as azure_native

capacity_reservation_group = azure_native.compute.CapacityReservationGroup("capacityReservationGroup",
    capacity_reservation_group_name="myCapacityReservationGroup",
    location="westus",
    resource_group_name="myResourceGroup",
    tags={
        "department": "finance",
    },
    zones=[
        "1",
        "2",
    ])
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";

const capacityReservationGroup = new azure_native.compute.CapacityReservationGroup("capacityReservationGroup", {
    capacityReservationGroupName: "myCapacityReservationGroup",
    location: "westus",
    resourceGroupName: "myResourceGroup",
    tags: {
        department: "finance",
    },
    zones: [
        "1",
        "2",
    ],
});
resources:
  capacityReservationGroup:
    type: azure-native:compute:CapacityReservationGroup
    properties:
      capacityReservationGroupName: myCapacityReservationGroup
      location: westus
      resourceGroupName: myResourceGroup
      tags:
        department: finance
      zones:
        - 1
        - 2

Create a CapacityReservationGroup Resource

new CapacityReservationGroup(name: string, args: CapacityReservationGroupArgs, opts?: CustomResourceOptions);
@overload
def CapacityReservationGroup(resource_name: str,
                             opts: Optional[ResourceOptions] = None,
                             capacity_reservation_group_name: Optional[str] = None,
                             location: Optional[str] = None,
                             resource_group_name: Optional[str] = None,
                             tags: Optional[Mapping[str, str]] = None,
                             zones: Optional[Sequence[str]] = None)
@overload
def CapacityReservationGroup(resource_name: str,
                             args: CapacityReservationGroupArgs,
                             opts: Optional[ResourceOptions] = None)
func NewCapacityReservationGroup(ctx *Context, name string, args CapacityReservationGroupArgs, opts ...ResourceOption) (*CapacityReservationGroup, error)
public CapacityReservationGroup(string name, CapacityReservationGroupArgs args, CustomResourceOptions? opts = null)
public CapacityReservationGroup(String name, CapacityReservationGroupArgs args)
public CapacityReservationGroup(String name, CapacityReservationGroupArgs args, CustomResourceOptions options)
type: azure-native:compute:CapacityReservationGroup
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args CapacityReservationGroupArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args CapacityReservationGroupArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args CapacityReservationGroupArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args CapacityReservationGroupArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args CapacityReservationGroupArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

CapacityReservationGroup Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The CapacityReservationGroup resource accepts the following input properties:

ResourceGroupName string

The name of the resource group.

CapacityReservationGroupName string

The name of the capacity reservation group.

Location string

Resource location

Tags Dictionary<string, string>

Resource tags

Zones List<string>

Availability Zones to use for this capacity reservation group. The zones can be assigned only during creation. If not provided, the group supports only regional resources in the region. If provided, enforces each capacity reservation in the group to be in one of the zones.

ResourceGroupName string

The name of the resource group.

CapacityReservationGroupName string

The name of the capacity reservation group.

Location string

Resource location

Tags map[string]string

Resource tags

Zones []string

Availability Zones to use for this capacity reservation group. The zones can be assigned only during creation. If not provided, the group supports only regional resources in the region. If provided, enforces each capacity reservation in the group to be in one of the zones.

resourceGroupName String

The name of the resource group.

capacityReservationGroupName String

The name of the capacity reservation group.

location String

Resource location

tags Map

Resource tags

zones List

Availability Zones to use for this capacity reservation group. The zones can be assigned only during creation. If not provided, the group supports only regional resources in the region. If provided, enforces each capacity reservation in the group to be in one of the zones.

resourceGroupName string

The name of the resource group.

capacityReservationGroupName string

The name of the capacity reservation group.

location string

Resource location

tags {[key: string]: string}

Resource tags

zones string[]

Availability Zones to use for this capacity reservation group. The zones can be assigned only during creation. If not provided, the group supports only regional resources in the region. If provided, enforces each capacity reservation in the group to be in one of the zones.

resource_group_name str

The name of the resource group.

capacity_reservation_group_name str

The name of the capacity reservation group.

location str

Resource location

tags Mapping[str, str]

Resource tags

zones Sequence[str]

Availability Zones to use for this capacity reservation group. The zones can be assigned only during creation. If not provided, the group supports only regional resources in the region. If provided, enforces each capacity reservation in the group to be in one of the zones.

resourceGroupName String

The name of the resource group.

capacityReservationGroupName String

The name of the capacity reservation group.

location String

Resource location

tags Map

Resource tags

zones List

Availability Zones to use for this capacity reservation group. The zones can be assigned only during creation. If not provided, the group supports only regional resources in the region. If provided, enforces each capacity reservation in the group to be in one of the zones.

Outputs

All input properties are implicitly available as output properties. Additionally, the CapacityReservationGroup resource produces the following output properties:

CapacityReservations List<Pulumi.AzureNative.Compute.Outputs.SubResourceReadOnlyResponse>

A list of all capacity reservation resource ids that belong to capacity reservation group.

Id string

The provider-assigned unique ID for this managed resource.

InstanceView Pulumi.AzureNative.Compute.Outputs.CapacityReservationGroupInstanceViewResponse

The capacity reservation group instance view which has the list of instance views for all the capacity reservations that belong to the capacity reservation group.

Name string

Resource name

Type string

Resource type

VirtualMachinesAssociated List<Pulumi.AzureNative.Compute.Outputs.SubResourceReadOnlyResponse>

A list of references to all virtual machines associated to the capacity reservation group.

CapacityReservations []SubResourceReadOnlyResponse

A list of all capacity reservation resource ids that belong to capacity reservation group.

Id string

The provider-assigned unique ID for this managed resource.

InstanceView CapacityReservationGroupInstanceViewResponse

The capacity reservation group instance view which has the list of instance views for all the capacity reservations that belong to the capacity reservation group.

Name string

Resource name

Type string

Resource type

VirtualMachinesAssociated []SubResourceReadOnlyResponse

A list of references to all virtual machines associated to the capacity reservation group.

capacityReservations ListResourceReadOnlyResponse>

A list of all capacity reservation resource ids that belong to capacity reservation group.

id String

The provider-assigned unique ID for this managed resource.

instanceView CapacityReservationGroupInstanceViewResponse

The capacity reservation group instance view which has the list of instance views for all the capacity reservations that belong to the capacity reservation group.

name String

Resource name

type String

Resource type

virtualMachinesAssociated ListResourceReadOnlyResponse>

A list of references to all virtual machines associated to the capacity reservation group.

capacityReservations SubResourceReadOnlyResponse[]

A list of all capacity reservation resource ids that belong to capacity reservation group.

id string

The provider-assigned unique ID for this managed resource.

instanceView CapacityReservationGroupInstanceViewResponse

The capacity reservation group instance view which has the list of instance views for all the capacity reservations that belong to the capacity reservation group.

name string

Resource name

type string

Resource type

virtualMachinesAssociated SubResourceReadOnlyResponse[]

A list of references to all virtual machines associated to the capacity reservation group.

capacity_reservations Sequence[SubResourceReadOnlyResponse]

A list of all capacity reservation resource ids that belong to capacity reservation group.

id str

The provider-assigned unique ID for this managed resource.

instance_view CapacityReservationGroupInstanceViewResponse

The capacity reservation group instance view which has the list of instance views for all the capacity reservations that belong to the capacity reservation group.

name str

Resource name

type str

Resource type

virtual_machines_associated Sequence[SubResourceReadOnlyResponse]

A list of references to all virtual machines associated to the capacity reservation group.

capacityReservations List

A list of all capacity reservation resource ids that belong to capacity reservation group.

id String

The provider-assigned unique ID for this managed resource.

instanceView Property Map

The capacity reservation group instance view which has the list of instance views for all the capacity reservations that belong to the capacity reservation group.

name String

Resource name

type String

Resource type

virtualMachinesAssociated List

A list of references to all virtual machines associated to the capacity reservation group.

Supporting Types

CapacityReservationGroupInstanceViewResponse

CapacityReservations List<Pulumi.AzureNative.Compute.Inputs.CapacityReservationInstanceViewWithNameResponse>

List of instance view of the capacity reservations under the capacity reservation group.

CapacityReservations []CapacityReservationInstanceViewWithNameResponse

List of instance view of the capacity reservations under the capacity reservation group.

capacityReservations ListReservationInstanceViewWithNameResponse>

List of instance view of the capacity reservations under the capacity reservation group.

capacityReservations CapacityReservationInstanceViewWithNameResponse[]

List of instance view of the capacity reservations under the capacity reservation group.

capacity_reservations Sequence[CapacityReservationInstanceViewWithNameResponse]

List of instance view of the capacity reservations under the capacity reservation group.

capacityReservations List

List of instance view of the capacity reservations under the capacity reservation group.

CapacityReservationInstanceViewWithNameResponse

Name string

The name of the capacity reservation.

Statuses List<Pulumi.AzureNative.Compute.Inputs.InstanceViewStatusResponse>

The resource status information.

UtilizationInfo Pulumi.AzureNative.Compute.Inputs.CapacityReservationUtilizationResponse

Unutilized capacity of the capacity reservation.

Name string

The name of the capacity reservation.

Statuses []InstanceViewStatusResponse

The resource status information.

UtilizationInfo CapacityReservationUtilizationResponse

Unutilized capacity of the capacity reservation.

name String

The name of the capacity reservation.

statuses ListViewStatusResponse>

The resource status information.

utilizationInfo CapacityReservationUtilizationResponse

Unutilized capacity of the capacity reservation.

name string

The name of the capacity reservation.

statuses InstanceViewStatusResponse[]

The resource status information.

utilizationInfo CapacityReservationUtilizationResponse

Unutilized capacity of the capacity reservation.

name str

The name of the capacity reservation.

statuses Sequence[InstanceViewStatusResponse]

The resource status information.

utilization_info CapacityReservationUtilizationResponse

Unutilized capacity of the capacity reservation.

name String

The name of the capacity reservation.

statuses List

The resource status information.

utilizationInfo Property Map

Unutilized capacity of the capacity reservation.

CapacityReservationUtilizationResponse

VirtualMachinesAllocated List<Pulumi.AzureNative.Compute.Inputs.SubResourceReadOnlyResponse>

A list of all virtual machines resource ids allocated against the capacity reservation.

VirtualMachinesAllocated []SubResourceReadOnlyResponse

A list of all virtual machines resource ids allocated against the capacity reservation.

virtualMachinesAllocated ListResourceReadOnlyResponse>

A list of all virtual machines resource ids allocated against the capacity reservation.

virtualMachinesAllocated SubResourceReadOnlyResponse[]

A list of all virtual machines resource ids allocated against the capacity reservation.

virtual_machines_allocated Sequence[SubResourceReadOnlyResponse]

A list of all virtual machines resource ids allocated against the capacity reservation.

virtualMachinesAllocated List

A list of all virtual machines resource ids allocated against the capacity reservation.

InstanceViewStatusResponse

Code string

The status code.

DisplayStatus string

The short localizable label for the status.

Level string

The level code.

Message string

The detailed status message, including for alerts and error messages.

Time string

The time of the status.

Code string

The status code.

DisplayStatus string

The short localizable label for the status.

Level string

The level code.

Message string

The detailed status message, including for alerts and error messages.

Time string

The time of the status.

code String

The status code.

displayStatus String

The short localizable label for the status.

level String

The level code.

message String

The detailed status message, including for alerts and error messages.

time String

The time of the status.

code string

The status code.

displayStatus string

The short localizable label for the status.

level string

The level code.

message string

The detailed status message, including for alerts and error messages.

time string

The time of the status.

code str

The status code.

display_status str

The short localizable label for the status.

level str

The level code.

message str

The detailed status message, including for alerts and error messages.

time str

The time of the status.

code String

The status code.

displayStatus String

The short localizable label for the status.

level String

The level code.

message String

The detailed status message, including for alerts and error messages.

time String

The time of the status.

SubResourceReadOnlyResponse

Id string

Resource Id

Id string

Resource Id

id String

Resource Id

id string

Resource Id

id str

Resource Id

id String

Resource Id

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:compute:CapacityReservationGroup myCapacityReservationGroup /subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/CapacityReservationGroups/myCapacityReservationGroup 

Package Details

Repository
https://github.com/pulumi/pulumi-azure-native
License
Apache-2.0