alicloud_ecs_capacity_reservation

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

data "alicloud_instance_types" "default" {
  instance_type_family = "ecs.g5"
}

data "alicloud_zones" "default" {
  available_resource_creation = "Instance"
  available_instance_type     = data.alicloud_instance_types.default.ids.0
}

data "alicloud_resource_manager_resource_groups" "default" {
  status = "OK"
}

resource "alicloud_ecs_capacity_reservation" "default" {
  description               = "terraform-example"
  platform                  = "linux"
  capacity_reservation_name = "terraform-example"
  end_time_type             = "Unlimited"
  resource_group_id         = data.alicloud_resource_manager_resource_groups.default.ids.0
  instance_amount           = 1
  instance_type             = data.alicloud_instance_types.default.ids.0
  match_criteria            = "Open"
  tags = {
    Created = "terraform-example"
  }
  zone_ids = [data.alicloud_zones.default.zones[0].id]
}

Argument Reference

The following arguments are supported:

• capacity_reservation_name - (Optional) Capacity reservation service name.
• description - (Optional) description of the capacity reservation instance.
• end_time - (Optional) 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
• end_time_type - (Optional) 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.
• instance_amount - (Required) The total number of instances that need to be reserved within the capacity reservation.
• instance_type - (Required,ForceNew) Instance type. Currently, you can only set the capacity reservation service for one instance type.
• match_criteria - (ForceNew,Optional) 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
• platform - (Optional) platform of the capacity reservation, value range windows, linux.
• resource_group_id - (ForceNew,Optional) The resource group id.
• tags - (Optional) The tag of the resource.
• dry_run - (Optional) Specifies whether to pre-check the API request. Valid values: true and false.
• zone_ids - (ForceNew,Required) 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.

Attributes Reference

The following attributes are exported:

• id - The key of the resource supplied above.
• payment_type - The payment type of the resource
• start_time_type - The capacity is scheduled to take effect. Possible values:-Now: Effective immediately.-Later: the specified time takes effect.
• status - The status of the capacity reservation.
• time_slot - This parameter is under test and is not yet open for use.
• start_time - time of the capacity reservation which become active.

Timeouts

The timeouts block allows you to specify timeouts for certain actions:

• create - (Defaults to 5 mins) Used when create the Capacity Reservation.
• delete - (Defaults to 5 mins) Used when delete the Capacity Reservation.
• update - (Defaults to 5 mins) Used when update the Capacity Reservation.

Import

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

$terraform import alicloud_ecs_capacity_reservation.example <id>