iDRACのRESTful APIでマシンの電源をオン/オフする [のふ処|NOFUDOKORO]

この文書は読取専用です。文書のソースを閲覧することは可能ですが、変更はできません。もし変更したい場合は管理者に連絡してください。
====== iDRACのRESTful APIでマシンの電源をオン/オフする ======

===== 試した環境 =====

  * PowerEdge T330
    * iDRAC 8 Ver.2.61.60.60
      * Web管理ページの設定>ネットワーク>サービスで、Redfishが有効になっていることを確認のこと

===== 手順 =====

iDRAC 7からRedfish準拠のRESTful APIに対応しているので、''https://iDRACのIPアドレス/redfish/v1/リソースパス''に対して、リクエストすればよい。

例えば、''https://iDRACのIPアドレス/redfish/v1/Chassis/System.Embedded.1''をブラウザで開くと、システム概要がJSONで返ってくる。BASIC認証はiDRACのアカウントで通る。

{{ :pc:server:idrac_rest_api_system_info.png |}}

実に簡単ですね。curlならこんな感じ。

<code>
> curl -k -i -u root:calvin -X GET https://iDRACのIPアドレス/redfish/v1/Chassis/System.Embedded.1
HTTP/1.1 200 OK
OData-Version: 4.0
Keep-Alive: timeout=60, max=199
Content-Type: application/json;odata.metadata=minimal;charset=utf-8
Server: iDRAC/8
Date: Sat, 17 Aug 2024 23:56:32 GMT
Link: </redfish/v1/Schemas/Chassis.v1_5_0.json>;rel=describedby
Cache-Control: no-cache
Content-Length: 1997
Allow: POST,PATCH
Connection: Keep-Alive
Access-Control-Allow-Origin: *
Accept-Ranges: bytes

{"@odata.context":"/redfish/v1/$metadata#Chassis.Chassis","@odata.id":"/redfish/v1/Chassis/System.Embedded.1","@odata.type":"#Chassis.v1_5_0.Chassis","Actions":{"#Chassis.Reset":{"ResetType@Redfish.AllowableValues":["On","ForceOff"],"target":"/redfish/v1/Chassis/System.Embedded.1/Actions/Chassis.Reset"}},"AssetTag":"","ChassisType":"StandAlone","Description":"It represents the properties for physical components for any system.It represent racks, rackmount servers, blades, standalone, modular systems,enclosures, and all other containers.The non-cpu/device centric parts of the schema are all accessed either directly or indirectly through this resource.","Id":"System.Embedded.1","IndicatorLED":"Off","Links":{"ComputerSystems":[{"@odata.id":"/redfish/v1/Systems/System.Embedded.1"}],"ComputerSystems@odata.count":1,"Contains":[{"@odata.id":"/redfish/v1/Chassis/Enclosure.Internal.0-1:RAID.Slot.2-1"}],"Contains@odata.count":1,"CooledBy":[],"CooledBy@odata.count":0,"Drives":[],"Drives@odata.count":0,"ManagedBy":[{"@odata.id":"/redfish/v1/Managers/iDRAC.Embedded.1"}],"ManagedBy@odata.count":1,"ManagersInChassis":[{"@odata.id":"/redfish/v1/Managers/iDRAC.Embedded.1"}],"ManagersInChassis@odata.count":1,"PoweredBy":[{"@odata.id":"/redfish/v1/Chassis/System.Embedded.1/Power/PowerSupplies/PSU.Slot.1"}],"PoweredBy@odata.count":1,"Storage":[{"@odata.id":"/redfish/v1/Systems/System.Embedded.1/Storage/RAID.Slot.2-1"},{"@odata.id":"/redfish/v1/Systems/System.Embedded.1/Storage/AHCI.Embedded.1-1"}],"Storage@odata.count":2},"Manufacturer":"Dell Inc.","Model":"PowerEdge T330","Name":"Computer System Chassis","NetworkAdapters":{"@odata.id":"/redfish/v1/Systems/System.Embedded.1/NetworkAdapters"},"PartNumber":"ZZZZZ","Power":{"@odata.id":"/redfish/v1/Chassis/System.Embedded.1/Power"},"PowerState":"Off","SKU":"XXXXX","SerialNumber":"YYYYY","Status":{"Health":"OK","HealthRollup":"OK","State":"Enabled"},"Thermal":{"@odata.id":"/redfish/v1/Chassis/System.Embedded.1/Thermal"}}
</code>

見づらくて大変恐縮なんですが、上記ログの''"PowerState":"Off"''ってのが電源の状態で、ご覧のとおり電源は切れてる状態。

続いて電源を入れてみる。

[[https://www.dell.com/support/manuals/ja-jp/idrac7-8-lifecycle-controller-v2.40.40.40/redfish%202.40.40.40/computersystem?guid=guid-071f0516-1b31-4a4b-90ab-4f9bfcc5db4a&lang=en-us|APIリファレンス]]によると、''/redfish/v1/Systems/<ID>/Actions/ComputerSystem.Reset''に対しPOSTで''ResetType''パラメータを投げつければよいらしい。あ、API内の<ID>は1階層上のリソース──ここではSystemを特定するためのIDで、''/redfish/v1/Systems/''で得られる値を使う……のが正しいと思うんだけど、おおむね''System.Embedded.1''を指定しとけば大丈夫っぽい。

というわけで叩いてみる。コマンドプロンプトを使ったため、JSONのダブルクオーテーションがエスケープされていることに注意。

<code>
> curl -k -i -u root:calvin -X POST -H "Content-Type: application/json" -d "{\"ResetType\":\"On\"}" https://iDRACのIPアドレス/redfish/v1/Systems/System.Embedded.1/Actions/ComputerSystem.Reset
HTTP/1.1 204 No Content
OData-Version: 4.0
OData-EntityId: /redfish/v1/Systems/System.Embedded.1
Keep-Alive: timeout=60, max=199
Content-Type: application/json;odata.metadata=minimal;charset=utf-8
Server: iDRAC/8
Date: Sun, 18 Aug 2024 00:47:11 GMT
Cache-Control: no-cache
Content-Length: 0
Connection: Keep-Alive
Access-Control-Allow-Origin: *
Accept-Ranges: bytes
</code>

返ってきたHTTPステータスコードがAPIリファレンスと違うけど、200番台だし成功なんでしょう、きっと。

再びシステム概要を問い合わせ、電源の状態を確認してみる。（さすがに見づらかったのでjqを入れた）

<code>
> curl -k -u root:calvin -X GET https://iDRACのIPアドレス/redfish/v1/Chassis/System.Embedded.1 | jq ".PowerState"
"On"
</code>

期待どおりですな。iDRACのWeb管理ページの方からも電源が入っていることが確認できるはず。

電源オフは''RequestType''に''PushPowerButton''か''ForceOff''を指定してAPIを叩けばよい。それぞれ、Web管理ページの「正常なシャットダウン」「システムの電源を切る」に相当すると思われる。

===== 参考サイト =====

  * [[https://www.dell.com/support/manuals/ja-jp/idrac7-8-lifecycle-controller-v2.40.40.40/redfish%202.40.40.40/|iDRAC 8/7 v2.40.40.40 Redfish API Reference Guide | Dell 日本]]
  * [[https://qiita.com/tocoteron/items/291b463e45f422abd425|Windows版curlでJSONをPOSTする際に困った話 #post - Qiita]]