# API - AWS Direct Connectへの接続 FabricとAWS Direct Connectを使用して、IBXコロケーションアセットとAmazon Web Services(AWS)リソース間の直接レイヤー2接続を確立します。APIを使用して、ポート、Network Edgeデバイス、またはFabric Cloud Routerから接続を作成します。 ![](https://docs.equinix.com/ja/assets/images/connectToAWS-e4d5112e10b97bf9a1a7d753bf90b11b.png) AWS提供のサービストークンがある場合は、「[サービストークンを使用して接続先に接続する」を](https://docs.equinix.com/ja/fabric/fabric-api/connect-using-service-token.md)参照してください。 ## API の前提条件[​](#api-の前提条件 "への直接リンクAPI の前提条件") 1. 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。OAuth APIを呼び出して認証情報を検証および認証する方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 2. Aサイド情報を決定します。次のいずれかを実行 * エンドポイントにリクエストを[`/fabric/v4/ports`](https://docs.equinix.com/ja/api-catalog/fabricv4/ports/getports.md)送信して、Equinix Fabricポート情報を決定します。`GET`ポートUUIDとリンクプロトコルタイプ(Dot1QまたはQinQ)が必要です。 または * エンドポイントにリクエストを[`/fabric/v4/serviceTokens`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Tokens/operation/getServiceTokens)送信して、Aサイドのサービストークンを取得します。`GET`トークンのUUIDが必要です。Aサイドトークンは、接続のAサイドを設定するための関連情報を提供します。 または * Network Edgeデバイス情報を確認します。エンドポイントにリクエストを[`/ne/v1/devices`](https://docs.equinix.com/ja/api-catalog/network-edgev1/virtual-device/getvirtualdevices)送信して、利用可能な仮想デバイスとクラスタを確認します。`GET`デバイスのUUIDが必要です。デバイスの詳細を取得するためのリクエストを[`/ne/v1/devices/{device_id}`](https://docs.equinix.com/ja/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid)エンドポイントに送信します。`GET`接続には、デバイスで使用可能なインターフェースを選択できます。指定しない場合、接続は次に使用可能なインターフェースに自動的に割り当てられます。 または * Fabric Cloud Router情報を確認します。エンドポイントにリクエストを[`/fabric/v4/routers/search`](https://docs.equinix.com/ja/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md)送信して、利用可能なクラウドルーターを確認します。`POST`ルーターのUUIDが必要です。 3. AWS Direct Connectサービスプロファイルとロケーション情報を特定する。どのサービスプロファイルを選択すべきかの詳細については、[AWS Direct Connectの概要](https://docs.equinix.com/ja/fabric-marketplace/connecting-to-service-provider/aws/direct-connect-overview.md)ページを参照してください。 * AWS Direct Connect UUID -`69ee618d-be52-468d-bc99-00566f2dd2b9` * AWS Direct Connect大容量UUID-`de55ca94-df3b-4680-845f-6f7093f76bef` * AWS Direct Connect冗長UUID -`8b5cbdbd-53da-4d37-9bfc-cc988eb522f1` * AWS Direct Connect -大容量冗長-`ed48616a-c182-40b4-a462-a78ba812e961` ロケーション情報を見つけるには、AWS Direct ConnectサービスプロファイルIDSのいずれかを使用して、エンドポイントにリクエストを[`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)送信します。`GET``metros`応答内のオブジェクトには、Equinix都市圏とそれに関連付けられたAWS地域のリストが含まれています。接続を作成するには、両方が必要です。 4. AmazonアカウントIDを特定して検証します。AWS Management Consoleにログインし、アカウント番号を確認します。アカウント番号の確認方法については、[AWSのドキュメントを参照してください。](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html)エンドポイントにリクエストを[`/fabric/v4/connections/validate`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/validateconnections.md)送信して、`POST`AWSアカウントIDを使用して、指定の都市圏で選択したサービスプロファイルへの接続を作成できることを確認します。 ## DOT1Q ポートからの接続[​](#dot1q-ポートからの接続 "への直接リンクDOT1Q ポートからの接続") Dot1QポートからAWSへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`接続は`type`です。`EVPL_VC` オブジェクトにポート情報を入力します。`aSide`以下を含みます。 * `accessPoint.type`AS`COLO` * ポートのUUIDをに入力してください`port.uuid` * linkProtocolタイプ`DOT1Q` * VLAN IDをに提供`linkProtocol.vlanTag` AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。`zSide`以下を含みます。 * に設定します。`accessPoint.type``SP` * に設定します。`profile.type``L2_PROFILE` * で、接続先のAWSサービスプロファイルを指定します。`profile.uuid` * で接続するEquinix都市圏の場所を指定します。`location.metroCode` * で、Equinix都市圏に関連付けられたAWS地域を指定します。`sellerRegion`この情報はエンドポイントから見つけることができます。[`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)「[API前提条件](#api-prerequisites)エンドポイント」を参照してください。詳細については、[APIの前提条件を](#api-prerequisites)参照してください。 * AWSアカウントIDとして設定します。`authenticationKey` `redundancy`リクエストの本文で、およびを含むその他の接続構成の詳細を指定します。`bandwidth`パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.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": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "accessPoint": {      "type": "COLO",       "port": {        "uuid": ""       },       "linkProtocol": {         "type": "DOT1Q",         "vlanTag":       }     }   }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## QINQ ポートからの接続[​](#qinq-ポートからの接続 "への直接リンクQINQ ポートからの接続") QinQポートからAWSへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`接続は`type`です。`EVPL_VC` オブジェクトにポート情報を入力します。`aSide`以下を含みます。 * として設定`accessPoint.type``COLO` * ポートのUUIDをに入力してください`port.uuid` * `linkProtocol.type` AS`QINQ` * 内部タグIDをに提供します`linkProtocol.vlanCTag` * 外部タグIDをに提供します`linkProtocol.vlanSTag` AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。`zSide`以下を含みます。 * に設定します。`accessPoint.type``SP` * に設定します。`profile.type``L2_PROFILE` * で、接続先のAWSサービスプロファイルを指定します。`profile.uuid` * で接続するEquinix都市圏の場所を指定します。`location.metroCode` * で、Equinix都市圏に関連付けられたAWS地域を指定します。`sellerRegion`この情報はエンドポイントから見つけることができます。[`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)「[API前提条件](#api-prerequisites)エンドポイント」を参照してください。詳細については、[APIの前提条件を](#api-prerequisites)参照してください。 * AWSアカウントIDとして設定します。`authenticationKey` `redundancy`リクエストの本文で、およびを含むその他の接続構成の詳細を指定します。`bandwidth`パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.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": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "accessPoint": { "type": "COLO",       "port": {        "uuid": ""       },       "linkProtocol": {        "type": "QINQ",         "vlanCTag": ,         "vlanSTag":       } }   }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] } ``` ## サービス・トークンを使った接続[​](#サービストークンを使った接続 "への直接リンクサービス・トークンを使った接続") Aサイドサービストークンを使用してAWSへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`接続は`type`です。`EVPL_VC` オブジェクト内のサービストークンUUIDをにプロバイダします。`aSide`サービストークンは、接続を確立するために必要なその他すべての情報を提供します。 AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。`zSide`以下を含みます。 * に設定します。`accessPoint.type``SP` * に設定します。`profile.type``L2_PROFILE` * で、接続先のAWSサービスプロファイルを指定します。`profile.uuid` * で接続するEquinix都市圏の場所を指定します。`location.metroCode` * で、Equinix都市圏に関連付けられたAWS地域を指定します。`sellerRegion`この情報はエンドポイントから見つけることができます。[`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)「[API前提条件](#api-prerequisites)エンドポイント」を参照してください。詳細については、[APIの前提条件を](#api-prerequisites)参照してください。 * AWSアカウントIDとして設定します。`authenticationKey` `redundancy`リクエストの本文で、およびを含むその他の接続構成の詳細を指定します。`bandwidth`パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.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": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "serviceToken": { "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4" } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] } ``` ## Network Edge デバイスから接続する[​](#network-edge-デバイスから接続する "への直接リンクNetwork Edge デバイスから接続する") Network EdgeデバイスからAWSへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`接続は`type`です。`EVPL_VC` オブジェクトでNetwork Edgeデバイスを定義する。`aSide`以下を含みます。 * `accessPoint.type` as `VD` * `virtualDevice.type`AS`EDGE` * `virtualDevice.uuid` デバイスのUUIDとして AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。`zSide`以下を含みます。 * に設定します。`accessPoint.type``SP` * に設定します。`profile.type``L2_PROFILE` * で、接続先のAWSサービスプロファイルを指定します。`profile.uuid` * で接続するEquinix都市圏の場所を指定します。`location.metroCode` * で、Equinix都市圏に関連付けられたAWS地域を指定します。`sellerRegion`この情報はエンドポイントから見つけることができます。[`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)「[API前提条件](#api-prerequisites)エンドポイント」を参照してください。詳細については、[APIの前提条件を](#api-prerequisites)参照してください。 * AWSアカウントIDとして設定します。`authenticationKey` `redundancy`リクエストの本文で、およびを含むその他の接続構成の詳細を指定します。`bandwidth`パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.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": "", "bandwidth": , "redundancy": { "priority": "" }, "aSide": { "accessPoint": { "type": "VD", "virtualDevice": { "type": "EDGE", "uuid": "" } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Fabric Cloud Router から接続する[​](#fabric-cloud-router-から接続する "への直接リンクFabric Cloud Router から接続する") Fabric Cloud RouterからAWSへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`接続は`type`です。`IP_VC` オブジェクトにFabric Cloud Routerを定義する。`aSide`以下が含まれます。 * に設定します。`accessPoint.type``CLOUD_ROUTER` * ルーターのUUIDとして設定します。`router.uuid` AWS Direct Connectの詳細とロケーションの詳細をオブジェクトに入力します。`zSide`以下を含みます。 * に設定します。`accessPoint.type``SP` * に設定します。`profile.type``L2_PROFILE` * で、接続先のAWSサービスプロファイルを指定します。`profile.uuid` * で接続するEquinix都市圏の場所を指定します。`location.metroCode` * で、Equinix都市圏に関連付けられたAWS地域を指定します。`sellerRegion`この情報はエンドポイントから見つけることができます。[`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)「[API前提条件](#api-prerequisites)エンドポイント」を参照してください。詳細については、[APIの前提条件を](#api-prerequisites)参照してください。 * AWSアカウントIDとして設定`authenticationKey` サンプルcURLリクエスト: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{ "type": "IP_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" }, "aSide": { "accessPoint": { "type": "CLOUD_ROUTER", "router": { "uuid": "" } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## 接続状況の監視[​](#接続状況の監視 "への直接リンク接続状況の監視") 接続ステータスを監視するリクエストを[`fabric/v4/connections/{connection_id}`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/getconnectionbyuuid.md)エンドポイントに送信します。`GET` | `equinixStatus`属性値 | `providerStatus`属性値 | **AWS Direct Connect状態** | **説明** | | --------------------- | ---------------------- | -------------------------- | --------------------------------------------- | | `PROVISIONING` | `PROVISIONING` | | 接続リクエストはまだAWSに送信されていません。 | | `PROVISIONED` | `PENDING_APPROVAL` | 注文 -> リクエスト | 接続が承認されるのを待っています。 | | `PROVISIONED` | `PROVISIONING` | 保留中 | 接続確立中。 | | `PROVISIONED` | `PROVISIONED` | 保留中 -> 利用可能 | 接続が承認されました。 |