# 创建A端服务令牌 服务令牌是唯一的 Equinix Fabric 密钥,用于授予互连资产授权。 A端服务令牌允许用户或客户建立从Fabric端口到Fabric上其他目标的连接。它允许聚合使用您的A侧Fabric端口,并消除您(提供商或转销商)了解或了解每个连接的独特要求的必要性。 ![](https://docs.equinix.com/zh-Hans/assets/images/create-a-side-connections-f573b4bc220a74be54ca4473915a3633.png) 创建A侧服务令牌,以授权您使用Equinix Fabric端口,从而允许您的用户或客户连接到云提供商,网络提供商或任何其他Equinix Fabric目标。您作为A侧端口的所有者,您将为兑换A侧令牌的用户或客户配置的虚拟连接收取费用。 > **注意** > > A端服务令牌已由提供商,转销商,运营商或服务提供商与您共享,请参阅[兑换A侧令牌](https://docs.equinix.com/zh-Hans/fabric/service-tokens/redeem-a-side-service-token.md)。 要创建服务令牌,您必须具备以下条件: * 具有以下[角色](https://docs.equinix.com/zh-Hans/iam/roles-permissions/iam-roles-permission-reference.md)之一的Equinix Fabric账户:`Fabric Manager`,`Fabric Connection Manager`,`Fabric Service Provider`,`Fabric Service Profile Manager`或`End Customer Fabric Manager`。 * 授予对要为其创建服务令牌的端口的访问权限。 * 如果您使用的是API,请通过将客户端ID和客户端机密交换访问令牌来进行验证。有关详细信息,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 ## A面代币选项[​](#a面代币选项 "直接链接至A面代币选项") **连接设置**: * VLAN -根据端口类型,您需要提供建立连接所需的封装和VLAN信息。如果您使用的是Dot1q端口,请提供VLAN ID。如果您使用QinQ端口,请提供VLAN S-tag和C-tag。 * 最大带宽-指定连接的最大带宽。您的用户或客户能够将连接速度设置为最高带宽限制。 * 允许远程连接-指定是否允许远程连接到您的端口。如果您允许远程连接,则您的用户或客户可以创建终止在端口以外的都会区的连接。"不允许远程连接"将仅限制连接到与端口相同的都会区。 **服务令牌设置**: * 过期-您必须设置服务令牌的过期日期。您的客户或用户必须在到期日期之前使用令牌创建连接。令牌已过期,则无法用于创建连接,您必须创建新令牌。 * 服务令牌收件人-通过电子邮件将服务令牌发送给最多12个收件人。令牌仅限一次性使用;只有一个收件人能够使用该令牌。 ## 创建服务令牌[​](#创建服务令牌 "直接链接至创建服务令牌") * Portal * API 要创建A端服务令牌: 1. 登录[客户门户网站](https://portal.equinix.com/fabric)> *Fabric控制面板*。 2. 从\_服务令牌\_菜单中,选择**创建服务令牌**。 ![](https://docs.equinix.com/zh-Hans/assets/images/create-service-token-drop-down-a304f07e49d3e840e2fa4bbc3c39fb11.png) **服务令牌类型** 1. 在“*服务令牌类型*”部分中,选择**A侧服务令牌**。 2. 在\_A侧资产\_部分中,\_端口\_将自动选择。 ![](https://docs.equinix.com/zh-Hans/assets/images/create-a-side-token-type-722fc7b8136958bea744117984dfd143.png) 3. 单击\*\*+选择端口\*\*,从当前项目的合格端口列表中选择端口。单击**选择端口**。 ![](https://docs.equinix.com/zh-Hans/assets/images/create-a-side-select-port-edb2e22c39d3ee50a854548655e73d20.png) 单击**下一步**。 **连接设置** 在\_连接设置\_中: 1. 请输入端口的VLAN信息。 2. 选择端口连接的最大带宽。 3. 要允许远程连接,请勾选“*允许远程连接*”复选BOX。 ![](https://docs.equinix.com/zh-Hans/assets/images/create-a-side-connection-settings-154c21eefdbd81f1eadc47b2c7057820.png) **服务令牌设置** 在\_服务令牌设置\_中: 1. 输入或选择服务令牌的到期日期。最长到期时间为90天。 ![](https://docs.equinix.com/zh-Hans/assets/images/create-a-side-expiration-d201f7ded8c4a34adb146cf7543adc81.png) 2. 输入将接收此服务令牌的用户的电子邮件地址。任何收件人只能使用一次此令牌。 ![](https://docs.equinix.com/zh-Hans/assets/images/create-a-side-recipients-fc238c8b7b7897c476cd0aa30ba2539a.png) 单击**下一步**。 **审核** 在“*服务令牌类型*”,“*连接设置*”和\_“服务令牌设置\_”部分中查看服务令牌信息。如需更改信息,请单击**后退**。 :::info重要提示 创建 A 端服务令牌并将其与用户或客户共享后,他们就拥有从服务令牌定义的端口创建连接的完全权限。A端令牌的创建者和端口所有者将根据您的用户或客户建立的连接收取费用。 ::: 服务令牌信息正确后,单击**创建服务令牌**。 ![](https://docs.equinix.com/zh-Hans/assets/images/create-a-side-review-8c37f70ceaa964b65bc2b048a6da4148.png) 要创建A端服务令牌,请向端点发送`POST`请求[`/fabric/v4/serviceTokens`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/service-tokens/createservicetoken.md)。在请求正文中提供您的服务令牌设置,连接设置和端口详细信息。 **服务令牌设置** * `expirationDateTime`-以ISO 8601 datetime格式指定服务令牌的到期日期。到期日期必须在接下来的90天内。 * `notifications`-在对象中指定最多12个服务令牌的收件人`notifications`。将电子邮件设`notifications.type`为`NOTIFICATION`并在中输入电子邮件`notifications.emails`。 **连接设置** * `allowRemoteConnection`-设置`allowRemoteConnection`为`true`允许您的用户或客户创建从您的端口到不同都会区的目标的连接。将`false`连接限制到与端口位于同一都会区的目标。 * `bandwidthLimit`-使用`bandwidthLimit`参数设置使用此服务令牌创建的连接的最大带宽。 **端口选择** * 在对象中指定授予访问权限的端口`aSide.accessPointSelectors`。设置`accessPointSelectors.type`为`COLO`。在中指定端口`port.uuid`。 * 使用`linkProtocol`对象指定端口的封装和VLAN详细信息。 cURL 请求示例: ``` curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens' -H 'Content-Type: application/json' -H 'Authorization: Bearer ' -d '{ "type": "VC_TOKEN", "expirationDateTime": "", "connection": { "type": "EVPL_VC", "allowRemoteConnection": , "bandwidthLimit": , "aSide": { "accessPointSelectors": [ { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "DOT1Q", "vlanTag": } } ] } }, "notifications": [ { "type": "NOTIFICATION", "emails": [ "", "" ] } ] }' ``` > **注意** > > `/fabric/v4/serviceTokens`出于测试目的,端点支持[`dryRun`查询参数](https://docs.equinix.com/zh-Hans/equinix-api/testing/testing-in-production-dry-run.md)。 ## 服务令牌状态[​](#服务令牌状态 "直接链接至服务令牌状态") 服务令牌创建完毕后,可以检查其状态,包括是否已由您的用户或客户兑换。如果状态为`Inactive`,则服务令牌尚未兑换。如果状态为`Active`,则表示服务令牌已兑换。 如果状态为`Expired`,则服务令牌已到达到期日,您的用户或客户尚未兑换。 * Portal * API 要检查服务令牌状态,请登录[客户门户网站](https://portal.equinix.com/fabric)并导航至[服务令牌清单](https://docs.equinix.com/zh-Hans/fabric/service-tokens/service-token-inventory.md) ![](https://docs.equinix.com/zh-Hans/assets/images/create-a-side-inventory-ffd1e8fb00db4b9dfc7b80726bb1bb35.png) 要检查服务令牌的状态,请向端点发送`GET`请求[`/fabric/v4/serviceTokens`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/service-tokens/getservicetokens.md)。响应包括您的服务令牌列表及其在字段中的状态`state`。 cURL 请求示例: ``` curl -X GET 'https://api.equinix.com/fabric/v4/serviceTokens' -H 'Authorization: Bearer ' ``` 有关管理服务[令牌](https://docs.equinix.com/zh-Hans/fabric/service-tokens/service-token-inventory.md)的更多信息,请参阅[服务令牌清单](https://docs.equinix.com/zh-Hans/fabric/service-tokens/service-token-inventory.md)页面。