NXR,VXRシリーズ

8-25. Wake ON LAN設定（wol）

 処理概要

Wake ON LAN設定に関する処理を実行します。

 

URIおよびメソッド

機能	Version	URI	メソッド
			POST	PUT	GET	DELETE
Wake ON LAN	v2	/api/v2/wol	－	－	－	－
		/api/v2/wol/wol-list	〇	－	●	－
		/api/v2/wol/wol-list/{NAME}	－	〇	●	〇

凡例：

● : 読み取り専用ユーザも含めアクセス可

〇 : 読み取り専用ユーザはアクセス不可

－ : 未対応

 

実行例

Wake ON LAN設定の作成

メソッド	URI
POST	/api/v2/wol/wol-list

JSON

リクエスト

POST /api/v2/wol/wol-list
Content-Type: application/json

 

{
"wol-list": {
"name": "PC",
"type": "ether",
"interface": "ethernet0",
"hw-address": "00:00:5E:00:53:01",
"broadcast": "enable"
}
}

 

レスポンス

201 Created

 

XML

リクエスト

POST /api/v2/wol/wol-list
Content-Type: application/xml

 

<wol>
<wol-list>
<name>PC</name>
<type>ether</type>
<interface>ethernet0</interface>
<hw-address>00:00:5E:00:53:01</hw-address>
<broadcast>enable</broadcast>
</wol-list>
</wol>

 

レスポンス

201 Created

 

全Wake ON LAN設定の取得

メソッド	URI
GET	/api/v2/wol/wol-list

JSON

リクエスト

GET /api/v2/wol/wol-list
Accept: application/json

 

レスポンス

200 OK
Content-Type: application/json

 

{
"wol-list": [
{
"name": "PC",
"type": "ether",
"interface": "ethernet0",
"hw-address": "00:00:5E:00:53:01",
"broadcast": "enable"
},
{
"name": "PC2",
"type": "udp4",
"address": "192.168.10.255",
"hw-address": "00:00:5E:00:53:02"
}
]
}

 

XML

リクエスト

GET /api/v2/wol/wol-list
Accept: application/xml

 

レスポンス

200 OK
Content-Type: application/xml

 

<wol>
<wol-list>
<name>PC</name>
<type>ether</type>
<interface>ethernet0</interface>
<hw-address>00:00:5E:00:53:01</hw-address>
<broadcast>enable</broadcast>
</wol-list>
<wol-list>
<name>PC2</name>
<type>udp4</type>
<address>192.168.10.255</address>
<hw-address>00:00:5E:00:53:02</hw-address>
</wol-list>
</wol>

 

TEXT/PLAIN

リクエスト

GET /api/v2/wol/wol-list
Accept: text/plain

 

レスポンス

200 OK
Content-Type: text/plain

 

wol name PC interface ethernet 0 00:00:5E:00:53:01 ethernet broadcast
wol name PC2 ip 192.168.10.255 00:00:5E:00:53:02

 

Wake ON LAN設定の更新

メソッド	URI
PUT	/api/v2/wol/wol-list/{NAME}

JSON

リクエスト

PUT /api/v2/wol/wol-list/PC
Content-Type: application/json

 

{
"name": "PC",
"type": "ether",
"interface": "ethernet0",
"hw-address": "00:00:5E:00:53:11",
"broadcast": "enable"
}

 

レスポンス

204 No content

 

XML

リクエスト

PUT /api/v2/wol/wol-list/PC
Content-Type: application/xml

 

<wol-list>
<name>PC</name>
<type>ether</type>
<interface>ethernet0</interface>
<hw-address>00:00:5E:00:53:11</hw-address>
<broadcast>enable</broadcast>
</wol-list>

 

レスポンス

204 No content

 

Wake ON LAN設定の取得

メソッド	URI
GET	/api/v2/wol/wol-list/{NAME}

JSON

リクエスト

GET /api/v2/wol/wol-list/PC
Accept: application/json

 

レスポンス

200 OK
Content-Type: application/json

 

{
"name": "PC",
"type": "ether",
"interface": "ethernet0",
"hw-address": "00:00:5E:00:53:11",
"broadcast": "enable"
}

 

XML

リクエスト

GET /api/v2/wol/wol-list/PC
Accept: application/xml

 

レスポンス

200 OK
Content-Type: application/xml

 

<wol-list>
<name>PC</name>
<type>ether</type>
<interface>ethernet0</interface>
<hw-address>00:00:5E:00:53:11</hw-address>
<broadcast>enable</broadcast>
</wol-list>

 

TEXT/PLAIN

リクエスト

GET /api/v2/wol/wol-list/PC
Accept: text/plain

 

レスポンス

200 OK
Content-Type: text/plain

 

wol name PC interface ethernet 0 00:00:5E:00:53:11 ethernet broadcast

 

Wake ON LAN設定の削除

メソッド	URI
DELETE	/api/v2/wol/wol-list/{NAME}

 

リクエスト

DELETE /api/v2/wol/wol-list/PC

 

レスポンス

204 No content

 

パラメータ

指定可能なパラメータは下記の通りです。

なお、指定可能なパラメータは製品およびファームウェアのバージョンにより異なりますので、各パラメータの詳細については各製品のユーザーズガイド（CLI版）も合わせてご参照ください。

• パラメータ表の説明文中の記号について
  < > … 括弧内の値の範囲から選択することを示しています。
  [ ] … 括弧内の値のどれかを選択することを示しています。
  数字,文字列 … 初期値
• パラメータ表の説明文中のデータタイプについて
  A.B.C.D … IPv4アドレス
  FQDN … FQDN名
  XX:XX:XX:XX:XX:XX … MACアドレス

 

パラメータおよびレベル			説明
Lv.1	Lv.2	Lv.3
wol	wol-list	name	WOL名
		type	タイプ … [ ether | udp4 ]
		address	アドレス …  A.B.C.D FQDN
		interface	インタフェース名（ex. ethernet0）
		hw-address	MACアドレス … XX:XX:XX:XX:XX:XX
		port	UDPポート番号 … <1-65535(9)>
		ethernet-type	Ethernetタイプ … <1501-65535>
		interval	送信間隔 … <1-65535>(sec)
		count	送信回数 … <1-65535>
		broadcast	broadcastアドレスへの送信 … [ enable | disable ]