AWS Native v0.126.0, Sep 30 24

We recommend new projects start with resources from the AWS provider.

AWS Native v0.126.0 published on Monday, Sep 30, 2024 by Pulumi

pulumi/pulumi-aws-native

aws-native.ec2.CapacityReservationFleet

Explore with Pulumi AI

We recommend new projects start with resources from the AWS provider.

AWS Native v0.126.0 published on Monday, Sep 30, 2024 by Pulumi

pulumi/pulumi-aws-native

Example Usage

Example

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AwsNative = Pulumi.AwsNative;

return await Deployment.RunAsync(() => 
{
    var ec2CapacityReservationFleetCanary = new AwsNative.Ec2.CapacityReservationFleet("ec2CapacityReservationFleetCanary", new()
    {
        AllocationStrategy = "prioritized",
        InstanceTypeSpecifications = new[]
        {
            new AwsNative.Ec2.Inputs.CapacityReservationFleetInstanceTypeSpecificationArgs
            {
                InstanceType = "c4.large",
                InstancePlatform = "Linux/UNIX",
                AvailabilityZone = "us-east-1a",
                Weight = 1,
                Priority = 1,
            },
            new AwsNative.Ec2.Inputs.CapacityReservationFleetInstanceTypeSpecificationArgs
            {
                InstanceType = "c5.large",
                InstancePlatform = "Linux/UNIX",
                AvailabilityZone = "us-east-1a",
                Weight = 1,
                Priority = 2,
            },
        },
        Tenancy = AwsNative.Ec2.CapacityReservationFleetTenancy.Default,
        TotalTargetCapacity = 2,
        InstanceMatchCriteria = AwsNative.Ec2.CapacityReservationFleetInstanceMatchCriteria.Open,
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ec2.NewCapacityReservationFleet(ctx, "ec2CapacityReservationFleetCanary", &ec2.CapacityReservationFleetArgs{
			AllocationStrategy: pulumi.String("prioritized"),
			InstanceTypeSpecifications: ec2.CapacityReservationFleetInstanceTypeSpecificationArray{
				&ec2.CapacityReservationFleetInstanceTypeSpecificationArgs{
					InstanceType:     pulumi.String("c4.large"),
					InstancePlatform: pulumi.String("Linux/UNIX"),
					AvailabilityZone: pulumi.String("us-east-1a"),
					Weight:           pulumi.Float64(1),
					Priority:         pulumi.Int(1),
				},
				&ec2.CapacityReservationFleetInstanceTypeSpecificationArgs{
					InstanceType:     pulumi.String("c5.large"),
					InstancePlatform: pulumi.String("Linux/UNIX"),
					AvailabilityZone: pulumi.String("us-east-1a"),
					Weight:           pulumi.Float64(1),
					Priority:         pulumi.Int(2),
				},
			},
			Tenancy:               ec2.CapacityReservationFleetTenancyDefault,
			TotalTargetCapacity:   pulumi.Int(2),
			InstanceMatchCriteria: ec2.CapacityReservationFleetInstanceMatchCriteriaOpen,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

Coming soon!

import pulumi
import pulumi_aws_native as aws_native

ec2_capacity_reservation_fleet_canary = aws_native.ec2.CapacityReservationFleet("ec2CapacityReservationFleetCanary",
    allocation_strategy="prioritized",
    instance_type_specifications=[
        {
            "instance_type": "c4.large",
            "instance_platform": "Linux/UNIX",
            "availability_zone": "us-east-1a",
            "weight": 1,
            "priority": 1,
        },
        {
            "instance_type": "c5.large",
            "instance_platform": "Linux/UNIX",
            "availability_zone": "us-east-1a",
            "weight": 1,
            "priority": 2,
        },
    ],
    tenancy=aws_native.ec2.CapacityReservationFleetTenancy.DEFAULT,
    total_target_capacity=2,
    instance_match_criteria=aws_native.ec2.CapacityReservationFleetInstanceMatchCriteria.OPEN)

import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const ec2CapacityReservationFleetCanary = new aws_native.ec2.CapacityReservationFleet("ec2CapacityReservationFleetCanary", {
    allocationStrategy: "prioritized",
    instanceTypeSpecifications: [
        {
            instanceType: "c4.large",
            instancePlatform: "Linux/UNIX",
            availabilityZone: "us-east-1a",
            weight: 1,
            priority: 1,
        },
        {
            instanceType: "c5.large",
            instancePlatform: "Linux/UNIX",
            availabilityZone: "us-east-1a",
            weight: 1,
            priority: 2,
        },
    ],
    tenancy: aws_native.ec2.CapacityReservationFleetTenancy.Default,
    totalTargetCapacity: 2,
    instanceMatchCriteria: aws_native.ec2.CapacityReservationFleetInstanceMatchCriteria.Open,
});

Coming soon!

Create CapacityReservationFleet Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new CapacityReservationFleet(name: string, args?: CapacityReservationFleetArgs, opts?: CustomResourceOptions);

@overload
def CapacityReservationFleet(resource_name: str,
                             args: Optional[CapacityReservationFleetArgs] = None,
                             opts: Optional[ResourceOptions] = None)

@overload
def CapacityReservationFleet(resource_name: str,
                             opts: Optional[ResourceOptions] = None,
                             allocation_strategy: Optional[str] = None,
                             end_date: Optional[str] = None,
                             instance_match_criteria: Optional[CapacityReservationFleetInstanceMatchCriteria] = None,
                             instance_type_specifications: Optional[Sequence[CapacityReservationFleetInstanceTypeSpecificationArgs]] = None,
                             no_remove_end_date: Optional[bool] = None,
                             remove_end_date: Optional[bool] = None,
                             tag_specifications: Optional[Sequence[CapacityReservationFleetTagSpecificationArgs]] = None,
                             tenancy: Optional[CapacityReservationFleetTenancy] = None,
                             total_target_capacity: Optional[int] = None)

func NewCapacityReservationFleet(ctx *Context, name string, args *CapacityReservationFleetArgs, opts ...ResourceOption) (*CapacityReservationFleet, error)

public CapacityReservationFleet(string name, CapacityReservationFleetArgs? args = null, CustomResourceOptions? opts = null)

public CapacityReservationFleet(String name, CapacityReservationFleetArgs args)
public CapacityReservationFleet(String name, CapacityReservationFleetArgs args, CustomResourceOptions options)

type: aws-native:ec2:CapacityReservationFleet
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args CapacityReservationFleetArgs: 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 CapacityReservationFleetArgs: 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 CapacityReservationFleetArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args CapacityReservationFleetArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args CapacityReservationFleetArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

CapacityReservationFleet 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 CapacityReservationFleet resource accepts the following input properties:

AllocationStrategy string

The strategy used by the Capacity Reservation Fleet to determine which of the specified instance types to use. Currently, only the prioritized allocation strategy is supported. For more information, see Allocation strategy in the Amazon EC2 User Guide .

Valid values: prioritized

EndDate string

The date and time at which the Capacity Reservation Fleet expires. When the Capacity Reservation Fleet expires, its state changes to expired and all of the Capacity Reservations in the Fleet expire.

The Capacity Reservation Fleet expires within an hour after the specified time. For example, if you specify 5/31/2019 , 13:30:55 , the Capacity Reservation Fleet is guaranteed to expire between 13:30:55 and 14:30:55 on 5/31/2019 .

InstanceMatchCriteria Pulumi.AwsNative.Ec2.CapacityReservationFleetInstanceMatchCriteria

Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria.

Currently, Capacity Reservation Fleets support open instance matching criteria only. This means that instances that have matching attributes (instance type, platform, and Availability Zone) run in the Capacity Reservations automatically. Instances do not need to explicitly target a Capacity Reservation Fleet to use its reserved capacity.

InstanceTypeSpecifications List<Pulumi.AwsNative.Ec2.Inputs.CapacityReservationFleetInstanceTypeSpecification>

Information about the instance types for which to reserve the capacity.

NoRemoveEndDate bool

Used to add an end date to a Capacity Reservation Fleet that has no end date and time. To add an end date to a Capacity Reservation Fleet, specify true for this paramater and specify the end date and time (in UTC time format) for the EndDate parameter.

RemoveEndDate bool

Used to remove an end date from a Capacity Reservation Fleet that is configured to end automatically at a specific date and time. To remove the end date from a Capacity Reservation Fleet, specify true for this paramater and omit the EndDate parameter.

TagSpecifications List<Pulumi.AwsNative.Ec2.Inputs.CapacityReservationFleetTagSpecification>

The tags to assign to the Capacity Reservation Fleet. The tags are automatically assigned to the Capacity Reservations in the Fleet.

Tenancy Pulumi.AwsNative.Ec2.CapacityReservationFleetTenancy

Indicates the tenancy of the Capacity Reservation Fleet. All Capacity Reservations in the Fleet inherit this tenancy. The Capacity Reservation Fleet can have one of the following tenancy settings:

default - The Capacity Reservation Fleet is created on hardware that is shared with other AWS accounts .
dedicated - The Capacity Reservations are created on single-tenant hardware that is dedicated to a single AWS account .

TotalTargetCapacity int

The total number of capacity units to be reserved by the Capacity Reservation Fleet. This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see Total target capacity in the Amazon EC2 User Guide .

AllocationStrategy string

Valid values: prioritized

EndDate string

InstanceMatchCriteria CapacityReservationFleetInstanceMatchCriteria

Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria.

InstanceTypeSpecifications []CapacityReservationFleetInstanceTypeSpecificationArgs

Information about the instance types for which to reserve the capacity.

NoRemoveEndDate bool

RemoveEndDate bool

TagSpecifications []CapacityReservationFleetTagSpecificationArgs

The tags to assign to the Capacity Reservation Fleet. The tags are automatically assigned to the Capacity Reservations in the Fleet.

Tenancy CapacityReservationFleetTenancy

Indicates the tenancy of the Capacity Reservation Fleet. All Capacity Reservations in the Fleet inherit this tenancy. The Capacity Reservation Fleet can have one of the following tenancy settings:

default - The Capacity Reservation Fleet is created on hardware that is shared with other AWS accounts .
dedicated - The Capacity Reservations are created on single-tenant hardware that is dedicated to a single AWS account .

TotalTargetCapacity int

allocationStrategy String

Valid values: prioritized

endDate String

instanceMatchCriteria CapacityReservationFleetInstanceMatchCriteria

Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria.

instanceTypeSpecifications List<CapacityReservationFleetInstanceTypeSpecification>

Information about the instance types for which to reserve the capacity.

noRemoveEndDate Boolean

removeEndDate Boolean

tagSpecifications List<CapacityReservationFleetTagSpecification>

The tags to assign to the Capacity Reservation Fleet. The tags are automatically assigned to the Capacity Reservations in the Fleet.

tenancy CapacityReservationFleetTenancy

Indicates the tenancy of the Capacity Reservation Fleet. All Capacity Reservations in the Fleet inherit this tenancy. The Capacity Reservation Fleet can have one of the following tenancy settings:

default - The Capacity Reservation Fleet is created on hardware that is shared with other AWS accounts .
dedicated - The Capacity Reservations are created on single-tenant hardware that is dedicated to a single AWS account .

totalTargetCapacity Integer

allocationStrategy string

Valid values: prioritized

endDate string

instanceMatchCriteria CapacityReservationFleetInstanceMatchCriteria

Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria.

instanceTypeSpecifications CapacityReservationFleetInstanceTypeSpecification[]

Information about the instance types for which to reserve the capacity.

noRemoveEndDate boolean

removeEndDate boolean

tagSpecifications CapacityReservationFleetTagSpecification[]

The tags to assign to the Capacity Reservation Fleet. The tags are automatically assigned to the Capacity Reservations in the Fleet.

tenancy CapacityReservationFleetTenancy

Indicates the tenancy of the Capacity Reservation Fleet. All Capacity Reservations in the Fleet inherit this tenancy. The Capacity Reservation Fleet can have one of the following tenancy settings:

default - The Capacity Reservation Fleet is created on hardware that is shared with other AWS accounts .
dedicated - The Capacity Reservations are created on single-tenant hardware that is dedicated to a single AWS account .

totalTargetCapacity number

allocation_strategy str

Valid values: prioritized

end_date str

instance_match_criteria CapacityReservationFleetInstanceMatchCriteria

Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria.

instance_type_specifications Sequence[CapacityReservationFleetInstanceTypeSpecificationArgs]

Information about the instance types for which to reserve the capacity.

no_remove_end_date bool

remove_end_date bool

tag_specifications Sequence[CapacityReservationFleetTagSpecificationArgs]

The tags to assign to the Capacity Reservation Fleet. The tags are automatically assigned to the Capacity Reservations in the Fleet.

tenancy CapacityReservationFleetTenancy

Indicates the tenancy of the Capacity Reservation Fleet. All Capacity Reservations in the Fleet inherit this tenancy. The Capacity Reservation Fleet can have one of the following tenancy settings:

default - The Capacity Reservation Fleet is created on hardware that is shared with other AWS accounts .
dedicated - The Capacity Reservations are created on single-tenant hardware that is dedicated to a single AWS account .

total_target_capacity int

allocationStrategy String

Valid values: prioritized

endDate String

instanceMatchCriteria "open"

Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria.

instanceTypeSpecifications List<Property Map>

Information about the instance types for which to reserve the capacity.

noRemoveEndDate Boolean

removeEndDate Boolean

tagSpecifications List<Property Map>

The tags to assign to the Capacity Reservation Fleet. The tags are automatically assigned to the Capacity Reservations in the Fleet.

tenancy "default"

Indicates the tenancy of the Capacity Reservation Fleet. All Capacity Reservations in the Fleet inherit this tenancy. The Capacity Reservation Fleet can have one of the following tenancy settings:

default - The Capacity Reservation Fleet is created on hardware that is shared with other AWS accounts .
dedicated - The Capacity Reservations are created on single-tenant hardware that is dedicated to a single AWS account .

totalTargetCapacity Number

Outputs

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

CapacityReservationFleetId string: The ID of the Capacity Reservation Fleet.
Id string: The provider-assigned unique ID for this managed resource.

CapacityReservationFleetId string: The ID of the Capacity Reservation Fleet.
Id string: The provider-assigned unique ID for this managed resource.

capacityReservationFleetId String: The ID of the Capacity Reservation Fleet.
id String: The provider-assigned unique ID for this managed resource.

capacityReservationFleetId string: The ID of the Capacity Reservation Fleet.
id string: The provider-assigned unique ID for this managed resource.

capacity_reservation_fleet_id str: The ID of the Capacity Reservation Fleet.
id str: The provider-assigned unique ID for this managed resource.

capacityReservationFleetId String: The ID of the Capacity Reservation Fleet.
id String: The provider-assigned unique ID for this managed resource.

Supporting Types

CapacityReservationFleetInstanceMatchCriteria, CapacityReservationFleetInstanceMatchCriteriaArgs

Open: open

CapacityReservationFleetInstanceMatchCriteriaOpen: open

Open: open

Open: open

OPEN: open

"open": open

CapacityReservationFleetInstanceTypeSpecification, CapacityReservationFleetInstanceTypeSpecificationArgs

AvailabilityZone string

The Availability Zone in which the Capacity Reservation Fleet reserves the capacity. A Capacity Reservation Fleet can't span Availability Zones. All instance type specifications that you specify for the Fleet must use the same Availability Zone.

AvailabilityZoneId string

The ID of the Availability Zone in which the Capacity Reservation Fleet reserves the capacity. A Capacity Reservation Fleet can't span Availability Zones. All instance type specifications that you specify for the Fleet must use the same Availability Zone.

EbsOptimized bool

Indicates whether the Capacity Reservation Fleet supports EBS-optimized instances types. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using EBS-optimized instance types.

InstancePlatform string

The type of operating system for which the Capacity Reservation Fleet reserves capacity.

InstanceType string

The instance type for which the Capacity Reservation Fleet reserves capacity.

Priority int

The priority to assign to the instance type. This value is used to determine which of the instance types specified for the Fleet should be prioritized for use. A lower value indicates a high priority. For more information, see Instance type priority in the Amazon EC2 User Guide .

Weight double

The number of capacity units provided by the specified instance type. This value, together with the total target capacity that you specify for the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see Total target capacity in the Amazon EC2 User Guide.

Valid Range: Minimum value of 0.001 . Maximum value of 99.999 .

AvailabilityZone string

AvailabilityZoneId string

EbsOptimized bool

InstancePlatform string

The type of operating system for which the Capacity Reservation Fleet reserves capacity.

InstanceType string

The instance type for which the Capacity Reservation Fleet reserves capacity.

Priority int

Weight float64