使用服务令牌连接到 Fabric
通过兑换Z端服务令牌,从Network Edge设备连接到Fabric上的目标。您可以从转销商,运营商,服务提供商或其他Equinix Fabric客户处为您授予Z端服务令牌,以便您可以根据其基础设施或服务进行创建。
创建连接时,请选择虚拟设备及其连接设置,服务令牌将提供连接另一端的连接详细信息和配置。每个连接都需要自己的服务令牌。您可以使用两个单独的服务令牌从冗余或集群虚拟设备创建一对连接。
您Network Edge可以创建并共享Z端服务令牌。
先决条件
- Portal
- API
-
登录Equinix Customer Portal并导航至Network Edge控制面板。
-
单击创建连接。

-
身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅API验证。
-
使用或
/ne/v1/devices/{uuid}端点检索您的Network Edge设备信息/ne/v1/devices。从冗余设备进行连接,则需要主或辅助设备的UUID。从集群设备进行连接,则需要使用或的UUIDnode0``node1。每个服务令牌只能有一个连接。冗余或集群设备的额外连接需要额外的服务令牌。 -
检索服务令牌。
-
如果第三方共享了服务令牌,以便您可以连接到其基础设施或服务,则您需要提供他们已与其共享的服务令牌的UUID。
-
如果您使用您或组织中的其他人创建的服务令牌连接到自己的资产,可以从端点检索服务令牌的UUID
/fabric/v4/serviceTokens以及允许的连接设置。
-
建立连接
- Portal
- API
在“建立连接到:”页面上:
-
单击“使用服务令牌连接”卡上的“输入服务令牌”。

-
输入Z端服务令牌。验证_服务令牌详细信息_是否正确,然后单击兑换服务令牌。

-
单击下一步。
-
从_源资产类型_下拉菜单中,选择虚拟设备。
-
在_“源”_部分中,单击虚拟设备。
-
选择位置和虚拟设备类型。
- 如果您从单台设备进行连接,系统将为您选择单一连接选项。
- 从冗余设备或集群设备进行连接,您可以选择创建冗余连接。在_冗余目标_字段中输入第二个连接的服务令牌。
-
选择虚拟设备,然后单击下一步。

-
在_连接信息_页面上:
-
请输入连接名称。对于冗余连接,请在_“主要连接信息_”字段中输入主要连接的名称,在“次要连接信息”字段中输入次要连接的名称。
-
在_接口选择_部分中,选择在我的设备上自动选择下一个可用接口,或者我将选择一个接口。
-
_(可选)_输入购买订单编号。
-
选择_连接速度_。连接速度选项由服务令牌预定义。如果订购冗余连接,请同时选择_主要连接_速度和_次要连接_速度。
-
单击下一步。

-
-
在_“审核_”页面上,查看“预览”,“连接概要”和“定价概览”中的信息。在_通知_部分中,添加所有应接收有关此连接通知的用户的电子邮件地址。

-
单击提交订单。
要使用服务令牌在虚拟设备与Fabric上的其他网络位置之间建立连接,请向端点发送POST请求/fabric/v4/connections。
在对象中定义您的Network Edge设备aSide,包括:
accessPoint.typeasVDvirtualDevice.typeASEDGEvirtualDevice.uuid设备的UUID
在对象中提供服务令牌UUIDzSide。服务令牌提供建立连接所需的所有其他必要信息。
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": "<connection_name>",
"bandwidth": <connection_speed>,
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "<virtual_device_uuid>"
},
}
},
"zSide": {
"serviceToken": {
"uuid": "<service_token_uuid>"
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"<contact_email>",
"<contact_email>"
]
}
]
}'
监控连接状态
- Portal
- API
您可以在“连接清单”中监控新连接的状态。
使用/fabric/v4/connections/{connectionId}API端点监控连接状态。