金属计费织物虚拟连接

Metal计费 Fabric 虚拟连接允许您从Equinix Metal™ 建立到同一城域内 Fabric 上其他云服务提供商 (CSP) 的二层虚拟连接，而无需Network Edge设备。您仍然需要在Equinix Fabric门户上拥有一个帐户才能兑换 A 端服务令牌，但您无需拥有Equinix Fabric计费帐户。

系统信息

• 每个虚拟光纤连接可以是单个端口，也可以是一组冗余端口。建议使用冗余端口以实现一定程度的高可用性。单个端口无法保证正常运行时间。

• 每个 Fabric 虚拟连接都带有一条虚拟电路，可供您连接到 VLAN 或 VRF。如果您使用冗余端口，则每个端口都会有一条虚拟电路。

• 虚拟电路与 VLAN 的关系是 1:1。您只能将一个 VLAN 连接到一条虚拟电路，并且只能将一条虚拟电路连接到一个 VLAN。同一个 VLAN 不能连接到两个或多个虚拟电路。因此，如果您要设计具有主端口和辅助端口的高可用性，则需要为每个端口分配一个 VLAN，并且需要具有 VLAN 间路由或其他一些三层应用程序感知功能。

• 对于路由，Fabric 虚拟连接可以使用虚拟路由和转发。更多信息，请参阅互连 VRF页面。

• 虚拟结构端口的最大带宽为 10 Gbps。

• 虚拟结构端口支持高达 9000 字节的最大传输单元 (MTU) 和巨型以太网帧。

出发地和目的地

Origin	Destination	Supported
金属纤维布 VC	Fabric 上的任何物理端口（不在 服务配置文件 上）	是
金属计费 Fabric VC	物理 Fabric 端口上的任何二层 服务配置文件，通常指云服务提供商	是
金属纤维化 VC	虚拟设备（网络边缘）或虚拟设备上的服务配置文件	否
金属计费架构 VC	Equinix Metal 作为目标云服务提供商	否

带宽和定价

Metal Billed Fabric 虚拟连接使用费由Equinix Metal计量计费，并将包含在您的月度发票中。所有使用量均按小时计算，费率取决于您选择的连接最大速度。您的最大速度选项包括：

• 50 Mbps
• 200 Mbps
• 500 Mbps
• 1 Gbps
• 2 Gbps
• 5 Gbps
• 10 Gbps

注意：您正在选择最大速度，因为您连接的服务提供商可能提供其他连接速度选项。在 Fabric 门户中，您可以选择最高速度，最高可达您通过Equinix Metal订购的最大速度。

请求Metal账单结构虚拟连接

Console

要申请 Fabric 虚拟连接，请打开项目的“互连”页面。单击“+ 申请新互连”。

在“互连类型”部分，单击“Fabric VC”下的下拉菜单，然后选择“金属计费”。

• 从下拉菜单中选择新连接的位置。您需要选择Equinix Metal基础设施所在的城市，以及您在 Fabric 上连接的 CSP 所在的城市：这些互连都受限于城市。
• 为您的连接命名。
• 选择是否需要一组冗余端口。强烈建议使用冗余端口。选择单个端口可能会因计划内和计划外中断而导致长时间停机。
• 从下拉菜单中选择连接速度进行设置。注意：服务令牌签发后，速度将无法更改。更改速度需要新的请求和服务令牌。

接下来，选择将端口连接到 VLAN 还是 VRF。

• 如果您仅使用 VLAN，请选择要连接到端口的 VLAN。VLAN 必须与您的 Fabric VC 位于同一项目和位置。如果您没有任何符合条件的 VLAN，可以单击“+ 创建 VLAN”进行创建。同一个 VLAN 不能连接到两个或多个虚拟电路，因此如果您需要冗余端口，请为每个端口选择一个 VLAN。注意：创建 Fabric VC 后，您将无法更新或更改 VLAN。

• 如果您使用 VRF，请为您的端口选择 VRF。更多文档请参见互连 VRF页面。

请查看您的请求摘要。点击提交请求以获取您的A面服务令牌。

令牌有效期为 7 天。您还会收到一封包含令牌和到期信息的电子邮件。在“互连”页面上，您新请求的 Fabric 虚拟连接将显示在“待处理请求”选项卡中。

CLI

要在 CLI 中请求金属计费 Fabric VC，请使用 metal interconnections create 命令。

