pulumi-alicloud-kotlin/com.pulumi.alicloud.ecs.kotlin/CapacityReservation

CapacityReservation

class CapacityReservation : KotlinCustomResource

Provides a Ecs Capacity Reservation resource. For information about Ecs Capacity Reservation and how to use it, see What is Capacity Reservation.

NOTE: Available in v1.195.0+.

Example Usage

Basic Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ecs.EcsFunctions;
import com.pulumi.alicloud.ecs.inputs.GetInstanceTypesArgs;
import com.pulumi.alicloud.AlicloudFunctions;
import com.pulumi.alicloud.inputs.GetZonesArgs;
import com.pulumi.alicloud.resourcemanager.ResourcemanagerFunctions;
import com.pulumi.alicloud.resourcemanager.inputs.GetResourceGroupsArgs;
import com.pulumi.alicloud.ecs.CapacityReservation;
import com.pulumi.alicloud.ecs.CapacityReservationArgs;
import java.util.List;
import java.util.ArrayList;
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 defaultInstanceTypes = EcsFunctions.getInstanceTypes(GetInstanceTypesArgs.builder()
            .instanceTypeFamily("ecs.g5")
            .build());
        final var defaultZones = AlicloudFunctions.getZones(GetZonesArgs.builder()
            .availableResourceCreation("Instance")
            .availableInstanceType(defaultInstanceTypes.applyValue(getInstanceTypesResult -> getInstanceTypesResult.ids()[0]))
            .build());
        final var defaultResourceGroups = ResourcemanagerFunctions.getResourceGroups(GetResourceGroupsArgs.builder()
            .status("OK")
            .build());
        var defaultCapacityReservation = new CapacityReservation("defaultCapacityReservation", CapacityReservationArgs.builder()
            .description("terraform-example")
            .platform("linux")
            .capacityReservationName("terraform-example")
            .endTimeType("Unlimited")
            .resourceGroupId(defaultResourceGroups.applyValue(getResourceGroupsResult -> getResourceGroupsResult.ids()[0]))
            .instanceAmount(1)
            .instanceType(defaultInstanceTypes.applyValue(getInstanceTypesResult -> getInstanceTypesResult.ids()[0]))
            .matchCriteria("Open")
            .tags(Map.of("Created", "terraform-example"))
            .zoneIds(defaultZones.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
            .build());
    }
}
Content copied to clipboard

Import

Ecs Capacity Reservation can be imported using the id, e.g.

$ pulumi import alicloud:ecs/capacityReservation:CapacityReservation example <id>
Content copied to clipboard

Properties

Link copied to clipboard
val capacityReservationName: Output<String>

Capacity reservation service name.

Link copied to clipboard
val description: Output<String>?

description of the capacity reservation instance.

Link copied to clipboard
val dryRun: Output<Boolean>?

Specifies whether to pre-check the API request. Valid values: true and false.

Link copied to clipboard
val endTime: Output<String>

end time of the capacity reservation. the capacity reservation will be released at the end time automatically if set. otherwise it will last until manually released

Link copied to clipboard
val endTimeType: Output<String>

Release mode of capacity reservation service. Value range:Limited: release at specified time. The EndTime parameter must be specified at the same time.Unlimited: manual release. No time limit.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val instanceAmount: Output<Int>

The total number of instances that need to be reserved within the capacity reservation.

Link copied to clipboard
val instanceType: Output<String>

Instance type. Currently, you can only set the capacity reservation service for one instance type.

Link copied to clipboard
val matchCriteria: Output<String>

The type of private resource pool generated after the capacity reservation service takes effect. Value range:Open: Open mode.Target: dedicated mode.Default value: Open

Link copied to clipboard
val paymentType: Output<String>

The payment type of the resource

Link copied to clipboard
val platform: Output<String>

platform of the capacity reservation, value range windows, linux.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val resourceGroupId: Output<String>?

The resource group id.

Link copied to clipboard
val startTime: Output<String>

time of the capacity reservation which become active.

Link copied to clipboard
val startTimeType: Output<String>

The capacity is scheduled to take effect. Possible values:-Now: Effective immediately.-Later: the specified time takes effect.

Link copied to clipboard
val status: Output<String>

The status of the capacity reservation.

Link copied to clipboard
val tags: Output<Map<String, Any>>?

The tag of the resource.

Link copied to clipboard
val timeSlot: Output<String>

This parameter is under test and is not yet open for use.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val zoneIds: Output<List<String>>

The ID of the zone in the region to which the capacity reservation service belongs. Currently, it is only supported to create a capacity reservation service in one zone.