# API - Microsoft Azure ExpressRouteへの接続 Microsoft Azure へのレイヤー 2 の直接接続を確立し、Azure クラウドインフラストラクチャとその他の Azure クラウドサービスにアクセスします。 ![](https://docs.equinix.com/ja/assets/images/connectToMicrosoftAzure-7cbea56c79acbe0302b172a682b43b7e.jpg) > **メモ** > > 本書では、APIのポート、サービストークン、またはクラウドルーターからの接続の作成について説明します。APIを含む仮想デバイスからの接続の作成については、「[Network Edge](https://docs.equinix.com/ja/fabric-marketplace/connecting-to-service-provider/microsoft/ne-azure-expressroute.md) to [Azure ExpressRoute](https://docs.equinix.com/ja/fabric-marketplace/connecting-to-service-provider/microsoft/ne-azure-expressroute.md)」を参照してください。 ## 前提条件[​](#前提条件 "への直接リンク前提条件") 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サイドを設定するための関連情報を提供します。 または * Fabric Cloud Router情報を確認します。エンドポイントにリクエストを[`/fabric/v4/routers/search`](https://docs.equinix.com/ja/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md)送信して、利用可能なクラウドルーターを確認します。`POST`ルーターのUUIDが必要です。 3. Azure ExpressRouteサービスプロファイル情報を特定する。どのサービスプロファイルを選択すべきかの詳細については、[Azure ExpressRouteの概要](https://docs.equinix.com/ja/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#azure-express-route-service-profiles)ページを参照してください。 * Azure ExpressRoute -`a1390b22-bbe0-4e93-ad37-85beef9d254d` * Azure Government ExpressRoute -`0de4e413-edd7-4325-912f-7c8a4428e156` 4. ExpressRouteサービスキーを特定して検証します。エンドポイントにリクエストを[`/fabric/v4/connections/validate`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/validateconnections.md)送信して、`POST`ExpressRouteサービスキーを使用して、指定された都市圏で選択されたサービスプロファイルへの接続を作成できることを確認します。 ## DOT1Q ポートからの接続[​](#dot1q-ポートからの接続 "への直接リンクDOT1Q ポートからの接続") Dot1QポートからAzure ExpressRouterへの接続を作成するには、エンドポイントにリクエストを[`/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` Azure ExpressRouteの詳細とロケーションの詳細をオブジェクトに入力します。`zSide`以下を含みます。 * に設定します。`accessPoint.type``SP` * に設定します。`profile.type``L2_PROFILE` * で、接続先のAzure ExpressRouteサービスプロファイルを指定します。`profile.uuid` * で接続するEquinix都市圏の場所を指定します。`location.metroCode` * ExpressRouteサービスキーとして設定します。`authenticationKey` * `PRIVATE`接続を使用しているサービスに応じて、またはに`MICROSOFT`設定します。`peeringType`詳細については、「[ピアリングの設定」を](https://docs.equinix.com/ja/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering)参照してください。 * (*オプション*)をに`QINQ`設定`linkProtocol.type`し、を指定します。`linkProtocol.vlanCTag`これにより、ピアリングに使用するExpressRoute VLAN IDが設定されます。接続を作成した後、Azureポータルでこの値を設定することもできます。 `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": "DC" }, "linkProtocol": { "type": "QINQ", "vlanCTag": }, "peeringType": "", "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] } ``` ## QINQポートからの接続[​](#qinqポートからの接続 "への直接リンクQINQポートからの接続") Dot1QポートからAzure ExpressRouterへの接続を作成するには、エンドポイントにリクエストを[`/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タイプ`QINQ` * 内部タグIDをに提供します`linkProtocol.vlanCTag` * 外部タグIDをに提供します`linkProtocol.vlanSTag` Azure ExpressRouteの詳細とロケーションの詳細をオブジェクトに入力します。`zSide`以下を含みます。 * に設定します。`accessPoint.type``SP` * に設定します。`profile.type``L2_PROFILE` * で、接続先のAzure ExpressRouteサービスプロファイルを指定します。`profile.uuid` * で接続するEquinix都市圏の場所を指定します。`location.metroCode` * ExpressRouteサービスキーとして設定します。`authenticationKey` * `PRIVATE`接続を使用しているサービスに応じて、またはに`MICROSOFT`設定します。`peeringType`詳細については、「[ピアリングの設定」を](https://docs.equinix.com/ja/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering)参照してください。 * (*オプション*)をに`QINQ`設定`linkProtocol.type`し、を指定します。`linkProtocol.vlanCTag`これにより、ピアリングに使用するExpressRoute VLAN IDが設定されます。接続を作成した後、Azureポータルでこの値を設定することもできます。 `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", "vlanSTag": , "vlanCTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## サービス・トークンを使った接続[​](#サービストークンを使った接続 "への直接リンクサービス・トークンを使った接続") Dot1QポートからAzure ExpressRouterへの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`接続は`type`です。`EVPL_VC` オブジェクト内のサービストークンUUIDをにプロバイダします。`aSide`サービストークンは、接続を確立するために必要なその他すべての情報を提供します。 Azure ExpressRouteの詳細とロケーションの詳細をオブジェクトに入力します。`zSide`以下を含みます。 * に設定します。`accessPoint.type``SP` * に設定します。`profile.type``L2_PROFILE` * で、接続先のAzure ExpressRouteサービスプロファイルを指定します。`profile.uuid` * で接続するEquinix都市圏の場所を指定します。`location.metroCode` * ExpressRouteサービスキーとして設定します。`authenticationKey` * `PRIVATE`接続を使用しているサービスに応じて、またはに`MICROSOFT`設定します。`peeringType`詳細については、「[ピアリングの設定」を](https://docs.equinix.com/ja/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering)参照してください。 * (*オプション*)をに`QINQ`設定`linkProtocol.type`し、を指定します。`linkProtocol.vlanCTag`これにより、ピアリングに使用するExpressRoute VLAN IDが設定されます。接続を作成した後、Azureポータルでこの値を設定することもできます。 `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": "" } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Fabric Cloud Router から接続する[​](#fabric-cloud-router-から接続する "への直接リンクFabric Cloud Router から接続する") Network Edgeデバイスから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` Azure ExpressRouteの詳細とロケーションの詳細をオブジェクトに入力します。`zSide`以下を含みます。 * に設定します。`accessPoint.type``SP` * に設定します。`profile.type``L2_PROFILE` * で、接続先のAzure ExpressRouteサービスプロファイルを指定します。`profile.uuid` * で接続するEquinix都市圏の場所を指定します。`location.metroCode` * ExpressRouteサービスキーとして設定します。`authenticationKey` * `PRIVATE`接続を使用しているサービスに応じて、またはに`MICROSOFT`設定します。`peeringType`詳細については、「[ピアリングの設定」を](https://docs.equinix.com/ja/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering)参照してください。 * (*オプション*)をに`QINQ`設定`linkProtocol.type`し、を指定します。`linkProtocol.vlanCTag`これにより、ピアリングに使用するExpressRoute VLAN IDが設定されます。接続を作成した後、Azureポータルでこの値を設定することもできます。 `redundancy`リクエストの本文で、およびを含むその他の接続構成の詳細を指定します。`bandwidth`パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)参照してください。 ``` 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": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## 接続状況の監視[​](#接続状況の監視 "への直接リンク接続状況の監視") 接続ステータスを監視するリクエストを[`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/getconnectionbyuuid.md)エンドポイントに送信します。`GET` | 接続ステート | | アジュール州 | | | | ----------------------------- | ------------------------------ | ------------------------------ | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \*\*`equinixStatus`\*\*属性値 | \*\*`providerStatus`\*\*属性値 | **プロバイダステータス** | **ピアリングステータス** | **説明** | | `PROVISIONING` | `PROVISIONING` | プロビジョニングされていません | プロビジョニングされていません | 接続要求はまだMicrosoftに送信されていません。 | | `PENDING_BGP_PEERING` | `PENDING_BGP` | プロビジョニング済み | プロビジョニングされていません | 接続が承認され、お客様がMicrosoft AzureポータルでMicrosoftピアリングを設定するのを待っています。ポートからAzure ExpressRouteに接続している場合、Microsoft Azureポータルでピアリングが完了するまでステータスは維持され`PENDING_BGP_PEERING`、Equinix FabricがMicrosoftと同期するとステータスはに変わります。`PROVISIONED`BGPピアリングを即座に同期する場合は、[接続アクション](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnectionaction.md)APIエンドポイントを使用します。Fabric Cloud RouterからAzure ExpressRouteに接続する場合は、Equinix Customer Portalで接続の[ルーティング詳細を設定する必要](https://docs.equinix.com/ja/fabric-cloud-router/bgp/fcr-bgp.md)もあります。 | | `PROVISIONING` | `PROVISIONED` | | | Microsoft側でプロビジョニングが完了し、Equinix側で接続がプロビジョニングされています。 | | `PROVISIONED` | `PROVISIONED` | | | 接続が確立されました。 |