大都会

Equinix Metal™ 城域网是指按地理位置分组的设施，共享容量和网络功能。我们的城域网覆盖美洲、欧洲、中东和亚太地区的Equinix IBX设施。

城域网内配置

在Equinix Metal上配置服务器时，您需要选择服务器所在的 Metro 区域。我们会根据多种因素（包括 Metro 区域的容量以及您账户或组织的权限）来确定您的服务器实际位于 Metro 区域内的哪个IBX中。

Console

当您配置新的按需服务器时，选择Metro是您做的第一个选择。

CLI

使用 metal device create 命令时，使用 --metro 或 -m 参数来指定 Metro。

metal device create -p $METAL_PROJECT_ID -P <plan> -m <metro> -H <hostname> -O <operating_system>

API

当您发送配置 POST 请求 projects/{id}/devices 端点时，请使用 "metro" 字段，并在 metro_code 中指定您希望服务器所在的位置。

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/devices" \
-d '{
    "metro": "<metro_code>",
    "plan": "<server_type>",
    "operating_system": "<os_code>"
}'

有关如何检查库存和监控产能的信息，请参阅库存和产能页面。

城域网

城域网内的所有Equinix Metal IBX位置均通过高速链路互连，城域网内的典型延迟时间少于 5 毫秒，并且城域网内 IBX 之间的流量无需计费。

此外，我们的许多网络功能都是为了利用这一点而设计的。

• VLANs - When you provision a VLAN in a Metro, all servers in that Metro are able to connect to it.
• Reserved Public IPv4 Addresses - When you request a public IPv4 address, you will be able to assign it to any server in the Metro where you requested it.
• Private IPv4 Addresses - All servers within a project in the same Metro can use private IPv4 addresses to connect to each other. If you need to set up connections between servers in different Metros, you can use Backend Transfer.

关于 Equinix Metal 在城域网中的应用，需要注意一点：由于其高度互联的设计，IBX 级别的服务器多样性并不能保证高可用性。高可用性和冗余架构应跨越多个城域网。更多信息请参阅位置多样性和弹性页面。

地铁快速参考

Tables

Americas

Region	Country	Metro	Code
美洲	巴西	圣保罗	SP
美洲	加拿大	蒙特利尔	MT
美国	加拿大	多伦多	TR
美洲	墨西哥	墨西哥城	MX
美国	美国	亚特兰大	AT
美国	美国	芝加哥	CH
美国	美国	达拉斯	DA
美国	美国	洛杉矶	LA
美国	美国	迈阿密	密歇根州
美国	美国	纽约	纽约州
美国	美国	西雅图	东南
美国	美国	硅谷	SV
美国	美国	华盛顿特区	华盛顿特区

Europe and Middle-East

Region	Country	Metro	Code
欧洲、中东和非洲	芬兰	赫尔辛基	他
欧洲、中东和非洲地区	法国	巴黎	PA
欧洲、中东和非洲地区	德国	法兰克福	法国
欧洲、中东和非洲地区	爱尔兰	都柏林	DB
欧洲、中东和非洲地区	意大利	米兰	ML
欧洲、中东和非洲地区	荷兰	阿姆斯特丹	上午
欧洲、中东和非洲地区	西班牙	马德里	马里兰州
欧洲、中东和非洲	瑞典	斯德哥尔摩	SK
欧洲、中东和非洲地区	英国	伦敦	LD
欧洲、中东和非洲地区	英国	曼彻斯特	马萨诸塞州

Asia-Pacific

Region	Country	Metro	Code
亚太地区	澳大利亚	墨尔本	中东
亚太地区	澳大利亚	悉尼	SY
亚太地区	香港	香港	香港
亚太地区	印度	孟买	MB
亚太地区	日本	大阪	OS
亚太地区	日本	东京	TY
亚太地区	韩国	首尔	SL
亚太地区	新加坡	新加坡	SG

CLI

您可以使用 metal metros 命令列出可用的地铁。

metal metros get

响应示例（截断）：

+--------------------------------------+----------------+------+
|                  ID                  |      NAME      | CODE |
+--------------------------------------+----------------+------+
| b8ffa6c9-3da2-4cf1-b48d-049002b208fe | Seattle        | se   |
| 96a57b6d-c62c-41b5-ab8e-f8d63a7f9887 | Washington DC  | dc   |
| d50fd052-34ec-4977-a173-ad6f9266995d | Hong Kong      | hk   |
| 108b2cfb-246b-45e3-885a-bf3e82fce1a0 | Amsterdam      | am   |
| 932eecda-6808-44b9-a3be-3abef49796ef | New York       | ny   |
|....                                  |....            |....  |
+--------------------------------------+----------------+------+

API

向 /locations/metros 端点发送 GET 请求会返回用户帐户可用的 Metro 列表。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/locations/metros

响应示例（截断）：

{
"metros": [
    {
    "id": "96a57b6d-c62c-41b5-ab8e-f8d63a7f9887",
    "name": "Washington DC",
    "code": "dc",
    "country": "US"
    },
    {
    "id": "d50fd052-34ec-4977-a173-ad6f9266995d",
    "name": "Hong Kong",
    "code": "hk",
    "country": "HK"
    },
    {
    "id": "108b2cfb-246b-45e3-885a-bf3e82fce1a0",
    "name": "Amsterdam",
    "code": "am",
    "country": "NL"
    },
    {
    "id": "932eecda-6808-44b9-a3be-3abef49796ef",
    "name": "New York",
    "code": "ny",
    "country": "US"
    },
    {
    "id": "5f72cbf6-96e4-44f2-ae60-213888fa2b9f",
    "name": "Tokyo",
    "code": "ty",
    "country": "JP"
    },
    ....
]
}    

向 /locations/metros/{id} 端点发送 GET 请求会返回指定 Metro 的信息。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/locations/metros/{id}

例如，使用纽约地铁的 ID，932eecda-6808-44b9-a3be-3abef49796ef：

{
"id": "932eecda-6808-44b9-a3be-3abef49796ef",
"name": "New York",
"code": "ny",
"country": "US"
}