跳到主要内容

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

先决条件​

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

  2. 确定现有连接ID。使用搜索连接端点检索连接列表,并确定要迁移到其他端口的连接的ID。

  3. 确定您的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参数路径。
值是对象-
类型是字符串VDVDVD——虚拟设备。
虚拟设备是对象-虚拟设备详细信息。
类型是字符串EDGEEDGE边缘。
唯一标识符是字符串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",
    }
}
这个页面对您有帮助吗?