# Fabric上のサービスプロバイダーに接続する IBXコロケーション資産とサービスプロファイルの接続を確立します。 ![](https://docs.equinix.com/ja/assets/images/connectToServiceProfile-02fcde0308ccca223457d1acfc0af2f1.png) ## 前提条件[​](#前提条件 "への直接リンク前提条件") 1. 認証-ユーザー認証情報、クライアントID、クライアントシークレットを送信してOauth2認証を行います。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 2. Aサイドポート情報を決定する。 [](https://docs.equinix.com/ja/api-catalog/fabricv4/ports/getports.md)Get All Portエンドポイントを使用して、関連するポート情報を取得します。 3. Zサイドの都市圏の拠点を選択します。[「全ての都市圏を取得」](https://docs.equinix.com/ja/api-catalog/fabricv4/metros/getmetros.md)エンドポイントを使用して、Equinix Fabricが利用可能な全ての都市圏を検索し、接続先の場所を特定します。 4. サービスプロバイダのサービスプロファイル情報を特定します。[\[サービスプロファイルの取得\]](https://docs.equinix.com/ja/api-catalog/fabricv4/service-profiles/searchserviceprofiles.md)エンドポイントを使用して特定のサービスプロファイルを検索するか、[\[サービスプロファイルの一覧表示\]](https://docs.equinix.com/ja/api-catalog/fabricv4/service-profiles/listserviceprofiles.md)エンドポイントを使用して、利用可能なすべてのサービスプロファイルを一覧表示し、接続先のプロファイルを特定します。 ## DOT1Q ポートからサービスプロバイダへの接続の作成[​](#dot1q-ポートからサービスプロバイダへの接続の作成 "への直接リンクDOT1Q ポートからサービスプロバイダへの接続の作成") Dot1Qポートからサービスプロバイダへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`リクエストの本文で接続の構成の詳細を指定します。 | | **`POST /fabric/v4/connections`** | | ------------------ | ------------------------------------------------------------------------------------- | | 方法 | `POST` | | エンドポイント | `/fabric/v4/connections` | | ヘッダー | `Authorization`、`Content-Type` | | パスパラメータ | 該当なし | | クエリーパラメータ | 該当なし | | ボディパラメータ | `type``name`、、`order`、、`redundancy`、`bandwidth``aSide`、`zSide`、`notifications` | 接続を作成せずに本番環境でこのリクエストを安全に検証するには、「[本番環境でのテスト(APIドライラン)」を](https://docs.equinix.com/ja/equinix-api/testing/testing-in-production-dry-run.md)参照してください。 サンプル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": {         "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",         "priority": "SECONDARY"     },     "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"             }         }     },     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test@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": "b767f685-41b0-1b07-6de0-320a5c00abdd",     "priority": "SECONDARY" }, "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/serviceProfiles/a867f685-41b0-1b07-6de0-320a5c00abdd",             "type": "L2_Profile",             "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"         },         "location": {             "href": "https://api.equinix.com/v4/metros/SV",             "metrocode": "SV",             "region": "AMER"         }     } }, "notifications": [     {         "type": "ALL",         "emails": [             "test@equinix.com",             "test2@equinix.com"         ]     } ], "operation": {     "equinixStatus": "PENDING_APPROVAL",     "providerStatus": "NOT_AVAILABLE" }, "changeLog": {     "createdDateTime": "2021-07-15T19:30:29.526Z" } } ``` 応答ペイロードには、リクエスト本文で定義された構成パラメータが含まれます。使用可能なパラメータの全リストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)参照してください。 ## QINQ ポートからサービスプロバイダへの接続の作成[​](#qinq-ポートからサービスプロバイダへの接続の作成 "への直接リンクQINQ ポートからサービスプロバイダへの接続の作成") QinQポートからサービスプロバイダへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`リクエストの本文で接続の構成の詳細を指定します。 サンプル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": {         "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",         "priority": "SECONDARY"     },     "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"             }         }     },     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test@equinix.com"             ]         }     ] }' ``` リクエスト本文に含まれるパラメータは、この例に固有のものです。パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)参照してください。 ## 接続の監視[​](#接続の監視 "への直接リンク接続の監視") [指定された接続の取得](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/getconnectionbyuuid.md)エンドポイントを使用して、接続ステータスを監視します。 | \*\*`equinixStatus`\*\*パラメータ値 | \*\*`providerStatus`\*\*パラメータ値 | **説明** | | ----------------------------------- | ------------------------------------ | ------------------------------------------ | | `PENDING_APPROVAL` | `NOT_AVAILABLE` | 接続申請は承認待ち。 | | `PROVISIONING`または `REJECTED` | `NOT_AVAILABLE` | 接続確立中、または売り手が接続を拒否した。 | | `PROVISIONED` | `AVAILABLE` | 接続が確立されました。 | ![](https://docs.equinix.com/ja/assets/images/connectToEnterpriseStatus-552bb7e1ddd9c71b8b8449c99b629842.png)