1. FutureNet製品活用ガイド
  2. FutureNet NXR,VXRシリーズ
  3. REST-API編

FutureNet

NXR,VXRシリーズ

REST-API編

2. メンテナンス

2-6. ファームウェアリストアップデートでの更新（maint/firmware/list-update）

 処理概要

ファームウェアリストアップデートに関する処理を実行します。

 

URIおよびメソッド

機能 Version URI メソッド
POST PUT GET DELETE
firmware list-update v1 /api/v1/maint/firmware/list-update 〇 － ● －
v2 /api/v2/maint/firmware/list-update 〇 － ● －

凡例：

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

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

－ : 未対応

※ NXR-G100シリーズ以外の機種ではREST-APIv2の利用を推奨します。

 

実行例

ファームウェアリストアップデート

メソッド URI
POST /api/{VERSION}/maint/firmware/list-update
JSON
リクエスト

POST /api/v2/maint/firmware/list-update
Content-Type: application/json

 

{
"url": "https://www.example.jp/firmware-list.txt",
"target": "system"
}

 

レスポンス

202 Accepted

 

XML
リクエスト

POST /api/v2/maint/firmware/list-update
Content-Type: application/xml

 

<config>
<url>https://www.example.jp/firmware-list.txt</url>
<target>system</target>
</config>

 

レスポンス

202 Accepted

 

ファームウェアリストアップデートの状況取得

メソッド URI
GET /api/{VERSION}/maint/firmware/list-update
JSON
リクエスト

GET /api/v2/maint/firmware/list-update
Accept: application/json

 

レスポンス

200 OK
Content-Type: application/json

 

{
"version": "9.10.0",
"state": "downloading",
"download": 97,
"build": 70
}

 

XML
リクエスト

GET /api/v2/maint/firmware/list-update
Accept: application/xml

 

レスポンス

200 OK
Content-Type: application/xml

 

<firmware>
<state>updating</state>
<version>9.10.0</version>
<build>70</build>
</firmware>

 

TEXT/PLAIN
リクエスト

GET /api/v2/maint/firmware/list-update
Accept: text/plain

 

レスポンス

200 OK
Content-Type: text/plain

 

state : restarting

 

パラメータ

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

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

  • パラメータ表の説明文中の記号について
    [ ] … 括弧内の値のどれかを選択することを示しています。
  • パラメータ表の説明文中のデータタイプについて
    A.B.C.D … IPv4アドレス
    X:X::X:X … IPv6アドレス
    FILENAME … ファイル名
    USER … ユーザ名

 

パラメータおよびレベル 説明
Lv.1 Lv.2
config url リストファイルダウンロード先 …

  • ssh://USER@[ A.B.C.D | X:X::X:X ]/FILENAME
  • ftp://[ A.B.C.D | X:X::X:X ]/FILENAME
  • diskX:FILENAME
    ※Xはディスク番号 (ex. disk0)
  • http://[ A.B.C.D | X:X::X:X ]/FILENAME
  • https://[ A.B.C.D | X:X::X:X ]/FILENAME
  • https-://[ A.B.C.D | X:X::X:X ]/FILENAME
target 更新対象 … system
password パスワード
※SSHでのみ指定
source 送信元アドレス … [ A.B.C.D | X:X::X:X ]