equinix_fabric_connection（资源）

Fabric V4 API 兼容资源允许创建和管理 Equinix Fabric 连接

补充文件：

入门指南：https://docs.equinix.com/api-catalog/fabricv4/
API：https://docs.equinix.com/api-catalog/fabricv4/#tag/Connections

辅助模块

资源的直接用法将在下一节“示例用法”中介绍。我们还提供配套的 Terraform 模块，可以帮助您处理常见的 Fabric Connection 用例。

您可以在 Terraform Registry: (Fabric Terraform Modules) 上找到这些模块及其使用示例。

用法示例

端口到端口 EVPL_VC 连接：

resource "equinix_fabric_connection" "port2port" {
  name = "ConnectionName"
  type = "EVPL_VC"
  notifications {
    type = "ALL"
    emails = ["example@equinix.com","test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number= "1-323292"
  }
  a_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<aside_port_uuid>"
      }
      link_protocol {
        type = "QINQ"
        vlan_s_tag = "1976"
        
      }
    }
  }
  z_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<zside_port_uuid>"
      }
      link_protocol {
        type = "QINQ"
        vlan_s_tag = "3711"
      }
      location {
        metro_code= "SV"
      }
    }
  }
}

端口至 AWS EVPL_VC 连接：

resource "equinix_fabric_connection" "port2aws" {
  name = "ConnectionName"
  type = "EVPL_VC"
  notifications {
    type = "ALL"
    emails = ["example@equinix.com","test1@equinix.com"]
  }
  bandwidth = 50
  redundancy { priority= "PRIMARY" }
  order {
    purchase_order_number= "1-323929"
  }
  a_side {
    access_point {
      type= "COLO"
      port {
        uuid = "<aside_port_uuid>"
      }
      link_protocol {
        type = "QINQ"
        vlan_s_tag = "2019"
        vlan_c_tag = "2112"
      }
    }
  }
  z_side {
    access_point {
      type = "SP"
      authentication_key = "<aws_account_id>"
      seller_region = "us-west-1"
      profile {
        type = "L2_PROFILE"
        uuid = "<service_profile_uuid>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
  
  additional_info = [
    { key = "accessKey", value = "<aws_access_key>" },
    { key = "secretKey", value = "<aws_secret_key>" }
  ]
}

端口到端口 EPL 连接：

resource "equinix_fabric_connection" "epl" {
  name = "ConnectionName"
  type = "EPL_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<aside_port_uuid>"
      }
    }
  }
  z_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<zside_port_uuid>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

端口到端口 ACCESS_EPL_VC 连接：

resource "equinix_fabric_connection" "access_epl_vc" {
  name = "ConnectionName"
  type = "ACCESS_EPL_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<aside_port_uuid>"
      }
      link_protocol {
        type       = "QINQ"
        vlan_s_tag = "1976"
      }
    }
  }
  z_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<zside_port_uuid>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

虚拟设备到端口的连接：

resource "equinix_fabric_connection" "vd2port" {
  name = "ConnectionName"
  type = "EVPL_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "VD"
      virtual_device {
        type = "EDGE"
        uuid = "<device_uuid>"
      }
      interface {
        type = "NETWORK"
        id = 7
      }
    }
  }
  z_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<zside_port_uuid>"
      }
      link_protocol {
        type       = "DOT1Q"
        vlan_s_tag = "3711"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

虚拟设备到服务令牌的连接：

resource "equinix_fabric_connection" "vd2token" {
  name = "ConnectionName"
  type = "EVPL_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "VD"
      virtual_device {
        type = "EDGE"
        uuid = "<device_uuid>"
      }
      interface {
        type = "NETWORK"
        id = 7
      }
    }
  }
  z_side {
    service_token {
      uuid = "<service_token_uuid>"
    }
  }
}

服务令牌到 AWS 连接：