metal interconnections create -p <project_id> -n <name> -m <metro> -r redundant -t shared -T z_side [--vlans <vlan_id>, <vlan_id> | --vrfs <vrf_uuid>, <vrf_uuid>]

选项：

• -p, --project-id (required) - Your Project's UUID.
• -r, --redundancy - Select primary or redundant. If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• -T, --service-token-type (required) - This parameter is required when requesting a Metal-billed Fabric Virtual Connection. Set the value to a_side.
• -t, --type (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to "shared".
• --vlan" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The vlan option is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• --vrfs - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The vrfs option is required if you are using VRFs. If you are using VLANs, this field is NOT required.

注意：可以使用 "vlans" 字段或 "vrfs" 字段。它们互斥，必须至少使用其中一个。

发送请求会生成您的 Z 端服务令牌。令牌包含在响应对象中。如果您请求了冗余连接，则会收到两个令牌。

API

要通过 API 请求连接，请向 /projects/{project_id}/connections 端点发送 POST 请求。如果您要将 VLAN 连接到此 Fabric VC，请在请求正文中使用 "vlans" 参数。如果您正在使用 VRF，请在请求正文中使用 vrfs 参数。

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{project_id}/connections" \
-d '{
    "name": "<string>",
    "description": "<string>",
    "contact_email": "<string>",
    "metro": "<metro_slug>",
    "type": "shared",
    "service_token_type": "a_side",
    "redundancy": "<redundant>",
    "speed": "<string>",
    "vlans": [ <integer>, <integer> ]  
}'

身体参数：

• "name" (required) - The name of your new Fabric Virtual Connection.
• "description" (optional) - A user-friendly description for your Fabric Virtual Connection.
• "contact_email" - The preferred email used for communication and notifications about the Interconnection. Required when using a Project API key. Optional and defaults to your user email address when using a User API key.
• "metro" (required) - Select the metro where both your Equinix Metal infrastructure and the CSP destination on Fabric is: these interconnections are metro-bound.
• "type" (required) - This parameter is required when requesting a Metal-billed Fabric Virtual Connection. Set the value to "shared".
• "service_token_type" (required) - This parameter is required when requesting a Metal-billed Fabric Virtual Connection. Set the value to a_side.
• "redundancy" (required) - Select "primary" or "redundant". If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• "vlans" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The "vlans" field is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• "vrfs" - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The "vrfs" field is required if you are using VRFs. If you are using VLANs, this field is NOT required.

注意：可以使用 "vlans" 字段或 "vrfs" 字段。它们互斥，必须至少使用其中一个。

发送请求会在 Equinix Medal 上创建 Fabric 虚拟控制器 (VC) 并生成 Fabric 令牌。令牌包含在响应的 "service_tokens" 对象中。如果您请求的是冗余连接，则会收到两个令牌。

"service_tokens": [ 
    {
    “id”: "ff0cf4dc-a897-426d-9621-13e5b975058c",
    “role”: "primary",
    “state”: "inactive",
        “max_allowed_speed”: 50000000,
    “service_token_type”: "a_side",
    “expires_at”: "2019-09-30T20:22:20",
    }
],

令牌将在 7 天后过期。您还会收到一封包含服务令牌和过期信息的电子邮件。在此期间，您可以通过向 /connections/{connection_id} 端点发送 GET 请求来查看您的请求并检索令牌。

curl -X GET -H 'X-Auth-Token: $API_TOKEN' \
"https://api.equinix.com/metal/v1/connections/{connection_id}"

兑换您的 A 面服务代币

要兑换您的代币，请登录 Equinix Fabric 门户，然后从 Connections 下拉菜单中单击 Create a Connection。

选择连接目标，可以是 AWS 或 Azure 等云服务提供商，也可以是您自有的 Fabric 端口。不支持将Equinix Metal作为目标。

如果要连接到云服务提供商，请选择“服务提供商”，然后选择您要查找的服务提供商。

或者

如果要连接到您自己的 Fabric 端口，请选择“我的资产”和“将我的资产连接为 E 线”。

选择目标服务器后，使用您的服务令牌将 Equinix Metal 设置为连接源。选择“服务令牌”并在相应字段中输入令牌。输入令牌后，源端口信息将自动填充。

