本文へスキップ

Network Edgeでインターネットアクセスを注文

Equinix Internet Access（EIA）は、複数のティア1インターネットサービスプロバイダ（ISP）とEquinix Internet Exchange（IX）を利用したブレンデッドインターネットアクセスを提供し、高い可用性、信頼性、速度を実現しています。APIを通じてインターネットアクセスを注文するには、以下のリンクをクリックしてください：

  • お客様のNetwork EdgeデバイスとEquinix Internet Accessサービスプロファイル間のFabric接続は無料で提供されます。
  • Internet Accessサービスインスタンスのデプロビジョニング](deprovision-eia-api.md)を行うと、関連するFabric接続もデプロビジョニングされます。
  • Internet Accessサービスインスタンスのプロビジョニングに問題が発生した場合、関連するFabric接続は自動的にデプロビジョニングされます。

Equinix Internet Access with Network Edgeは、Equinix Identity and Access Managementに登録されている組織が利用できます。APIリクエストを送信するアカウントには、Equinix Fabric Manager、Network Edge Connections Manager、Network Edge Device Managerのロールが必要です。

必須条件​

  1. 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証を使用します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API認証を参照してください。

  2. A側の情報を決定します。Network Edgeの仮想デバイス、冗長デバイス、またはクラスタがプロビジョニングされ、ライセンスが登録されている必要があります。[ne/v1/devices](/api-catalog/network-edgev1#tag/Virtual-Device/operation/getVirtualDevices)エンドポイントまたは[/ne/v1/devices/{id}](/api-catalog/network-edgev1#tag/Virtual-Device/operation/getVirtualDeviceByUuid)エンドポイントに GET` リクエストを送信します。接続には、デバイス上の利用可能な任意のインターフェースを選択できます。ただし、指定がない場合はエクイニクスがインターフェースを選択します。

  3. サイド情報を決定します。Internet AccessサービスプロファイルのタイプはIA_PROFILEで、IDは32d81829-0bf8-45d5-84e2-7289a553dbb6です。サービスのメトロロケーションを調べるには、/internetAccess/v2/ibxs エンドポイントに GET リクエストを送信して、Internet Access が利用可能なロケーションを調べます。この情報はインターネットアクセスサービスの注文に必要です。

インターネットアクセス接続の作成​

Internet Access サービスの接続を作成するには、/fabric/v4/connections エンドポイントに POST リクエストを送信します。接続の type は IA_VC です。

aSide` オブジェクトに以下のような仮想デバイス情報をプロバイダとして指定します：

  • accessPoint.type as VD
  • virtualDevice.type as EDGE
  • virtualDevice.uuid as your device's UUID

インターネットAccessサービスプロファイルをzSideオブジェクトにプロバイダします：

  • accessPoint.type as SP.
  • profile.type as IA_PROFILE
  • profile.uuid as 32d81829-0bf8-45d5-84e2-7289a553dbb6
  • metroCode as the two letter metro code of the Internet Access metro you are connecting to.

冗長接続を作成する場合は、2つのリクエストを作成します。一方のリクエストには redundancy.priority を PRIMARY に設定し、もう一方のリクエストには redundancy.priority を SECONDARY に設定し、redundancy.group には最初の接続の UUID を指定します。 A側には仮想デバイスクラスタまたは冗長デバイスのペア（プライマリとセカンダリに1つずつ）を使用します。

サンプルcURLリクエスト：

Primary connection example
curl -X POST 'https://api.equinix.com/fabric/v4/connections' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "type": "IA_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "PRIMARY"
  },
  "aSide": {
    "accessPoint": {
      "type": "VD",
      "virtualDevice": {
        "type": "EDGE",
        "uuid": "<your_virtual_device_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "IA_PROFILE",
        "uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6"
      },
      "location": {
        "metroCode": "<metro_code>"
      }
    }
  },
  "project": {
    "projectId": "<project_id>"
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'
Secondary connection example
curl -X POST 'https://api.equinix.com/fabric/v4/connections' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "type": "IA_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "SECONDARY",
    "group": "<primary_connection_uuid>"
  },
  "aSide": {
    "accessPoint": {
      "type": "VD",
      "virtualDevice": {
        "type": "EDGE",
        "uuid": "<your_virtual_device_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "IA_PROFILE",
        "uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6"
      },
      "location": {
        "metroCode": "<metro_code>"
      }
    }
  },
  "project": {
    "projectId": "<project_id>"
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'
重要

レスポンスには、インターネット Access サービスの接続 ID である uuid が含まれます。インターネットアクセスサービスを注文するには、この接続UUIDが必要です。

プロバイダ割り当てIPブロックによるサービスの注文​

メモ

冗長デバイスまたはクラスタへの冗長接続を使用する場合は、BGPルーティングのみがサポートされます。

Internet Accessサービスを注文するには、/internetAccess/v2/servicesエンドポイントにPOSTリクエストを送信します。

エクイニクスが所有する（PA）IPアドレスを使用してサービスを注文する場合は、ipBlock.prefixLengthの値を必要なサブネットのサイズに設定してください。

単一の接続でサービスを注文する場合：

  • typeをSINGLEに設定し、接続 ID をconnections` 配列に提供します。
  • routingProtocol.typeを STATIC、DIRECT、BGP` から選択します。

1対の冗長接続でサービスを注文する場合：

  • typeをDUALに設定し、両方の接続 ID をconnections` 配列にプロバイダとして提供します。
  • routingProtocol.typeをBGP`に設定します。
メモ

APAC地域のIBXデータセンターの1つにあるEIAサービスインスタンスを注文する場合、PA IPv4ブロックの場合は、addressingPlansとquestions情報を必ずipBlockオブジェクトに追加してください。詳細については、API reference を参照してください。

スタティックルーティング​

スタティック・ルーティングに関するドキュメントはこちらにあります。

サンプルcURLリクエスト：

Single Static Service in APAC region example
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "name": "<your_service_name>",
  "type": "SINGLE",
  "connections": [
    "<connection_uuid>"
  ],
  "routingProtocol": {
    "type": "STATIC",
    "ipv4": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv4_ip_block>,
            "addressingPlans": [
                {
                    "afterThreeMonths": <number_of_ip_addresses_used_after_three_months>,
                    "immediate": <number_of_ip_addresses_used_instantly>,
                    "purpose": "<purpose_of_ip_block>",
                    "size": <number_of_ip_addresses_requested>
                }
            ],
            "questions": [
                {
                    "answer": "YES",
                    "type": "PRIVATE_SPACE_CONSIDERED"
                },
                {
                    "answer": "NO",
                    "type": "REFUSED_PREVIOUSLY"
                },
                {
                    "answer": "NO",
                    "type": "RETURNING_ADDRESS_SPACE"
                }
            ]
          }
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv6_ip_block>
          }
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'

ダイレクトルーティング​

ダイレクトルーティングに関するドキュメントはこちらを参照してください。

サンプルcURLリクエスト：

Single Direct Service example
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "name": "<your_service_name>",
  "type": "SINGLE",
  "connections": [
    "<connection_uuid>"
  ],
  "routingProtocol": {
    "type": "DIRECT",
    "ipv4": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv4_ip_block>
          }
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv6_ip_block>
          }
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'

BGPルーティング​

routingProtocol`オブジェクトにBGP設定の詳細を指定します：

  • routingProtocol.exportPolicyで、インターネットにアドバタイズするルートを FULL、DEFAULT、FULL_DEFAULT、PARTIAL` のいずれかに設定します。
  • routingProtocol.customerAsnRange`に、16ビットASNの場合はBITS_16、32ビットASNの場合はBITS_32をプロバイダに指定してください。
  • 必要に応じて、routingProtocol.bgpAuthKey に bgpAuthKey を指定してください。

BGPルーティングに関するドキュメントはこちらにあります。

サンプルcURLリクエスト：

Single BGP Service example
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "name": "<your_service_name>",
  "type": "SINGLE",
  "connections": [
    "<connection_uuid>"
  ],
  "routingProtocol": {
    "type": "BGP",
    "customerAsnRange": "<asn_range>",
    "bgpAuthKey": "<bgp_auth_key>",
    "exportPolicy": "<route_advertisement_code>",
    "ipv4": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv4_ip_block>
          }
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv6_ip_block>
          }
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'
Dual BGP Service example
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "name": "<your_service_name>",
  "type": "DUAL",
  "connections": [
    "<connection_uuid1>", "<connection_uuid2>"
  ],
  "routingProtocol": {
    "type": "BGP",
    "customerAsnRange": "<asn_range>",
    "bgpAuthKey": "<bgp_auth_key>",
    "exportPolicy": "<route_advertisement_code>",
    "ipv4": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv4_ip_block>
          }
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv6_ip_block>
          }
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'

