# equinix\_fabric\_ports（数据源）

兼容 Fabric V4 API 的数据资源，允许用户按名称或 UUID 获取端口。

补充文件：

* 入门指南：<https://docs.equinix.com/fabric/ports/managing-fabric-ports/>
* API：<https://docs.equinix.com/api-catalog/fabricv4/#tag/Ports>

## 用法示例[​](#用法示例 "Direct link to 用法示例")

```
data "equinix_fabric_ports" "ports_data_name" {

  filters {

    name = "<name_of_port||port_prefix>"

  }

}





output "id" {

  value = data.equinix_fabric_port.ports_data_name.data.0.id

}



output "name" {

  value = data.equinix_fabric_port.ports_data_name.data.0.name

}



output "state" {

  value = data.equinix_fabric_port.ports_data_name.data.0.state

}



output "account_name" {

  value = data.equinix_fabric_port.ports_data_name.data.0.account.0.account_name

}



output "type" {

  value = data.equinix_fabric_port.ports_data_name.data.0.type

}



output "bandwidth" {

  value = data.equinix_fabric_port.ports_data_name.data.0.bandwidth

}



output "used_bandwidth" {

  value = data.equinix_fabric_port.ports_data_name.data.0.used_bandwidth

}



output "encapsulation_type" {

  value = data.equinix_fabric_port.ports_data_name.data.0.encapsulation.0.type

}



output "ibx" {

  value = data.equinix_fabric_port.ports_data_name.data.0.location.0.ibx

}



output "metro_code" {

  value = data.equinix_fabric_port.ports_data_name.data.0.location.0.metro_code

}



output "metro_name" {

  value = data.equinix_fabric_port.ports_data_name.data.0.location.0.metro_name

}



output "region" {

  value = data.equinix_fabric_port.ports_data_name.data.0.location.0.region

}



output "device_redundancy_enabled" {

  value = data.equinix_fabric_port.ports_data_name.data.0.device.0.redundancy.0.enabled

}



output "device_redundancy_priority" {

  value = data.equinix_fabric_port.ports_data_name.data.0.device.0.redundancy.0.priority

}
```

<!-- -->

## 模式[​](#模式 "Direct link to 模式")

### 可选[​](#可选 "Direct link to 可选")

* `filter`（块列表）SearchPorts API 的过滤器对象列表。每个过滤器必须包含属性、运算符和值。（嵌套架构请参见[下方](#nestedblock--filter)）
* `filters`（块集，最大值：1，已弃用）（已弃用）请改用“filter”。（有关嵌套模式，请参见[下方](#nestedblock--filters)）

### 只读[​](#只读 "Direct link to 只读")

* `data`（对象列表）端口列表（嵌套模式见下文）
* `id`（字符串）此资源的 ID。

[]()

### `filter` 的嵌套模式[​](#filter-的嵌套模式 "Direct link to filter-的嵌套模式")

必需的：

* `operator`（字符串）运算符（例如 =、!=、in 等）
* `property`（字符串）属性路径（例如 /name、/uuid、/metroCode 等）
* `value`（字符串）用于筛选的值。

[]()

### `filters` 的嵌套模式[​](#filters-的嵌套模式 "Direct link to filters-的嵌套模式")

必需的：

* `name`（字符串）按名称获取端口的查询参数

[]()

### `data` 的嵌套模式[​](#data-的嵌套模式 "Direct link to data-的嵌套模式")

只读：

* `account`（对象集合）（有关嵌套模式，请参见[下文](#nestedobjatt--data--account)）
* `available_bandwidth`（数字）
* `bandwidth`（数字）
* `change_log`（对象集合）（有关嵌套模式，请参见[下文](#nestedobjatt--data--change_log)）
* `description`（字符串）
* `device`（对象集合）（有关嵌套模式，请参见[下文](#nestedobjatt--data--device)）
* `encapsulation`（对象集合）（有关嵌套模式，请参见[下文](#nestedobjatt--data--encapsulation)）
* `href`（字符串）
* `lag_enabled`（布尔值）
* `location`（对象集合）（有关嵌套模式，请参见[下文](#nestedobjatt--data--location)）
* `name`（字符串）
* `operation`（对象集合）（有关嵌套模式，请参见[下文](#nestedobjatt--data--operation)）
* `redundancy`（对象集合）（有关嵌套模式，请参见[下文](#nestedobjatt--data--redundancy)）
* `service_type`（字符串）
* `state`（字符串）
* `type`（字符串）
* `used_bandwidth`（数字）
* `uuid`（字符串）

[]()

### `data.account` 的嵌套模式[​](#dataaccount-的嵌套模式 "Direct link to dataaccount-的嵌套模式")

只读：

* `account_name`（字符串）
* `account_number`（数字）
* `global_cust_id`（字符串）
* `global_org_id`（字符串）
* `global_organization_name`（字符串）
* `org_id`（数字）
* `organization_name`（字符串）
* `ucm_id`（字符串）

[]()

### `data.change_log` 的嵌套模式[​](#datachange_log-的嵌套模式 "Direct link to datachange_log-的嵌套模式")

只读：

* `created_by`（字符串）
* `created_by_email`（字符串）
* `created_by_full_name`（字符串）
* `created_date_time`（字符串）
* `deleted_by`（字符串）
* `deleted_by_email`（字符串）
* `deleted_by_full_name`（字符串）
* `deleted_date_time`（字符串）
* `updated_by`（字符串）
* `updated_by_email`（字符串）
* `updated_by_full_name`（字符串）
* `updated_date_time`（字符串）

[]()

### `data.device` 的嵌套模式[​](#datadevice-的嵌套模式 "Direct link to datadevice-的嵌套模式")

只读：

* `name`（字符串）
* `redundancy`（对象集合）（有关嵌套模式，请参见[下文](#nestedobjatt--data--device--redundancy)）

[]()

### `data.device.redundancy` 的嵌套模式[​](#datadeviceredundancy-的嵌套模式 "Direct link to datadeviceredundancy-的嵌套模式")

只读：

* `enabled`（布尔值）
* `group`（字符串）
* `priority`（字符串）

[]()

### `data.encapsulation` 的嵌套模式[​](#dataencapsulation-的嵌套模式 "Direct link to dataencapsulation-的嵌套模式")

只读：

* `tag_protocol_id`（字符串）
* `type`（字符串）

[]()

### `data.location` 的嵌套模式[​](#datalocation-的嵌套模式 "Direct link to datalocation-的嵌套模式")

只读：

* `ibx`（字符串）
* `metro_code`（字符串）
* `metro_name`（字符串）
* `region`（字符串）

[]()

### `data.operation` 的嵌套模式[​](#dataoperation-的嵌套模式 "Direct link to dataoperation-的嵌套模式")

只读：

* `connection_count`（数字）
* `op_status_changed_at`（字符串）
* `operational_status`（字符串）

[]()

### `data.redundancy` 的嵌套模式[​](#dataredundancy-的嵌套模式 "Direct link to dataredundancy-的嵌套模式")

只读：

* `enabled`（布尔值）
* `group`（字符串）
* `priority`（字符串）