グローバル・エニーキャストIPアドレス

Equinix Metal™ Global Anycast IPは、エクイニクスが所有するIPスペースから取得したパブリックIPv4アドレスです。

グローバル・エニーキャストIPアドレスを使用できます：

• (elastic-ips.mdx)として複数のメトロの単一サーバーに割り当てることができます。
• または、複数のメトロにある複数のサーバーからLocal BGP経由でアナウンスします。

グローバル・エニーキャストIPアドレスがメトロのどのサーバにもルーティングされないか、どのサーバからもアナウンスされない場合、そのIPアドレスは到達不能になります。

エクイニクスメタルでは、以下のサブネットサイズのグローバルエニーキャストIPアドレスを予約できます。

Global Anycast Subnet Size	Usable IP Addresses
/32	1 IPv4 address
/31	2 IPv4 addresses
/30	4 IPv4 addresses

グローバル・エニーキャストIPアドレスは、1時間あたりIPあたりの固定料金で使用ベース課金されます。帯域幅は、1GBあたりの標準アウトバウンドレートとインバウンドレートで課金されます。料金はエクイニクスMetalコンソールでご確認いただけます。

グローバル・エニーキャストIPアドレスの要求

Console

プロジェクトの_Networking_セクションで、_IPs_ページを開きます。

プロジェクトの現在のIPアドレスがリストされている必要があります。グローバル Anycast IP アドレスを要求するには、+ Add New をクリックします。

IPアドレスのリクエスト］スライドアウトから、［グローバルIPv4］と予約サブネットの［数量］（サイズ）を選択します。また、_Tags_と_Description_のフィールドもあります。カスタムJSON_フィールドは、サーバーのメタデータに含めたいカスタムデータ用です。

リクエストに関連する情報をサポートに連絡するには、_Comments_フィールドを使用してください。複数のサブネット、または複数の大規模なサブネットをリクエストする場合は、プロジェクトレベルで割り当てがあることにご注意ください。あなたのリクエストについてサポートから質問があるかもしれません。

CLI

グローバル Anycast IP アドレスを要求するには、metal ip request コマンドを使用し、--type を global_ipv4 と指定します。

metal ip request --project-id <project_id> --type global_ipv4 --quantity <int>

API

API で追加の IP アドレスを要求するには、/projects/{id}/ips エンドポイントに POST リクエストを送信します。

curl -X POST \
-H 'Content-Type: application/json' \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/ips" \
-d '{
    "type": "global_ipv4",
    "quantity": 4,
    "fail_on_approval_required": "false"
}'

本体パラメータ

• "type"（必須） - グローバルAnycast IPアドレスを要求するには、"global_ipv4"を使用します。
• "quantity"（必須） - 量パラメータには、サブネット内のIP数を指定します。有効な値は、グローバル Anycast IP アドレスの場合 1、2、4 です。
• "fail_on_approval_required"（オプション） - プロジェクトで利用可能な IP アドレスの最大数を超えるリクエストを送信する場合、リクエストで fail_on_approval_required パラメータを true に設定して提供することで、レビュープロセスをトリガーする代わりに HTTP ステータス 422 でリクエストを自動的に失敗させることができます。

APIリファレンスにボディ・パラメータ・フィールドとオプションの完全なリストがあります。

グローバル・エニーキャストIPアドレスの管理

Console

プロジェクトの IPs ページには、すべての管理、予約、およびグローバル Anycast サブネットと IP のリストが含まれています。

CLI

CLI では、metal ip get コマンドからプロジェクトのすべての管理、予約、グローバル Anycast サブネットと IP アドレス情報を利用できます。

`metal ip get -p <project-uuid>`

API

プロジェクト内の管理、予約、およびグローバル Anycast サブネットと IP のリストを取得するには、/projects/{id}/ips エンドポイントに GET リクエストを送信します。

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/ips"

レスポンスには、"id"フィールドに予約IDが含まれています。(応答例は切り捨てられています)。

