文档

alicloud_vswitches

更新时间:
一键部署

This data source provides a list of VSwitches owned by an Alibaba Cloud account.

Example Usage

variable "name" {
  default = "vswitchDatasourceName"
}
data "alicloud_zones" "default" {}

resource "alicloud_vpc" "vpc" {
  cidr_block = "172.16.0.0/16"
  vpc_name   = "${var.name}"
}

resource "alicloud_vswitch" "vswitch" {
  vswitch_name      = "${var.name}"
  cidr_block        = "172.16.0.0/24"
  vpc_id            = "${alicloud_vpc.vpc.id}"
  availability_zone = "${data.alicloud_zones.default.zones.0.id}"
}

data "alicloud_vswitches" "default" {
  name_regex = "${alicloud_vswitch.vswitch.vswitch_name}"
}

Argument Reference

The following arguments are supported:

  • cidr_block - (Optional) Filter results by a specific CIDR block. For example: "172.16.0.0/12".
  • zone_id - (Optional) The availability zone of the VSwitch.
  • name_regex - (Optional) A regex string to filter results by name.
  • is_default - (Optional, type: bool) Indicate whether the VSwitch is created by the system.
  • vpc_id - (Optional) ID of the VPC that owns the VSwitch.
  • tags - (Optional, Available in v1.55.3+) A mapping of tags to assign to the resource.
  • output_file - (Optional) File name where to save data source results (after running terraform plan).
  • ids - (Optional, Available in 1.52.0+) A list of VSwitch IDs.
  • resource_group_id - (Optional, ForceNew, Available in 1.60.0+) The Id of resource group which VSWitch belongs.
  • dry_run - (Optional, ForceNew, Available in 1.119.0+) Specifies whether to precheck this request only. Valid values: true and false.
  • route_table_id - (Optional, ForceNew, Available in 1.119.0+) The route table ID of the VSwitch.
  • status - (Optional, ForceNew, Available in 1.119.0+) The status of the VSwitch. Valid values: Available and Pending.
  • vswitch_name - (Optional, ForceNew, Available in 1.119.0+) The name of the VSwitch.
  • vswitch_owner_id - (Optional, ForceNew, Available in 1.119.0+) The VSwitch owner id.

Attributes Reference

The following attributes are exported in addition to the arguments listed above:

  • ids - A list of VSwitch IDs.
  • names - A list of VSwitch names.
  • vswitches - A list of VSwitches. Each element contains the following attributes:
    • id - ID of the VSwitch.
    • zone_id - ID of the availability zone where the VSwitch is located.
    • vpc_id - ID of the VPC that owns the VSwitch.
    • name - Name of the VSwitch.
    • cidr_block - CIDR block of the VSwitch.
    • instance_ids - (Deprecated in v1.119.0+) List of ECS instance IDs in the specified VSwitch.
    • description - Description of the VSwitch.
    • is_default - Whether the VSwitch is the default one in the region.
    • creation_time - Time of creation.
    • available_ip_address_count - The available ip address count of the VSwitch.
    • resource_group_id - The resource group ID of the VSwitch.
    • route_table_id - The route table ID of the VSwitch.
    • status - The status of the VSwitch.
    • tags - The Tags of the VSwitch.
    • vswitch_id - ID of the VSwitch.
    • vswitch_name - Name of the VSwitch.
    • ipv6_cidr_block - The IPv6 CIDR block of the switch.