# 将连接迁移到不同的虚拟设备 ![](https://docs.equinix.com/zh-Hans/assets/images/MigrateConnectionToDifferentVirtualDevice-c2f98589b6a3ad47dc85d71ac39d316b.jpg) ## 先决条件[​](#先决条件 "直接链接至先决条件") 1. 验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 2. 确定现有连接ID。使用[搜索连接](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/searchconnections.md)端点检索连接列表,并确定要迁移到其他端口的连接的ID。 3. 确定您的Network Edge设备信息。您需要一个已配置且具有注册许可证的Equinix虚拟设备/冗余设备/集群。拨打[获取虚拟设备](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/getvirtualdevices)或[获取](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid)虚拟[设备](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/getvirtualdevices)[{uuid}](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid),以检查可用的虚拟设备和集群。您可以在设备上选择任何可用接口进行连接。但是,如果您未指定接口,Equinix将选择接口。 ## 更新连接[​](#更新连接 "直接链接至更新连接") 要更新连接并将其迁移到其他虚拟设备,请向[/fabric/v4/connections/{id}](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/updateconnectionbyuuid.md)端点发送`PATCH`请求。在请求正文中指定要将连接迁移到的虚拟设备的连接A侧ID。 | | **patch /abric/v4/connections/{uuid}** | | ---------- | -------------------------------------- | | 方法 | 补丁 | | URL 或端点 | `/fabric/v4/connections/{uuid}` | | 标题 | `Authorization`,`Content-Type` | | 路径参数 | `uuid` | | 查询参数 | 不适用 | | 身体参数 | 运营,路径,值 | 在不更改任何连接的情况下,在Production[中](https://docs.equinix.com/zh-Hans/equinix-api/testing/testing-in-production-dry-run.md)安全验证此请求,请参阅[在Production中测试(API Dry Run)](https://docs.equinix.com/zh-Hans/equinix-api/testing/testing-in-production-dry-run.md)。 cURL 请求示例: ``` curl -X PATCH 'https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62' -H 'content-type: application/json-patch+json' -H 'authorization: Bearer ' -d '[     {         "op": "replace",         "path": "/aSide/accessPoint",         "value": {             "type": "VD",             "virtualDevice": {                 "type": "EDGE",                 "uuid": "e8b49cd7-9b4c-4123-8bd4-fbead83c3436"             },             "interface": {                 "type": "NETWORK",                 "id": 5             }         }     } ]' ``` **路径参数** | **参数** | **必填** | **类型** | **示例** | **适用值** | **描述** | | ---------- | -------- | -------- | ------------------------------------ | ---------- | -------------------------- | | 唯一标识符 | 是 | 字符串 | 3a58dd05-f46d-4b1d-a154-2e85c396ea62 | - | Equinix 分配的连接标识符。 | **实体参数** | **参数** | **必填** | **类型** | **示例** | **适用值** | **描述** | | ---------- | -------- | -------- | ------------------------------------ | ---------------- | --------------------- | | 运营点 | 是 | 字符串 | 更换 | 更换 | 更新请求类型。 | | 路径 | 是 | 字符串 | /aside/accspoint | /aside/accspoint | 参数路径。 | | 值 | 是 | 对象 | | - | | | 类型 | 是 | 字符串 | VD | VD | VD——虚拟设备。 | | 虚拟设备 | 是 | 对象 | | - | 虚拟设备详细信息。 | | 类型 | 是 | 字符串 | EDGE | EDGE | 边缘。 | | 唯一标识符 | 是 | 字符串 | 78rtdd05-f46d-4b1d-a154-2e85c396yt56 | | 新虚拟设备的唯一 ID。 | | 接口 | 否 | 对象 | | | 接口详细信息。 | | 类型 | 否 | 字符串 | 网络 | | 网络。 | | ID | 否 | 整数 | 5 | | 虚拟设备的接口。 | 示例回答: ``` {     "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "type": "EVPL_VC",     "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "name": "Conn-Name-2",     "state": "PROVISIONED",     "order": {         "purchaseOrderNumber": "1-129105284100",         "billingTier": "Up to 1 Gbps"     },     "bandwidth": 1000,     "redundancy": {         "group": "m167f685-41b0-1b07-6de0-320a5c00abeu",         "priority": "PRIMARY"     },     “aSide”: {         “accessPoint”: {             "interface": {                 “uuid”: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",                 “id”: 7,                 “type”: "NETWORK"             },             “location”: {                 “metroCode”: "AM"             },             “virtualDevice”: {                 “uuid”: "XXXXXXXXXXXXXXXXXXXXXXXXXX",                  “type”: "EDGE"             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",                 "type": "L2_Profile",                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"             },             "location": {                 "href": "https://api.equinix.com/v4/metros/SV",                 "metrocode": "SV",                 "region": "AMER"             }         }     },     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test@equinix.com"             ]         }     ],     "operation": {         "equinixStatus": "PROVISIONED",         "providerStatus": "PROVISIONED"     },     "changeLog": {         "createdDateTime": "2021-07-15T19:30:29.526Z",         "updatedDateTime": "2021-08-15T19:30:29.526Z",     } } ```