# API - IBM Cloud Direct Link on Classic への接続 Classic の IBM Cloud™ Direct Link を使用して接続を確立し、IBX コロケーション資産を IBM Cloud リソースに接続します。 ![](https://docs.equinix.com/ja/assets/images/connectToIbmDirectLink20-d03a5f72aff4e50771a2f6d848d6952d.jpg) ## IBMアカウントIDの確認[​](#ibmアカウントidの確認 "への直接リンクIBMアカウントIDの確認") [IBM Cloudコンソール](https://cloud.ibm.com/login)にログインし、[*管理]*>[\_アカウント]を\_選択して、IBMアカウントIDを確認します。 ## Fabric API の前提条件[​](#fabric-api-の前提条件 "への直接リンクFabric API の前提条件") 1. 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。OAuth APIを呼び出して認証情報を検証および認証する方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 2. Aサイド情報を決定します。[Get All Ports](https://docs.equinix.com/ja/api-catalog/fabricv4/ports/getports.md) APIリクエストを使用して、Equinix Fabricポート情報を取得します。 3. Zサイドの都市圏の拠点を選択します。[[すべての都市圏を取得]](https://docs.equinix.com/ja/api-catalog/fabricv4/metros/getmetros.md)APIリクエストを使用して、Equinix Fabricが利用可能なすべての都市圏を検索し、接続先の場所を決定します。 4. サービスプロファイルを特定します。特定のサービス[プロファイルを](https://docs.equinix.com/ja/api-catalog/fabricv4/service-profiles/searchserviceprofiles.md)検索するには、\[Retrieve Service Profiles API[(サービスプロファイルの](https://docs.equinix.com/ja/api-catalog/fabricv4/service-profiles/listserviceprofiles.md)\[取得)]]\(/api-catalog/fabricv4/service-profiles/searchserviceprofiles)リクエストを使用するか、\[[List Service Profiles](https://docs.equinix.com/ja/api-catalog/fabricv4/service-profiles/listserviceprofiles.md) API\[(サービスプロファイルの一覧表示)]]\(/api-catalog/fabricv4/service-profiles/listserviceprofiles)リクエストを使用して、 接続先のプロフィール ## DOT1QポートからClassic上のIBM Cloud Direct Linkへの接続[​](#dot1qポートからclassic上のibm-cloud-direct-linkへの接続 "への直接リンクDOT1QポートからClassic上のIBM Cloud Direct Linkへの接続") Dot1QポートからClassicのIBM Cloud Direct Linkへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`リクエストの本文で接続の構成の詳細を指定します。 | | **POST/ファブリック/v4/connections** | | ------------------ | ------------------------------------------------------------------------------------------------------- | | 方法 | `POST` | | エンドポイント | `/fabric/v4/connections` | | ヘッダー | `Authorization`、`Content-Type` | | パスパラメータ | 該当なし | | クエリーパラメータ | 該当なし | | ボディパラメータ | `type``name`、、`order`、、`bandwidth`、`redundancy``aSide`、`zSide`、、`additionalInfo``notifications` | サンプルcURLリクエスト: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{     "type": "EVPL_VC",     "name": "Conn-1",     "order": {         "purchaseOrderNumber": "1-129105284100"     },     "bandwidth": 1000,     "redundancy": {         "priority": "PRIMARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "DOT1Q",                 "vlanTag": 1001             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "metroCode": "SV"             },             "authenticationKey": "xx-xxx-xx",             "sellerRegion": "us-west-1"         }     },     "additionalInfo": [         {             "key": "ASN",             "value": "12345"         },         {             "key": "Global",             "value": "false"         }     ],     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test2@equinix.com"             ]         }     ] }' ``` リクエスト本文に含まれるパラメータは、この例に固有のものです。パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)参照してください。 回答例 ``` {     "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "type": "EVPL_VC",     "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "name": "Conn-1",     "state": "PROVISIONING",     "order": {         "purchaseOrderNumber": "1-129105284100",         "billingTier": "Up to 1 Gbps"     },     "bandwidth": 1000,     "redundancy": {         "group": "m167f685-41b0-1b07-6de0-320a5c00abeu",         "priority": "PRIMARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",                 "type": "XF_PORT",                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "DOT1Q",                 "vlanTag": 1001             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "href": "https://api.equinix.com/fabric/v4/services/serviceProfiles/20d32a80-0d61-4333-bc03-707b591ae2f5",                 "type": "L2_PROFILE",                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "href": "https://api.equinix.com/v4/metros/SV",                 "metroCode": "SV",                 "region": "AMER"             },             "sellerRegion": "us-west-1"         }     },     "additionalInfo": [         {             "key": "ASN",             "value": "12345"         },         {             "key": "Global",             "value": "false"         }     ],     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test2@equinix.com"             ]         }     ],     "operation": {         "equinixStatus": "PROVISIONING",         "providerStatus": "PROVISIONING"     },     "changeLog": {         "createdDateTime": "2021-07-15T19:30:29.526Z"     } } ``` 応答ペイロードには、リクエスト本文で定義された構成パラメータが含まれます。使用可能なパラメータの全リストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)参照してください。 ## QINQポートからClassicのIBM Cloud Direct Linkへの接続[​](#qinqポートからclassicのibm-cloud-direct-linkへの接続 "への直接リンクQINQポートからClassicのIBM Cloud Direct Linkへの接続") ClassicのQinQポートからIBM Cloud Direct Linkへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`リクエストの本文で接続の構成の詳細を指定します。 ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{     "type": "EVPL_VC",     "name": "Conn-1",     "order": {         "purchaseOrderNumber": "1-129105284100"     },     "bandwidth": 1000,     "redundancy": {         "priority": "PRIMARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "QINQ",                 "vlanCTag": 1001,                 "vlanSTag": 1002             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "metroCode": "SV"             },             "authenticationKey": "xx-xxx-xx",             "sellerRegion": "us-west-1"         }     },     "additionalInfo": [         {             "key": "ASN",             "value": "12345"         },         {             "key": "Global",             "value": "false"         }     ],     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test2@equinix.com"             ]         }     ] }' ``` リクエスト本文に含まれるパラメータは、この例に固有のものです。パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)参照してください。 ## 接続ステータスの監視[​](#接続ステータスの監視 "への直接リンク接続ステータスの監視") 接続ステータスを監視するリクエストを[`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/getconnectionbyuuid.md)エンドポイントに送信します。`GET` | `equinixStatus`属性値 | `providerStatus`属性値 | **IBMダイレクトリンク**のステータス | **説明** | | ----------------------- | ---------------------------- | ----------------------------------- | --------------------------------------- | | `PROVISIONING` | `PROVISIONING` | - | 接続要求はまだIBMに送信されていません。 | | `PENDING_PROVIDER_VLAN` | `PENDING_APPROVAL` | 承認待ち | 接続は承認待ち。 | | `PROVISIONED` | `PROVISIONING / PROVISIONED` | 作成中 | 接続確立中。 | | `PROVISIONED` | `PROVISIONED` | プロビジョニング済み | 接続が確立されました。 | ## 接続を受け入れる[​](#接続を受け入れる "への直接リンク接続を受け入れる") [IBM Cloudコンソール](https://cloud.ibm.com/login)にログインし、[IBM Cloud Direct Link Exchangeページ](https://cloud.ibm.com/classic/network/directlink/exchange)に移動して、保留中の接続を確認して承認します。