diff --git a/website/docs/d/networking_port_v2.html.markdown b/website/docs/d/networking_port_v2.html.markdown new file mode 100644 index 0000000000..8969d1092b --- /dev/null +++ b/website/docs/d/networking_port_v2.html.markdown @@ -0,0 +1,75 @@ +--- +layout: "huaweicloud" +page_title: "HuaweiCloud: huaweicloud_networking_port_v2" +sidebar_current: "docs-huaweicloud-datasource-networking-port-v2" +description: |- + Get information of an HuaweiCloud Port. +--- + +# huaweicloud\_networking\_port\_v2 + +Use this data source to get the ID of an available HuaweiCloud port. + +## Example Usage + +```hcl +data "huaweicloud_networking_port_v2" "port_1" { + name = "port_1" +} +``` + +## Argument Reference + +* `region` - (Optional) The region in which to obtain the V2 Neutron client. + A Neutron client is needed to retrieve port ids. If omitted, the + `region` argument of the provider is used. + +* `project_id` - (Optional) The owner of the port. + +* `port_id` - (Optional) The ID of the port. + +* `name` - (Optional) The name of the port. + +* `admin_state_up` - (Optional) The administrative state of the port. + +* `network_id` - (Optional) The ID of the network the port belongs to. + +* `device_owner` - (Optional) The device owner of the port. + +* `mac_address` - (Optional) The MAC address of the port. + +* `device_id` - (Optional) The ID of the device the port belongs to. + +* `fixed_ip` - (Optional) The port IP address filter. + +* `status` - (Optional) The status of the port. + +* `security_group_ids` - (Optional) The list of port security group IDs to filter. + +## Attributes Reference + +`id` is set to the ID of the found port. In addition, the following attributes +are exported: + +* `region` - See Argument Reference above. + +* `project_id` - See Argument Reference above. + +* `port_id` - See Argument Reference above. + +* `name` - See Argument Reference above. + +* `admin_state_up` - See Argument Reference above. + +* `network_id` - See Argument Reference above. + +* `device_owner` - See Argument Reference above. + +* `mac_address` - See Argument Reference above. + +* `device_id` - See Argument Reference above. + +* `all_fixed_ips` - The collection of Fixed IP addresses on the port in the + order returned by the Network v2 API. + +* `all_security_group_ids` - The set of security group IDs applied on the port. diff --git a/website/huaweicloud.erb b/website/huaweicloud.erb index f3765bc97b..d1a4006e34 100644 --- a/website/huaweicloud.erb +++ b/website/huaweicloud.erb @@ -28,6 +28,9 @@