如果您连接到云服务提供商，他们可能会提供冗余选项，允许您同时兑换两个令牌。

否则，您将必须对每个令牌重复此过程。

或者

如果您连接到自己的 Fabric 端口，则原始端口信息也将被自动过滤，并且您将能够看到选择目标 Fabric 端口的选项。

目的地选项将筛选为您在 Equinix Metal 上请求的地铁线路。选择您要换乘的线路，然后点击下一步。

为连接的虚拟电路指定一个易记的名称，并输入您要连接的服务提供商所需的任何信息，例如您的 AWS 账户 ID。设置连接速度，最高可达Equinix Metal上设置的限制。

点击下一步查看您的选择，准备好下单后，点击提交订单。

注意：提交订单后，您可能还需要登录用于管理所连接服务提供商的帐户，以批准来自Equinix Metal和 Fabric 的连接。

在 Fabric 中兑换 A 端服务令牌并设置连接后， Equinix Metal会启动后台作业来完成设置和激活。这通常需要不到 15 分钟的时间。

如果您因冗余连接而收到两个令牌，但在连接到云服务提供商 (CSP) 时未能兑换这两个令牌，请务必重复该过程以兑换第二个令牌。

如果需要检索令牌，它们位于“互连请求”选项卡中。单击要获取令牌的互连旁边的“管理”按钮。

当您在 Fabric 上兑换服务令牌并完成激活后，将开始按小时计费。

管理结构虚拟连接

Console

Fabric 和 Equinix Metal 之间的互连建立后，它将出现在您项目的“互连”页面的“Fabric VC”部分，状态为“已激活”。当 Fabric 虚拟连接的状态变为“已激活”时，计费开始。

• Fabric Billed Fabric Virtual Connections 的类型为 Fabric Billed。
• 金属计费结构虚拟连接的类型为_金属计费_。
• 设置为“共享端口”的互连以类型“传统”表示。

请注意，专用端口是在组织级别进行管理的，因此如果您的组织中有任何专用端口，它们也会出现在“专用端口”部分中。

点击互连的名称，即可进入其“概览”页面，其中包含详细视图以及主端口和辅助端口配置的摘要。

点击“主端口”或“辅助端口”即可查看端口的状态和配置。

CLI

使用 metal interconnections get 命令列出项目的所有互连，包括金属网状虚拟连接。使用 -p 或 --project_id 指定项目。

metal interconnections get -p <project_id>

注意：专用端口在组织级别进行管理，并在组织内的项目之间共享。如果您的组织中存在任何专用端口，它们也会显示在响应中。

使用 metal interconnections get 命令获取特定 Fabric 虚拟连接的详细信息，通过其 UUID 和 -i 或 --connID 指定 Fabric 虚拟连接。

metal interconnections get -i <fabric_vc_uuid>

要更新 Fabric 虚拟连接，请使用 metal interconnections update 命令。Fabric 虚拟连接的 UUID 为必填项。所有其他字段均为可选，可以单独更新。

metal interconnections update -i <fabric_vc_uuid> -n <name> -d <description> -r <redundant|primary> -e <e-mail> --tags="<tag1>,<tag2>"

选项：

• -i, --id (required) - The UUID of the interconnection.
• -e, --contactEmail - Adds or updates the email contact for the Fabric Virtual Connection.
• -n, --name - Updates the name.
• -d, --description - Adds or updates the description.
• -r, --redundancy - Updating to primary will remove a secondary port, while updating to redundant will add a secondary port.
• -t, --tags - Adds or updates the tags.

API

要列出项目中的所有互连，请向 /organizations/{organization_id}/connections 端点发送 GET 请求，并在请求路径中筛选对项目的响应。

注意：专用端口在组织级别进行管理，并在组织内的项目之间共享。如果您的组织中存在任何专用端口，它们也会显示在响应中。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/organizations/{organization_id}/connections?project={project_id}

要获取金属计费织物 VC 的详细信息，请向 /connections/{connection_id} 端点发送 GET 请求，并在请求路径中指定 UUID。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}

您可以使用此信息通过向 /connections/{connection_id} 端点发送 PUT 请求来管理和更新 Fabric Billed Fabric VC。请在请求正文中指定要更改的内容。所有字段均为可选，因此可以单独更新。

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/connections/{connection_id}" \
-d '{
    "contact_email": "<string>",
    "description": "<string>",
    "name": "<string>",
    "redundancy": "<string>",
    "tags": [
        "<string>"
    ]
}'