{
"ip_addresses": [
    {
    "id": "804c4112-c00a-486c-9c54-0918dd1894b2",
    "address_family": 4,
    "netmask": "255.255.255.254",
    "created_at": "2022-09-21T13:14:55Z",
    "public": true,
    "cidr": 31,
    "management": false,
    "manageable": true,
    "enabled": true,
    "global_ip": true,
    "assignments": [],
    "network": "147....",
    "address": "147....",
    "gateway": "147....",
    "type": "global_ipv4"
    ....
    },
    ....
]
}

IPアドレスの公表

グローバルAnycast IPv4アドレスブロックが割り当てられたら、新しいIPアドレスをElastic IPsとしてサーバに割り当てるか、BGPでアナウンスするかの2つのオプションがあります。

グローバル・エニーキャストIPアドレスをElastic IPアドレスとしてバインドすることを選択した場合、各メトロ内の1つのサーバーに個別のアドレスを割り当てることができます。ただし、同じメトロ内の複数のサーバに同じ IP アドレスを割り当てようとすると、エラーが発生します。

BGP を使用してグローバル Anycast IP をアナウンスする場合は、Local BGP を設定して構成する必要があります。BGP を使用して、各メトロの複数のサーバにグローバル・エニーキャスト IP アドレスを割り当てることができるため、高可用性アプリケーションには BGP の使用をお勧めします。

グローバル・エニーキャストIPステータス

Console

Global Anycast IP ブロックのステータスを表示するには、プロジェクトの IPs ページに移動し、管理する IP 予約の Actions メニューを開きます。ブロックを更新 をクリックします。

灰色の丸は、ブロック内のIPがその施設に割り当てられていないか、BGP経由でアナウンスされていないことを示します。緑色の円は、ブロック内のIPがその施設に割り当てられているか、またはアナウンスされていることを示します。ある施設でグローバル・エニーキャストIPをアナウンスまたはバインドしていない場合、IPが割り当てられるかアナウンスされている次に近い施設にトラフィックをバックホールします。これにはコストが発生するため、インバウンド転送には料金が発生します。

CLI

グローバル Anycast IP ブロックで使用可能なサブネットと IP アドレスを確認するには、metal ip available コマンドを使用します。 --reservation-id は metal ip get -p <project-uuid> コマンドから取得できます。

metal ip available --reservation-id <reservation_UUID> --cidr <size_of_subnet>

API

/ips/{id}エンドポイントにGETリクエストを送信することで、プロジェクトの各管理、予約、グローバルAnycastサブネットのサブネットとIPアドレスのステータスを確認できます。サブネットまたは IP アドレスの予約 UUID がパスに入ります。

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"

レスポンスには"assignments"オブジェクトのIPアドレスブロックの予約IDが含まれます。(応答例は切り捨てられています)。

{
"ip_addresses": [
    {
    "id": "804c4112-c00a-486c-9c54-0918dd1894b2",
    "address_family": 4,
    "netmask": "255.255.255.254",
    "global_ip": true,
        "assignments": [
        {
            "href": "/metal/v1/ips/4cc7f67b-522e-4b6c-82a5-3b2505cf326a"
        }
        ],
    ....
    "type": "global_ipv4"
    },
    ....
]
}

グローバル・エニーキャストIP予約の削除

予約を削除すると、プロジェクトからサブネットが削除されます。そのIPアドレスをサーバーに使用することはできなくなります。

Console

予約を削除するには、プロジェクトの IPs ページに移動し、Global Anycast IP ブロックを選択します。Delete をクリックします。

CLI

グローバル Anycast IP 予約を削除するには、metal ip remove コマンドを使用します。

metal ip remove --id <reservation-id>

API

API を使用して IP 予約を削除するには、/ips/{id} エンドポイントに DELETE リクエストを送信します。id は予約の UUID です。

curl -X DELETE \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"