将虚拟连接迁移到新端口

Equinix Fabric 用户可以迁移自己的基于端口的虚拟连接，而无需提交支持工单。要迁移连接，您需要Fabric Connection Manager或Fabric Manager角色。

连接和端口要求

要符合自助连接迁移条件，连接和端口必须满足以下要求：

• 该连接必须是 EVPL 连接。

• 连接的源端口和目标端口都必须是端口。

• 新的始发港或目的港必须与现有端口位于同一个计费账户中。

• 新端口必须与现有端口具有相同的端口优先级（主端口或辅助端口）。

  注意

  如果虚拟连接在源(A侧)和目标(Z侧)端口之间的优先级(主要/次要)不匹配，则此要求将被放松。不同优先级的端口有资格迁移以更正不匹配情况。有关更多详细信息，请参阅连接弹性和冗余。

• 新端口必须与现有端口（Dot1Q、QinQ）具有相同的封装。

• 新港口必须与现有港口位于同一都市区。

• 新端口必须具备合适的容量和 VLAN 可用性。

信息

无法迁移使用服务令牌，Fabric云路由器，服务提供商或网络创建的连接。如果需要迁移此类连接，则必须创建新连接并删除现有连接。

先决条件

Portal

1. 登录客户门户网站并导航至_Fabric控制面板_。

2. 从_连接_菜单中，选择连接清单。

   

3. 单击要迁移的连接以打开其_连接详情_。

API

1. 验证-提交您的用户凭据，客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明，请参阅API验证。

2. 确定现有连接ID。使用/fabric/v4/connections/search端点检索连接列表，并确定要迁移到其他端口的连接的ID。

3. 使用端点获取要将连接迁移到的端口ID的端口信息/fabric/v4/ports。

A面迁移

Portal

要将连接的 A 端迁移到不同的端口：

1. 在_连接详细信息_中，单击源。

2. 在_端口名称_部分中，单击迁移。

   

3. 在_将此连接迁移到新端口_部分，从下拉列表中选择端口。下拉列表中只有符合条件的端口可用。

   注意

   如果您选择的端口类型与原始端口不同，您将收到一条消息，指出连接费用将发生变化。"定价概述"部分将指明新费用。

4. 在_将此连接迁移到新端口_对话框中：

   • 检查_我是否已验证新端口的端口容量和VLAN可用性。我将在我的端执行必要的更改_
   • 勾选以同意条款与条件。

   

5. 单击确认。

_连接详情_表示迁移已发起。

API

要将连接的A端迁移到其他端口，请向端点发送PATCH请求/fabric/v4/connections/{id}。

请在请求正文中注明：

• opASreplace
• pathAS/aSide/accessPoint/port/uuid
• value端口的UUID，该UUID是连接的新A端。

cURL 请求示例：

curl -X PATCH 'https://api.equinix.com/fabric/v4/connections/{connection_id}' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '[{
"op": "replace",
"path": "/aSide/accessPoint/port/uuid",
"value": "<new_port_uuid>"
}]'

在不更改任何连接的情况下，在Production中安全验证此请求，请参阅在Production中测试(API Dry Run)。

迁移成功后，在24小时内无法再次迁移同一连接。Equinix更新连接计费和发票的方式而存在此限制；每次迁移都会触发计费更新，系统需要24小时间隔才能为同一连接进行另一次迁移。

24小时限制的一个例外情况是，如果您的连接为本地连接(例如，西雅图至西雅图)，且A侧端口迁移发生在无限制连接套餐中的端口之间。在24小时内，这些连接可以迁移多次，因为连接的账单没有变更。

Z 轴方向的迁移

对于终止于用户有权访问的端口的连接，支持 Z 端迁移。

注意

如果您要迁移的连接终止于贵组织管理的服务配置文件，您可以提交支持工单，请求启用您的服务配置文件以在这些端口上进行 Z 端迁移。

Portal

要将连接的 Z 端迁移到不同的端口：

1. 在_连接详情_中，单击目标。

2. 在_端口名称_部分中，单击迁移。

   

3. 在_将此连接迁移到新端口_部分，从下拉列表中选择端口。下拉列表中只有符合条件的端口可用。

   注意

   对于 Z 端迁移，选择不同计费类型的端口不会导致连接的计费发生变化。

4. 在_将此连接迁移到新端口_对话框中：

   • 检查_我是否已验证新端口的端口容量和VLAN可用性。我将在我的端执行必要的更改_
   • 勾选以同意条款与条件。

   

5. 单击确认。

_连接详情_表示迁移已发起。

API

要将连接的Z端迁移到其他端口，请向端点发送PATCH请求/fabric/v4/connections/{id}。

请在请求正文中注明：

• opASreplace
• pathAS/zSide/accessPoint/port/uuid
• value端口的UUID，该UUID是连接的新Z端。 cURL 请求示例：

curl -X PATCH 'https://api.equinix.com/fabric/v4/connections/{connection_id}' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '[{
"op": "replace",
"path": "/zSide/accessPoint/port/uuid",
"value": "<new_port_uuid>"
}]'

后续的 Z 轴方向迁移可以不受任何限制地进行。