所选语种没有对应资源，请选择：
企业业务网站
选择区域/语言
Huawei Global - English
技术支持 文档中心
S1700, S2720, S5700, S6700 V200R019C10 NETCONF YANG API参考

本文档介绍了设备支持的NETCONF YANG API功能，包括数据模型及相关示例。

评分并提供意见反馈 :
华为采用机器翻译与人工审校相结合的方式将此文档翻译成不同语言，希望能帮助您更容易理解此文档的内容。 请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 华为对于翻译的准确性不承担任何责任，并建议您参考英文文档（已提供链接）。
文件管理与启动（HTTPS）

文件管理与启动（HTTPS）

该模型主要功能是通过HTTPS协议对文件进行管理与启动。

数据模型

通过HTTPS协议管理文件对应的数据模型文件名为huawei-system-load.yang。

表2-51 HTTPS协议管理文件的数据模型

节点

说明

取值范围

备注

load-file/loadfile/files/name

表示下载/上传文件的名称。

字符串形式，长度范围是1～64。

NA

load-file/loadfile/files/file-parameters/type

表示下载/上传文件的类型。

字符串枚举格式。

  • cc-packet：软件大包。
  • patch：补丁文件。
  • license：许可证。
  • initial-cfg：配置文件。
  • python-file：python文件。
  • cpu-utilization-diagnosis：记录CPU使用率的文件。
  • mem-utilization-diagnosis：记录内存使用率的文件。
  • reboot-diagnosis：记录交换机重启信息的文件。
  • commom-diagnosis-info：收集系统的公共信息。
  • device-diagnosis-info：收集设备的诊断信息。
  • current-configuration：收集设备的运行配置。
  • sys-root-certification：根证书。
  • capture-file：capture文件。
  • device-certification：设备证书。

NA

load-file/loadfile/files/file-parameters/size

表示下载文件的大小。

整数形式，单位是byte。

仅下载文件时需要填充。

load-file/loadfile/files/direction

表示下载还是上传文件。
字符串枚举格式，包含如下枚举值：
  • download：下载文件
  • upload：上传文件

NA

load-file/loadfile/files/file-parameters/checksum/digest-algorithm

表示控制器使用的文件验证模式。

字符串枚举格式。

  • sha256：HMAC-SHA256加密算法。

仅下载文件时需要填充。

load-file/loadfile/files/file-parameters/checksum/digest

表示目标文件校验值。

字符串形式，长度范围是1～64。

仅下载文件时需要填充。

load-file/loadfile/files/file-parameters/file-load-peers/file-location/fileserver-address

表示文件服务器地址。

字符串形式，长度范围是1～64。

NA

load-file/loadfile/files/file-parameters/file-load-peers/file-location/file-directory

表示文件服务器上的路径。

字符串形式，长度范围是1～128。

NA

load-file/loadfile/files/https/authentication-method

表示https的认证方式。
字符串枚举格式，包含如下枚举值：
  • account：使用账号进行认证。
  • tls-ssl：使用tls-ssl进行认证。
  • account-and-ca：使用账号和tls-ssl进行认证。
  • none：不进行认证。
  • 如果取值是account或account-and-ca，需要同时下发https/username和https/password节点。
  • 如果取值是tls-ssl或account-and-ca，需要填ca-authentication-method节点。

load-file/loadfile/files/https/username

表示文件服务器的用户名。

字符串形式。

NA

load-file/loadfile/files/https/password

表示文件服务器的密码。

字符串形式。

NA

load-file/loadfile/files/https/ca-authentication-method

表示文件服务器的验证方式。
字符串枚举格式，包含如下枚举值：
  • bidirection：双向验证
  • unidirection：单向验证

NA

load-file/loadfile/files/https/port

表示文件服务器的端口号。

整数形式，取值是0～65535。

NA

load-file/loadfile/files/pre-load-actions/remove-old-cc

表示删除设备旧大包补丁，空间不足时删除日志。
布尔型，其中：
  • true：开启
  • false：关闭

NA

load-file/loadfile/files/pre-load-actions/remove-old-log

表示删除设备日志文件。
布尔型，其中：
  • true：开启
  • false：关闭

NA

post-load-action/actions-to-file/name

表示执行文件的名称。

字符串形式，长度范围是5～48。

NA

post-load-action/actions-to-file/type

表示执行文件的类型。

字符串枚举格式。

  • initial-cfg：配置文件。

NA

post-load-action/actions-to-file/actions/enable

表示执行文件。
布尔型，其中：
  • true：开启
  • false：关闭

NA

/huawei-system-load:download-guage

表示设备加载过程状态。

NA

包括下载状态、下载进度、下载失败的错误标识等。

control-loading-action/actions-to-file/actions/status

表示对正在下载的文件的操作。

字符串枚举格式，取值如下：

  • pause：暂停
  • resume：重新下载
  • cancel：取消

NA

从文件服务器下载文件到交换机

本章节主要介绍交换机从文件服务器下载文件到交换机的报文。

表2-52 交换机从文件服务器下载文件到交换机

操作

XPATH

rpc

/huawei-system-load/load-file

数据需求

表2-53 交换机从文件服务器下载文件到交换机的数据

项目

数据

描述

文件名称

test.cc

下载文件的名称

文件类型

sys-load:cc-packet

下载文件的类型

文件大小

60301028 byte

下载文件的大小

目标文件校验值

ff0fd0701a5ab80ee406816be4f8ea4d61c798a7ed503ece6e25f0b569b73369

下载文件的校验值

文件处理方式

download

下载文件

