API - Microsoft Azure ExpressRouteへの接続

Microsoft Azure へのレイヤー 2 の直接接続を確立し、Azure クラウドインフラストラクチャとその他の Azure クラウドサービスにアクセスします。

メモ

本書では、APIのポート、サービストークン、またはクラウドルーターからの接続の作成について説明します。APIを含む仮想デバイスからの接続の作成については、「Network Edge to Azure ExpressRoute」を参照してください。

前提条件

認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。認証。OAuth APIを呼び出して認証情報を検証および認証する方法については、「API認証」を参照してください。
Aサイド情報を決定します。次のいずれかを実行
- エンドポイントにリクエストを/fabric/v4/ports送信して、Equinix Fabricポート情報を決定します。GETポートUUIDとリンクプロトコルタイプ（Dot1QまたはQinQ）が必要です。
または
- エンドポイントにリクエストを/fabric/v4/serviceTokens送信して、Aサイドのサービストークンを取得します。GETトークンのUUIDが必要です。Aサイドトークンは、接続のAサイドを設定するための関連情報を提供します。
または
- Fabric Cloud Router情報を確認します。エンドポイントにリクエストを/fabric/v4/routers/search送信して、利用可能なクラウドルーターを確認します。POSTルーターのUUIDが必要です。
Azure ExpressRouteサービスプロファイル情報を特定する。どのサービスプロファイルを選択すべきかの詳細については、Azure ExpressRouteの概要ページを参照してください。
- Azure ExpressRoute -a1390b22-bbe0-4e93-ad37-85beef9d254d
- Azure Government ExpressRoute -0de4e413-edd7-4325-912f-7c8a4428e156
ExpressRouteサービスキーを特定して検証します。エンドポイントにリクエストを/fabric/v4/connections/validate送信して、POSTExpressRouteサービスキーを使用して、指定された都市圏で選択されたサービスプロファイルへの接続を作成できることを確認します。

DOT1Q ポートからの接続

Dot1QポートからAzure ExpressRouterへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POST接続はtypeです。EVPL_VC

オブジェクトにポート情報を入力します。aSide以下を含みます。

accessPoint.typeASCOLO
ポートの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詳細については、「ピアリングの設定」を参照してください。
(オプション)をにQINQ設定linkProtocol.typeし、を指定します。linkProtocol.vlanCTagこれにより、ピアリングに使用するExpressRoute VLAN IDが設定されます。接続を作成した後、Azureポータルでこの値を設定することもできます。

redundancyリクエストの本文で、およびを含むその他の接続構成の詳細を指定します。bandwidthパラメータの完全なリストとその説明については、APIリファレンスを参照してください。

サンプルcURLリクエスト：

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<your_port_uuid>"
      },
      "linkProtocol": {
        "type": "DOT1Q",
        "vlanTag": <vlan_id>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "DC"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanCTag": <vlan_id>
      },
      "peeringType": "<peering_type>",
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}

QINQポートからの接続

Dot1QポートからAzure ExpressRouterへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POST接続はtypeです。EVPL_VC

オブジェクトにポート情報を入力します。aSide以下を含みます。

accessPoint.typeASCOLO
ポートの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詳細については、「ピアリングの設定」を参照してください。
(オプション)をにQINQ設定linkProtocol.typeし、を指定します。linkProtocol.vlanCTagこれにより、ピアリングに使用するExpressRoute VLAN IDが設定されます。接続を作成した後、Azureポータルでこの値を設定することもできます。

サンプルcURLリクエスト：

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanSTag": <vlan_id>,
        "vlanCTag": <vlan_id>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'

サービス・トークンを使った接続

Dot1QポートからAzure ExpressRouterへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。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詳細については、「ピアリングの設定」を参照してください。
(オプション)をにQINQ設定linkProtocol.typeし、を指定します。linkProtocol.vlanCTagこれにより、ピアリングに使用するExpressRoute VLAN IDが設定されます。接続を作成した後、Azureポータルでこの値を設定することもできます。

サンプルcURLリクエスト：

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "serviceToken": {
      "uuid": "<your_aside_service_token>"
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'

Fabric Cloud Router から接続する

Network EdgeデバイスからAWSへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。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詳細については、「ピアリングの設定」を参照してください。
(オプション)をにQINQ設定linkProtocol.typeし、を指定します。linkProtocol.vlanCTagこれにより、ピアリングに使用するExpressRoute VLAN IDが設定されます。接続を作成した後、Azureポータルでこの値を設定することもできます。

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "IP_VC",
    "name": "<connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "CLOUD_ROUTER",
      "router": {
        "uuid": "<router_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'

接続状況の監視

接続ステータスを監視するリクエストをfabric/v4/connections/{connectionId}エンドポイントに送信します。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ピアリングを即座に同期する場合は、接続アクションAPIエンドポイントを使用します。Fabric Cloud RouterからAzure ExpressRouteに接続する場合は、Equinix Customer Portalで接続のルーティング詳細を設定する必要もあります。
`PROVISIONING`	`PROVISIONED`			Microsoft側でプロビジョニングが完了し、Equinix側で接続がプロビジョニングされています。
`PROVISIONED`	`PROVISIONED`			接続が確立されました。

前提条件​

DOT1Q ポートからの接続​

QINQポートからの接続​

サービス・トークンを使った接続​

Fabric Cloud Router から接続する​

接続状況の監視​

前提条件

DOT1Q ポートからの接続

QINQポートからの接続

サービス・トークンを使った接続

Fabric Cloud Router から接続する

接続状況の監視