equinix_fabric_port(资源)
Fabric V4 API 兼容资源允许创建和管理 Equinix Fabric 端口
补充文件:
- 入门指南:https://docs.equinix.com/fabric/ports/fabric-order-port/
- API:https://docs.equinix.com/api-catalog/fabricv4/#operation/createPort
~> **注意:**此资源目前处于测试阶段,可能会有所更改。请谨慎使用。实验性资源可能存在错误,不建议用于生产环境。
- 通过 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 = "<account_number>"
}
project = {
project_id = "<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 = [
"<username>"
]
},
{
type = "NOTIFICATION"
registered_users = [
"<username>"
]
}
]
additional_info = [
{
key = "lagType"
value = "New"
}
]
}
模式
需要
account(属性)端口订单帐户详细信息(有关嵌套架构,请参见下面的嵌套架构)connectivity_source_type(字符串)创建后从端口使用的连接类型demarcation_point_ibx(字符串)IBX 代码,端口所在位置encapsulation(属性)端口封装设置(有关嵌套架构,请参见下文)lag_enabled(布尔值)启用已创建端口的链路聚合组的布尔值location(属性)端口订单的位置详细信息(有关嵌套架构,请参见下面的嵌套架构)notifications(属性列表)通知类型列表以及接收这些通知类型的已注册用户(有关嵌套架构,请参见下文)physical_ports(属性列表)将实现此端口顺序的物理端口(有关嵌套模式,请参见下面的嵌套模式)physical_ports_count(数字)端口顺序中的物理端口数量physical_ports_speed(数字)物理端口速度(Mbps)physical_ports_type(字符串)物理端口类型project(属性)端口订单项目详情(有关嵌套架构,请参见下方)redundancy(属性)端口冗余设置(有关嵌套架构,请参见下文)settings(属性)端口顺序配置设置(有关嵌套架构,请参见下面的)type(字符串)端口订单请求的类型
可选
additional_info(属性列表)键/值对象列表,用于为端口顺序提供额外的上下文(有关嵌套模式,请参见下文)device(属性)端口设备配置(有关嵌套架构,请参见下文)name(字符串)端口的指定名称order(属性)港口订单的详细信息,例如采购订单详细信息和签名(有关嵌套架构,请参见下面的嵌套架构)timeouts(属性)(有关嵌套模式,请参见下文)
只读
change_log(属性)端口资源上次更改的详细信息(有关嵌套架构,请参见下面的)href(字符串)Equinix 分配的端口资源 URIid(字符串)资源的唯一标识符state(字符串)表示端口资源配置状态的值uuid(字符串)Equinix 为端口资源分配的唯一标识符
account 的嵌套模式
必需的:
account_number(数字)将为之创建端口的账号
只读:
account_name(字符串)账户持有人的法定姓名。ucm_id(字符串)企业数据存储 ID
encapsulation 的嵌套模式
必需的:
tag_protocol_id(字符串)端口封装标签协议标识符type(字符串)端口封装协议类型
location 的嵌套模式
必需的:
metro_code(字符串)将要创建的端口的 Metro 代码
notifications 的嵌套模式
必需的:
registered_users(字符串列表)已注册用户数组,这些用户将在端口上接收此类型的通知。type(字符串)通知类型
physical_ports 的嵌套模式
必需的:
demarcation_point(属性)客户物理端口(有关嵌套架构,请参见下文)type(字符串)物理端口类型
选修的:
interface(属性)物理端口接口(有关嵌套模式,请参见下面的嵌套模式)
physical_ports.demarcation_point 的嵌套模式
必需的:
cabinet_unique_space_id(字符串)端口柜唯一空间 IDcage_unique_space_id(字符串)端口笼唯一空间 IDconnector_type(字符串)端口连接器类型ibx(字符串)物理端口的 IBX Metro 代码patch_panel(字符串)端口配线架
physical_ports.interface 的嵌套模式
选修的:
type(字符串)物理端口的接口类型
project 的嵌套模式
必需的:
project_id(字符串)项目 ID,端口将在其中创建
redundancy 的嵌套模式
必需的:
priority(字符串)端口冗余优先级值
settings 的嵌套模式
必需的:
package_type(字符串)所订购端口的计费套餐shared_port_type(布尔值)指示这是专用客户笼还是共享的中立笼
additional_info 的嵌套模式
必需的:
key(字符串)键值对的键名。value(字符串)键值对的值
device 的嵌套模式
选修的:
name(字符串)端口的设备名称redundancy(属性)设备冗余配置(有关嵌套架构,请参见下文)
device.redundancy 的嵌套模式
选修的:
group(字符串)冗余组标识符priority(字符串)冗余优先级(主或辅助)
order 的嵌套模式
选修的:
customer_reference_id(字符串)客户订单参考 IDpurchase_order(属性)采购订单详情(有关嵌套架构,请参见下方)signature(属性)端口订单确认签名详情(有关嵌套架构,请参见下方)
只读:
order_id(字符串)订单标识order_number(字符串)订单参考编号uuid(字符串)Equinix 分配的订单标识符,这是一个派生的响应属性
order.purchase_order 的嵌套模式
只读:
amount(字符串)采购订单金额attachment_id(字符串)采购订单附件 IDend_date(字符串)采购订单结束日期number(字符串)采购订单号start_date(字符串)采购订单开始日期type(字符串)采购订单类型
order.signature 的嵌套模式
必需的:
delegate(属性)委托订单详情(有关嵌套架构,请参见下方)signatory(字符串)端口签名类型
order.signature.delegate 的嵌套模式
必需的:
email(字符串)签署人的电子邮件地址
选修的:
first_name(字符串)签署人的名字last_name(字符串)签署人的姓氏
timeouts 的嵌套模式
选修的:
create(字符串)一个可以解析为持续时间的字符串,由数字和单位后缀组成,例如“30s”或“2h45m”。有效的时间单位为“s”(秒)、“m”(分钟)、“h”(小时)。delete(字符串)一个可解析为持续时间的字符串(https://pkg.go.dev/time#ParseDuration),由数字和单位后缀组成,例如“30s”或“2h45m”。有效的时间单位为“s”(秒)、“m”(分钟)和“h”(小时)。设置删除操作的超时时间仅在销毁操作发生之前将更改保存到状态时才适用。read(字符串)一个可解析为持续时间的字符串(https://pkg.go.dev/time#ParseDuration),由数字和单位后缀组成,例如“30s”或“2h45m”。有效的时间单位为“s”(秒)、“m”(分钟)和“h”(小时)。当刷新功能启用时,读取操作会在任何刷新或计划操作期间发生。update(字符串)一个可以解析为持续时间的字符串,由数字和单位后缀组成,例如“30s”或“2h45m”。有效的时间单位为“s”(秒)、“m”(分钟)、“h”(小时)。
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(字符串)端口资源的最后更新时间