サーバーアクション
Equinix Metal™では、コンソール、CLI、APIを通じて基本的なコマンドや機能を提供しています。
リブート
アップデートのインストールやオペレーティングシステムの設定後、サーバーを再起動する必要がある場合があります。このような場合、エクイニクスのコンソール、CLI、APIからリブートコマンドを送信できます。
- Console
- CLI
- API
Actions ドロップダウンメニューをクリックし、Reboot をクリックします。サーバーの再起動を確認すると、"Server Action Succeeded" というメッセージが表示されます。
metal device reboot コマンドでサーバーを再起動します。
metal device reboot --id <device_uuid>
/devices/{id}/actions エンドポイントへの POST リクエストでサーバーをリブートでき、アクションのタイプを "reboot" と指定できます。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/actions" \
-d '{
"type": "reboot"
}'
再起動中、サーバーは使用できなくなりますが、数分後、または再起動プロセスにかかる時間に応じて復帰するはずです。コンソール、CLI、および API から開始された再起動アクションはログに記録され、サーバーの Timeline タブに一覧表示されます。
電源オフと電源オン
サーバーをプロジェクトにプロビジョニングしたまま、電源を切った状態にすることができます。
注：サーバーの電源を切っても、課金は停止されません。課金を停止するには、サーバーのプロビジョニングを解除する必要があります。
- Console
- CLI
- API
サーバーの電源を切るには、Actions ドロップダウンメニューをクリックし、Power Off をクリックします。
サーバーの電源を切ることを確認すると、「Server Action Succeeded」というメッセージが表示され、サーバーのステータスが_Stopped_に更新されます。
サーバーの電源を入れるには、Actions メニューをクリックし、Power On をクリックします。
サーバーの電源をオンにすることを確認すると、"Server Action Succeeded "メッセージが表示され、サーバーのステータスが最初に_Starting_に更新され、次に_Running_に更新されます。
サーバーの電源を切るには、metal device stop コマンドを使用します。
metal device stop --id <device_uuid>
サーバーの電源を入れるには、metal device start コマンドを使用します。
metal device start --id <device_uuid>
/devices/{id}/actions エンドポイントへの POST 要求でサーバーの電源を切ることができ、アクションのタイプを "power_off" として指定します。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/actions" \
-d '{
"type": "power_off"
}'
同様に、/devices/{id}/actions エンドポイントへの POST リクエストでサーバーをパワーオンし、アクションのタイプを "power_on" として指定することができます。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/actions" \
-d '{
"type": "power_on"
}'
コンソール、CLI、および API から開始されたパワーオフとパワーオンのアクションは、サーバーの Timeline タブに記録され、一覧表示されます。
デバイスのロックとロック解除
デバイスをロックして、プロビジョニングされたサーバーの破壊的な変更を防ぐことができます。デバイスをロックすると、以下のことが防止されます：
- デバイスの削除またはデプロビジョニング。
- デバイスの 再インストール を開始します。
"termination time"がセットされたインスタンスの削除またはデプロビジョニング。Spot Market サーバーの終了時間は、デバイスをロックすることで上書きすることはできません。
ロックとロック解除のアクションはログに記録され、サーバーの_Timeline_タブに表示されます。
- Console
- CLI
- API
サーバーをロックまたはロック解除するには、サーバーの Actions ドロップダウンメニューの横にあるロックアイコンをクリックします。
デバイスをロックまたはアンロックするには、metal device update コマンドを使用し、--locked フラグを使用します。
ロックする：
metal device update -i <device_id> --locked true
ロックを解除する：
metal device update -i <device_id> --locked false
サーバをロックまたはアンロックするには、/devices/{id} エンドポイントに PUT リクエストを送信し、リクエスト本文で "locked" フィールドの状態を指定します。
ロックする：
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: $API_TOKEN" \
"https://api.equinix.com/metal/v1/devices/{id}" \
-d '{
"locked": true
}'
ロックを解除する：
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: $API_TOKEN" \
"https://api.equinix.com/metal/v1/devices/{id}" \
-d '{
"locked": false
}'
レスキュー、再インストール、OOBコンソール
サーバーの_Actions_メニューにある他の項目は、それぞれ_Recovery_セクションに例を挙げて使い方を説明した独自のドキュメント・ページがあります。