# 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がこの条件を満たさない場合は、別途注文リクエストを提出する必要があります。 ## 前提条件[​](#前提条件 "への直接リンク前提条件") 1. 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 ### Aサイド情報[​](#aサイド情報 "への直接リンクAサイド情報") 1. Cross Connect (Aサイド)の開始点のロケーション情報を[取得](https://docs.equinix.com/ja/api-catalog/lookupv2/lookup/get%20locations%20by%20permission%20code.md)エンドポイントを使用します。正確なIBX、ケージID、キャビネットIDを決定します。希望するすべてのCross Connectsが同じIBXとケージに属していることを確認してください。 このCross Connect用に機器にパッチを適用する場合、キャビネットIDは次のAサイドパラメータのリクエストで渡されます。`cabinetId`. Aサイドのロケーション情報がすでにお分かりの場合は、このステップを省略することができます。 2. [接続サービスの取得を](https://docs.equinix.com/ja/api-catalog/lookupv2/lookup/retrieve%20list%20of%20connection%20services.md)使用して、希望する場所のすべての接続サービス情報を取得します。選択したIBXで使用できる接続サービス、メディアタイプ、コネクタタイプ、およびプロトコルタイプを決定します。 これらの値は、以下のAサイドパラメータに対してリクエスト本文にも渡される。`connectionService`、`mediaType`、`connectorType`、。`protocolType` A側の接続サービス情報をすでにご存知の場合は、このステップを省略できます。 3. [パッチパネルの取得を](https://docs.equinix.com/ja/api-catalog/lookupv2/lookup/retrieve%20all%20patch%20panels.md)使用して、Aサイドの優先パッチパネルIDを決定します。この値は、次のAサイドパラメータ(PatchPanelの一部)のリクエスト本文で渡されます オブジェクト):`id`. 使用可能なポートやすべての接続サービスなど、パッチパネルの詳細については、「APIリファレンス」セクションの「[パッチパネルの取得{ patchPanelId}」を](https://docs.equinix.com/ja/api-catalog/lookupv2/lookup/retrieve%20patch%20panel%20details.md)参照してください。 すでにパッチパネル情報を知っている場合は、この手順を省略できます。 ### Zサイド情報[​](#zサイド情報 "への直接リンクZサイド情報") 1. [プロバイダの取得](https://docs.equinix.com/ja/api-catalog/lookupv2/lookup/retrieve%20list%20of%20providers.md)エンドポイントを使用して、利用可能なZサイドサービスプロバイダのリストを取得し、アカウント番号を決定します。 2. Cross Connect (zサイド)の接続先のロケーション情報を[取得](https://docs.equinix.com/ja/api-catalog/lookupv2/lookup/get%20locations%20by%20permission%20code.md)エンドポイントを使用します。正確なIBX、ケージID、キャビネットIDを決定します。希望するすべてのCross Connectsが同じIBXとケージに属していることを確認してください。 3. [接続サービスの取得を](https://docs.equinix.com/ja/api-catalog/lookupv2/lookup/retrieve%20list%20of%20connection%20services.md)使用して、希望する場所のすべての接続サービス情報を取得します。選択したIBXで使用できる接続サービス、メディアタイプ、コネクタタイプ、およびプロトコルタイプを決定します。 これらの値は、次のzサイドパラメータのリクエスト本文に渡されます。`connectorType`. 4. [パッチパネルの取得を](https://docs.equinix.com/ja/api-catalog/lookupv2/lookup/retrieve%20all%20patch%20panels.md)使用して、Aサイドの優先パッチパネルIDを決定します。この値は、次のAサイドパラメータ(PatchPanelの一部)のリクエスト本文で渡されます オブジェクト):`id`. 5. 回線IDケーブル参照番号については、サービスプロバイダにお問い合わせください。この値は、zサイドパラメータのリクエスト本文に渡されます。`circuitId` サーキットIDをすでにご存知の場合は、このステップを省略できます。 ## 承認書(LOA)なしで標準Cross Connectsを発注する[​](#承認書loaなしで標準cross-connectsを発注する "への直接リンク承認書(LOA)なしで標準Cross Connectsを発注する") 標準Cross Connectをオーダーするには、エンドポイントにリクエストを[`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/ja/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)送信します。`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 " -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リファレンスを](https://docs.equinix.com/ja/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)参照してください。 ## LOA付き標準Cross Connectのご注文[​](#loa付き標準cross-connectのご注文 "への直接リンクLOA付き標準Cross Connectのご注文") 標準Cross Connectをオーダーするには、エンドポイントにリクエストを[`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/ja/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)送信します。`POST` リクエスト本文に、AサイドのパッチパネルID、接続サービスの詳細、およびZサイドのコネクタタイプ、回路ID、パッチパネルID、LOAアタッチメットIDを指定してください。 details配列内の1つのオブジェクトが1つのCross Connectを表します。複数のCross Connectsをオーダーする場合は、details 配列に複数のオブジェクトを渡す。 添付ファイル付きのオーダーを作成する前に、[POST添付ファイルの](https://docs.equinix.com/ja/api-catalog/attachmentsv1/attachments/createattachment.md)エンドポイントを使用してください。 サンプルcURLリクエスト: ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -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リファレンスを](https://docs.equinix.com/ja/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)参照してください。 ## 標準Cross Connectのご注文 フル例[​](#標準cross-connectのご注文-フル例 "への直接リンク標準Cross Connectのご注文 フル例") 標準Cross Connectをオーダーするには、エンドポイントにリクエストを[`/colocations/v2/orders/crossConnects`](https://docs.equinix.com/ja/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)送信します。`POST` この例は、複数のアカウントを持つケージ内のアカウントから、LOAが添付された新しいサービスプロバイダへのCross Connectsの優先注文であり、他の添付ファイル、 情報、リクエストも含まれています。 添付ファイル付きのオーダーを作成する前に、[POST添付ファイルの](https://docs.equinix.com/ja/api-catalog/attachmentsv1/attachments/createattachment.md)エンドポイントを使用してください。 サンプルcURLリクエスト: ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/crossConnects" -H "content-type: application/json" -H "authorization: Bearer " -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リファレンスを](https://docs.equinix.com/ja/api-catalog/crossconnectsv2/cross-connects/order%20cross%20connects.md)参照してください。