将连接迁移到不同的虚拟设备

先决条件
-
验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅API验证。
-
确定现有连接ID。使用搜索连接端点检索连接列表,并确定要迁移到其他端口的连接的ID。
-
确定您的Network Edge设备信息。您需要一个已配置且具有注册许可证的Equinix虚拟设备/冗余设备/集群。拨打获取虚拟设备或获取虚拟设备{uuid},以检查可用的虚拟设备和集群。您可以在设备上选择任何可用接口进行连接。但是,如果您未指定接口,Equinix将选择接口。
更新连接
要更新连接并将其迁移到其他虚拟设备,请向/fabric/v4/connections/{id}端点发送PATCH请求。在请求正文中指定要将连接迁移到的虚拟设备的连接A侧ID。
| patch /abric/v4/connections/{uuid} | |
|---|---|
| 方法 | 补丁 |
| URL 或端点 | /fabric/v4/connections/{uuid} |
| 标题 | Authorization,Content-Type |
| 路径参数 | uuid |
| 查询参数 | 不适用 |
| 身体参数 | 运营,路径,值 |
在不更改任何连接的情况下,在Production中安全验证此请求,请参阅在Production中测试(API Dry Run)。
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 <token>'
-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",
}
}