# ファブリックポートによるインターネットアクセスのご注文 Equinix Internet Access(EIA)は、複数のTier-1インターネットサービスプロバイダ(ISPs)とEquinixインターネットエクスチェンジ(IX)を使用して混合インターネットアクセスを提供し、高可用性、信頼性、高速性を実現します。 * お客様のFabricポートとEquinix Internet Accessサービスプロファイル間のFabric接続は無料で提供されます。 * [インターネットアクセスサービスインスタンスのプロビジョニングを解除する](https://docs.equinix.com/ja/internet-access/eia-api/deprovision-eia-api.md)と、関連するファブリック接続もプロビジョニング解除されます。 * インターネットアクセスサービスインスタンスのプロビジョニングに問題がある場合、関連するFabric接続は自動的にプロビジョニング解除されます。 Equinix Internet Access with Fabricは、[Equinix IDおよびアクセス管理](https://docs.equinix.com/ja/iam.md)にオンボーディングされている組織で利用でき、APIリクエストの送信に使用するアカウントには役割が必要です。`Equinix Fabric Manager` お客様の組織がEquinix IDおよびアクセス管理にオンボーディングされていない場合は、[専用ポートでEquinix Internet Accessをオーダー](https://docs.equinix.com/ja/internet-access/eia-api/order-eia-dedicated-port-api.md)できます。 ## 前提条件[​](#前提条件 "への直接リンク前提条件") 1. 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 2. Aサイド情報を決定する。Fabricポート情報を取得するには、エンドポイントにリクエストを[`/fabric/v4/ports`](https://docs.equinix.com/ja/api-catalog/fabricv4/ports/getports.md)送信します。`GET`ポートUUID、リンクプロトコルタイプ(Dot1QまたはQinQ)が必要です。冗長接続を作成する場合は、ポートと`SECONDARY`ポートの両方を選択します。`PRIMARY`この情報は、接続の作成リクエストに必要です。 3. Zサイド情報を決定する。インターネットアクセスサービスプロファイルはタイプ`IA_PROFILE`で、IDはです。`32d81829-0bf8-45d5-84e2-7289a553dbb6`サービスの都市圏の場所を決定するには、インターネットアクセスが利用可能な場所を見つけるためのリクエストを[`/internetAccess/v2/ibxs`](https://docs.equinix.com/ja/api-catalog/internetaccessv2/product-availability/getibxs.md)エンドポイントに送信します。`GET`インターネットアクセスサービスの発注には、この情報が必要です。 ## インターネットアクセス接続の作成[​](#インターネットアクセス接続の作成 "への直接リンクインターネットアクセス接続の作成") インターネットアクセスサービスの接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST`接続は`type`です。`IA_VC` オブジェクトにポート情報を入力します。これには`aSide`以下が含まれます。 * `accessPoint.type`AS`COLO` * ポートのUUIDをに入力してください`port.uuid` Dot1qポートから接続する場合: * linkProtocolタイプ`DOT1Q` * VLAN IDをに提供`linkProtocol.vlanTag` QinQポートから接続する場合: * linkProtocolタイプ`QINQ` * 内部タグIDをに提供します`linkProtocol.vlanCTag` * 外部タグIDをに提供します`linkProtocol.vlanSTag` * 冗長接続を作成する場合は、2つのリクエストを行ってください。 1つのリクエストにはプライマリポートとがに設定され、`PRIMARY`もう1つのリクエストには`redundancy.priority`セカンダリポート とが`redundancy.priority`に設定され、`SECONDARY`最初の接続のUUIDとして指定する必要があります。`redundancy.group` オブジェクトにインターネットアクセスサービスプロファイルを提供します。これには、`zSide`次のものが含まれます。 * `accessPoint.type` as `SP`. * `profile.type`AS`IA_PROFILE` * `profile.uuid` AS`32d81829-0bf8-45d5-84e2-7289a553dbb6` * `metroCode` 接続しているインターネットアクセスの都市圏の2文字の都市圏コードとして入力します。 サンプルcURLリクエスト: プライマリ接続の例 ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "type": "IA_VC", "name": "", "bandwidth": , "redundancy": { "priority": "PRIMARY" }, "aSide": { "accessPoint": { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "DOT1Q", "vlanTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "IA_PROFILE", "uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6" }, "location": { "metroCode": "" } } }, "project": { "projectId": "" }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` セカンダリ接続の例 ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "type": "IA_VC", "name": "", "bandwidth": , "redundancy": { "priority": "SECONDARY", "group": "" }, "aSide": { "accessPoint": { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "DOT1Q", "vlanTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "IA_PROFILE", "uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6" }, "location": { "metroCode": "" } } }, "project": { "projectId": "" }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` > **重要** > > 応答には、インターネットアクセスサービスの接続IDであるが含まれています。`uuid`インターネットアクセスサービスを発注するには、この接続UUIDが必要です。 ## プロバイダが割り当てられたIPブロックを使用した発注サービス[​](#プロバイダが割り当てられたipブロックを使用した発注サービス "への直接リンクプロバイダが割り当てられたIPブロックを使用した発注サービス") インターネットアクセスサービスをオーダーするには、エンドポイントにリクエストを[`/internetAccess/v2/services`](https://docs.equinix.com/ja/api-catalog/internetaccessv2/eia-service/createequinixinternetaccessv2.md)送信します。`POST` 冗長性のために、サービスに2つの接続を作成した場合は、をに設定し、`type``DUAL`両方の接続IDSをアレイに提供します。`connections` サービスに対して単一の接続を作成した場合は、をに`SINGLE`設定`type`し、接続IDをアレイに入力します。`connections` `routingProtocol`オブジェクトで次を指定します。 * `routingProtocol.type``STATIC`、`DIRECT`、、またはからのユーザーです。`BGP` * Equinix所有(PA) IPブロックを使用してサービスを発注する場合は、必要なIPブロックのサイズに値を設定してください。`ipBlock.prefixLength` > **メモ** > > アジア太平洋地域のIBXデータセンターの1つにあるEIAサービスインスタンスを発注する場合は、PA IPv4ブロックの場合に備えて、オブジェクトにおよび`questions`情報を`ipBlock`追加してください。`addressingPlans`詳細については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/internetaccessv2/eia-service/createequinixinternetaccessv2.md)参照してください。 ### スタティックルーティング[​](#スタティックルーティング "への直接リンクスタティックルーティング") スタティックルーティングに関するドキュメントは、[こちらを参照してください。](https://docs.equinix.com/ja/internet-access/routing/static-routing.md) サンプルcURLリクエスト: APAC地域における単一静的サービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": , "addressingPlans": [ { "afterThreeMonths": , "immediate": , "purpose": "", "size": } ], "questions": [ { "answer": "YES", "type": "PRIVATE_SPACE_CONSIDERED" }, { "answer": "NO", "type": "REFUSED_PREVIOUSLY" }, { "answer": "NO", "type": "RETURNING_ADDRESS_SPACE" } ] } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` デュアル・スタティック・サービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### ダイレクトルーティング[​](#ダイレクトルーティング "への直接リンクダイレクトルーティング") ダイレクトルーティングに関するドキュメントは[こちらをご覧ください。](https://docs.equinix.com/ja/internet-access/routing/direct-routing.md) サンプルcURLリクエスト: シングル・ダイレクト・サービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` デュアルダイレクトサービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### BGPルーティング[​](#bgpルーティング "への直接リンクBGPルーティング") オブジェクトでBGP設定の詳細を指定し`routingProtocol`ます。 * `FULL`でインターネット、、`DEFAULT`、`FULL_DEFAULT`、または`PARTIAL`にアドバタイズするルート。`routingProtocol.exportPolicy` * では、16ビットASNの場合はBITS\_16、32ビットASNの場合はBITS\_32をお客様に提供します。`routingProtocol.customerAsnRange` * 必要に応じて、にbgpauthKeyを入力します。`routingProtocol.bgpAuthKey` BGPルーティングに関するドキュメントは、[こちらをご覧ください。](https://docs.equinix.com/ja/internet-access/routing/bgp-routing.md) サンプルcURLリクエスト: シングルBGPサービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "My Internet Access Service", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` デュアルBGPサービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ## プロバイダ非依存IPブロックでの発注サービス[​](#プロバイダ非依存ipブロックでの発注サービス "への直接リンクプロバイダ非依存IPブロックでの発注サービス") 独自のIPブロック(PI)を使用してサービスを発注する場合は、`customerRoutes.prefix` ### スタティックルーティング[​](#スタティックルーティング-1 "への直接リンクスタティックルーティング") サンプルcURLリクエスト: シングル・スタティック・サービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` デュアル・スタティック・サービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### ダイレクトルーティング[​](#ダイレクトルーティング-1 "への直接リンクダイレクトルーティング") オブジェクトのピアリング目的で使用できるIPブロックを指定します。`peering` 単一のサービスタイプの場合、アレイ内のIPアドレスを1つだけ指定します。`equinixPeerIps` デュアルサービスタイプの場合、アレイに2つのIPアドレスを入力し、フィールドにVRRP IPアドレスを`equinixVRRPIp`入力します。`equinixPeerIps` サンプルcURLリクエスト: シングル・ダイレクト・サービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "" ] } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "" ] } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` デュアルダイレクトサービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "", "" ], "equinixVRRPIp": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "", "" ], "equinixVRRPIp": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### BGPルーティング[​](#bgpルーティング-1 "への直接リンクBGPルーティング") サンプルcURLリクエスト: シングルBGPサービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` デュアルBGPサービスの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ## PAおよびPI IPブロックの注文サービス[​](#paおよびpi-ipブロックの注文サービス "への直接リンクPAおよびPI IPブロックの注文サービス") プロバイダ割り当て(PA)とプロバイダ独立(PI)の両方のIPブロックを使用してサービスを注文する場合は、適切なフィールドで2つ以上のカスタマー・ルート・オブジェクトを指定してください: * `ipBlock.prefixLength`Equinix提供のIPブロック(PA)の場合。 * `customerRoutes.prefix`独自のIPブロック(PI)を使用する場合。 > **重要** > > 複数のIPブロックは、スタティックおよびBGPルーティングプロトコルでのみリクエストできます。 サンプルcURLリクエスト: プロバイダ割当てIPブロックとプロバイダ非依存IPブロックの例 ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } }, { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } }, { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ## リクエストの監視[​](#リクエストの監視 "への直接リンクリクエストの監視") 接続作成リクエストのステータスを表示するには、エンドポイントにリクエストを[`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/getconnectionbyuuid.md)送信します。`GET` インターネットアクセスサービスの詳細を表示するには、エンドポイントを使用します。[`internetAccess/v2/services/{serviceId}`](https://docs.equinix.com/ja/api-catalog/internetaccessv2/eia-service/getequinixinternetaccessservicedetails.md) Internet Accessサービスインスタンスのプロビジョニングに問題が発生した場合、関連接続は自動的にデプロビジョニングされます。