创建 Z-Side 服务令牌

Z侧服务令牌是允许Equinix Fabric上的其他客户与您建立连接的唯一密钥。

您可以为以下资产类型创建Z侧标记：

• 结构端口(EVPL和EPL类型)
• Network Edge 虚拟设备
• 多点网络- E－LAN，E－Tree和E－Access。

创建Z端服务令牌并与其他客户共享后，他们可以兑换令牌以创建与预定义为目的地的资产的连接。

兑换Z侧令牌的客户(原始A侧资产的所有者)在创建虚拟连接后将对其收费。Z-side服务令牌还可用于允许您所在组织中在不同项目中拥有资产的其他用户，以便他们可以连接到项目中的资产。

有关兑换Z端服务令牌的详细信息，请参阅兑换Z端服务令牌。

先决条件

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

• 客户门户帐户。
• 现有端口，虚拟设备或多点网络。
• 对您想要为其创建服务令牌的资产的访问权限。

Portal

1. 登录客户门户并导航至_Fabric Dashboard_。

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

   

3. 在"服务令牌类型"部分中，选择Z侧服务令牌。

   

选择要为其创建Z侧标记的资产类型：端口，虚拟设备或多点网络。

API

1. 身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 身份验证。有关如何调用OAuth API以验证和验证凭据的说明，请参阅API身份验证。

2. 确定Z侧资产信息。

   • 如果您使用的是端口，请向端点发送GET请求/fabric/v4/ports。您需要端口UUID，端口类型，链路协议类型(dot1q或QinQ)。

   • 如果您使用的是虚拟设备，请向端点发送GET请求/ne/v1/devices。您需要设备UUID。向端点发送GET请求/ne/v1/devices/{device_id}以获取设备的详细信息。您可以在设备上为您的连接选择任何可用接口。如果不指定一个接口，连接将自动分配给下一个可用接口。

   • 如果您使用的是多点网络，请向端点发送GET请求/fabric/v4/networks/{networkId}。您需要网络的类型和UUID。

为端口创建服务令牌

Portal

1. 在_Z-Side Asset_ (Z侧资产)下拉列表中，选择Port(端口)。

2. 单击**+选择端口并从列表中选择服务令牌的特定端口。单击选择端口**。

   

3. 点击下一步。

4. 在“连接设置”中：

   • 输入Z侧资产上连接的VLAN ID。
   • 选择要提供给令牌用户的带宽。点击“添加其他带宽”创建自定义带宽选项。
   • 选择是否允许远程连接。选中_Allow Remote Connections_ BOX (允许远程连接)以允许令牌用户从Z侧资产所在位置以外的城域网进行连接。

   

5. 在_服务令牌设置_中：

   • 输入服务令牌的到期日期。代币必须在此日期之前兑换，否则将过期。最大日期范围为90天。
   • 输入有权使用服务令牌的用户的电子邮件地址。您最多可以输入12个收件人。令牌只能由任何收件人使用一次。

   

6. 点击下一步。

7. 在"查看"页面上，查看_"服务令牌类型"和"服务令牌设置_"面板中的信息。

   

   准备就绪后，单击创建服务令牌。

API

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

• 在对象中connection，指定：

  • 基于底层端口的连接类型：EVPL_VC或EPL_VC。
  • 此令牌是否可用于创建远程连接。
  • 允许用于连接的带宽。
  • 此令牌是否允许将自定义带宽用于连接。

• 在对象中zSide，指定：

  • typeASCOLO。
  • 端口的UUID。
  • 端口的链路协议类型和相应的VLAN信息。

• 使用expirationDateTime该字段指定令牌以ISO 8601格式到期的日期和时间。

• 在对象中notifications，指定令牌收件人的电子邮件地址。

示例 cURL 请求：

curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
  "type": "VC_TOKEN",
  "name": "<service_token_name>",
  "description": "<service_token_description>",
  "connection": {
    "type": "EVPL_VC",
    "allowRemoteConnection": <boolean>,
    "allowCustomBandwidth": <boolean>,
    "supportedBandwidths": [
      <bandwidth_speed>,
      <bandwidth_speed>,
      <bandwidth_speed>
    ],
    "zSide": {
      "accessPointSelectors": [
        {
          "type": "COLO",
          "port": {
            "uuid": "<port_uuid>"
          },
          "linkProtocol": {
            "type": "DOT1Q",
            "vlanTag": "<vlan_ID>"
          }
        }
      ]
    }
  },
  "expirationDateTime": "<expiration_date>",
  "notifications": [
    {
      "type": "NOTIFICATION",
      "emails": [
        "<email_address>"
      ]
    }
  ]
}'

为虚拟设备创建服务令牌

Portal

1. 在_Z-Side Asset (Z侧资产_)下拉列表中，选择Virtual Device(虚拟设备)。

2. 选择虚拟设备类型：

   • 单一设备 - 单一实例虚拟设备。
   • 冗余设备-一对冗余虚拟设备。重要提示：要创建到冗余设备的冗余连接，必须为冗余对中的每个设备创建单独的服务令牌。
   • 集群——集群虚拟设备。

3. 单击**+选择虚拟设备并从列表中选择虚拟设备实例。单击Select Virtual Device**(选择虚拟设备)。

   

4. 点击下一步。

