使用两个服务令牌进行连接
您可以使用服务令牌中预定义的信息在资产或第三方之间建立连接。可以为连接的A端和Z端签发服务令牌。
例如,您可以创建从由 a 端服务令牌定义的源到由 z 端服务令牌定义的目标的连接。
先决条件
-
验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅API验证。
-
从服务提供商处获取 A 面服务令牌详细信息。
-
从提供商处获取 Z 端服务令牌详细信息。
调用创建连接 API 需要此信息。
创建从 A 侧到 Z 侧的服务令牌连接
要在服务令牌之间建立连接,请向端点发送POST请求/fabric/v4/connections。在请求正文中指定A端和Z端服务令牌详情。
注意
服务令牌可以发送给多个接收者,并且对于其中任何一个接收者来说都是一次有效的。
| 发布/fabric/v4/connections | |
|---|---|
| 方法 | POST |
| 端点 | /fabric/v4/connections |
| 标题 | Authorization,Content-Type |
| 路径参数 | 不适用 |
| 查询参数 | 不适用 |
| 身体参数 | type,name,order redundancy bandwidth,,aSide,zSide,notifications |
在不创建连接的情况下在Production中安全验证此请求,请参阅在Production中测试(API Dry Run)。
cURL 请求示例:
curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
"type": "EVPL_VC",
"name": "AST_TO_ZST_CONNECTION",
"order": {
"purchaseOrderNumber": "1-129105284100" },
"bandwidth": 100,
"redundancy": {
"priority": "PRIMARY" },
"aSide": {
"serviceToken": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5" }
},
"zSide": {
"serviceToken": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5" }
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test1@equinix.com" ]
}
]
}'
请求正文中包含的参数特定于此示例。参数及其说明的完整列表,请参见API参考手册。
示例回答:
{
"href": "https://api.equinix.com/fabric/v4/connections/b067f685-49b0-1a09-6fe0-360a5d00a",
"type": "EVPL_VC",
"uuid": "b067f685-49b0-1a09-6fe0-360a5d00a",
"name": "AST_TO_ZST_CONNECTION",
"state": "ACTIVE",
"operation": {
"providerStatus": "PROVISIONED",
"equinixStatus": "PROVISIONED" },
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com" ]
}
],
"account": {
"accountNumber": 201246,
"orgId": 92610,
"globalOrgId": "0017i000011X250AAC" },
"changeLog": {
"createdBy": "testuser",
"createdDateTime": "2022-05-16T07:50:49.749Z" },
"bandwidth": 100,
"redundancy": {
"group": "b067f685-49b0-1a09-6fe0-360a5d00afdg",
"priority": "PRIMARY" },
"isRemote": true,
"direction": "OUTGOING",
"aSide": {
"serviceToken": {
"href": "https://api.equinix.com/fabric/v4/serviceTokens/b067f685-49b0-1a09-6fe0-360a5d00afdg",
"uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg" },
"accessPoint": {
"location": {
"metroHref": "https://api.equinix.com/fabric/v4/metros/SV",
"metroCode": "SV" },
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/b067f685-49b0-1a09-6fe0-360a5d00afdg",
"uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg" },
"linkProtocol": {
"type": "DOT1Q" }
}
},
"zSide": {
"serviceToken": {
"href": "https://api.equinix.com/fabric/v4/serviceTokens/b067f685-49b0-1a09-6fe0-360a5d00afdg",
"uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg" },
"accessPoint": {
"location": {
"metroHref": "https://api.equinix.com/fabric/v4/metros/SV",
"metroCode": "SV" },
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/b067f685-49b0-1a09-6fe0-360a5d00afdg",
"uuid": "b067f685-49b0-1a09-6fe0-360a5d00afdg" },
"linkProtocol": {
"type": "DOT1Q" }
}
},
"order": {
"purchaseOrderNumber": "1122334",
"billingTier": "Up to 50 MB" }
}
响应负载包括在请求正文中定义的配置参数。有关可能参数及其说明的完整列表,请参阅API参考手册。
监控连接
使用获取指定的连接端点监控连接状态。