プロバイダ独立IPブロックによるサービスの注文​

独自のIPブロック（PI）を使用してサービスを注文する場合は、customerRoutes.prefixで指定してください。

スタティックルーティング​

サンプルcURLリクエスト：

Single Static Service example
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "name": "<your_service_name>",
  "type": "SINGLE",
  "connections": [
    "<connection_uuid>"
  ],
  "routingProtocol": {
    "type": "STATIC",
    "ipv4": {
      "customerRoutes": [
        {
          "prefix": "<your_ipv4_ip_block>"
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "prefix": "<your_ipv6_ip_block>"
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'

ダイレクトルーティング​

peeringオブジェクトでピアリングに使用できるIPブロックを指定します。 シングルサービスタイプでは、equinixPeerIps`配列に1つのIPアドレスのみを指定してください。

サンプルcURLリクエスト：

Single Direct Service example
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "name": "<your_service_name>",
  "type": "SINGLE",
  "connections": [
    "<connection_uuid>"
  ],
  "routingProtocol": {
    "type": "DIRECT",
    "ipv4": {
      "customerRoutes": [
        {
          "prefix": "<your_ipv4_ip_block>"
        }
      ],
      "peerings": [
        {
          "equinixPeerIps": [
            "<peering_ip_address>"
          ]
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "prefix": "<your_ipv6_ip_block>"
        }
      ],
      "peerings": [
        {
          "equinixPeerIps": [
            "<peering_ip_address>"
          ]
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'

BGPルーティング​

サンプルcURLリクエスト：

Single BGP Service example
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "name": "<your_service_name>",
  "type": "SINGLE",
  "connections": [
    "<connection_uuid>"
  ],
  "routingProtocol": {
    "type": "BGP",
    "customerAsnRange": "<asn_range>",
    "bgpAuthKey": "<bgp_auth_key>",
    "exportPolicy": "<route_advertisement_code>",
    "ipv4": {
      "customerRoutes": [
        {
          "prefix": "<your_ipv4_ip_block>"
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "prefix": "<your_ipv6_ip_block>"
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'
Dual BGP Service example
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "name": "<your_service_name>",
  "type": "DUAL",
  "connections": [
    "<connection_uuid1>", "<connection_uuid2>"
  ],
  "routingProtocol": {
    "type": "BGP",
    "customerAsnRange": "<asn_range>",
    "bgpAuthKey": "<bgp_auth_key>",
    "exportPolicy": "<route_advertisement_code>",
    "ipv4": {
      "customerRoutes": [
        {
          "prefix": "<your_ipv4_ip_block>"
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "prefix": "<your_ipv6_ip_block>"
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'

PAおよびPI IPブロックの注文サービス​

プロバイダ割り当て（PA）とプロバイダ独立（PI）の両方のIPブロックを使用してサービスを注文する場合は、適切なフィールドで2つ以上のカスタマー・ルート・オブジェクトを指定してください：

  • ipBlock.prefixLength in case of Equinix provided IP Block (PA).
  • customerRoutes.prefix in case of using your own IP Block (PI).
重要

複数のIPブロックは、スタティックおよびBGPルーティングプロトコルでのみリクエストできます。

サンプルcURLリクエスト：

Provider Assigned and Provider Independent IP Blocks example
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
  "name": "<your_service_name>",
  "type": "SINGLE",
  "connections": [
    "<connection_uuid>"
  ],
  "routingProtocol": {
    "type": "STATIC",
    "ipv4": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv4_ip_block>
          }
        },
        {
          "prefix": "<your_ipv4_ip_block>"
        }
      ]
    },
    "ipv6": {
      "customerRoutes": [
        {
          "ipBlock": {
            "prefixLength": <size_of_ipv6_ip_block>
          }
        },
        {
          "prefix": "<your_ipv6_ip_block>"
        }
      ]
    }
  },
  "order": {
    "purchaseOrder": {
      "number": "<purchase_order_number>"
    }
  }
}'

リクエストの監視​

接続作成リクエストのステータスを表示するには、fabric/v4/connections/{connectionId} エンドポイントに GET リクエストを送信します。

インターネットアクセスサービスの詳細を表示するには、internetAccess/v2/services/{serviceId} エンドポイントを使用します。

Internet Accessサービスインスタンスのプロビジョニングに問題が発生した場合、関連接続は自動的にデプロビジョニングされます。

このページは役に立ちましたか？