全球任播 IP 地址

Equinix Metal™ 全球任播 IP 是从Equinix Metal拥有的 IP 空间中提取的公共 IPv4 地址，可从Equinix Metal 的任何或所有 Metro 中公布。

可以使用全局任播 IP 地址：

• 将它们作为 弹性 IP 地址 分配给多个 Metro 中的单个服务器。
• 或者通过从多个城域网中的多个服务器通过 本地 BGP 公告它们。

如果全球任播 IP 地址未路由到任何城域网中的任何服务器或从任何城域网中的任何服务器公布，则该 IP 地址将无法访问。

Equinix Metal允许您保留以下子网大小的全球任播 IP 地址。

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

全球任播 IP 地址按使用量计费，每 IP 每小时固定费率。带宽按标准出站费率和每 GB 入站费率计费。费率可在Equinix Metal控制台中查看。

申请全球任播 IP 地址

Console

在项目的“网络”部分，打开“IP地址”页面。

您的项目当前 IP 地址应已列出。要申请全局任播 IP 地址，请点击**+ 添加新地址**。

从“请求 IP 地址”滑出菜单中，选择“全局 IPv4”和预留子网的“数量”（大小）。此外，还有“标签”和“描述”字段供您使用。“自定义 JSON”字段用于输入您希望包含在服务器元数据中的自定义数据。

请使用“备注”栏提供与您的请求相关的任何信息，以便联系支持团队。请注意，如果您计划申请多个子网或多个大型子网，项目层面存在配额限制。支持团队可能会就您的请求与您联系。

CLI

要请求全局任播 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" (required) - To request a Global Anycast IP address, use "global_ipv4".
• "quantity" (required) - The quantity parameter should be the number of IPs in the subnet. Valid values are 1, 2, and 4 for Global Anycast IP addresses.
• "fail_on_approval_required" (optional) - If you submit a request that exceeds the maximum number of IP addresses available to your project, you can automatically have the request fail with HTTP status 422 instead of triggering the review process by providing the fail_on_approval_required parameter set to true in the request.

完整的 body 参数字段和选项列表可在 API 参考 中找到。

管理全球任播 IP 地址

Console

您的项目的 IPs 页面包含所有管理子网、保留子网和全局任播子网及 IP 地址的列表。

CLI

在 CLI 中，可以通过 metal ip get 命令获取项目的所有管理子网、保留子网和全局任播子网以及 IP 地址信息。

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

API

要获取项目中的管理子网、保留子网和全局任播子网及 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地址

一旦您获得了全局任播 IPv4 地址块，您有两种选择：将您的新 IP 地址作为 弹性 IP 分配给服务器，或者通过 BGP 通告它们。

如果您选择将全局任播 IP 地址绑定为弹性 IP 地址，则可以将单独的地址分配给每个城域网中的单个服务器。但是，如果您尝试将同一个 IP 地址分配给同一城域网中的多个服务器，则会收到错误消息。

如果您选择使用 BGP 通告您的全球任播 IP 地址，则需要设置和配置本地 BGP。您可以使用 BGP 将全球任播 IP 地址分配给每个城域网中的多个服务器，因此我们建议在需要高可用性的应用场景中使用 BGP。

全球任播 IP 状态

Console

要查看您的全局任播 IP 地址块的状态，请导航至项目的“IP 地址”页面，然后打开要管理的 IP 地址预留的“操作”菜单。单击“更新地址块”。

灰色圆圈表示该地址块中的 IP 尚未在该设施中分配或通过 BGP 进行公告。绿色圆圈表示该地址块中的 IP 已在该设施中分配或公告。如果您未在某个设施中公告或绑定全局任播 IP，我们会将该流量回传到下一个最近的已分配或公告该 IP 的设施。这会产生费用，因此入站传输需要收费。

CLI

要检查全局任播 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 请求来检查项目中每个管理子网、预留子网和全局任播子网中的子网和 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

要删除预留地址，请导航至项目的“IP地址”页面，然后选择“全局任播IP地址块”。点击“删除”。

CLI

要删除全局任播 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}"