API - 连接阿里巴巴

与阿里云建立直接的第 2 层连接。

识别您的阿里巴巴账户ID

登录阿里巴巴快运通管理控制台并找到您的账户ID。

Fabric API 先决条件

身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥身份验证。请参阅API身份验证以获取有关如何调用OAuth API来验证和认证您的凭据的说明。
确定您的 A 面信息。您可以：
- 使用 Get All Ports API 请求检索 Equinix Fabric 端口信息。
或者
- 请确定您的网络边缘设备信息。您需要已配置且已注册许可证的 Equinix 虚拟设备/冗余设备/集群。您可以通过调用 Get Virtual Devices 或 Get Virtual Device {uuid} 来查看可用的虚拟设备和集群。您可以选择设备上的任何可用接口进行连接。但是，如果您未指定接口，Equinix 将自动选择一个。
选择 Z 侧地铁站点。使用 Get All Metros API 请求查找所有 Equinix Fabric 可用的地铁站点，并确定目的地位置。
确定服务配置文件。使用检索服务配置文件 API 请求搜索特定服务配置文件，或使用获取服务配置文件 API 请求列出所有可用的服务配置文件，并确定所需的服务配置文件。你想联系的个人资料。

从 DOT1Q 端口连接到 Alibaba Express Connect

要从您的 DOT1Q 端口创建到 Alibaba Express Connect 的连接，请向 /fabric/v4/connections 端点发送 POST 请求。在请求正文中指定连接的配置详细信息。

	`POST /fabric/v4/connections`
Method	`POST`
Endpoint	`/fabric/v4/connections`
Headers	`Authorization`, `Content-Type`
Path Parameters	Not applicable
Query Parameters	Not applicable
Body Parameters	`type`, `name`, `order`, `bandwidth`, `aSide`, `zSide`, `additionalInfo`, `notifications`

示例 cURL 请求：

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "type": "EVPL_VC",  
    "name": "Conn-1",  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "bandwidth": 1000,  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "DOT1Q",  
                "vlanTag": 1001  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "uuid": "4c4b8edf-873b-4c6c-805a-edb2c335bd6c"  
            },  
            "location": {  
                "metroCode": "SV"  
            },  
            "authenticationKey": "xx-xxx-xx",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "notifications": {  
        "type": "ALL",  
        "emails": [  
            "test@equinix.com",  
            "test2@equinix.com"  
        ]  
    }  
}'

请求正文中包含的参数仅适用于此示例。有关参数及其说明的完整列表，请参阅API 参考。

示例响应：

{  
    "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",  
    "type": "EVPL_VC",  
    "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",  
    "name": "Conn-1",  
    "state": "PROVISIONING",  
    "order": {  
        "purchaseOrderNumber": "1-129105284100",  
        "billingTier": "Up to 1 Gbps"  
    },  
    "bandwidth": 1000,  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",  
                "type": "XF_PORT",  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "DOT1Q",  
                "vlanTag": 1001  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "href": "https://api.equinix.com/fabric/v4/services/serviceProfiles/20d32a80-0d61-4333-bc03-707b591ae2f5",  
                "type": "L2_PROFILE",  
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"  
            },  
            "location": {  
                "href": "https://api.equinix.com/v4/metros/SV",  
                "metroCode": "SV",  
                "region": "AMER"  
            },  
            "authenticationKey": "xx-xxx-xx",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "test@equinix.com",  
                "test2@equinix.com"  
            ]  
        }  
    ],  
    "operation": {  
        "equinixStatus": "PROVISIONING",  
        "providerStatus": "PROVISIONING"  
    },  
    "changeLog": {  
        "createdDateTime": "2021-07-15T19:30:29.526Z"  
    }  
}

响应有效负载包含在请求正文中定义的配置参数。有关所有可用参数及其说明的完整列表，请参阅API 参考。

从 QINQ 端口连接到阿里云 Express Connect

要从您的 QINQ 端口创建到 Alibaba Express Connect 的连接，请向 /fabric/v4/connections 端点发送 POST 请求。在请求正文中指定连接的配置详细信息。

示例 cURL 请求：

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "type": "EVPL_VC",  
    "name": "Conn-1",  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "bandwidth": 1000,  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "QINQ",  
                "vlanCTag": 1001,  
                "vlanSTag": 1002  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "uuid": "4c4b8edf-873b-4c6c-805a-edb2c335bd6c"  
            },  
            "location": {  
                "metroCode": "SV"  
            },  
            "authenticationKey": "xx-xxx-xx",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "notifications": {  
        "type": "ALL",  
        "emails": [  
            "test@equinix.com",  
            "test2@equinix.com"  
        ]  
    }  
}'

请求正文中包含的参数仅适用于此示例。有关参数及其说明的完整列表，请参阅API 参考。

