クロスコネクト注文の作成
Cross Connectは、同一または異なるエクイニクスIBXデータセンター内の2つのお客様間を結ぶポイントツーポイントのケーブルリンクです。Cross Connectは、Cross Connect＆施設内ケーブルの発注権限を持つカスタマーポータルユーザーによってのみ発注できます。
このメソッドは、同じIBXロケーションまたは異なるIBXロケーションにある2つのエクイニクスのお客様（AサイドとZサイド）間のCross Connect注文リクエストを作成します。Aサイドのお客様がこのリクエストを開始し、Zサイドのプロバイダに接続します。
クロスコネクトは、1回の注文で単数または複数の数量を発注することができます。複数数量のクロスコネクトは、以下の条件を満たす場合のみ、1回の注文依頼で提出することができます：
- すべてのCross Connectは、同じA側のIBX、ケージ、口座から始まります。
- すべてのCross Connectは、同じZ側プロバイダ、IBX、ケージで終了する。
- 1回のリクエストにおけるCross Connectの総数が10を超えないこと。
注文したいCross Connectがこの条件を満たさない場合は、別途注文リクエストを提出する必要があります。
前提条件
- 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証を使用します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API認証を参照してください。
A面情報
-
GET Locationsエンドポイントを使用して、クロスコネクトの起点（a側）のロケーション情報を取得します。正確なIBX、ケージID、キャビネットIDを決定します。すべてのクロスコネクトが同じ IBX とケージに属していることを確認してください。
このCross Connectのために機器にパッチを当てたい場合、キャビネットIDは次のa-sideパラメータでリクエストに渡されます:
cabinetId。Aサイドの位置情報がすでに分かっている場合は、このステップを飛ばしてもよい。
-
GET 接続サービスを使用して、ご希望の場所のすべての接続サービス情報を取得します。選択した IBX で利用可能な接続サービス、メディア タイプ、コネクタ タイプ、およびプロトコル タイプを決定します。
これらの値は、以下のa-sideパラメータのリクエストボディにも渡されます：connectionService
、mediaType、connectorType、protocolType`。Aサイドの接続サービス情報をすでに知っている場合は、このステップを飛ばしてもよい。
-
GET PatchPanelsを使用して、a側の優先パッチパネルIDを決定します。この値は、以下のa-sideパラメータ（patchPanelの一部）のリクエストボディに渡されます。 オブジェクト)：id`.
利用可能なポートやすべての接続サービスなど、パッチパネルの詳細情報を取得したい場合は、APIリファレンスセクションのGET PatchPanels {patchPanelId}を参照してください。
すでにパッチパネルの情報を知っている場合は、このステップを飛ばしてもかまいません。
Z側情報
-
GET Providersエンドポイントを使用して、利用可能なサイド・サービス・プロバイダのリストを取得し、アカウント番号を決定します。
-
GET Locationsエンドポイントを使用して、クロスコネクト先（サイド）のロケーション情報を取得します。正確な IBX、ケージ ID、キャビネット ID を決定します。すべてのクロスコネクトが同じ IBX とケージに属していることを確認してください。
-
GET 接続サービスを使用して、ご希望の場所のすべての接続サービス情報を取得します。選択した IBX で利用可能な接続サービス、メディア タイプ、コネクタ タイプ、およびプロトコル タイプを決定します。
これらの値は、リクエストボディの
connectorTypeパラメータに渡されます。 -
GET PatchPanelsを使用して、a側の優先パッチパネルIDを決定します。この値は、以下のa-sideパラメータ（patchPanelの一部）のリクエストボディに渡されます。 オブジェクト)：id`.
-
サーキットIDケーブル参照番号については、サービスプロバイダーを参照してください。この値はリクエストボディの
circuitIdサイドパラメータに渡されます。サーキットIDをすでに知っている場合は、この手順を省略できます。
LOAなしの標準クロスコネクトのご注文
標準Cross Connectを注文するには、/colocation/v2/orders/crossConnectsエンドポイントにPOSTリクエストを送信します。
リクエスト本文に、A側パッチパネルID、接続サービスの詳細、Z側コネクタタイプ、回路ID、パッチパネルIDを指定する。
詳細配列の1つのオブジェクトは、1つのCross Connectを表します。複数のCross Connectを注文する場合は、詳細配列に複数のオブジェクトを渡します。
curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"details": [
{
"aSide": {
"connectionService": "SINGLE_MODE_FIBER",
"mediaType": "SINGLE_MODE_FIBER",
"protocolType": "10_GIG_ETHERNET",
"connectorType": "FC",
"patchPanel": {
"id": "CP:0104:1199890"
}
},
"zSide": {
"connectorType": "LC",
"circuitId": "1-12312312",
"patchPanel": {
"id": "PP:0104:1190123"
}
}
}
]
}'
リクエストボディに含まれるパラメータは、この例に特有のものです。パラメータの完全なリストとその説明については、API Referenceを参照してください。
LOA付き標準クロスコネクトのご注文
標準Cross Connectを注文するには、/colocation/v2/orders/crossConnectsエンドポイントにPOSTリクエストを送信します。
リクエスト本文に、A側パッチパネルID、接続サービスの詳細、Z側コネクタタイプ、回路ID、パッチパネルID、LOAアタッチメットIDを指定する。
詳細配列の1つのオブジェクトは、1つのCross Connectを表します。複数のCross Connectを注文する場合は、詳細配列に複数のオブジェクトを渡します。
添付ファイル付きの注文を作成する前に、POST Attachments File エンドポイントを使用してください。
サンプルcURLリクエスト：
curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"details": [
{
"aSide": {
"connectionService": "SINGLE_MODE_FIBER",
"mediaType": "SINGLE_MODE_FIBER",
"protocolType": "10_GIG_ETHERNET",
"connectorType": "FC",
"patchPanel": {
"id": "CP:0104:1199890"
}
},
"zSide": {
"providerName": "Acme Corporation",
"ibx": "AM1",
"loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba"
}
}
]
}'
リクエストボディに含まれるパラメータは、この例に特有のものです。パラメータの完全なリストとその説明については、API Referenceを参照してください。
標準クロスコネクトのご注文 フル例
標準Cross Connectを注文するには、/colocation/v2/orders/crossConnectsエンドポイントにPOSTリクエストを送信します。
この例は、複数のアカウントを持つケージのアカウントから、LOA添付の新しいサービスプロバイダーへのCross Connectのための迅速な注文で、その他の添付ファイル、情報、およびリクエストも含まれています。
添付ファイル付きの注文を作成する前に、POST Attachments File エンドポイントを使用してください。
サンプルcURLリクエスト：
curl -X
POST "https://api.equinix.com/colocations/v2/orders/crossConnects"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"details": [
{
"aSide": {
"connectionService": "SINGLE_MODE_FIBER",
"mediaType": "SINGLE_MODE_FIBER",
"protocolType": "10_GIG_ETHERNET",
"connectorType": "FC",
"mediaConverterRequired": false,
"ifcCircuitCount": 2,
"patchPanel": {
"id": "CP:0104:1199890",
"portA": 12,
"portB": 13
},
"patchEquipment": {
"cabinetId": "SG1:01:00EQ00:0001",
"connectorType": "FC",
"details": "Refer to attachment for patching details.",
"port": 10
}
},
"zSide": {
"providerName": "Acme Corporation",
"ibx": "PE2",
"connectorType": "LC",
"circuitId": "1-12312312",
"patchPanel": {
"id": "PP:0104:1190123",
"portA": 1,
"portB": 2
},
"loaAttachmentId": "fcb2k8763-2947-456e-8d68-f280753d60ba",
"notificationEmail": "johndoe@acme.com"
},
"verifyLink": true,
"circuitDeliveryDate": "2020-10-09T10:00:22.395Z",
"submarineEngineerRequired": true
}
],
"expediteDateTime": "2020-10-10T06:30:22.395Z",
"customerReferenceId": "EQX_CC_20201010",
"description": "Please refer to attachment for full details for this cross connects order.",
"attachments": [
{
"id": "85d9660a-f877-405a-b38e-8e61a4f77f44",
"name": "OrderInstructions.docx"
}
],
"purchaseOrder": {
"type": "NEW",
"number": "EQXPO_Ref9654284",
"amount": 10000,
"startDate": "2020-10-01",
"endDate": "2021-09-30",
"attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"
},
"contacts": [
{
"type": "NOTIFICATION",
"registeredUsers": [
"john_doe",
"john_doe1"
]
},
{
"type": "TECHNICAL",
"firstName": "Jane",
"lastName": "Doe",
"availability": "WORK_HOURS",
"timezone": "America/New_York",
"details": [
{
"type": "EMAIL",
"value": "janedoe@acme.com"
},
{
"type": "PHONE",
"value": "+1-987654321"
},
{
"type": "MOBILE",
"value": "+1-912345678"
}
]
}
]
}'
パラメータの完全なリストとその説明については、API リファレンスを参照してください。