# 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>

## 辅助模块[​](#辅助模块 "Direct link to 辅助模块")

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

您可以在 [Terraform Registry: (Fabric Terraform Modules)](https://registry.terraform.io/modules/equinix/fabric/equinix/latest) 上找到这些模块及其使用示例。

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

端口到端口 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 阿里巴巴配置文件连接示例的分步说明[​](#以下是-fabric-端口到-fabric-阿里巴巴配置文件连接示例的分步说明 "Direct link to 以下是 Fabric 端口到 Fabric 阿里巴巴配置文件连接示例的分步说明")

#### 1. 创建并接受连接[​](#1-创建并接受连接 "Direct link to 1. 创建并接受连接")

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

#### 2. 删除资源[​](#2-删除资源 "Direct link to 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"

      }

    }

  }

}
```

### 注意事项：[​](#注意事项 "Direct link to 注意事项：")

可以通过向 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"

<!-- -->

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

### 需要[​](#需要 "Direct link to 需要")

* `a_side`（块集，最小值：1，最大值：1）多段连接的请求方或客户方连接配置对象（有关嵌套模式，请参见[下文](#nestedblock--a_side)）
* `bandwidth`（数字）连接带宽（Mbps）
* `name`（字符串）连接名称。一个包含 24 个字符的字母数字字符串，只能包含连字符和下划线。
* `notifications`（阻止列表，最小值：1）连接配置或状态更改通知的首选项（有关嵌套架构，请参见[下面的](#nestedblock--notifications)）
* `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）多段连接的目标端或提供端连接配置对象（有关嵌套模式，请参见[下文](#nestedblock--z_side)）

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

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

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

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

[]()

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

选修的：

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

[]()

### `a_side.access_point` 的嵌套模式[​](#a_sideaccess_point-的嵌套模式 "Direct link to a_sideaccess_point-的嵌套模式")

选修的：

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

只读：

* `account`（块集）帐户（有关嵌套架构，请参见[下文](#nestedblock--a_side--access_point--account)）
* `provider_connection_id`（字符串）提供程序分配的连接 ID

[]()

### `a_side.access_point.gateway` 的嵌套模式[​](#a_sideaccess_pointgateway-的嵌套模式 "Direct link to a_sideaccess_pointgateway-的嵌套模式")

选修的：

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

只读：

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

[]()

### `a_side.access_point.interface` 的嵌套模式[​](#a_sideaccess_pointinterface-的嵌套模式 "Direct link to a_sideaccess_pointinterface-的嵌套模式")

选修的：

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

[]()

### `a_side.access_point.link_protocol` 的嵌套模式[​](#a_sideaccess_pointlink_protocol-的嵌套模式 "Direct link to a_sideaccess_pointlink_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` 的嵌套模式[​](#a_sideaccess_pointlocation-的嵌套模式 "Direct link to a_sideaccess_pointlocation-的嵌套模式")

选修的：

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

[]()

### `a_side.access_point.network` 的嵌套模式[​](#a_sideaccess_pointnetwork-的嵌套模式 "Direct link to a_sideaccess_pointnetwork-的嵌套模式")

必需的：

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

只读：

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

[]()

### `a_side.access_point.port` 的嵌套模式[​](#a_sideaccess_pointport-的嵌套模式 "Direct link to a_sideaccess_pointport-的嵌套模式")

选修的：

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

只读：

* `href`（字符串）唯一资源标识符
* `name`（字符串）端口名称
* `redundancy`（对象集）冗余信息（有关嵌套模式，请参见[下文](#nestedatt--a_side--access_point--port--redundancy)）

[]()

### `a_side.access_point.port.redundancy` 的嵌套模式[​](#a_sideaccess_pointportredundancy-的嵌套模式 "Direct link to a_sideaccess_pointportredundancy-的嵌套模式")

只读：

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

[]()

### `a_side.access_point.profile` 的嵌套模式[​](#a_sideaccess_pointprofile-的嵌套模式 "Direct link to a_sideaccess_pointprofile-的嵌套模式")

必需的：

* `type`（字符串）服务配置文件类型 - L2\_PROFILE、L3\_PROFILE、ECIA\_PROFILE、ECMC\_PROFILE、IA\_PROFILE
* `uuid`（字符串）Equinix 分配的服务配置文件标识符

只读：

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

[]()

### `a_side.access_point.profile.access_point_type_configs` 的嵌套模式[​](#a_sideaccess_pointprofileaccess_point_type_configs-的嵌套模式 "Direct link to a_sideaccess_pointprofileaccess_point_type_configs-的嵌套模式")

只读：

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

[]()

### `a_side.access_point.router` 的嵌套模式[​](#a_sideaccess_pointrouter-的嵌套模式 "Direct link to a_sideaccess_pointrouter-的嵌套模式")

选修的：

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

只读：

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

[]()

### `a_side.access_point.virtual_device` 的嵌套模式[​](#a_sideaccess_pointvirtual_device-的嵌套模式 "Direct link to a_sideaccess_pointvirtual_device-的嵌套模式")

必需的：

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

选修的：

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

只读：

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

[]()

### `a_side.access_point.account` 的嵌套模式[​](#a_sideaccess_pointaccount-的嵌套模式 "Direct link to a_sideaccess_pointaccount-的嵌套模式")

只读：

* `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` 的嵌套模式[​](#a_sideadditional_info-的嵌套模式 "Direct link to a_sideadditional_info-的嵌套模式")

选修的：

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

[]()

### `a_side.service_token` 的嵌套模式[​](#a_sideservice_token-的嵌套模式 "Direct link to a_sideservice_token-的嵌套模式")

选修的：

* `type`（字符串）令牌类型 - VC\_TOKEN
* `uuid`（字符串）Equinix 分配的服务令牌标识符

只读：

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

[]()

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

必需的：

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

选修的：

* `send_interval`（字符串）发送间隔

[]()

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

选修的：

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

[]()

### `z_side.access_point` 的嵌套模式[​](#z_sideaccess_point-的嵌套模式 "Direct link to z_sideaccess_point-的嵌套模式")

选修的：

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

只读：

* `account`（块集）帐户（有关嵌套架构，请参见[下文](#nestedblock--z_side--access_point--account)）
* `provider_connection_id`（字符串）提供程序分配的连接 ID

[]()

### `z_side.access_point.gateway` 的嵌套模式[​](#z_sideaccess_pointgateway-的嵌套模式 "Direct link to z_sideaccess_pointgateway-的嵌套模式")

选修的：

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

只读：

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

[]()

### `z_side.access_point.interface` 的嵌套模式[​](#z_sideaccess_pointinterface-的嵌套模式 "Direct link to z_sideaccess_pointinterface-的嵌套模式")

选修的：

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

[]()

### `z_side.access_point.link_protocol` 的嵌套模式[​](#z_sideaccess_pointlink_protocol-的嵌套模式 "Direct link to z_sideaccess_pointlink_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` 的嵌套模式[​](#z_sideaccess_pointlocation-的嵌套模式 "Direct link to z_sideaccess_pointlocation-的嵌套模式")

选修的：

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

[]()

### `z_side.access_point.network` 的嵌套模式[​](#z_sideaccess_pointnetwork-的嵌套模式 "Direct link to z_sideaccess_pointnetwork-的嵌套模式")

必需的：

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

只读：

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

[]()

### `z_side.access_point.port` 的嵌套模式[​](#z_sideaccess_pointport-的嵌套模式 "Direct link to z_sideaccess_pointport-的嵌套模式")

选修的：

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

只读：

* `href`（字符串）唯一资源标识符
* `name`（字符串）端口名称
* `redundancy`（对象集）冗余信息（有关嵌套模式，请参见[下文](#nestedatt--z_side--access_point--port--redundancy)）

[]()

### `z_side.access_point.port.redundancy` 的嵌套模式[​](#z_sideaccess_pointportredundancy-的嵌套模式 "Direct link to z_sideaccess_pointportredundancy-的嵌套模式")

只读：

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

[]()

### `z_side.access_point.profile` 的嵌套模式[​](#z_sideaccess_pointprofile-的嵌套模式 "Direct link to z_sideaccess_pointprofile-的嵌套模式")

必需的：

* `type`（字符串）服务配置文件类型 - L2\_PROFILE、L3\_PROFILE、ECIA\_PROFILE、ECMC\_PROFILE、IA\_PROFILE
* `uuid`（字符串）Equinix 分配的服务配置文件标识符

只读：

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

[]()

### `z_side.access_point.profile.access_point_type_configs` 的嵌套模式[​](#z_sideaccess_pointprofileaccess_point_type_configs-的嵌套模式 "Direct link to z_sideaccess_pointprofileaccess_point_type_configs-的嵌套模式")

只读：

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

[]()

### `z_side.access_point.router` 的嵌套模式[​](#z_sideaccess_pointrouter-的嵌套模式 "Direct link to z_sideaccess_pointrouter-的嵌套模式")

选修的：

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

只读：

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

[]()

### `z_side.access_point.virtual_device` 的嵌套模式[​](#z_sideaccess_pointvirtual_device-的嵌套模式 "Direct link to z_sideaccess_pointvirtual_device-的嵌套模式")

必需的：

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

选修的：

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

只读：

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

[]()

### `z_side.access_point.account` 的嵌套模式[​](#z_sideaccess_pointaccount-的嵌套模式 "Direct link to z_sideaccess_pointaccount-的嵌套模式")

只读：

* `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` 的嵌套模式[​](#z_sideadditional_info-的嵌套模式 "Direct link to z_sideadditional_info-的嵌套模式")

选修的：

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

[]()

### `z_side.service_token` 的嵌套模式[​](#z_sideservice_token-的嵌套模式 "Direct link to z_sideservice_token-的嵌套模式")

选修的：

* `type`（字符串）令牌类型 - VC\_TOKEN
* `uuid`（字符串）Equinix 分配的服务令牌标识符

只读：

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

[]()

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

选修的：

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

[]()

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

选修的：

* `project_id`（字符串）项目 ID

只读：

* `href`（字符串）唯一资源 URL

[]()

### `redundancy` 的嵌套模式[​](#redundancy-的嵌套模式 "Direct link to 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` 的嵌套模式[​](#timeouts-的嵌套模式 "Direct link to timeouts-的嵌套模式")

选修的：

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

[]()

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

只读：

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

[]()

### `change_log` 的嵌套模式[​](#change_log-的嵌套模式 "Direct link to 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` 的嵌套模式[​](#operation-的嵌套模式 "Direct link to operation-的嵌套模式")

只读：

* `equinix_status`（字符串）
* `errors`（对象列表）（有关嵌套模式，请参见[下方](#nestedobjatt--operation--errors)）
* `provider_status`（字符串）

[]()

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

只读：

* `additional_info`（对象列表）（有关嵌套模式，请参见[下方](#nestedobjatt--operation--errors--additional_info)）
* `correlation_id`（字符串）
* `details`（字符串）
* `error_code`（字符串）
* `error_message`（字符串）
* `help`（字符串）

[]()

### `operation.errors.additional_info` 的嵌套模式[​](#operationerrorsadditional_info-的嵌套模式 "Direct link to operationerrorsadditional_info-的嵌套模式")

只读：

* `property`（字符串）
* `reason`（字符串）
