创建数字 LOA
电子授权书 (LOA) 方便订购需要第三方提供的服务。 授权。它最大限度地减少了A端和Z端在处理订单时的参与度。 互联服务，例如 Cross Connect。
本文档适用于创建数字授权书的z方合作伙伴。如果您是a方合作伙伴，希望从z方合作伙伴处获得数字授权书，请参阅申请数字授权书。
先决条件
-
身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥 身份验证。请参阅API身份验证以获取有关如何调用OAuth API来验证和认证您的凭据的说明。
-
（可选）获取可能的 A 方合作伙伴。使用 获取可能的连接 端点检索指定 IBX 数据中心中存在的 A 方合作伙伴列表。
创建Digital LOA - 现有 A 方关系
要创建数字 LOA，请向 /diloa/v1/digitalLoas 端点发送 POST 请求。在请求正文中指定 A 方合作伙伴和连接详细信息。
API specification for "diloav1" not found.
如果您要向其签发此电子版授权书的A方客户已列入回复中，则
对 Get Possible Connections 端点发出 GET 请求时，将 requestor.type 参数设置为 CUSTOMER_ORGANIZATION。
在 requestor.ids 参数中，指定有权使用此数字 LOA 文档的客户组织。
cURL 请求示例：
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"products": [
{
"type": "CROSS_CONNECT",
"crossConnect": {
"connectionService": "UTP",
"mediaType": "CAT6",
"protocolType": "ETHERNET",
"zSide": {
"connectorType": "RJ45",
"patchPanelId": "PP:0000:6256843",
"circuitId": "34234535",
"portA": 4
}
}
}
],
"requestor": {
"type": "CUSTOMER_ORGANIZATION",
"contacts": [
{
"type": "NOTIFICATION",
"details": [
{
"value": "jane@xyz.com",
"type": "EMAIL"
}
]
}
],
"orgIds": [
"123412",
"223124"
],
"name": "XYZ Company"
},
"provider": {
"contacts": [
{
"type": "NOTIFICATION",
"firstName": "John",
"lastName": "Smith",
"timezone": "America/Los_Angeles",
"details": [
{
"value": "john@smith.com",
"type": "EMAIL"
}
]
}
]
},
"notes": "",
"expiryDateTime": "2022-07-31T21:59:59.999Z"
}'
请求正文中包含的参数仅适用于此示例。有关参数及其说明的完整列表，请参阅API 参考。
示例回答：
{
"token": "<token>",
"uuid": "079dc798-05e8-11ed-b939-0242ac120002",
"state": "READY_FOR_USE",
"draft": false,
"changeLog": {
"createdDateTime": 2018-05-24T18:19:59.999Z
},
"link": {
"rel": "info",
"href": "https://ic-core-prod-ingress-usw1.clouda.equinix.com:80/diloa/v2/digitalLoas/402cbf99-97d7-440f-8291-1a4b9639154a",
"method": "GET",
"contentType": "application/json",
"authenticate": true
},
"expiryDateTime": 2018-06-24T18:19:59.999Z,
"href": "diloa/v1/digitalLoas/079dc798-05e8-11ed-b939-0242ac120002"
}
响应有效负载包含在请求正文中定义的配置参数。有关所有可用参数及其说明的完整列表，请参阅API 参考。
创建Digital LOA - 新的 A 方关系
要创建数字 LOA，请向 /diloa/v1/digitalLoas 端点发送 POST 请求。请在请求正文中指定连接详细信息。
由于您要向其签发此电子版授权书的A方客户未列在回复中，因此
向 Get Possible Connections 端点发送 GET 请求，并将 requestor.type 参数设置为 NEW_RELATIONSHIP。同时提供他们的联系信息。
cURL 请求示例：
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas"
-H "content-type: application/json"
-H "Authorization: Bearer {Access Token}"
-d '{
"products": [
{
"type": "CROSS_CONNECT",
"crossConnect": {
"connectionService": "UTP",
"mediaType": "CAT6",
"protocolType": "ETHERNET",
"zSide": {
"connectorType": "RJ45",
"patchPanelId": "PP:0000:6256843",
"circuitId": "34234535",
"portA": 4
}
}
}
],
"requestor": {
"type": "NEW_RELATIONSHIP",
"email": "jane@xyz.com",
"name": "XYZ Company"
},
"provider": {
"contacts": [
{
"type": "NOTIFICATION",
"firstName": "John",
"lastName": "Smith",
"timezone": "America/Los_Angeles",
"details": [
{
"value": "john@smith.com",
"type": "EMAIL"
}
]
}
]
},
"notes": "",
"expiryDateTime": "2022-07-31T21:59:59.999Z"
}'
请求正文中包含的参数仅适用于此示例。有关参数及其说明的完整列表，请参阅API 参考。
授权使用Digital LOA
此步骤适用于新的A方客户关系。创建Digital LOA文档后，A方将收到一封包含授权链接的电子邮件通知。
A方验证并批准数字授权书后，向/diloa/v1/digitalLoas/{id}/actions端点发送GET请求。在请求路径中指定数字授权书，并在请求正文中将type设置为AUTHORIZE。
API specification for "diloav1" not found.
cURL 请求示例：
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas/{id}/actions"
-H "Authorization: Bearer <token>"
-d '{
"type": "AUTHORIZE"
}'
请求正文中包含的参数仅适用于此示例。有关参数及其说明的完整列表，请参阅API 参考。
监控Digital LOA状态
使用 /diloa/v1/digitalLoas/{id} API 请求来监控 LOA 文档的状态。有关可能状态的信息，请参阅 数字 LOA 状态。