5. 在“连接设置”中：

   • 配置用于连接的接口。选择是使用下一个可用接口还是选择特定接口。
   • 选择要提供给令牌用户的带宽。点击“添加其他带宽”创建自定义带宽选项。
   • 选择是否允许远程连接。选中_Allow Remote Connections_ BOX (允许远程连接)以允许令牌用户从Z侧资产所在位置以外的城域网进行连接。

   

6. 在_服务令牌设置_中：

   • 输入服务令牌的到期日期。代币必须在此日期之前兑换，否则将过期。最大日期范围为90天。
   • 输入有权使用服务令牌的用户的电子邮件地址。您最多可以输入12个收件人。令牌只能由任何收件人使用一次。

   

7. 点击下一步。

8. 在"查看"页面上，查看_"服务令牌类型"和"服务令牌设置_"面板中的信息。

   

   准备就绪后，单击创建服务令牌。

API

要为虚拟设备创建Z侧服务令牌，请向端点发送POST请求/fabric/v4/serviceTokens。在请求正文中提供您的连接设置，虚拟设备详细信息和服务令牌设置。

• 在对象中connection，指定：

  • 此令牌是否可用于创建远程连接。
  • 允许用于连接的带宽。
  • 此令牌是否允许将自定义带宽用于连接。

• 在对象中zSide，指定：

  • typeASVD。
  • 虚拟设备UUID。
  • 用于服务令牌连接的接口。如果interface省略对象，设备上的下一个可用接口将用于连接。

• 使用expirationDateTime该字段指定令牌以ISO 8601格式到期的日期和时间。

• 在对象中notifications，指定令牌收件人的电子邮件地址。

示例 cURL 请求：

curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
  "type": "VC_TOKEN",
  "name": "<service_token_name>",
  "description": "<service_token_description>",
  "connection": {
    "type": "EVPL_VC",
    "allowRemoteConnection": <boolean>,
    "allowCustomBandwidth": <boolean>,
    "supportedBandwidths": [
      <bandwidth_speed>,
      <bandwidth_speed>,
      <bandwidth_speed>
    ],
    "zSide": {
      "accessPointSelectors": [
        {
          "type": "VD",
          "virtualDevice": {
            "type": "EDGE",
            "uuid": "<virtual_device_uuid>"
          },
          "interface": {
            "type": "NETWORK",
            "id": <interface_id>
          }
        }
      ]
    }
  },
  "expirationDateTime": "<expiration_date>",
  "notifications": [
    {
      "type": "NOTIFICATION",
      "emails": [
        "<email_address>"
      ]
    }
  ]
}'

为多点网络创建服务令牌

Portal

1. 在_Z-Side Asset_ (Z侧资产)下拉列表中，选择Multipoint Network(多点网络)。

2. 单击**+选择网络并从列表中选择多点网络。单击"Select Network**(选择网络)"。

   

3. 点击下一步。

4. 在“连接设置”中：

   • 请注意，从E-Tree服务令牌创建的连接将默认为Leaf。作为网络的所有者，您可以在服务令牌兑换并配置连接后编辑Root的连接角色。
   • 选择要提供给令牌用户的带宽。点击“添加其他带宽”创建自定义带宽选项。

   

5. 在_服务令牌设置_中：

   • 输入服务令牌的到期日期。代币必须在此日期之前兑换，否则将过期。最大日期范围为90天。
   • 输入有权使用服务令牌的用户的电子邮件地址。您最多可以输入12个收件人。令牌只能由任何收件人使用一次。

   

6. 点击下一步。

7. 在"查看"页面上，查看_"服务令牌类型"和"服务令牌设置_"面板中的信息。

   

   准备就绪后，单击创建服务令牌。

API

要为多点网络创建Z侧服务令牌，请向端点发送POST请求/fabric/v4/serviceTokens。在请求正文中提供您的连接设置，网络详细信息和服务令牌设置。

• 在对象中connection，指定：

  • 连接类型为EVPLAN_VC，或EPTREE_VC``EPLAN_VC，EVPTREE_VC具体取决于您的网络配置。
  • 此令牌是否可用于创建远程连接。
  • 允许用于连接的带宽。
  • 此令牌是否允许将自定义带宽用于连接。

• 在对象中zSide：

  • 指定type为NETWORK。
  • 将网络类型指示为EVPLAN，EPLAN，EVPTREE或EPTREE。
  • 提供网络的UUID。

• 使用expirationDateTime该字段指定令牌以ISO 8601格式到期的日期和时间。

• 在对象中notifications，指定令牌收件人的电子邮件地址。

示例 cURL 请求：

curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
  "type": "VC_TOKEN",
  "name": "<service_token_name>",
  "description": "<service_token_description>",
  "connection": {
    "type": "EVPLAN_VC",
    "allowRemoteConnection": <boolean>,
    "supportedBandwidths": [
      <bandwidth_speed>,
      <bandwidth_speed>,
      <bandwidth_speed>
    ],
    "zSide": {
      "accessPointSelectors": [
        {
          "type": "NETWORK",
          "network": {
            "type": "EVPLAN",
            "uuid": "<network_uuid>"
          }
        }
      ]
    }
  },
  "expirationDateTime": "<token_expiration_date>",
  "notifications": [
    {
      "type": "NOTIFICATION",
      "emails": [
        "<email_address>"
      ]
    }
  ]
}'

服务令牌状态

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

注意

使用Z侧令牌的连接的创建者将为此连接收取费用。

如果状态为Expired，则服务令牌已到达到期日期，但未兑换。

Portal

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

API

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

示例 cURL 请求：

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

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