# 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`(字符串)冗余优先级(主要或次要)