身体参数：

• "contact_email" - Adds or updates the email contact for the Fabric Virtual Connection.
• "name" - Updates the name.
• "description" - Adds or updates the description.
• "redundancy" - Updating to "primary" will remove a secondary port, while updating to "redundant" will add a secondary port.
• “标签”——添加或更新标签。

您还可以获取互连的端口信息。

要获取 Metal Billed Fabric VC 的端口列表，请向 /connections/{connection_id}/ports 端点发送 GET 请求。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports

要获取端口的详细信息，请向 /connections/{connection_id}/ports/{id} 端点发送 GET 请求。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports/{id}

虚拟电路

每个端口（主端口和辅助端口）都有一个可连接 VLAN 或 VRF 的虚拟电路。

如果您使用 VLAN，您的虚拟电路将连接到您指定的 VLAN。这些 VLAN 无法修改或更改。如果您需要具有不同 VLAN 的 Fabric VC，则必须拆除并重新创建 Fabric VC。

注意：如果您之前通过控制台或 API 在虚拟电路上添加、删除或更改过 VLAN，则这些选项在2024年2月29日之后将不可用。发送到 /virtual-circuits/{id} 端点的更新 (PUT) 请求的响应中将包含一个“日落”标头。但对于2024年3月1日之前配置的、处于“等待客户 VLAN”状态的 Fabric VC，则存在例外情况。

如果您正在使用 VRF，则您的虚拟电路的状态将显示为“等待对等详细信息”。

配置 VRF

Console

如果您在虚拟电路中使用 VRF，请单击三横线菜单打开“管理对等连接详细信息”窗格。填写所需信息。

您可以在此处从 VRF IP 地址范围中指定一个子网，该子网将用于寻址 VRF 和虚拟电路的远端。系统将自动为该子网创建 IP 地址预留。

更详细的文档可在 VRF for Interconnections 页面上找到。

点击更新虚拟电路。

如果有冗余端口，请在辅助端口上重复此过程。

API

要使用 VRF 的对等连接详细信息更新虚拟电路，请向 /virtual-circuits/{vrf_virtual_circuit_id} 端点发送 PUT 请求。

您可以在此处从 VRF IP 地址范围中指定一个子网，该子网将用于寻址 VRF 和虚拟电路的远端。系统将自动为该子网创建 IP 地址预留。

对于 IPv4 子网：

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
    "peer_asn": <integer>,
    "subnet": "<subnet>",
    "metal_ip": "<ip_address>",
    "customer_ip": "<ip_address>”,
    "md5": "<string>"
}'

对于 IPv6 子网：

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
    "peer_asn": <integer>,
    "subnet_ipv6": "<subnet>",
    "metal_ipv6": "<ip_address>",
    "customer_ipv6": "<ip_address>”,
    "md5": "<string>"
}'

更详细的文档可在 VRF for Interconnections 页面上找到。

删除结构虚拟连接

警告

删除 Fabric 虚拟连接是永久性的。删除连接后，所有连接的 VLAN 都将被断开，从 Fabric 到服务器的流量也将被切断。

从Equinix Metal端删除 Metal 计费虚拟连接会自动删除 Fabric 中的连接。如果您从 Fabric 门户删除该连接， Equinix Metal端也会自动清理该连接。这是一个异步过程，最多可能需要 3 分钟才能完成。

删除前请务必停止流量，并确保清理与目标云服务提供商的连接关联的所有资源。在从Metal或 Fabric 门户删除连接之前执行此操作可确保连接被完全删除并停止计费。

Console

在“互连”页面的连接列表中，单击要删除的 Fabric 虚拟连接的名称。

单击“删除互连”以永久删除 Fabric 虚拟连接。

CLI

要删除 Fabric 虚拟连接，请使用 metal interconnections delete 命令。使用 -i 或 --id 指定 Fabric 虚拟连接的 UUID。要跳过确认步骤，请使用 -f 或 --force。

metal interconnections delete -i <uuid> -f

API

要从 API 中删除 Fabric 虚拟连接，请向 /connections/{connection_id} 端点发送 DELETE 请求，并在路径中指定端口的 ID。

curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{id}

发送请求将永久删除该连接。Metal Metal连接删除后，使用/计费将停止。