alicloud_common_bandwidth_package

Provides a CBWP Common Bandwidth Package resource. -> NOTE: Terraform will auto build common bandwidth package instance while it uses alicloud_common_bandwidth_package to build a common bandwidth package resource.

For information about common bandwidth package billing methods, see Common Bandwidth Package Billing Methods.

For information about CBWP Common Bandwidth Package and how to use it, see What is Common Bandwidth Package.

-> NOTE: Available since v1.23.0.

Example Usage

Basic Usage

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

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

resource "alicloud_common_bandwidth_package" "default" {
  bandwidth_package_name    = var.name
  description               = var.name
  isp                       = "BGP"
  bandwidth                 = "1000"
  ratio                     = 100
  internet_charge_type      = "PayByBandwidth"
  resource_group_id         = data.alicloud_resource_manager_resource_groups.default.ids.0
  security_protection_types = ["AntiDDoS_Enhanced"]
}

Deleting alicloud_common_bandwidth_package or removing it from your configuration

The alicloud_common_bandwidth_package resource allows you to manage internet_charge_type = "PayBy95" instance, but Terraform cannot destroy it. Deleting the subscription resource or removing it from your configuration will remove it from your state file and management, but will not destroy the Instance. You can resume managing the subscription instance via the AlibabaCloud Console.

Argument Reference

The following arguments are supported:

• bandwidth - (Required) The maximum bandwidth of the Internet Shared Bandwidth instance. Unit: Mbit/s. Valid values: 1 to 1000. Default value: 1.

• bandwidth_package_name - (Optional, Available since v1.120.0) The description of the EIP bandwidth plan. The description must be 2 to 256 characters in length. It must start with a letter but cannot start with http:// or https://.

• deletion_protection - (Optional, Available since v1.124.4) Specifies whether to enable deletion protection. Valid values:

  • true: yes
  • false: no

• description - (Optional) The description of the Internet Shared Bandwidth instance. The description must be 0 to 256 characters in length and cannot start with http:// or https://.

• force - (Optional) Specifies whether to forcefully delete the Internet Shared Bandwidth instance. Valid values:

  • false (default): deletes the Internet Shared Bandwidth instance only when no EIPs are associated with the Internet Shared Bandwidth instance.
  • true: disassociates all EIPs from the Internet Shared Bandwidth instance and deletes the Internet Shared Bandwidth instance.

• internet_charge_type - (Optional, ForceNew, Computed) Billing method of Internet Shared Bandwidth. Valid values: PayByTraffic: billed by primary traffic.

  • PayByBandwidth (default): Billing by bandwidth.
  • PayBy95: Billed as Enhanced 95.
  • PayByDominantTraffic: billed by primary traffic.

• isp - (Optional, ForceNew, Computed, Available since v1.90.1) The line type. Valid values:

  • BGP (default) All regions support BGP (Multi-ISP).
  • BGP_PRO BGP (Multi-ISP) Pro lines are available in the China (Hong Kong), Singapore, Japan (Tokyo), Philippines (Manila), Malaysia (Kuala Lumpur), Indonesia (Jakarta), and Thailand (Bangkok) regions.

If you are allowed to use single-ISP bandwidth, you can also use one of the following values:

• ChinaTelecom
• ChinaUnicom
• ChinaMobile
• ChinaTelecom_L2
• ChinaUnicom_L2
• ChinaMobile_L2

If your services are deployed in China East 1 Finance, this parameter is required and you must set the value to BGP_FinanceCloud.

• ratio - (Optional, ForceNew, Computed, Int, Available since v1.55.3) The percentage of the minimum bandwidth commitment. Set the parameter to 20.

-> NOTE: This parameter is available only on the Alibaba Cloud China site.

• resource_group_id - (Optional, Computed, Available since v1.115.0) The ID of the resource group to which you want to move the resource.

-> NOTE: You can use resource groups to facilitate resource grouping and permission management for an Alibaba Cloud. For more information, see What is resource management?

• security_protection_types - (Optional, ForceNew, List, Available since v1.184.0) The edition of Anti-DDoS. If you do not set this parameter, Anti-DDoS Origin Basic is used. If you set the value to AntiDDoS_Enhanced, Anti-DDoS Pro(Premium) is used. It is valid when internet_charge_type is PayBy95.
• tags - (Optional, Map) The tag of the resource
• zone - (Optional, Available since v1.120.0) The zone of the Internet Shared Bandwidth instance. This parameter is required if you create an Internet Shared Bandwidth instance for a cloud box.

The following arguments will be discarded. Please use new fields as soon as possible:

• name - (Deprecated since v1.120.0). Field 'name' has been deprecated from provider version 1.120.0. New field 'bandwidth_package_name' instead.

Attributes Reference

The following attributes are exported:

• id - The ID of the resource supplied above.
• payment_type - The billing type of the Internet Shared Bandwidth instance. Valid values: PayAsYouGo, Subscription.
• create_time - The creation time.
• status - The status of the Internet Shared Bandwidth instance. Default value: Available.

Timeouts

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

• create - (Defaults to 5 mins) Used when create the Common Bandwidth Package.
• delete - (Defaults to 5 mins) Used when delete the Common Bandwidth Package.
• update - (Defaults to 5 mins) Used when update the Common Bandwidth Package.

Import

EIP Bandwidth Plan (CBWP) Common Bandwidth Package can be imported using the id, e.g.

$ terraform import alicloud_common_bandwidth_package.example <id>