施設(非推奨)
2023年5月、エクイニクスMetal™は施設固有のAPIエンドポイントとサポートを廃止します。デバイスやその他のインフラストラクチャのプロビジョニングを含む、ロケーション関連のコンセプトはすべてメトロレベルに移行されます。
May 30th, 2023 :
- APIは、facilitiesエンドポイントに送られたリクエストや、パラメータにfacilitiesを使用したリクエストに対して、deprecationメッセージやsunsetメッセージを含むレスポンスヘッダを返します。
- 新しい組織(5月30日以降に作成された組織)は、facilitiesエンドポイントにアクセスできず、リクエストパラメータにfacilitiesを使用することもできません。
施設固有のエンドポイントとリクエスト・パラメーターの使用は、2023年後半にすべてのユーザーに対して永久に使用できなくなる。
一般的なメトロ情報を探す
Facilitiesエンドポイントの廃止に伴い、以下のCLIおよびAPIリクエストに対するレスポンスは、廃止情報を含むレスポンスヘッダを返します。これらのエンドポイントを使用するスクリプトやオートメーションは、代わりにMetrosをクエリするように更新してください。
metal facilities getコマンド。/facilitiesエンドポイント。/projects/{id}/facilitiesエンドポイント。/organizations/{id}/facilitiesエンドポイント。
メトロには、代わりに以下のコマンドとエンドポイントを使用する。
metal metros getコマンド。/locations/metrosエンドポイント。/locations/metros/{id}エンドポイント。
すべてのメトロは、すべての組織とプロジェクトに表示されます。
プロビジョニング
Facilitiesエンドポイントの廃止に伴い、以下のCLIおよびAPIリクエストに対するレスポンスは、廃止情報を含むレスポンスヘッダを返します。これらのエンドポイントを使用するスクリプトやオートメーションは、代わりにMetrosを使用してプロビジョニングするように更新してください。
- CLI
- API
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" は文字列または文字列の配列を取ります。
施設の代わりにメトロを使う
オンデマンドサーバーのプロビジョニングと同様に、以前は特定の施設でのプロビジョニングをサポートしていたその他のデプロイメントオプションやプラットフォーム機能は、非推奨であることを示すレスポンスヘッダを返します。
CLIまたはAPIのファシリティの代わりにMetrosを使用するように、スクリプトまたはオートメーションを更新してください。
"facilities" パラメータの使用は "metros" パラメータと排他的です。
キャパシティ・クエリー
Facilities エンドポイントの廃止に伴い、以下の CLI および API リクエストへの応答は、廃止情報を含む応答ヘッダーを返します。これらのエンドポイントを使用するスクリプトやオートメーションは、代わりに メトロ容量 をクエリするように更新してください。
- メトロの代わりにファシリティで使用する場合の
metal capacityコマンド。 - メトロの代わりにファシリティで使用する場合の
metal capacity checkコマンド。 /capacityエンドポイント。
私のサーバーはどのメトロまたは施設にありますか?
"facilities"オブジェクトを含むサーバーやその他のインフラストラクチャに対する応答は、引き続き"facilities"オブジェクトを返します。メトロレベルでプロビジョニングされるインフラストラクチャの場合、"facilities" オブジェクトは空になることがあります。
すべてのレスポンスには"metro"オブジェクトが含まれ、どのメトロでプロビジョニングされているかを識別します。
ただし、施設レベルの多様性では高可用性や冗長性は保証されないことを知っておく必要があります。高可用性を設定および構成するには、マルチメトロ・アーキテクチャを目指す必要があります。
- CLI
- API
metal deviceコマンドを使用し、出力フラグ-oを使用してJSON応答が必要であることを指定します。
metal device get -i <device_id> -o json
GET リクエストを devices/{id} エンドポイントに送信します。
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"
}
},
...
}