创建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. 点击**+ 选择端口**，从当前项目中可用的端口列表中选择一个端口。点击选择端口。

   

点击下一步。

连接设置

在“连接设置”中：

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

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

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

服务令牌设置

在_服务令牌设置_中：

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

   

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

   

点击下一步。

审查

查看服务令牌_类型_，_连接设置_和_服务_令牌_设置_部分中的服务令牌信息。如果需要更改信息，请单击后退。

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

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

API

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

服务令牌设置

• expirationDateTime-以ISO 8601 datetime格式指定服务令牌的到期日期。有效期必须在接下来的90天内。
• notifications-指定对象中最多12个服务令牌的收件人notifications。设置notifications.type为NOTIFICATION并在中输入电子邮件notifications.emails。

连接设置

• allowRemoteConnection-设置allowRemoteConnection为true允许您的用户或客户从您的港口创建连接到不同的地铁目的地。设置为false将连接限制到与端口相同的Metro中的目标。
• 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 <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用于测试目的的查询参数。

服务令牌状态

创建服务令牌后，您可以检查其状态，包括是否已由您的用户或客户兑换。如果状态为Inactive，则服务令牌尚未兑换。如果状态为Active，则表示服务令牌已兑换。

如果状态为Expired，则服务令牌已到达到期日期，但您的用户或客户尚未兑换。

Portal

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

API

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

示例 cURL 请求：

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

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