Cross Connectオーダーを作成
Cross Connectは、同じまたは異なるEquinix IBXデータセンター内の2人の顧客間のポイントツーポイントケーブルリンクです。Cross Connectsは、Cross Connectおよび施設内ケーブルの発注権限を持つカスタマーポータルユーザーのみが発注できます。
この方法では、同じまたは異なるIBX拠点にある2つのEquinix顧客(AサイドとZサイド)間でCross Connectsオーダーリクエストが作成されます。Aサイドのお客様は、Zサイドのプロバイダに接続するためにこのリクエストを開始します。
1回のリクエストで1つまたは複数のCross Connectsをオーダーできます。複数数量のCross Connectsは、以下の条件を満たしている場合、1つのオーダーリクエストでのみ送信できます。
- すべてのCross Connectは、同じAサイドのIBX、ケージ、口座から始まります。
- すべてのCross Connectは、同じZサイドプロバイダ、IBX、ケージで終了します。
- 1回のリクエストにおけるCross Connectの総数が10を超えないこと。
注文したいCross Connectがこの条件を満たさない場合は、別途注文リクエストを提出する必要があります。
前提条件
- 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「API認証」を参照してください。
Aサイド情報
-
Cross Connect (Aサイド)の開始点のロケーション情報を取得エンドポイントを使用します。正確なIBX、ケージID、キャビネットIDを決定します。希望するすべてのCross Connectsが同じIBXとケージに属していることを確認してください。
このCross Connect用に機器にパッチを適用する場合、キャビネットIDは次のAサイドパラメータのリクエストで渡されます。
cabinetId.Aサイドのロケーション情報がすでにお分かりの場合は、このステップを省略することができます。
-
接続サービスの取得を使用して、希望する場所のすべての接続サービス情報を取得します。選択したIBXで使用できる接続サービス、メディアタイプ、コネクタタイプ、およびプロトコルタイプを決定します。
これらの値は、以下のAサイドパラメータに対してリクエスト本文にも渡される。
connectionService、mediaType、connectorType、。protocolTypeA側の接続サービス情報をすでにご存知の場合は、このステップを省略できます。
-
パッチパネルの取得を使用して、Aサイドの優先パッチパネルIDを決定します。この値は、次のAサイドパラメータ(PatchPanelの一部)のリクエスト本文で渡されます オブジェクト):
id.使用可能なポートやすべての接続サービスなど、パッチパネルの詳細については、「APIリファレンス」セクションの「パッチパネルの取得{ patchPanelId}」を参照してください。
すでにパッチパネル情報を知っている場合は、この手順を省略できます。
Zサイド情報
-
プロバイダの取得エンドポイントを使用して、利用可能なZサイドサービスプロバイダのリストを取得し、アカウント番号を決定します。
-
Cross Connect (zサイド)の接続先のロケーション情報を取得エンドポイントを使用します。正確なIBX、ケージID、キャビネットIDを決定します。希望するすべてのCross Connectsが同じIBXとケージに属していることを確認してください。
-
接続サービスの取得を使用して、希望する場所のすべての接続サービス情報を取得します。選択したIBXで使用できる接続サービス、メディアタイプ、コネクタタイプ、およびプロトコルタイプを決定します。
これらの値は、次のzサイドパラメータのリクエスト本文に渡されます。
connectorType. -
パッチパネルの取得を使用して、Aサイドの優先パッチパネルIDを決定します。この値は、次のAサイドパラメータ(PatchPanelの一部)のリクエスト本文で渡されます オブジェクト):
id. -
回線IDケーブル参照番号については、サービスプロバイダにお問い合わせください。この値は、zサイドパラメータのリクエスト本文に渡されます。
circuitIdサーキットIDをすでにご存知の場合は、このステップを省略できます。
承認書(LOA)なしで標準Cross Connectsを発注する
標準Cross Connectをオーダーするには、エンドポイントにリクエストを/colocations/v2/orders/crossConnects送信します。POST
リクエストの本文で、サイドのパッチパネルID、接続サービスの詳細、およびサイドのコネクタタイプ、回路ID、パッチパネルIDを指定してください。
details配列内の1つのオブジェクトが1つのCross Connectを表します。複数のCross Connectsをオーダーする場合は、details 配列に複数のオブジェクトを渡す。
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リファレンスを参照してください。
LOA付き標準Cross Connectのご注文
標準Cross Connectをオーダーするには、エンドポイントにリクエストを/colocations/v2/orders/crossConnects送信します。POST
リクエスト本文に、AサイドのパッチパネルID、接続サービスの詳細、およびZサイドのコネクタタイプ、回路ID、パッチパネルID、LOAアタッチメットIDを指定してください。
details配列内の1つのオブジェクトが1つのCross Connectを表します。複数のCross Connectsをオーダーする場合は、details 配列に複数のオブジェクトを渡す。
添付ファイル付きのオーダーを作成する前に、POST添付ファイルのエンドポイントを使用してください。
サンプル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リファレンスを参照してください。
標準Cross Connectのご注文 フル例
標準Cross Connectをオーダーするには、エンドポイントにリクエストを/colocations/v2/orders/crossConnects送信します。POST
この例は、複数のアカウントを持つケージ内のアカウントから、LOAが添付された新しいサービスプロバイダへのCross Connectsの優先注文であり、他の添付ファイル、 情報、リクエストも含まれています。
添付ファイル付きのオーダーを作成する前に、POST添付ファイルのエンドポイントを使用してください。
サンプル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リファレンスを参照してください。