从Network Edge设备连接到阿里巴巴快递

要从您的网络边缘设备创建与阿里巴巴速卖通的连接，请向 /fabric/v4/connections 端点发送 POST 请求。在请求正文中指定连接的配置详细信息。

	`POST /fabric/v4/connections`
Method	`POST`
Endpoint	`/fabric/v4/connections`
Headers	`Authorization`, `Content-Type`
Path Parameters	Not applicable
Query Parameters	Not applicable
Body Parameters	`type`, `name`, `order`, `bandwidth`, `aSide`, `zSide`, `additionalInfo`, `notifications`

示例 cURL 请求：

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '  
{  
    "type": "EVPL_VC",  
    "name": "vd2Alibaba-vvv-0425b",  
    "bandwidth": "50",  
    "aSide": {  
        "accessPoint": {  
            "type": "VD",  
            "virtualDevice": {  
                "type": "EDGE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "type": "L2_PROFILE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            },  
            "location": {  
                "metroCode": "SV"  
            },  
            "authenticationKey": "XXXXXXXXXXXXXXX",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "X@gmail.com"  
            ]  
        }  
    ],  
    "project": {  
        "projectId": "16799d66-ef43-445c-ba29-d17522d8a137"  
    }  
}'

请求正文中包含的参数仅适用于此示例。有关参数及其说明的完整列表，请参阅API 参考。

{  
    "type": "EVPL_VC",  
    "href": "https://api.equinix.com/fabric/v4/connections/66ed4e8a-584c-4027-9788-748fecb5ce35",  
    "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
    "name": "vd2Alibaba-vvv-0425c",  
    "operation": {  
        "providerStatus": "PROVISIONING",  
        "equinixStatus": "PROVISIONING"  
    },  
    "order": {  
        "billingTier": "Up to 50 MB"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "X@gmail.com"  
            ]  
        }  
    ],  
    "changeLog": {  
        "createdBy": "fabricamcrh1",  
        "createdByFullName": "fabric amcrh1",  
        "createdByEmail": "X@gmail.com",  
        "createdDateTime": "2024-04-25T20:43:43.199Z",  
        "updatedBy": "fabricamcrh1",  
        "updatedByFullName": "fabric amcrh1",  
        "updatedByEmail": "X@gmail.com",  
        "updatedDateTime": "2024-04-25T20:43:43.199Z"  
    },  
    "bandwidth": 50,  
    "redundancy": {  
        "group": "160e06b5-cd42-4c2c-b674-6dcda54da4d8",  
        "priority": "PRIMARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "interface": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "id": 6,  
                "type": "CLOUD"  
            },  
            "location": {  
                "metroCode": "DC"  
            },  
            "virtualDevice": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "type": "EDGE"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "location": {  
                "metroCode": "SV"  
            },  
            "profile": {  
                "href": "https://api.equinix.com/fabric/v4/serviceProfiles/4c4b8edf-873b-4c6c-805a-edb2c335bd6c",  
                "type": "L2_PROFILE",  
                "name": "Alibaba Cloud Express Connect",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            },  
            "sellerRegion": "us-west-1",  
            "authenticationKey": "1111111111111"  
        }  
    }  
}  

响应有效负载包含在请求正文中定义的配置参数。有关所有可用参数及其说明的完整列表，请参阅API 参考。

监控连接状态

向 fabric/v4/connections/{connectionId} 端点发送 GET 请求以监控连接状态。

`equinixStatus` attribute values	`providerStatus` attribute values	Alibaba Cloud status	Description
`PROVISIONING`	`NOT_AVAILABLE`	-	Connection request has not been sent to Alibaba yet.
`PROVISIONED`	`PENDING_APPROVAL`	Pending creation	The connection awaits for approval.
`PROVISIONED`	`PROVISIONING / PROVISIONED`	Create in progress	Connection establishment in progress.
`PROVISIONED`	`PROVISIONED`	Active	Connection established.

接受并支付连接费用

登录阿里快递管理控制台。
从左侧菜单中，选择物理连接。
找到新创建的实例并单击 接受并付款。
创建虚拟边界路由器 (VBR) 实例并将其与以下设备关联： connection.

有关更多信息，请参阅计费 - 定价 | 阿里云文档中心。

识别您的阿里巴巴账户ID​

Fabric API 先决条件​

从 DOT1Q 端口连接到 Alibaba Express Connect​

从 QINQ 端口连接到阿里云 Express Connect​

从Network Edge设备连接到阿里巴巴快递​

监控连接状态​

接受并支付连接费用​

识别您的阿里巴巴账户ID

Fabric API 先决条件

从 DOT1Q 端口连接到 Alibaba Express Connect

从 QINQ 端口连接到阿里云 Express Connect

从Network Edge设备连接到阿里巴巴快递

监控连接状态

接受并支付连接费用