创建A端服务令牌

服务令牌是唯一的 Equinix Fabric 密钥，用于授予互连资产授权。

A 端服务令牌允许用户或客户从您的 Fabric端口创建到 Fabric 上其他目标的连接。它支持聚合使用您的 A 端 Fabric端口，并且无需您（提供商或经销商）了解或注意每个连接的独特要求。

创建 A 端服务令牌，以授权使用您的Equinix Fabric端口，从而允许您的用户或客户连接到云提供商、网络提供商或任何其他Equinix Fabric目标。作为 A 端端口的所有者，您需要为兑换了您的 A 端令牌的用户或客户所配置的虚拟连接付费。

注意

如果提供商、经销商、运营商或服务提供商已与您共享 A 面服务令牌，请参阅兑换 A 面令牌。

要创建服务令牌，您必须具备以下条件：

• 拥有 Equinix Fabric 帐户，且具有以下角色之一：Fabric Manager、Fabric Connection Manager、Fabric Service Provider、Fabric Service Profile Manager 或 End Customer Fabric Manager。
• 授予对要为其创建服务令牌的端口的访问权限。
• 如果您使用 API，请通过交换您的客户端 ID 和客户端密钥来获取访问令牌，从而进行身份验证。有关详细信息，请参阅API 身份验证。

A面代币选项

连接设置：

• VLAN - 根据端口类型，您需要提供建立连接所需的封装和 VLAN 信息。如果您使用的是 Dot1q端口，请提供 VLAN ID。如果您使用的是 QinQ端口，请提供 VLAN S 标签和 C 标签。

• 最大带宽 - 指定连接的最大带宽。您的用户或客户可以将连接速度设置为不超过带宽限制的速度。

• 允许远程连接 - 指定是否允许远程连接到您的端口。如果允许远程连接，您的用户或客户可以创建终止于与您的端口不同的都会区 的连接。不允许远程连接会将连接限制为仅与端口位于同一都会区的目标。

服务令牌设置：

• 过期时间 - 您必须为服务令牌设置过期日期。您的客户或用户必须在过期日期之前使用该令牌创建连接。如果令牌过期，则无法用于创建连接，您必须创建一个新令牌。

• 服务令牌接收者 - 通过电子邮件将服务令牌发送给最多 12 位接收者。令牌为一次性使用；每个接收者中只有一位可以使用该令牌。

创建服务令牌

Portal

要创建 A 端服务令牌：

1. 登录客户门户 > Fabric 控制面板。

2. 从“服务令牌”菜单中，选择“创建服务令牌”。

服务令牌类型

1. 在“服务令牌类型”部分，选择 A-side 服务令牌。

2. 在 A 面资产 部分，端口 会自动选中。

   

3. 点击**+ 选择端口**，从当前项目中可用的端口列表中选择一个端口。点击选择端口。

   

   点击下一步。

   连接设置

   在“连接设置”中：

4. 请输入端口的VLAN信息。

5. 选择端口连接的最大带宽。

6. 要允许远程连接，请选中“允许远程连接”复选框。

服务令牌设置

在_服务令牌设置_中：

1. 输入或选择服务令牌的有效期。最长有效期为 90 天。

   

2. 请输入将接收此服务令牌的用户的电子邮件地址。此令牌每个接收者只能使用一次。

   

   点击下一步。

   审查

   请查看“服务令牌类型”、“连接设置”和“服务令牌设置”部分中的服务令牌信息。如果需要更改信息，请单击“返回”。

   :::info重要的 创建 A 端服务令牌并将其共享给用户或客户后，他们便拥有从该服务令牌定义的端口建立连接的完整权限。作为 A 端令牌的创建者和端口的所有者，您需要为用户或客户建立的连接支付费用。 :::

   当服务令牌信息正确时，单击创建服务令牌。

   

API

要创建 A 端服务令牌，请向 /fabric/v4/serviceTokens 端点发送 POST 请求。在请求正文中提供服务令牌设置、连接设置和端口详细信息。

服务令牌设置

• expirationDateTime - Specify the expiration date for your service token in ISO 8601 datetime format. The expiration must be within the next 90 days.
• notifications - Specify up to 12 recipients of the service token in the notifications object. Set notifications.type as NOTIFICATION and enter the emails in notifications.emails.

连接设置

• allowRemoteConnection - Setting allowRemoteConnection to true allows your user or customer to create connections from your port to destinations in different Metros. Setting to false limits connections to destinations in the same Metro as the port.
• bandwidthLimit - Use the bandwidthLimit parameter to set the maximum bandwidth for a connection created using this service token.

端口选择

• 在 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 <token>' 
-d '{
  "type": "VC_TOKEN",
  "expirationDateTime": "<token_expiration_date>",
  "connection": {
    "type": "EVPL_VC",
    "allowRemoteConnection": <boolean>,
    "bandwidthLimit": <bandwidth_value>,
    "aSide": {
      "accessPointSelectors": [
        {
          "type": "COLO",
          "port": {
            "uuid": "<port_uuid>"
          },
          "linkProtocol": {
            "type": "DOT1Q",
            "vlanTag": <vlan_id>
          }
        }
      ]
    }
  },
  "notifications": [
    {
      "type": "NOTIFICATION",
      "emails": [
        "<token_recipient_email>",
        "<token_recipient_email>"
      ]
    }
  ]
}'

注意

/fabric/v4/serviceTokens 端点支持用于测试目的的 dryRun 查询参数。

服务令牌状态

创建服务令牌后，您可以查看其状态，包括用户或客户是否已兑换该令牌。如果状态为“未激活”，则表示服务令牌尚未被兑换。如果状态为“已激活”，则表示服务令牌已被兑换。

如果状态为“已过期”，则表示服务令牌已达到其到期日，且尚未被您的用户或客户兑换。

Portal

要查看您的服务令牌状态，请登录客户门户并导航至您的服务令牌清单。

API

要检查服务令牌的状态，请向 /fabric/v4/serviceTokens 端点发送 GET 请求。响应中包含服务令牌列表，并在 state 字段中显示其状态。

示例 cURL 请求：

curl -X GET 'https://api.equinix.com/fabric/v4/serviceTokens'  
-H 'Authorization: Bearer <token>'

有关管理服务令牌的更多信息，请参阅服务令牌清单页面。