# 使用服务令牌连接到 Fabric 通过兑换Z端服务令牌,从Network Edge设备连接到Fabric上的目标。您可以从转销商,运营商,服务提供商或其他Equinix Fabric客户处为您授予Z端服务令牌,以便您可以根据其基础设施或服务进行创建。 创建连接时,请选择虚拟设备及其连接设置,服务令牌将提供连接另一端的连接详细信息和配置。每个连接都需要自己的服务令牌。您可以使用两个单独的服务令牌从冗余或集群虚拟设备创建一对连接。 > **注意** > > 您Network Edge可以创建[并共享Z端服务令牌](https://docs.equinix.com/zh-Hans/fabric/service-tokens/create-z-side-token.md)。 ## 先决条件[​](#先决条件 "直接链接至先决条件") * Portal * API 1. 登录[Equinix Customer Portal](https://portal.equinix.com/)并导航至Network Edge控制面板。 2. 单击**创建连接**。 ![](https://docs.equinix.com/zh-Hans/assets/images/service-provider-create-connection-49f02d48309fc652e6b31fbd69a326fd.png) 1. 身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 2. 使用或[`/ne/v1/devices/{uuid}`](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/getvirtualdevices)端点检索您的Network Edge设备信息[`/ne/v1/devices`](https://docs.equinix.com/zh-Hans/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid)。从冗余设备进行连接,则需要主或辅助设备的UUID。从集群设备进行连接,则需要使用或的UUID`node0``node1`。每个服务令牌只能有一个连接。冗余或集群设备的额外连接需要额外的服务令牌。 3. 检索服务令牌。 * 如果第三方共享了服务令牌,以便您可以连接到其基础设施或服务,则您需要提供他们已与其共享的服务令牌的UUID。 * 如果您使用您或组织中的其他人创建的服务令牌连接到自己的资产,可以从端点检索服务令牌的UUID[`/fabric/v4/serviceTokens`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/service-tokens/getservicetokens.md)以及允许的连接设置。 ## 建立连接[​](#建立连接 "直接链接至建立连接") * Portal * API 在“*建立连接到:*”页面上: 1. 单击“*使用服务令牌连接*”卡上的“**输入服务令牌**”。 ![](https://docs.equinix.com/zh-Hans/assets/images/service-token-connections-menu-96ae3f5091bbcf89410c63c92be6c66a.png) 2. 输入Z端服务令牌。验证\_服务令牌详细信息\_是否正确,然后单击**兑换服务令牌**。 ![](https://docs.equinix.com/zh-Hans/assets/images/service-token-redeem-344e66b23c8acb912cc900be97ceb66a.png) 1. 单击**下一步**。 2. 从\_源资产类型\_下拉菜单中,选择**虚拟设备**。 3. 在\_“源”\_部分中,单击**虚拟设备**。 4. 选择位置和虚拟设备类型。 * 如果您从单台设备进行连接,系统将为您选择单一连接选项。 * 从冗余设备或集群设备进行连接,您可以选择创建冗余连接。在\_冗余目标\_字段中输入第二个连接的服务令牌。 5. 选择虚拟设备,然后单击**下一步**。 ![](https://docs.equinix.com/zh-Hans/assets/images/service-token-virtual-device-fe4db02711276df460318a5122625160.png) 6. 在\_连接信息\_页面上: * 请输入连接名称。对于冗余连接,请在\_“主要连接信息\_”字段中输入主要连接的名称,在“*次要连接信息*”字段中输入次要连接的名称。 * 在\_接口选择\_部分中,选择**在我的设备上自动选择下一个可用接口**,或者**我将选择一个接口**。 * \_(可选)\_输入购买订单编号。 * 选择\_连接速度\_。连接速度选项由服务令牌预定义。如果订购冗余连接,请同时选择\_主要连接\_速度和\_次要连接\_速度。 * 单击**下一步**。 ![](https://docs.equinix.com/zh-Hans/assets/images/service-token-connection-info-8c09f23678501108dafe7a21853c4e1e.png) 7. 在\_“审核\_”页面上,查看“预览”,“连接概要”和“定价概览”中的信息。在\_通知\_部分中,添加所有应接收有关此连接通知的用户的电子邮件地址。 ![](https://docs.equinix.com/zh-Hans/assets/images/service-token-review-41a501edf2fa8a66a48c64e247a04899.png) 8. 单击**提交订单**。 要使用服务令牌在虚拟设备与Fabric上的其他网络位置之间建立连接,请向端点发送`POST`请求[`/fabric/v4/connections`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/createconnection.md)。 在对象中定义您的Network Edge设备`aSide`,包括: * `accessPoint.type` as `VD` * `virtualDevice.type`AS`EDGE` * `virtualDevice.uuid` 设备的UUID 在对象中提供服务令牌UUID`zSide`。服务令牌提供建立连接所需的所有其他必要信息。 cURL 请求示例: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "aSide": { "accessPoint": { "type": "VD", "virtualDevice": { "type": "EDGE", "uuid": "" }, } }, "zSide": { "serviceToken": { "uuid": "" } }, "notifications": [ { "type": "ALL", "emails": [ "", "" ] } ] }' ``` ## 监控连接状态[​](#监控连接状态 "直接链接至监控连接状态") * Portal * API 您可以在“[*连接清单”*](https://docs.equinix.com/zh-Hans/fabric/managing-connections/fabric-new-connections-inventory.md)中监控新连接的状态。 使用[`/fabric/v4/connections/{connectionId}`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/connections/getconnectionbyuuid.md)API端点监控连接状态。