# equinix\_fabric\_port(资源)
Fabric V4 API 兼容资源允许创建和管理 Equinix Fabric 端口
补充文件:
* 入门指南:
* API:
**注意:**\~该资源为Beta版,可能会有更改。谨慎使用。实验资源可能包含错误,不建议将其用于生产。
* 通过 Terraform 创建端口指令后,并不能保证一定会发生端口预留。
* 如果未进行端口预留,则端口订单不完整,Terraform 资源将无法用作依赖项。
* 端口删除并非短期流程,通常需要 2-5 个工作日才能完成。
* 使用相同设置重新运行Terraform资源可能无法获得可供预留的端口,即使上一端口已完成
## 用法示例[](#用法示例 "直接链接至用法示例")
```
resource "equinix_fabric_port" "order" {
type = "XF_PORT"
connectivity_source_type = "COLO"
location = {
metro_code = "TR"
}
settings = {
package_type = "STANDARD"
shared_port_type = false
}
encapsulation = {
type = "DOT1Q"
tag_protocol_id = "0x8100"
}
account = {
account_number = ""
}
project = {
project_id = ""
}
redundancy = {
priority = "PRIMARY"
}
lag_enabled = true
physical_ports = [
{
type = "XF_PHYSICAL_PORT"
demarcation_point = {
ibx = "TR2"
cage_unique_space_id = "TR2:01:002087"
cabinet_unique_space_id = "Demarc"
patch_panel = "PP:Demarc:00002087"
connector_type = "SC"
}
}
]
physical_ports_speed = 1000
physical_ports_type = "1000BASE_LX"
physical_ports_count = 1
demarcation_point_ibx = "TR2"
notifications = [
{
type = "TECHNICAL"
registered_users = [
""
]
},
{
type = "NOTIFICATION"
registered_users = [
""
]
}
]
additional_info = [
{
key = "lagType"
value = "New"
}
]
}
```
## 模式[](#模式 "直接链接至模式")
### 必填[](#必填 "直接链接至必填")
* `account`(属性)端口订单账户详情([有关嵌套架构](#nestedatt--account),请参阅[下文](#nestedatt--account))
* `connectivity_source_type`(字符串)创建后从端口使用的连接类型
* `demarcation_point_ibx`(字符串)端口所在的IBX代码
* `encapsulation`(属性)端口封装设置([有关嵌套架构](#nestedatt--encapsulation),请参阅[下文](#nestedatt--encapsulation))
* `lag_enabled`(布尔值)布尔值,用于启用已创建端口的链路聚合组
* `location`(属性)端口订单的位置详细信息([有关嵌套架构](#nestedatt--location),请参阅[下文](#nestedatt--location))
* `notifications`(属性列表)通知类型和接收这些通知类型的注册用户列表([有关嵌套架构](#nestedatt--notifications),请参阅[下文](#nestedatt--notifications))
* `physical_ports`(属性列表)将实现此端口订单的物理端口([有关嵌套架构](#nestedatt--physical_ports),请参阅[下文](#nestedatt--physical_ports))
* `physical_ports_count`端口订单中的物理端口数量
* `physical_ports_speed`(数量)物理端口速度,以Mbps为单位
* `physical_ports_type`(字符串)物理端口类型
* `project`(属性)端口订单项目详情([有关嵌套架构](#nestedatt--project),请参阅[下文](#nestedatt--project))
* `redundancy`(属性)端口冗余设置([有关嵌套架构](#nestedatt--redundancy),请参阅[下文](#nestedatt--redundancy))
* `type`端口订单请求的类型
### 可选[](#可选 "直接链接至可选")
* `order`(属性)端口订单的详细信息,如购买订单详细信息和签名([嵌套架构](#nestedatt--order)参见[下文](#nestedatt--order))
* `timeouts`(属性)([有关嵌套架构](#nestedatt--timeouts),请参阅[下文](#nestedatt--timeouts))
### 只读[](#只读 "直接链接至只读")
* `additional_info`(属性列表)键/值对象列表,用于为端口订单提供附加上下文([嵌套架构](#nestedatt--additional_info)请参阅[下文](#nestedatt--additional_info))
* `change_log`(属性)端口资源上次更改的详细信息([有关嵌套架构](#nestedatt--change_log),请参阅[下文](#nestedatt--change_log))
* `device`(属性)端口设备配置([有关嵌套架构](#nestedatt--device),请参阅[下文](#nestedatt--device))
* `href`(字符串) Equinix分配的端口资源URI
* `id`(字符串)资源的唯一标识符
* `name`端口的指定名称
* `state`(字符串)值,表示端口资源的配置状态
* `uuid`(字符串) Equinix分配了端口资源的唯一标识符
[]()
### 的嵌套架构`account`[](#的嵌套架构account "直接链接至的嵌套架构account")
必需的:
* `account_number` 创建端口的账号
只读:
* `account_name`(字符串)账户持有人的法定名称。
* `ucm_id`(字符串)企业数据存储ID
[]()
### 的嵌套架构`encapsulation`[](#的嵌套架构encapsulation "直接链接至的嵌套架构encapsulation")
必需的:
* `tag_protocol_id` (字符串)端口封装标记协议标识符
* `type`(字符串)端口封装协议类型
[]()
### 的嵌套架构`location`[](#的嵌套架构location "直接链接至的嵌套架构location")
必需的:
* `metro_code` (字符串)创建端口的都会区代码
[]()
### 的嵌套架构`notifications`[](#的嵌套架构notifications "直接链接至的嵌套架构notifications")
必需的:
* `registered_users` (字符串列表)将在端口上接收此类通知的注册用户数组
* `type`(字符串)通知类型
[]()
### 的嵌套架构`physical_ports`[](#的嵌套架构physical_ports "直接链接至的嵌套架构physical_ports")
必需的:
* `demarcation_point` (属性)客户物理端口([有关嵌套架构](#nestedatt--physical_ports--demarcation_point),请参阅[下文](#nestedatt--physical_ports--demarcation_point))
* `type`(字符串)物理端口类型
可选:
* `interface`(属性)物理端口接口([有关嵌套架构](#nestedatt--physical_ports--interface),请参阅[下文](#nestedatt--physical_ports--interface))
[]()
### 的嵌套架构`physical_ports.demarcation_point`[](#的嵌套架构physical_portsdemarcation_point "直接链接至的嵌套架构physical_portsdemarcation_point")
必需的:
* `cabinet_unique_space_id` (字符串)端口机柜唯一空间ID
* `cage_unique_space_id`(字符串)端口机笼唯一空间ID
* `connector_type`(字符串)端口连接器类型
* `ibx`(字符串)物理端口的IBX都会区代码
* `patch_panel`端口配线架
[]()
### 的嵌套架构`physical_ports.interface`[](#的嵌套架构physical_portsinterface "直接链接至的嵌套架构physical_portsinterface")
可选:
* `type` (字符串)物理端口的接口类型
[]()
### 的嵌套架构`project`[](#的嵌套架构project "直接链接至的嵌套架构project")
必需的:
* `project_id` (字符串)将在其中创建端口的项目ID
[]()
### 的嵌套架构`redundancy`[](#的嵌套架构redundancy "直接链接至的嵌套架构redundancy")
必需的:
* `priority` 端口冗余优先级值
[]()
### 的嵌套架构`order`[](#的嵌套架构order "直接链接至的嵌套架构order")
可选:
* `customer_reference_id` (字符串)客户订单参考ID
* `purchase_order`(属性)购买订单详情([有关嵌套架构](#nestedatt--order--purchase_order),请参阅[下文](#nestedatt--order--purchase_order))
* `signature`(属性)端口订单确认签名详情([有关嵌套架构](#nestedatt--order--signature),请参阅[下文](#nestedatt--order--signature))
[]()
### 的嵌套架构`order.purchase_order`[](#的嵌套架构orderpurchase_order "直接链接至的嵌套架构orderpurchase_order")
只读:
* `amount` (字符串)购买订单金额
* `attachment_id`(字符串)购买订单附件ID
* `end_date`(字符串)购买订单结束日期
* `number`(字符串)购买订单编号
* `start_date`(字符串)购买订单开始日期
* `type`(字符串)购买订单类型
[]()
### 的嵌套架构`order.signature`[](#的嵌套架构ordersignature "直接链接至的嵌套架构ordersignature")
必需的:
* `delegate` (属性)委托订单详情([有关嵌套架构](#nestedatt--order--signature--delegate),请参阅[下文](#nestedatt--order--signature--delegate))
* `signatory`(字符串)端口签名类型
[]()
### 的嵌套架构`order.signature.delegate`[](#的嵌套架构ordersignaturedelegate "直接链接至的嵌套架构ordersignaturedelegate")
必需的:
* `email` (字符串)签字人的电子邮件
可选:
* `first_name`(字符串)签字人的名字
* `last_name`(字符串)签字人的姓氏
[]()
### 的嵌套架构`timeouts`[](#的嵌套架构timeouts "直接链接至的嵌套架构timeouts")
可选:
* `create` (string)可[解析为持续时间的](https://pkg.go.dev/time#ParseDuration)字符串,由数字和单位后缀组成,例如“30s”或“2h45m”。有效时间单位为“s”(秒),“m”(分钟),“h”(小时)。
* `delete`(string)可[解析为持续时间的](https://pkg.go.dev/time#ParseDuration)字符串,由数字和单位后缀组成,例如“30s”或“2h45m”。有效时间单位为“s”(秒),“m”(分钟),“h”(小时)。仅当更改保存到销毁操作发生之前的状态时,删除操作的超时才适用。
* `read`(string)可[解析为持续时间的](https://pkg.go.dev/time#ParseDuration)字符串,由数字和单位后缀组成,例如“30s”或“2h45m”。有效时间单位为“s”(秒),“m”(分钟),“h”(小时)。启用刷新后,读取操作将在任何刷新或计划操作期间进行。
* `update`(string)可[解析为持续时间的](https://pkg.go.dev/time#ParseDuration)字符串,由数字和单位后缀组成,例如“30s”或“2h45m”。有效时间单位为“s”(秒),“m”(分钟),“h”(小时)。
[]()
### 的嵌套架构`additional_info`[](#的嵌套架构additional_info "直接链接至的嵌套架构additional_info")
只读:
* `key` (string)密钥/值对的密钥名称
* `value`(字符串)密钥/值对的值
[]()
### 的嵌套架构`change_log`[](#的嵌套架构change_log "直接链接至的嵌套架构change_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`(字符串)端口资源的上次更新时间
[]()
### 的嵌套架构`device`[](#的嵌套架构device "直接链接至的嵌套架构device")
只读:
* `name` (字符串)端口的设备名称
* `redundancy`(属性)设备冗余配置([有关嵌套架构](#nestedatt--device--redundancy),请参阅[下文](#nestedatt--device--redundancy))
[]()
### 的嵌套架构`device.redundancy`[](#的嵌套架构deviceredundancy "直接链接至的嵌套架构deviceredundancy")
可选:
* `group` (字符串)冗余组标识符
* `priority`(字符串)冗余优先级(主要或次要)