FutureNet

NXR,VXRシリーズ

REST-API編

2. メンテナンス

2-4. startup-configの保存・取得(maint/startup-config)

 処理概要

startup-configの保存・取得に関する処理を実行します。

 

URIおよびメソッド

機能 Version URI メソッド
POST PUT GET DELETE
startup-config v1 /api/v1/maint/startup-config
v2 /api/v2/maint/startup-config

凡例:

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

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

- : 未対応

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

 

実行例

startup-configの保存

メソッド URI
POST /api/{VERSION}/maint/startup-config
JSON
リクエスト

POST /api/v2/maint/startup-config
Content-Type: application/json

 

{
“config“: {
“global“: {
“hostname“: “nxr530“,
“telnet“: {
“server“: “enable”
},
・・・・・
}

 

レスポンス

200 OK

 

XML
リクエスト

POST /api/v2/maint/startup-config
Content-Type: application/xml

 

<config>
<dns>
<service>enable</service>
</dns>
<dns-intercept/>
・・・・・
</global>
</config>

 

レスポンス

200 OK

 

TEXT/PLAIN
リクエスト

POST /api/v2/maint/startup-config
Content-Type: text/plain

 

!
hostname nxr530
telnet-server enable
http-server enable
rest http enable
rest https enable
!
・・・・・
!
end

 

レスポンス

200 OK

 

APPLICATION/GZIP
リクエスト

POST /api/v2/maint/startup-config
Content-Type: application/gzip

 

インポートするファイルを指定(ex. config.tgz)

 

レスポンス

200 OK

 

APPLICATION/X-TAR
リクエスト

POST /api/v2/maint/startup-config
Content-Type: application/x-tar

 

インポートするファイルを指定(ex. config.tgz)

 

レスポンス

200 OK

 

startup-configの取得

メソッド URI
GET /api/{VERSION}/maint/startup-config
  • TEXT/PLAINは、差分コンフィグに対応している機種のみ対応
  • JSON形式未対応機種では、「Accept: application/json」での表示は不可

 

JSON
リクエスト

GET /api/v2/maint/startup-config
Accept: application/json

 

レスポンス

200 OK
Content-Type: application/json

 

{
“config“: {
“global“: {
“hostname“: “nxr530“,
“telnet“: {
“server“: “enable”
},
・・・・・
}

 

XML
リクエスト

GET /api/v2/maint/startup-config
Accept: application/xml

 

レスポンス

200 OK
Content-Type: application/xml

 

<–NXR-530 Series ver 21.11.13 build 10–>
<–Ethernet0 H/W address : 00:80:6d:xx:xx:xx–>
<–DATE : Tue Apr 25 12:37:38 JST 2023–>
<–DIP-SW : 1:off 2:off 3:off 4:off–>

<config>
<dns>
<service>
enable
</service>
</dns>
<dns-intercept />
・・・・・
 </global>
</config>

 

TEXT/PLAIN
リクエスト

GET /api/v2/maint/startup-config
Accept: text/plain

 

レスポンス

200 OK
Content-Type: text/plain

 

!
! Century Systems NXR-530 Series ver 21.11.13 build 0
!
!
hostname nxr530
telnet-server enable
http-server enable
rest http enable
rest https enable
rest timeout 3600
!
・・・・・
!
end