alicloud_vpc_ipv4_gateway

Provides a Vpc Ipv4 Gateway resource.

For information about VPC Ipv4 Gateway and how to use it, see What is Ipv4 Gateway.

-> NOTE: Available since v1.181.0.

Example Usage

Basic Usage

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

resource "alicloud_resource_manager_resource_group" "default" {
  display_name        = var.name
  resource_group_name = var.name
}

resource "alicloud_vpc" "default" {
  vpc_name   = "${var.name}2"
  cidr_block = "10.0.0.0/8"
}


resource "alicloud_vpc_ipv4_gateway" "default" {
  ipv4_gateway_name        = var.name
  ipv4_gateway_description = var.name
  resource_group_id        = alicloud_resource_manager_resource_group.default.id
  vpc_id                   = alicloud_vpc.default.id
}

Argument Reference

The following arguments are supported:

• dry_run - (Optional) Whether to PreCheck only this request. Value:-true: The check request is sent without creating an IPv4 Gateway. Check items include whether required parameters, request format, and business restrictions are filled in. If the check does not pass, the corresponding error is returned. If the check passes, the error code 'DryRunOperation' is returned '.-false (default): Sends a normal request, returns an HTTP 2xx status code and directly creates an IPv4 Gateway.
• enabled - (Optional, Computed, Available since v1.193.1) Whether the IPv4 gateway is active or not. Valid values are true and false.
• internet_mode - (Optional, Available since v1.249.0) The public network traffic mode of the VPC after the IPv4 Gateway is deleted:
  • public: Public network direct access
  • private: IPv4 Gateway centralized control
• ipv4_gateway_description - (Optional) The description of the IPv4 gateway. The description must be 2 to 256 characters in length. It must start with a letter but cannot start with http:// or https://.
• ipv4_gateway_name - (Optional) The name of the IPv4 gateway. The name must be 2 to 128 characters in length, and can contain letters, digits, periods (.), underscores (_), and hyphens (-). It must start with a letter.
• resource_group_id - (Optional, Computed) The ID of the resource group to which the instance belongs.
• tags - (Optional, Map) The tags of the current resource.
• vpc_id - (Required, ForceNew) The ID of the virtual private cloud (VPC) where you want to create the IPv4 gateway. You can create only one IPv4 gateway in a VPC.

Attributes Reference

The following attributes are exported:

• id - The ID of the resource supplied above.
• create_time - The creation time of the resource
• ipv4_gateway_id - Resource primary key field.
• ipv4_gateway_route_table_id - ID of the route table associated with IPv4 Gateway
• status - The status of the resource

Timeouts

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

• create - (Defaults to 5 mins) Used when create the Ipv4 Gateway.
• delete - (Defaults to 5 mins) Used when delete the Ipv4 Gateway.
• update - (Defaults to 5 mins) Used when update the Ipv4 Gateway.

Import

VPC Ipv4 Gateway can be imported using the id, e.g.

$ terraform import alicloud_vpc_ipv4_gateway.example <id>