Skip to content

Commit

Permalink
Add networking_port data source docs
Browse files Browse the repository at this point in the history
  • Loading branch information
niuzhenguo committed Jun 19, 2019
1 parent 572d817 commit cfb1917
Show file tree
Hide file tree
Showing 2 changed files with 78 additions and 0 deletions.
75 changes: 75 additions & 0 deletions website/docs/d/networking_port_v2.html.markdown
Original file line number Diff line number Diff line change
@@ -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.
3 changes: 3 additions & 0 deletions website/huaweicloud.erb
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,9 @@
<li<%= sidebar_current("docs-huaweicloud-datasource-networking-subnet-v2") %>>
<a href="/docs/providers/huaweicloud/d/networking_subnet_v2.html">huaweicloud_networking_subnet_v2</a>
</li>
<li<%= sidebar_current("docs-huaweicloud-datasource-networking-port-v2") %>>
<a href="/docs/providers/huaweicloud/d/networking_port_v2.html">huaweicloud_networking_port_v2</a>
</li>
<li<%= sidebar_current("docs-huaweicloud-datasource-kms-key-v1") %>>
<a href="/docs/providers/huaweicloud/d/kms_key_v1.html">huaweicloud_kms_key_v1</a>
</li>
Expand Down

0 comments on commit cfb1917

Please sign in to comment.