resource "equinix_fabric_connection" "token2aws" {
  name = "ConnectionName"
  type = "EVPL_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    service_token {
      uuid = "<service_token_uuid>"
    }
  }
  z_side {
    access_point {
      type = "SP"
      authentication_key = "<aws_account_id>"
      seller_region = "us-west-1"
      profile {
        type = "L2_PROFILE"
        uuid = "<service_profile_uuid>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

云路由器到端口的连接：

resource "equinix_fabric_connection" "fcr2port"{
  name = "ConnectionName"
  type = "IP_VC"
  notifications{
    type = "ALL"
    emails = ["example@equinix.com","test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "CLOUD_ROUTER"
      router {
        uuid = "<cloud_router_uuid>"
      }
    }
  }
  z_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<port_uuid>"
      }
      link_protocol {
        type = "DOT1Q"
        vlan_tag = "2711"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

云路由器到 Azure 的连接：

resource "equinix_fabric_connection" "fcr2azure"{
  name = "ConnectionName"
  type = "IP_VC"
  notifications{
    type = "ALL"
    emails = ["example@equinix.com","test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "CLOUD_ROUTER"
      router {
        uuid = "<cloud_router_uuid>"
      }
    }
  }
  z_side {
    access_point {
      type = "SP"
      authentication_key = "<Azure_ExpressRouter_Auth_Key>"
      peering_type = "PRIVATE"
      profile {
        type = "L2_PROFILE"
        uuid = "<Azure_Service_Profile_UUID>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

虚拟设备到 Azure 的连接：

resource "equinix_fabric_connection" "vd2azure" {
  name = "ConnectionName"
  type = "EVPL_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "VD"
      virtual_device {
        type = "EDGE"
        uuid = "<device_uuid>"
      }
      interface {
        type = "CLOUD"
        id = 7
      }
    }
  }
  z_side {
    access_point {
      type = "SP"
      authentication_key = "<Azure_ExpressRouter_Auth_Key>"
      peering_type = "PRIVATE"
      profile {
        type = "L2_PROFILE"
        uuid = "<Azure_Service_Profile_UUID>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

虚拟设备到 Azure 冗余连接：

resource "equinix_fabric_connection" "vd2azure_primary" {
  name = "ConnectionName"
  type = "EVPL_VC"
  redundancy { priority = "PRIMARY" }
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "VD"
      virtual_device {
        type = "EDGE"
        uuid = "<device_uuid>"
      }
      interface {
        type = "CLOUD"
        id = 7
      }
    }
  }
  z_side {
    access_point {
      type = "SP"
      authentication_key = "<Azure_ExpressRouter_Auth_Key>"
      peering_type = "PRIVATE"
      profile {
        type = "L2_PROFILE"
        uuid = "<Azure_Service_Profile_UUID>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

resource "equinix_fabric_connection" "vd2azure_secondary" {
  name = "ConnectionName"
  type = "EVPL_VC"
  redundancy {
    priority = "SECONDARY"
    group = one(equinix_fabric_connection.vd2azure_primary.redundancy).group
  }
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "VD"
      virtual_device {
        type = "EDGE"
        uuid = "<device_uuid>"
      }
      interface {
        type = "CLOUD"
        id = 5
      }
    }
  }
  z_side {
    access_point {
      type = "SP"
      authentication_key = "<Azure_ExpressRouter_Auth_Key>"
      peering_type = "PRIVATE"
      profile {
        type = "L2_PROFILE"
        uuid = "<Azure_Service_Profile_UUID>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

云路由器到网络连接：

resource "equinix_fabric_connection" "fcr2network"{
  name = "ConnectionName"
  type = "IPWAN_VC"
  notifications{
    type = "ALL"
    emails = ["example@equinix.com","test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "CLOUD_ROUTER"
      router {
        uuid = "<cloud_router_uuid>"
      }
    }
  }
  z_side {
    access_point {
      type = "NETWORK"
      network {
        uuid = "<network_uuid>"
      }
    }
  }
}

虚拟设备到网络连接：

resource "equinix_fabric_connection" "vd2network" {
  name = "ConnectionName"
  type = "EVPLAN_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "VD"
      virtual_device {
        type = "EDGE"
        uuid = "<device_uuid>"
      }
      interface {
        type = "CLOUD"
        id = 7
      }
    }
  }
  z_side {
    access_point {
      type = "NETWORK"
      network {
        uuid = "<network_uuid>"
      }
    }
  }
}

EPLAN 端口到网络连接：

resource "equinix_fabric_connection" "eplan" {
  name = "ConnectionName"
  type = "EPLAN_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<aside_port_uuid>"
      }
    }
  }
  z_side {
    access_point {
      type = "NETWORK"
      network {
        uuid = "<network_uuid>"
      }
    }
  }
}

EVPLAN 端口到网络连接：

resource "equinix_fabric_connection" "evplan" {
  name = "ConnectionName"
  type = "EVPLAN_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<aside_port_uuid>"
      }
      link_protocol {
        type = "DOT1Q"
        vlan_s_tag = "1976"

      }
    }
  }
  z_side {
    access_point {
      type = "NETWORK"
      network {
        uuid = "<network_uuid>"
      }
    }
  }
}

（金属结构集成）金属到 AWS EVPL_VC 的连接：

resource "equinix_fabric_connection" "metal2aws" {
  name = "ConnectionName"
  type = "EVPLAN_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type               = "METAL_NETWORK"
      authentication_key = "<metal_authorization_code>"
    }
  }
  z_side {
    access_point {
      type = "SP"
      authentication_key = "<aws_account_id>"
      seller_region = "us-west-1"
      profile {
        type = "L2_PROFILE"
        uuid = "<service_profile_uuid>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

（金属-Fabric 集成）Fabric 云路由器到金属 IP_VC 连接：

resource "equinix_fabric_connection" "fcr2metal" {
  name = "ConnectionName"
  type = "IP_VC"
  notifications {
    type   = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  order {
    purchase_order_number = "1-323292"
  }
  a_side {
    access_point {
      type = "CLOUD_ROUTER"
      router {
        uuid = "<cloud_router_uuid>"
      }
    }
  }
  z_side {
    access_point {
      type               = "METAL_NETWORK"
      authentication_key = "<metal_authorization_code>"
    }
  }
}

端口至阿里巴巴连接 EVPL_VC 连接：

以下是 Fabric 端口到 Fabric 阿里巴巴配置文件连接示例的分步说明

1. 创建并接受连接

使用 Equinix Terraform 提供程序创建连接
然后手动在阿里巴巴门户中接受已创建的物理连接的连接请求

2. 删除资源

运行 terraform destroy 删除阿里巴巴 VBR
直接删除 Equinix Fabric 连接将导致以下错误：ERR-UAA-003-00: Deletion for a provisioned connection needs to be initiated from Alibaba Portal
请前往阿里巴巴平台手动终止并删除物理连接。
此操作将自动删除 Equinix 端的连接，并将 Equinix 和提供商端的连接状态都更新为“已取消配置”。

resource "equinix_fabric_connection" "port2alibaba" {
  name = "ConnectionName"
  type = "EVPL_VC"
  notifications {
    type = "ALL"
    emails = ["example@equinix.com", "test1@equinix.com"]
  }
  bandwidth = 50
  redundancy { priority = "PRIMARY" }
  order {
    purchase_order_number = "1-323929"
  }
  a_side {
    access_point {
      type = "COLO"
      port {
        uuid = "<aside_port_uuid>"
      }
      link_protocol {
        type     = "DOT1Q"
        vlan_tag = "2019"
      }
    }
  }
  z_side {
    access_point {
      type               = "SP"
      authentication_key = "<alibaba_account_id>"
      seller_region      = "us-west-1"
      profile {
        type = "L2_PROFILE"
        uuid = "<service_profile_uuid>"
      }
      location {
        metro_code = "SV"
      }
    }
  }
}

注意事项：

可以通过向 additional_info 字段传递参数，从 IBM 服务提供商端修改到 IBM Connections 的端口：

{"key": "ASN", "value": "1111"}
{"key": "Global", "value": "false"}
{"key": "BGP_IBM_CIDR", "value": "172.16.0.18/30"}
{"key": "BGP_CER_CIDR", "value": "172.16.0.19/30"}

要使用“ibm_dl_gateway_action”资源接受、删除或升级 IBM Connections 的带宽，您必须更新以下属性：对于连接审批：

使用 action = "create_gateway_approve" 进行带宽升级/降级：
使用 action = "update_attributes_approve" 删除连接：
使用操作 = "delete_gateway_approve"

模式

需要

a_side（块集，最小值：1，最大值：1）多段连接的请求方或客户方连接配置对象（有关嵌套模式，请参见下文）
bandwidth（数字）连接带宽（Mbps）
name（字符串）连接名称。一个包含 24 个字符的字母数字字符串，只能包含连字符和下划线。
notifications（阻止列表，最小值：1）连接配置或状态更改通知的首选项（有关嵌套架构，请参见下面的）
type（字符串）定义连接类型，例如 EVPL_VC、EPL_VC、IPWAN_VC、IP_VC、ACCESS_EPL_VC、EVPLAN_VC、EPLAN_VC、EIA_VC、IA_VC、EC_VC
z_side（块集，最小值：1，最大值：1）多段连接的目标端或提供端连接配置对象（有关嵌套模式，请参见下文）

可选

additional_info（字符串映射列表）连接附加信息
description（字符串）客户提供的连接描述
order（区块集，最大值：1）订单详情（有关嵌套模式，请参见下方）
project（区块集，最大值：1）项目信息（有关嵌套模式，请参见下方）
redundancy（块集，最大值：1）连接冗余配置（有关嵌套模式，请参见下面的）
timeouts（块，可选）（有关嵌套模式，请参见下文）

只读

account（对象集）与此连接关联的客户帐户信息（有关嵌套架构，请参见下文）
change_log（对象集）捕获连接生命周期变更信息（有关嵌套模式，请参见下文）
direction（字符串）从请求者角度来看的连接方向
href（字符串）连接 URI 信息
id（字符串）此资源的 ID。
is_remote（布尔值）从接入点位置派生的连接属性
operation（对象集）特定于连接类型的操作数据（有关嵌套模式，请参见下文）
state（字符串）连接总体状态
uuid（字符串）Equinix 分配的连接标识符

`a_side` 的嵌套模式

选修的：

access_point（块集，最大值：1）接入点详细信息（有关嵌套模式，请参见下方）
additional_info（块列表）连接端附加信息（有关嵌套模式，请参见下文）
service_token（区块集，最大值：1）对于基于服务令牌的连接，服务令牌授权用户访问受保护的资源和服务。资源所有者可以将令牌分发给受信任的合作伙伴和供应商，从而允许选定的第三方直接与 Equinix 网络资产交互（有关嵌套模式，请参见下文）。

`a_side.access_point` 的嵌套模式

选修的：

authentication_key（字符串）基于提供程序的连接或 Metal Fabric Integration 连接的身份验证密钥
gateway（块集，最大值：1，已弃用）已弃用 gateway 请改用 router 属性（有关嵌套架构，请参见下文）
interface（块集，最大值：1）虚拟设备接口（有关嵌套模式，请参见下文）
link_protocol（块集，最大值：1）连接链路协议（有关嵌套模式，请参见下文）
location（块集，最大值：1）接入点位置（有关嵌套模式，请参见下面的嵌套模式）
network（块集，最大值：1）网络接入点信息（有关嵌套模式，请参见下文）
peering_type（字符串）对等连接类型 - 私有、微软、公共、手动
port（块集，最大值：1）端口接入点信息（有关嵌套模式，请参见下面的嵌套模式）
profile（块集，最大值：1）服务配置文件（有关嵌套架构，请参见下文）
role（字符串）网络角色
router（块集，最大值：1）云路由器接入点信息，用于替换 gateway（有关嵌套架构，请参见下文）
seller_region（字符串）接入点卖家区域
type（字符串）接入点类型 - COLO、VD、VG、SP、IGW、SUBNET、CLOUD_ROUTER、NETWORK、METAL_NETWORK
virtual_device（块集，最大值：1）虚拟设备（有关嵌套模式，请参见下文）

只读：

account（块集）帐户（有关嵌套架构，请参见下文）
provider_connection_id（字符串）提供程序分配的连接 ID

`a_side.access_point.gateway` 的嵌套模式

选修的：

uuid（字符串）Equinix 分配的虚拟网关标识符

只读：

href（字符串）唯一资源标识符

`a_side.access_point.interface` 的嵌套模式

选修的：

id（数字）id
type（字符串）接口类型
uuid（字符串）Equinix 分配的接口标识符

`a_side.access_point.link_protocol` 的嵌套模式

选修的：

type（字符串）链路协议类型 - UNTAGGED、DOT1Q、QINQ、EVPN_VXLAN
vlan_c_tag（数字）VLAN 客户标签信息，为 QINQ 连接指定的 vlanCTag 值
vlan_s_tag（数字）VLAN 提供商标签信息，为 QINQ 连接指定的 vlanSTag 值
vlan_tag（数字）VLAN 标签信息，为 DOT1Q 连接指定的 VLAN 标签值

`a_side.access_point.location` 的嵌套模式

选修的：

ibx（字符串）IBX 代码
metro_code（字符串）接入点地铁代码
metro_name（字符串）地铁接入点名称
region（字符串）接入点区域

`a_side.access_point.network` 的嵌套模式

必需的：

uuid（字符串）Equinix 分配的网络标识符

只读：

href（字符串）唯一资源标识符

`a_side.access_point.port` 的嵌套模式

选修的：

uuid（字符串）Equinix 分配的端口标识符

只读：

href（字符串）唯一资源标识符
name（字符串）端口名称
redundancy（对象集）冗余信息（有关嵌套模式，请参见下文）

`a_side.access_point.port.redundancy` 的嵌套模式

只读：

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

`a_side.access_point.profile` 的嵌套模式

必需的：

type（字符串）服务配置文件类型 - L2_PROFILE、L3_PROFILE、ECIA_PROFILE、ECMC_PROFILE、IA_PROFILE
uuid（字符串）Equinix 分配的服务配置文件标识符

只读：

access_point_type_configs（对象列表）接入点配置信息（有关嵌套架构，请参见下方）
description（字符串）用户提供的服务描述
href（字符串）服务配置文件 URI 响应属性
name（字符串）客户指定的服务配置文件名称

`a_side.access_point.profile.access_point_type_configs` 的嵌套模式

只读：

type（字符串）
uuid（字符串）

`a_side.access_point.router` 的嵌套模式

选修的：

uuid（字符串）Equinix 分配的虚拟网关标识符

只读：

href（字符串）唯一资源标识符

`a_side.access_point.virtual_device` 的嵌套模式

必需的：

uuid（字符串）Equinix 分配的虚拟设备标识符

选修的：

name（字符串）客户指定的虚拟设备名称
type（字符串）虚拟设备类型

只读：

href（字符串）唯一资源标识符

`a_side.access_point.account` 的嵌套模式

只读：

account_name（字符串）账户持有人的法定姓名。
account_number（数字）Equinix 分配的账号。
global_cust_id（字符串）订阅者父组织的 Equinix 分配的 ID。
global_org_id（字符串）订阅者父组织的 Equinix 分配的 ID。
global_organization_name（字符串）订阅者父组织的 Equinix 分配的名称。
org_id（数字）Equinix 分配的用户组织 ID。
organization_name（字符串）Equinix 分配的订阅者组织的名称。
ucm_id（字符串）企业数据存储 ID

`a_side.additional_info` 的嵌套模式

选修的：

key（字符串）附加信息键
value（字符串）附加信息值

`a_side.service_token` 的嵌套模式

选修的：

type（字符串）令牌类型 - VC_TOKEN
uuid（字符串）Equinix 分配的服务令牌标识符

只读：

description（字符串）服务令牌描述
href（字符串）链接上下文的绝对 URL

`notifications` 的嵌套模式

必需的：

emails（字符串列表）联系人邮箱数组
type（字符串）通知类型 - 全部、连接批准、销售代表通知、通知

选修的：

send_interval（字符串）发送间隔

`z_side` 的嵌套模式

选修的：

access_point（块集，最大值：1）接入点详细信息（有关嵌套架构，请参见下方）
additional_info（块列表）连接端附加信息（有关嵌套模式，请参见下文）
service_token（区块集，最大值：1）对于基于服务令牌的连接，服务令牌授权用户访问受保护的资源和服务。资源所有者可以将令牌分发给受信任的合作伙伴和供应商，从而允许选定的第三方直接操作 Equinix 网络资产（有关嵌套架构，请参见下文）。

`z_side.access_point` 的嵌套模式

选修的：

authentication_key（字符串）基于提供程序的连接或 Metal Fabric Integration 连接的身份验证密钥
gateway（块集，最大值：1，已弃用）已弃用 gateway 请改用 router 属性（有关嵌套架构，请参见下方）
interface（块集，最大值：1）虚拟设备接口（有关嵌套架构，请参见下文）
link_protocol（块集，最大值：1）连接链路协议（有关嵌套模式，请参见下文）
location（块集，最大值：1）接入点位置（有关嵌套架构，请参见下方）
network（块集，最大值：1）网络接入点信息（有关嵌套模式，请参见下文）
peering_type（字符串）对等连接类型 - 私有、微软、公共、手动
port（块集，最大值：1）端口接入点信息（有关嵌套模式，请参见下面的嵌套模式）
profile（块集，最大值：1）服务配置文件（有关嵌套架构，请参见下文）
role（字符串）网络角色
router（块集，最大值：1）云路由器接入点信息，用于替换 gateway（有关嵌套架构，请参见下文）
seller_region（字符串）接入点卖家区域
type（字符串）接入点类型 - COLO、VD、VG、SP、IGW、SUBNET、CLOUD_ROUTER、NETWORK、METAL_NETWORK
virtual_device（块集，最大值：1）虚拟设备（有关嵌套架构，请参见下文）

只读：

account（块集）帐户（有关嵌套架构，请参见下文）
provider_connection_id（字符串）提供程序分配的连接 ID

`z_side.access_point.gateway` 的嵌套模式

选修的：

uuid（字符串）Equinix 分配的虚拟网关标识符

只读：

href（字符串）唯一资源标识符

`z_side.access_point.interface` 的嵌套模式

选修的：

id（数字）id
type（字符串）接口类型
uuid（字符串）Equinix 分配的接口标识符

`z_side.access_point.link_protocol` 的嵌套模式

选修的：

type（字符串）链路协议类型 - UNTAGGED、DOT1Q、QINQ、EVPN_VXLAN
vlan_c_tag（数字）VLAN 客户标签信息，为 QINQ 连接指定的 vlanCTag 值
vlan_s_tag（数字）VLAN 提供商标签信息，为 QINQ 连接指定的 vlanSTag 值
vlan_tag（数字）VLAN 标签信息，为 DOT1Q 连接指定的 VLAN 标签值

`z_side.access_point.location` 的嵌套模式

选修的：

ibx（字符串）IBX 代码
metro_code（字符串）接入点地铁代码
metro_name（字符串）地铁接入点名称
region（字符串）接入点区域

`z_side.access_point.network` 的嵌套模式

必需的：

uuid（字符串）Equinix 分配的网络标识符

只读：

href（字符串）唯一资源标识符

`z_side.access_point.port` 的嵌套模式

选修的：

uuid（字符串）Equinix 分配的端口标识符

只读：

href（字符串）唯一资源标识符
name（字符串）端口名称
redundancy（对象集）冗余信息（有关嵌套模式，请参见下文）

`z_side.access_point.port.redundancy` 的嵌套模式

只读：

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

`z_side.access_point.profile` 的嵌套模式

必需的：

type（字符串）服务配置文件类型 - L2_PROFILE、L3_PROFILE、ECIA_PROFILE、ECMC_PROFILE、IA_PROFILE
uuid（字符串）Equinix 分配的服务配置文件标识符

只读：

access_point_type_configs（对象列表）接入点配置信息（有关嵌套架构，请参见下方）
description（字符串）用户提供的服务描述
href（字符串）服务配置文件 URI 响应属性
name（字符串）客户指定的服务配置文件名称

`z_side.access_point.profile.access_point_type_configs` 的嵌套模式

只读：

type（字符串）
uuid（字符串）

`z_side.access_point.router` 的嵌套模式

选修的：

uuid（字符串）Equinix 分配的虚拟网关标识符

只读：

href（字符串）唯一资源标识符

`z_side.access_point.virtual_device` 的嵌套模式

必需的：

uuid（字符串）Equinix 分配的虚拟设备标识符

选修的：

name（字符串）客户指定的虚拟设备名称
type（字符串）虚拟设备类型

只读：

href（字符串）唯一资源标识符

`z_side.access_point.account` 的嵌套模式

只读：

account_name（字符串）账户持有人的法定姓名。
account_number（数字）Equinix 分配的账号。
global_cust_id（字符串）订阅者父组织的 Equinix 分配的 ID。
global_org_id（字符串）订阅者父组织的 Equinix 分配的 ID。
global_organization_name（字符串）订阅者父组织的 Equinix 分配的名称。
org_id（数字）Equinix 分配的用户组织 ID。
organization_name（字符串）Equinix 分配的订阅者组织的名称。
ucm_id（字符串）企业数据存储 ID

`z_side.additional_info` 的嵌套模式

选修的：

key（字符串）附加信息键
value（字符串）附加信息值

`z_side.service_token` 的嵌套模式

选修的：

type（字符串）令牌类型 - VC_TOKEN
uuid（字符串）Equinix 分配的服务令牌标识符

只读：

description（字符串）服务令牌描述
href（字符串）链接上下文的绝对 URL

`order` 的嵌套模式

选修的：

billing_tier（字符串）连接带宽计费层级
order_id（字符串）订单标识
order_number（字符串）订单参考编号
purchase_order_number（字符串）采购订单号
term_length（数字）期限长度（月）；有效值为 1、12、24、36，其中 1 为默认值（适用于按需情况）

`project` 的嵌套模式

选修的：

project_id（字符串）项目 ID

只读：

href（字符串）唯一资源 URL

`redundancy` 的嵌套模式

选修的：

group（字符串）冗余组标识符（使用主连接的 redundancy.0.group UUID；例如 one(equinix_fabric_connection.primary_port_connection.redundancy).group 或 equinix_fabric_connection.primary_port_connection.redundancy.0.group）
priority（字符串）冗余组中的连接优先级 - 主连接、辅助连接

`timeouts` 的嵌套模式

选修的：

create（字符串）
delete（字符串）
read（字符串）
update（字符串）

`account` 的嵌套模式

只读：

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

`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（字符串）

`operation` 的嵌套模式

只读：

equinix_status（字符串）
errors（对象列表）（有关嵌套模式，请参见下方）
provider_status（字符串）

`operation.errors` 的嵌套模式

只读：

additional_info（对象列表）（有关嵌套模式，请参见下方）
correlation_id（字符串）
details（字符串）
error_code（字符串）
error_message（字符串）
help（字符串）

`operation.errors.additional_info` 的嵌套模式

只读：

property（字符串）
reason（字符串）

辅助模块
用法示例
- 以下是 Fabric 端口到 Fabric 阿里巴巴配置文件连接示例的分步说明
- 注意事项：
模式

辅助模块​

用法示例​

以下是 Fabric 端口到 Fabric 阿里巴巴配置文件连接示例的分步说明​

1. 创建并接受连接​

2. 删除资源​

注意事项：​

模式​

需要​

可选​

只读​

a_side 的嵌套模式​

a_side.access_point 的嵌套模式​

a_side.access_point.gateway 的嵌套模式​

a_side.access_point.interface 的嵌套模式​

a_side.access_point.link_protocol 的嵌套模式​

a_side.access_point.location 的嵌套模式​

a_side.access_point.network 的嵌套模式​

a_side.access_point.port 的嵌套模式​

a_side.access_point.port.redundancy 的嵌套模式​

a_side.access_point.profile 的嵌套模式​

a_side.access_point.profile.access_point_type_configs 的嵌套模式​

a_side.access_point.router 的嵌套模式​

a_side.access_point.virtual_device 的嵌套模式​

a_side.access_point.account 的嵌套模式​

a_side.additional_info 的嵌套模式​

a_side.service_token 的嵌套模式​

notifications 的嵌套模式​

z_side 的嵌套模式​

z_side.access_point 的嵌套模式​

z_side.access_point.gateway 的嵌套模式​

z_side.access_point.interface 的嵌套模式​

z_side.access_point.link_protocol 的嵌套模式​

z_side.access_point.location 的嵌套模式​

z_side.access_point.network 的嵌套模式​

z_side.access_point.port 的嵌套模式​

z_side.access_point.port.redundancy 的嵌套模式​

z_side.access_point.profile 的嵌套模式​

z_side.access_point.profile.access_point_type_configs 的嵌套模式​

z_side.access_point.router 的嵌套模式​

z_side.access_point.virtual_device 的嵌套模式​

z_side.access_point.account 的嵌套模式​

z_side.additional_info 的嵌套模式​

z_side.service_token 的嵌套模式​

order 的嵌套模式​

project 的嵌套模式​

redundancy 的嵌套模式​

timeouts 的嵌套模式​

account 的嵌套模式​

change_log 的嵌套模式​

operation 的嵌套模式​

operation.errors 的嵌套模式​

operation.errors.additional_info 的嵌套模式​

辅助模块

用法示例

以下是 Fabric 端口到 Fabric 阿里巴巴配置文件连接示例的分步说明

1. 创建并接受连接

2. 删除资源

注意事项：

模式

需要

可选

只读

`a_side` 的嵌套模式

`a_side.access_point` 的嵌套模式

`a_side.access_point.gateway` 的嵌套模式

`a_side.access_point.interface` 的嵌套模式

`a_side.access_point.link_protocol` 的嵌套模式

`a_side.access_point.location` 的嵌套模式

`a_side.access_point.network` 的嵌套模式

`a_side.access_point.port` 的嵌套模式

`a_side.access_point.port.redundancy` 的嵌套模式

`a_side.access_point.profile` 的嵌套模式

`a_side.access_point.profile.access_point_type_configs` 的嵌套模式

`a_side.access_point.router` 的嵌套模式

`a_side.access_point.virtual_device` 的嵌套模式

`a_side.access_point.account` 的嵌套模式

`a_side.additional_info` 的嵌套模式

`a_side.service_token` 的嵌套模式

`notifications` 的嵌套模式

`z_side` 的嵌套模式

`z_side.access_point` 的嵌套模式

`z_side.access_point.gateway` 的嵌套模式

`z_side.access_point.interface` 的嵌套模式

`z_side.access_point.link_protocol` 的嵌套模式

`z_side.access_point.location` 的嵌套模式

`z_side.access_point.network` 的嵌套模式

`z_side.access_point.port` 的嵌套模式

`z_side.access_point.port.redundancy` 的嵌套模式

`z_side.access_point.profile` 的嵌套模式

`z_side.access_point.profile.access_point_type_configs` 的嵌套模式

`z_side.access_point.router` 的嵌套模式

`z_side.access_point.virtual_device` 的嵌套模式

`z_side.access_point.account` 的嵌套模式

`z_side.additional_info` 的嵌套模式

`z_side.service_token` 的嵌套模式

`order` 的嵌套模式

`project` 的嵌套模式

`redundancy` 的嵌套模式

`timeouts` 的嵌套模式

`account` 的嵌套模式

`change_log` 的嵌套模式

`operation` 的嵌套模式

`operation.errors` 的嵌套模式

`operation.errors.additional_info` 的嵌套模式