デジタルLOAのリクエスト
Digital Letter of Authorization (LOA)は、第三者認証を必要とするサービスの便利な注文を可能にします。これにより、Cross-Connectなどの相互接続サービスの注文を処理する際に、AサイドとZサイドの両方からの関与が最小限に抑えられます。
このドキュメントは、Digital LOAをリクエストするAサイドパートナー向けです。サイド・パートナーがDigital LOAを作成する場合は、Request a Digital Letter of Authorizationを参照してください。
必須条件
-
認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証を使用します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API認証を参照してください。
-
Get Possible サイドパートナー。特定のIBXデータセンターに存在する潜在的なZサイドパートナーのリストを取得するには、Get Possible Connectionsエンドポイントを使用します。
リクエストの作成 - 既知のサイドパートナー
リクエストを作成するには、/diloa/v1/digitalLoas/loaRequest エンドポイントに POST リクエストを送信します。
このDigital LOAドキュメントを要求したいサイドパートナーがGet Possible ConnectionsエンドポイントへのGETリクエストのレスポンスにリストされている場合、provider.typeパラメータをCUSTOMER_ORGANIZATIONに設定し、その詳細を提供します。
POST /diloa/v1/digitalLoas/loaRequestsView the API Reference | |
|---|---|
| Method | POST |
| URL or End Point | /diloa/v1/digitalLoas/loaRequests |
| Headers | Content-Type |
| Query Parameters | Not applicable |
| Body Parameters | ibx, requestedNumber, requestor {contacts [{type, registeredUser, firstName, lastName, timezone, availability, details [{notes, value, type}]}]}, provider {type}, notes |
cURLリクエストのサンプル：
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas/loaRequest"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"ibx": "CH1",
"requestedNumber": 2,
"requestor": {
"contacts": [
{
"type": "NOTIFICATION",
"registeredUser": "Registered",
"firstName": "John",
"lastName": "Smith",
"timezone": "Australia/Perth",
"availability": "ANYTIME",
"details": [
{
"note": "new email address",
"value": "kyle@mail.com",
"type": "EMAIL"
}
]
}
]
},
"provider": {
"type": "CUSTOMER_ORGANIZATION",
"orgIds": [
"123456"
],
"name": "Michael Scott Paper Company",
"contacts": [
{
"type": "NOTIFICATION",
"registeredUser": "Registered",
"firstName": "John",
"lastName": "Smith",
"timezone": "Australia/Perth",
"availability": "ANYTIME",
"details": [
{
"note": "new email address",
"value": "kyle@mail.com",
"type": "EMAIL"
}
]
}
]
},
"notes": "No additional notes"
}'
リクエストボディに含まれるパラメータは、この例に特有のものです。パラメータの完全なリストとその説明については、APIリファレンスを参照してください。
リクエストの作成 - 新規サイドパートナー
リクエストを作成するには、/diloa/v1/digitalLoas/loaRequest エンドポイントに POST リクエストを送信します。
Get Possible ConnectionsエンドポイントへのGETリクエストのレスポンスに、このDigital LOA文書を発行したいサイドパートナーがリストされていないため、provider.typeパラメータをNEW_RELATIONSHIPに設定します。また、プロバイダの連絡先情報も入力してください。
cURLリクエストのサンプル：
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas/loaRequest"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"ibx": "CH1",
"requestedNumber": 2,
"requestor": {
"contacts": [
{
"type": "NOTIFICATION",
"registeredUser": "Registered",
"firstName": "John",
"lastName": "Smith",
"timezone": "Australia/Perth",
"availability": "ANYTIME",
"details": [
{
"note": "new email address",
"value": "kyle@mail.com",
"type": "EMAIL"
}
]
}
]
},
"provider": {
"type": "NEW_RELATIONSHIP",
"email": "mike@mspc.us",
"name": "Michael Scott Paper Company"
},
"notes": "No additional notes"
}'
リクエストボディに含まれるパラメータは、この例に特有のものです。パラメータの完全なリストとその説明については、APIリファレンスを参照してください。