CapacityBlockReservation class

Provides an EC2 Capacity Block Reservation. This allows you to purchase capacity block for your Amazon EC2 instances in a specific Availability Zone for machine learning (ML) Workloads.

> NOTE: Once created, a reservation is valid for the duration of the provided capacityBlockOfferingId and cannot be deleted. Performing a destroy will only remove the resource from state. For more information see EC2 Capacity Block Reservation Documentation and PurchaseReservedDBInstancesOffering.

> NOTE: Due to the expense of testing this resource, we provide it as best effort. If you find it useful, and have the ability to help test or notice issues, consider reaching out to us on GitHub.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const test = aws.ec2.getCapacityBlockOffering({
    capacityDurationHours: 24,
    endDateRange: "2024-05-30T15:04:05Z",
    instanceCount: 1,
    instanceType: "p5.4xlarge",
    startDateRange: "2024-04-28T15:04:05Z",
});
const example = new aws.ec2.CapacityBlockReservation("example", {
    capacityBlockOfferingId: test.then(test => test.capacityBlockOfferingId),
    instancePlatform: "Linux/UNIX",
});

import pulumi
import pulumi_aws as aws

test = aws.ec2.get_capacity_block_offering(capacity_duration_hours=24,
    end_date_range="2024-05-30T15:04:05Z",
    instance_count=1,
    instance_type="p5.4xlarge",
    start_date_range="2024-04-28T15:04:05Z")
example = aws.ec2.CapacityBlockReservation("example",
    capacity_block_offering_id=test.capacity_block_offering_id,
    instance_platform="Linux/UNIX")

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

return await Deployment.RunAsync(() =>
{
    var test = Aws.Ec2.GetCapacityBlockOffering.Invoke(new()
    {
        CapacityDurationHours = 24,
        EndDateRange = "2024-05-30T15:04:05Z",
        InstanceCount = 1,
        InstanceType = "p5.4xlarge",
        StartDateRange = "2024-04-28T15:04:05Z",
    });

    var example = new Aws.Ec2.CapacityBlockReservation("example", new()
    {
        CapacityBlockOfferingId = test.Apply(getCapacityBlockOfferingResult => getCapacityBlockOfferingResult.CapacityBlockOfferingId),
        InstancePlatform = "Linux/UNIX",
    });

});

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		test, err := ec2.GetCapacityBlockOffering(ctx, &ec2.GetCapacityBlockOfferingArgs{
			CapacityDurationHours: 24,
			EndDateRange:          pulumi.StringRef("2024-05-30T15:04:05Z"),
			InstanceCount:         1,
			InstanceType:          "p5.4xlarge",
			StartDateRange:        pulumi.StringRef("2024-04-28T15:04:05Z"),
		}, nil)
		if err != nil {
			return err
		}
		_, err = ec2.NewCapacityBlockReservation(ctx, "example", &ec2.CapacityBlockReservationArgs{
			CapacityBlockOfferingId: pulumi.String(test.CapacityBlockOfferingId),
			InstancePlatform:        pulumi.String("Linux/UNIX"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

data "aws_ec2_getcapacityblockoffering" "test" {
  capacity_duration_hours = 24
  end_date_range          = "2024-05-30T15:04:05Z"
  instance_count          = 1
  instance_type           = "p5.4xlarge"
  start_date_range        = "2024-04-28T15:04:05Z"
}

resource "aws_ec2_capacityblockreservation" "example" {
  capacity_block_offering_id = data.aws_ec2_getcapacityblockoffering.test.capacity_block_offering_id
  instance_platform          = "Linux/UNIX"
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetCapacityBlockOfferingArgs;
import com.pulumi.aws.ec2.CapacityBlockReservation;
import com.pulumi.aws.ec2.CapacityBlockReservationArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        final var test = Ec2Functions.getCapacityBlockOffering(GetCapacityBlockOfferingArgs.builder()
            .capacityDurationHours(24)
            .endDateRange("2024-05-30T15:04:05Z")
            .instanceCount(1)
            .instanceType("p5.4xlarge")
            .startDateRange("2024-04-28T15:04:05Z")
            .build());

        var example = new CapacityBlockReservation("example", CapacityBlockReservationArgs.builder()
            .capacityBlockOfferingId(test.capacityBlockOfferingId())
            .instancePlatform("Linux/UNIX")
            .build());

    }
}

resources:
  example:
    type: aws:ec2:CapacityBlockReservation
    properties:
      capacityBlockOfferingId: ${test.capacityBlockOfferingId}
      instancePlatform: Linux/UNIX
variables:
  test:
    fn::invoke:
      function: aws:ec2:getCapacityBlockOffering
      arguments:
        capacityDurationHours: 24
        endDateRange: 2024-05-30T15:04:05Z
        instanceCount: 1
        instanceType: p5.4xlarge
        startDateRange: 2024-04-28T15:04:05Z