alicloud_ecs_elasticity_assurance

Provides a ECS Elasticity Assurance resource.

For information about ECS Elasticity Assurance and how to use it, see What is Elasticity Assurance.

-> NOTE: Available since v1.196.0.

Example Usage

Basic Usage

variable "name" {
  default = "terraform-example"
}

provider "alicloud" {
  region = "cn-hangzhou"
}

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

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

resource "alicloud_ecs_elasticity_assurance" "default" {
  instance_amount                     = 1
  description                         = "before"
  zone_ids                            = [data.alicloud_instance_types.default.instance_types.0.availability_zones.0]
  private_pool_options_name           = var.name
  period                              = 1
  private_pool_options_match_criteria = "Open"
  instance_type                       = [data.alicloud_instance_types.default.instance_types.0.id]
  period_unit                         = "Month"
  assurance_times                     = "Unlimited"
  resource_group_id                   = data.alicloud_resource_manager_resource_groups.default.ids.0
}

Argument Reference

The following arguments are supported:

• assurance_times - (Optional, ForceNew) The total number of times that the elasticity assurance can be applied. Set the value to Unlimited. This value indicates that the elasticity assurance can be applied an unlimited number of times within its effective duration. Default value: Unlimited.
• auto_renew - (Optional, Bool, Available since v1.261.0) Specifies whether to enable auto-renewal for the elasticity assurance. Valid values:
  • true
  • false

Default value: false.

• auto_renew_period - (Optional, Int, Available since v1.261.0) The auto-renewal period. Unit: month. Valid values: 1, 2, 3, 6, 12, 24, and 36.
  • Default value when PeriodUnit is set to Month: 1.
  • Default value when PeriodUnit is set to Year: 12.

-> NOTE: If you set AutoRenew to true, you must specify this parameter.

• auto_renew_period_unit - (Optional, Available since v1.261.0) Unit of duration. Value range:
  • Month: Month
  • Year: Year

Default value: Year

• description - (Optional) Description of flexible guarantee service.
• instance_amount - (Required, Int) The total number of instances for which to reserve the capacity of an instance type. Valid values: 1 to 1000. NOTE: From version 1.261.0, instance_amount can be modified.
• instance_type - (Required, ForceNew) Instance type. Currently, only one instance type is supported.
• period - (Optional) Length of purchase. The unit of duration is determined by the 'period_unit' parameter. Default value: 1.
  • When the period_unit parameter is set to Month, the valid values are 1, 2, 3, 4, 5, 6, 7, 8, and 9.
  • When the period_unit parameter is set to Year, the valid values are 1, 2, 3, 4, and 5.
• period_unit - (Optional) Duration unit. Value range:-Month: Month-Year: YearDefault value: Year
• private_pool_options_match_criteria - (Optional, ForceNew) The matching mode of flexible guarantee service. Possible values:-Open: flexible guarantee service for Open mode.-Target: specifies the flexible guarantee service of the mode.
• private_pool_options_name - (Optional) The name of the flexible protection service.
• resource_group_id - (Optional, ForceNew) The ID of the resource group.
• start_time - (Optional, ForceNew) Flexible guarantee service effective time.
• tags - (Optional) The tag key-value pair information bound by the elastic guarantee service.
• zone_ids - (Required, ForceNew, List) The zone ID of the region to which the elastic Protection Service belongs. Currently, only the creation of flexible protection services in one available area is supported.

Attributes Reference

The following attributes are exported:

• id - The key of the resource supplied above.
• elasticity_assurance_id - The first ID of the resource
• end_time - Flexible guarantee service failure time.
• instance_charge_type - The billing method of the instance. Possible value: PostPaid. Currently, only pay-as-you-go is supported.
• region_id - (Available since v1.261.0) The region ID of the elasticity assurance.
• start_time_type - Flexible guarantee effective way. Possible values:-Now: Effective immediately.-Later: the specified time takes effect.
• status - The status of flexible guarantee services. Possible values:-Preparing: in preparation.-Prepared: to take effect.-Active: in effect.-Released: Released.
• used_assurance_times - This parameter is not yet available.

Timeouts

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

• create - (Defaults to 5 mins) Used when create the Elasticity Assurance.
• delete - (Defaults to 5 mins) Used when delete the Elasticity Assurance.
• update - (Defaults to 5 mins) Used when update the Elasticity Assurance.

Import

ECS Elasticity Assurance can be imported using the id, e.g.

$ terraform import alicloud_ecs_elasticity_assurance.example <id>