SFTP服务器地址

192.168.1.5

文件服务器的地址

服务器文件目录

/

文件服务器的文件目录

HTTPS服务器认证方式

none

不需要认证

HTTPS服务器端口号

18020

文件服务器的端口号

请求示例

<?xml version="1.0" encoding="UTF-8"?>
<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="d05b09cf-309f-11e7-bc35-c5664306265c">
 <sys-load:load-file xmlns:sys-load="urn:huawei:params:xml:ns:yang:huawei-system-load"> 
  <sys-load:loadfile> 
   <sys-load:files> 
    <sys-load:name>test.cc</sys-load:name> 
    <sys-load:file-parameters> 
     <sys-load:type>sys-load:cc-packet</sys-load:type> 
     <sys-load:size>60301028</sys-load:size> 
     <sys-load:checksum>
       <sys-load:digest-algorithm>sha256</sys-load:digest-algorithm>
       <sys-load:digest>ff0fd0701a5ab80ee406816be4f8ea4d61c798a7ed503ece6e25f0b569b73369</sys-load:digest>
    </sys-load:file-parameters> 
    <sys-load:direction>download</sys-load:direction>
    <sys-load:file-load-peers> 
     <sys-load:file-location> 
      <sys-load:fileserver-address>192.168.1.5</sys-load:fileserver-address> 
      <sys-load:file-directory>/</sys-load:file-directory> 
     </sys-load:file-location> 
    </sys-load:file-load-peers> 
    <sys-load:https> 
     <sys-load:authentication-method>none</sys-load:authentication-method>
     <sys-load:port>18020</sys-load:port> 
    </sys-load:https> 
   </sys-load:files> 
  </sys-load:loadfile> 
 </sys-load:load-file> 
</rpc>

响应示例

配置成功响应示例

<?xml version="1.0" encoding="UTF-8"?> 
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1001"> 
  <ok/> 
</rpc-reply>

配置失败响应示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="5">
  <rpc-error>
    <error-type>application</error-type>
    <error-tag>operation-failed</error-tag>
    <error-severity>error</error-severity>
    <error-message>parse rpc config error.</error-message>
  </rpc-error>
</rpc-reply>

从交换机上传文件到文件服务器

本章节主要介绍通知交换机上传文件到文件服务器的报文。

表2-54 通知交换机上传文件到文件服务器

操作

XPATH

rpc

/huawei-system-load/load-file

数据需求

表2-55 通知交换机上传文件到文件服务器的数据

项目

数据

描述

文件名称

2017_04_24_12_13_55_slot_1_0_cpu_diag.txt.gz

上传的文件名称

文件类型

cpu-utilization-diagnosis

上传的文件类型

文件处理方式

upload

上传文件

SFTP服务器地址

192.168.1.5

文件服务器的地址

服务器文件目录

/

文件服务器的文件目录

SFTP服务器认证方式

none

不需要认证

SFTP服务器端口号

18020

文件服务器的端口号

请求示例

<?xml version="1.0" encoding="UTF-8"?>
<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="d05b09cf-309f-11e7-bc35-c5664306265c">
 <sys-load:load-file xmlns:sys-load="urn:huawei:params:xml:ns:yang:huawei-system-load">
  <sys-load:loadfile>
   <sys-load:files>
    <sys-load:name>2017_04_24_12_13_55_slot_1_0_cpu_diag</sys-load:name>
    <sys-load:file-parameters>
     <sys-load:type>cpu-utilization-diagnosis</sys-load:type>
    </sys-load:file-parameters>
    <sys-load:direction>upload</sys-load:direction>
    <sys-load:file-load-peers>
     <sys-load:file-location>
      <sys-load:fileserver-address>192.168.1.5</sys-load:fileserver-address>
      <sys-load:file-directory>/</sys-load:file-directory>
     </sys-load:file-location>
    </sys-load:file-load-peers>
    <sys-load:https>
     <sys-load:authentication-method>none</sys-load:authentication-method>
     <sys-load:port>18020</sys-load:port>
    </sys-load:https>
   </sys-load:files>
  </sys-load:loadfile>
 </sys-load:load-file>
</rpc>

响应示例

配置成功响应示例

<?xml version="1.0" encoding="UTF-8"?> 
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1001"> 
  <ok/> 
</rpc-reply>

配置失败响应示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="5">
  <rpc-error>
    <error-type>application</error-type>
    <error-tag>operation-failed</error-tag>
    <error-severity>error</error-severity>
    <error-message>parse rpc config error.</error-message>
  </rpc-error>
</rpc-reply>

上传文件失败时的通知消息

<notification xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<eventTime>2017-01-04T15:56:43Z</eventTime>
  <load-result xmlns="urn:huawei:params:xml:ns:yang:huawei-system-load">
    <name>2017_04_24_12_13_55_slot_1_10_cpu_diag.txt.gz</name>
    <direction>upload</direction>
    <type>cpu-utilization-diagnosis</type>
    <result>fail</result>
    <error-tag>1</error-tag>
    <sub-error-tag>65539</sub-error-tag>
    <directory>/</directory>
  </load-result>
</notification>
翻译
English
下载文档
更新时间：2022-05-25

文档编号：EDOC1100127118

浏览量：14818

下载量：1049

平均得分:
本文档适用于这些产品

相关版本

相关文档

数字签名

数字签名验证工具
分享
上一页 下一页
华为亿家APP下载 华为亿家APP下载

版权所有 © 华为技术有限公司 1998-2022。 保留一切权利。粤A2-20044005号

您正离开华为站点，前往：