# NetworkEdgeによるインターネットアクセスのご注文

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](https://docs.equinix.com/ja/iam.md)に登録されている組織が利用できます。APIリクエストを送信するアカウントには、`Equinix Fabric Manager`、`Network Edge Connections Manager`、`Network Edge Device Manager`のロールが必要です。

## 前提条件

1. 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証を使用します。OAuth APIを呼び出して認証情報を検証および認証する方法については、[API認証](https://docs.equinix.com/ja/equinix-api/api-authentication.md)を参照してください。

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`](https://docs.equinix.com/ja/api-catalog/internetaccessv2.md#tag/Product-Availability/operation/getIbxs) エンドポイントに `GET` リクエストを送信して、Internet Access が利用可能なロケーションを調べます。この情報はインターネットアクセスサービスの注文に必要です。

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

Internet Access サービスの接続を作成するには、[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4.md#tag/Connections/operation/createConnection) エンドポイントに `POST` リクエストを送信します。接続の `type` は `IA_VC` です。

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

* `accessPoint.type` as `VD`
* `virtualDevice.type`を`EDGE`として
* デバイスの UUID として `virtualDevice.uuid` を指定します。

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

* `accessPoint.type` as `SP`.
* `profile.type`を`IA_PROFILE`として
* `profile.uuid`を`32d81829-0bf8-45d5-84e2-7289a553dbb6`として
* `metroCode`は接続先のInternet Accessメトロの2文字のメトロコードです。

冗長接続を作成する場合は、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`](https://docs.equinix.com/ja/api-catalog/internetaccessv2.md#tag/EIA-Service/operation/createEquinixInternetAccessv2)エンドポイントに`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](https://docs.equinix.com/ja/api-catalog/internetaccessv2.md#tag/EIA-Service/operation/createEquinixInternetAccessv2) を参照してください。

### スタティック・ルーティング

スタティック・ルーティングに関するドキュメントは[こちら](https://docs.equinix.com/ja/internet-access/routing/static-routing.md)にあります。

サンプル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>"

    }

  }

}'
```

### ダイレクト・ルーティング

ダイレクトルーティングに関するドキュメントは[こちら](https://docs.equinix.com/ja/internet-access/routing/direct-routing.md)を参照してください。

サンプル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ルーティングに関するドキュメントは[こちら](https://docs.equinix.com/ja/internet-access/routing/bgp-routing.md)にあります。

サンプル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つ以上のカスタマー・ルート・オブジェクトを指定してください：

* エクイニクスが提供するIPブロック（PA）の場合は`ipBlock.prefixLength`です。
* 独自のIPブロック（PI）を使用する場合は`customerRoutes.prefix`。

重要

複数の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}`](https://docs.equinix.com/ja/api-catalog/fabricv4.md#tag/Connections/operation/getConnectionByUuid) エンドポイントに `GET` リクエストを送信します。

インターネットアクセスサービスの詳細を表示するには、[`internetAccess/v2/services/{serviceId}`](https://docs.equinix.com/ja/api-catalog/internetaccessv2.md#tag/EIA-Service/operation/getEquinixInternetAccessServiceDetails) エンドポイントを使用します。

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