设施（已弃用）

2023 年 5 月， Equinix Metal™ 将弃用特定于设施的 API 端点和支持。所有与位置相关的概念，包括设备和其他基础设施的配置，都将迁移到 Metro 级别。

从May 30th, 2023开始：

API 会向发送到设施端点的请求或在参数中使用设施的请求返回包含弃用和日落消息的响应标头。
新组织（5 月 30 日之后创建的组织）将无法访问设施端点或无法在其请求参数中使用设施。

2023 年底，所有用户将永久禁止使用特定设施端点和请求参数。

查找一般地铁信息

随着 Facilities 端点的弃用，对以下 CLI 和 API 请求的响应将返回包含弃用信息的响应标头。请更新使用这些端点的任何脚本或自动化功能，以改为查询 Metros。

metal facilities get 命令。
/facilities 端点。
/projects/{id}/facilities 端点。
/organizations/{id}/facilities 端点。

请改用以下命令和 Metros 端点。

注意 - 所有 Metro 对所有组织和项目都是可见的。

供应

随着 Facilities 端点的弃用，对以下 CLI 和 API 请求的响应将返回包含弃用信息的响应标头。请更新使用这些端点的所有脚本或自动化功能，改为使用 Metros 进行配置。

使用 metal device create 命令时，请使用 --metro 或 -m 参数指定地铁而不是设施。

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

当您发送配置 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>"
}'

注意："metro" 仅接受字符串类型。"facilities 过去可以接受字符串或字符串数组。

使用地铁代替设施

与按需配置服务器类似，以前在特定设施中支持配置的其他部署选项和平台功能将返回指示其已弃用的响应标头。

请更新您的脚本或自动化以使用 Metros 代替 CLI 或 API 中的设施。

请注意，"facilities" 参数与 "metros" 参数是互斥的；不能同时使用两者。

容量查询

由于 Facilities 端点已弃用，对以下 CLI 和 API 请求的响应将返回包含弃用信息的响应头。请更新所有使用这些端点的脚本或自动化流程，改为查询 Metro capacity。

当与 Facility 而不是 Metro 一起使用时，metal capacity 命令。
当与 Facility 而不是 Metro 一起使用时，metal capacity check 命令。
/capacity 端点。

我的服务器位于哪个都市或设施？

对于包含 "facilities" 对象的服务器和其他基础设施，其响应将继续返回该对象。对于在 Metro 层级配置的基础设施，"facilities" 对象可能为空。

所有响应都包含一个 "metro" 对象，用于标识它在哪个都市区部署。

您仍然可以查明您的服务器位于哪个设施，但是您应该知道，设施级别的多样性并不能提供高可用性或冗余保证。要设置和配置高可用性，您应该选择多城域架构。

使用 metal device 命令，并使用输出标志 -o 指定要 JSON 响应。

metal device get -i <device_id> -o json

向 devices/{id} 端点发送 GET 请求。

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

CLI 和 API 都会返回包含 "facility" 对象的响应。示例响应：

{
"id": "0dd71771-143e-4964-87d2-7e6f0348253a",
...
 "facility": {
    "id": "917e9941-8323-487f-8688-2b0b11baacd4",
    "name": "Silicon Valley",
    "code": "sv15",
    "features": [
      "baremetal",
      "backend_transfer",
      "layer_2",
      "global_ipv4",
      "ibx"
    ],
    "address": {
      ...
      }
    },
    "metro": {
      "id": "2991b022-b8c4-497e-8db7-5a407c3a209b",
      "name": "Silicon Valley",
      "code": "sv",
      "country": "US"
    }
  },
...
}

查找一般地铁信息​

供应​

使用地铁代替设施​

容量查询​

我的服务器位于哪个都市或设施？​

查找一般地铁信息

供应

使用地铁代替设施

容量查询

我的服务器位于哪个都市或设施？