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

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

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

SNMP

本章节介绍SNMP的配置模型，以及配置的XML报文示例。

数据模型

SNMP的配置模型文件如下：
  • ietf-snmp.yang
  • ietf-snmp-engine.yang
  • ietf-snmp-target.yang
  • ietf-snmp-notification.yang
  • ietf-snmp-community.yang
  • ietf-snmp-usm.yang
  • ietf-snmp-vacm.yang
  • huawei-snmp.yang
表2-487 SNMP配置节点

节点

说明

取值范围

备注

/ietf-snmp:snmp/engine/enabled

是否使能交换机的SNMP Agent功能。

枚举值类型：

  • true：使能
  • false：去使能

缺省情况下，交换机的SNMP Agent功能未使能。
  • 配置SNMP功能之前，必须使能SNMP Agent功能。
  • 去使能SNMP Agent前，必须删除所有的SNMP配置。

/ietf-snmp:snmp/engine/listen/name

交换机名称。

字符串形式，区分大小写，长度范围是1～32。

该节点没有实际意义，符合取值范围要求即可。配置/ietf-snmp:snmp/ietf-snmp:engine/listen/transport/udp/port节点时必须配置该节点。

/ietf-snmp:snmp/engine/listen/transport/udp/ip

交换机的IP地址。

点分十进制格式，必须是合法的IPv4地址。

该节点没有实际意义，符合取值范围要求即可。配置/ietf-snmp:snmp/ietf-snmp:engine/listen/transport/udp/port节点时必须配置该节点。

/ietf-snmp:snmp/engine/listen/transport/udp/port

交换机与网管连接所使用的UDP端口。

整数形式，取值范围是161、1025～65535，缺省值是161。

配置该节点时必须同时配置/ietf-snmp:snmp/ietf-snmp:engine/listen/name和/ietf-snmp:snmp/ietf-snmp:engine/listen/transport/udp/ip节点。

/ietf-snmp:snmp/engine/version/v1

交换机启用SNMPv1版本。缺省情况下，交换机启用SNMPv3版本，交换机可同时运行多个SNMP版本。

该节点不需要配置任何数据。

NA

/ietf-snmp:snmp/engine/version/v2c

交换机启用SNMPv2c版本。缺省情况下，交换机启用SNMPv3版本，交换机可同时运行多个SNMP版本。

该节点不需要配置任何数据。

NA

/ietf-snmp:snmp/engine/version/v3

交换机启用SNMPv3版本。缺省情况下，交换机启用SNMPv3版本，交换机可同时运行多个SNMP版本。

该节点不需要配置任何数据。

NA

/ietf-snmp:snmp/engine/engine-id

SNMP Agent引擎ID。

十六进制数字，用：隔开，长度范围是10～64，全零或者全F为无效值，如80:00:07:DB:03:00:01:00:02:00:B1。

配置或修改该节点时，必须先清除交换机上的所有SNMPv3用户。

/ietf-snmp:snmp/engine/enable-authen-traps

是否使能交换机向网管发送团体名认证失败告警功能。

枚举值类型：

  • true：使能
  • false：去使能

缺省情况下，该功能未使能。

NA

/ietf-snmp:snmp/community/index

SNMP团体名索引。

字符串形式，区分大小写，长度范围是1～32。

该节点没有实际意义，符合取值范围要求即可。配置/ietf-snmp:snmp/ietf-snmp:community/text-name节点时必须配置该节点。

/ietf-snmp:snmp/community/security-name

SNMP团体安全名。

字符串形式，区分大小写，长度范围是1～32。

该节点没有实际意义，符合取值范围要求即可。配置/ietf-snmp:snmp/ietf-snmp:community/text-name节点时必须配置该节点。

/ietf-snmp:snmp/community/text-name

SNMP团体名。
字符串形式，区分大小写，不支持空格，长度范围是8～32或44、56、80、88。
  • 当输入的字符串两端使用双引号时，可在字符串中输入空格。
  • 当输入的字符串长度在8至32之间时，系统默认为是明文输入，会对明文加密。
  • 当输入的字符串长度为32、44、56、80或88时，系统默认为是密文输入，将判断该密文能否解析。
  • 配置该节点时必须同时配置/ietf-snmp:snmp/ietf-snmp:community/index和/ietf-snmp:snmp/ietf-snmp:community/security-name节点。
  • 不同的index必须配置不同的text-name。
  • 缺省情况下，设备已使能SNMP团体名复杂度检查功能。此时：团体名必须至少包含2种字符，包括：大写字母、小写字母、数字、特殊字符(不包括问号)；最小长度为设备允许的明文类型密码长度。可以通过节点/ietf-snmp:snmp/huawei-snmp:complexity-check去使能SNMP团体名复杂度检查功能，但是如果配置的团体名比较简单，不满足复杂度的要求，就比较容易受到非法用户的攻击和破解，影响设备的安全性。因此建议使能团体名复杂度检查功能。

/ietf-snmp:snmp/community/huawei-snmp:authority

SNMP团体名权限。

枚举值类型：

  • read-only：团体名具有只读权限
  • read-write：团体名具有读写权限

缺省值是read-only。

NA

/ietf-snmp:snmp/huawei-snmp:complexity-check

是否使能SNMP团体名复杂度检查功能。

布尔型：

  • true：使能
  • false：去使能

缺省值是true。

NA

/ietf-snmp:snmp/notify-filter-profile/name

过滤视图名。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

NA

/ietf-snmp:snmp/notify-filter-profile/include

过滤视图可以访问的MIB子树。

字符串形式，不支持空格，区分大小写，长度范围是1～255。取值可以是：

  • MIB子树的根节点OID，如1.4.5.3.1
  • MIB子树的根节点名称，如system
  • 必须是一个合法的MIB子树。
  • OID的单个节点有两位及以上的数字时，不能以0开始。如1.3.6.1.4.1.2011不能配置为1.3.6.1.4.1.02011。
  • 不能和同一个过滤视图下exclude节点配置相同的MIB子树。

/ietf-snmp:snmp/notify-filter-profile/exclude

过滤视图无法访问的MIB子树。

字符串形式，不支持空格，区分大小写，长度范围是1～255。取值可以是：

  • MIB子树的根节点OID，如1.4.5.3.1
  • MIB子树的根节点名称，如system
  • 必须是一个合法的MIB子树。
  • OID的单个节点有两位及以上的数字时，不能以0开始。如1.3.6.1.4.1.2011不能配置为1.3.6.1.4.1.02011。
  • 不能和同一个过滤视图下include节点配置相同的MIB子树。

/ietf-snmp:snmp/target/name

网管名称。

字符串形式，区分大小写，长度范围是1～32。

该节点没有实际意义，符合取值范围要求即可。配置/ietf-snmp:snmp/ietf-snmp:target/transport/udp/udp/ip节点时必须配置该节点。

/ietf-snmp:snmp/target/transport/udp/udp/ip

网管的IP地址。

字符串形式，可以是IPv4地址，也可以是IPv6地址：

  • IPv4地址：
  • IPv6地址：总长度为128位，通常分为8组，每组为4个十六进制数的形式。格式为X:X:X:X:X:X:X:X。

NA

/ietf-snmp:snmp/target/transport/udp/udp/port

网管与交换机连接所使用的UDP端口号。

整数形式，取值范围是0～65535，缺省值是162。

NA

/ietf-snmp:snmp/target/target-params

网管侧SNMP参数集的名称。

字符串形式，区分大小写，长度范围是1～32。

配置告警网管时必须配置该节点。

/ietf-snmp:snmp/target-params/params/v1/v1/security-name

交换机与网管采用SNMPv1版本通信时，网管侧显示的交换机安全名。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

当一个网管接收多个交换机的告警时，该参数用于区分告警来自哪一个交换机。

/ietf-snmp:snmp/target-params/params/v2c/v2c/security-name

交换机与网管采用SNMPv2c版本通信时，网管侧显示的交换机安全名。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

当一个网管接收多个交换机的告警时，该参数用于区分告警来自哪一个交换机。

/ietf-snmp:snmp/target-params/params/usm/usm/user-name

交换机与网管采用SNMPv3版本通信时，网管侧显示的用户安全名。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

交换机和网管都需要配置此参数，如果网管要接收交换机发送的告警，该参数必须通过认证和加密的校验，否则网管无法接收告警。

/ietf-snmp:snmp/target-params/params/usm/usm/security-level

交换机与网管采用SNMPv3版本通信时的报文安全级别。

枚举值类型：

  • no-auth-no-priv：既不认证也不加密
  • auth-no-priv：认证但不加密
  • auth-priv：既认证又加密

NA

/ietf-snmp:snmp/target-params/notify-filter-profile

应用到网管的过滤视图名称。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

必须在应用时或应用前配置过滤视图。

/ietf-snmp:snmp/usm/local/user/name

SNMPv3用户名。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

NA

/ietf-snmp:snmp/usm/local/user/huawei-snmp:acl

SNMPv3用户需要匹配的ACL。
  • 整数形式：取值范围是2000～3999。
  • 字符串形式：区分大小写，不支持空格，以英文字母开始，长度范围是1～64。

必须是已存在的ACL。

/ietf-snmp:snmp/usm/local/user/auth/protocol/md5/md5/key

认证协议为HMAC-MD5-96的认证密码。

十六进制ASCII码，用：隔开，如48:75:61:77:65:69:40:31:32:33，转换为字符串后的长度范围是8～64。
  • 该节点值转换为字符串后，至少包含大写字母、小写字母、数字和特殊字符中的两种或以上类型，特殊字符不包括“？”和空格。
  • 该节点和/ietf-snmp:snmp/usm/local/user/auth/protocol/sha/sha/key不能同时配置。
  • 删除认证密码之前必须先删除加密算法和加密密码。

/ietf-snmp:snmp/usm/local/user/auth/protocol/sha/sha/key

认证协议为HMAC-SHA-96的认证密码。

十六进制ASCII码，用：隔开，如48:75:61:77:65:69:40:31:32:33，转换为字符串后的长度范围是8～64。
  • 该节点值转换为字符串后，至少包含大写字母、小写字母、数字和特殊字符中的两种或以上类型，特殊字符不包括“？”和空格。
  • 该节点和/ietf-snmp:snmp/usm/local/user/auth/protocol/md5/md5/key不能同时配置。
  • 删除认证密码之前必须先删除加密算法和加密密码。

/ietf-snmp:snmp/usm/local/user/priv/protocol/des/des/key

加密算法为DES-56或3DES的加密密码。

十六进制ASCII码，用：隔开，如48:75:61:77:65:69:40:31:32:33，转换为字符串后的长度范围是8～64。
  • 该节点值转换为字符串后，至少包含大写字母、小写字母、数字和特殊字符中的两种或以上类型，特殊字符不包括“？”和空格。
  • 配置加密密码之前必须先配置认证密码。
  • 配置该节点必须同时配置/ietf-snmp:snmp/usm/local/user/priv/protocol/des/des/huawei-snmp:algorithm节点。
  • 该节点和/ietf-snmp:snmp/usm/local/user/priv/protocol/aes/aes/key不能同时配置。

/ietf-snmp:snmp/usm/local/user/priv/protocol/des/des/huawei-snmp:algorithm

加密协议为DES的加密算法。

枚举值类型：

  • des56：DES-56
  • 3des：3DES

NA

/ietf-snmp:snmp/usm/local/user/priv/protocol/aes/aes/key

加密算法为AES-128、AES-192或AES-256的加密密码。

十六进制ASCII码，用：隔开，如48:75:61:77:65:69:40:31:32:33，转换为字符串后的长度范围是8～64。
  • 该节点值转换为字符串后，至少包含大写字母、小写字母、数字和特殊字符中的两种或以上类型，特殊字符不包括“？”和空格。
  • 配置加密密码之前必须先配置认证密码。
  • 配置该节点必须同时配置/ietf-snmp:snmp/usm/local/user/priv/protocol/aes/aes/huawei-snmp:algorithm节点。
  • 该节点和/ietf-snmp:snmp/usm/local/user/priv/protocol/des/des/key不能同时配置。

/ietf-snmp:snmp/usm/local/user/priv/protocol/aes/aes/huawei-snmp:algorithm

加密协议为AES的加密算法。

枚举值类型：

  • aes128：AES-128
  • aes192：AES-192
  • aes256：AES-256

NA

/ietf-snmp:snmp/vacm/view/name

MIB视图名。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

NA

/ietf-snmp:snmp/vacm/view/include

MIB视图可以访问的MIB子树。

字符串形式，不支持空格，区分大小写，长度范围是1～255。取值可以是：

  • MIB子树的根节点OID，如1.4.5.3.1
  • MIB子树的根节点名称，如system
  • 必须是一个合法的MIB子树。
  • OID的单个节点有两位及以上的数字时，不能以0开始。如1.3.6.1.4.1.2011不能配置为1.3.6.1.4.1.02011。
  • 不能和同一个MIB视图下的exclude节点配置相同的MIB子树。

/ietf-snmp:snmp/vacm/view/exclude

MIB视图无法访问的MIB子树。

字符串形式，不支持空格，区分大小写，长度范围是1～255。取值可以是：

  • MIB子树的根节点OID，如1.4.5.3.1
  • MIB子树的根节点名称，如system
  • 必须是一个合法的MIB子树。
  • OID的单个节点有两位及以上的数字时，不能以0开始。如1.3.6.1.4.1.2011不能配置为1.3.6.1.4.1.02011。
  • 不能和同一个MIB视图下的include节点配置相同的MIB子树。

/ietf-snmp:snmp/vacm/group/name

SNMPv3用户组名称。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

NA

/ietf-snmp:snmp/vacm/group/access/context

访问权限适用的上下文。

字符串形式，区分大小写，长度范围是0～32。

配置SNMPv3用户组时必须配置该节点。

/ietf-snmp:snmp/vacm/group/access/security-model

SNMPv3用户组的安全模式。

取值为usm。

配置SNMPv3用户组时必须配置该节点。

/ietf-snmp:snmp/vacm/group/access/security-level

SNMPv3用户组的安全级别。

枚举值类型：

  • no-auth-no-priv：既不认证也不加密
  • auth-no-priv：认证但不加密
  • auth-priv：既认证又加密

NA

/ietf-snmp:snmp/vacm/group/access/read-view

应用到SNMPv3用户组的具有只读权限的MIB视图名。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

NA

/ietf-snmp:snmp/vacm/group/access/write-view

应用到SNMPv3用户组的具有读写权限的MIB视图名。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

NA

/ietf-snmp:snmp/vacm/group/access/notify-view

应用到SNMPv3用户组的具有通知权限的MIB视图名。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

NA

/ietf-snmp:snmp/vacm/group/access/huawei-snmp:acl

SNMPv3用户组需要匹配的ACL。
  • 整数形式：取值范围是2000～3999。
  • 字符串形式：区分大小写，不支持空格，以英文字母开始，长度范围是1～64。

必须是已存在的ACL。

/ietf-snmp:snmp/vacm/group/member/security-name

用户组中SNMPv3成员用户的名称。

字符串形式，不支持空格，区分大小写，长度范围是1～32。当输入的字符串两端使用双引号时，可在字符串中输入空格。

必须是已存在的SNMPv3用户。

/ietf-snmp:snmp/vacm/group/member/security-model

用户组中SNMPv3成员用户的安全模式。

取值为usm。

NA

/ietf-snmp:snmp/huawei-snmp:acl

用于限制网管的ACL。
  • 整数形式：取值范围是2000～3999。
  • 字符串形式：区分大小写，不支持空格，以英文字母开始，长度范围是1～64。

必须是已存在的ACL。

/ietf-snmp:snmp/huawei-snmp:mms

交换机接收和发送的SNMP报文的最大尺寸。

整数形式，取值范围是484～17940，单位是字节，缺省值是12000。

NA

/ietf-snmp:snmp/huawei-snmp:trap-enable

交换机是否使能发送所有模块Trap报文给网管。

布尔型：

  • default-type：将交换机所有模块是否发送Trap报文给网管恢复为缺省情况
  • enable-all：交换机发送所有模块的Trap报文给网管
  • disable-all：交换机不发送任一模块的Trap报文给网管

缺省值是default-type。

交换机所有模块是否发送Trap报文给网管的缺省情况，可通过在交换机上执行命令display snmp-agent trap all进行查看。

/ietf-snmp:snmp/huawei-snmp:source-interface

交换机使用指定接口的IP地址作为发送给网管的Trap报文的源IP地址。

字符串形式，格式为interface-typeinterface-number，其中：

  • interface-type：接口类型
  • interface-number：接口编号

必须是交换机上已存在的接口，且已配置IP地址。

配置允许管理交换机的网管示例

本章节主要介绍通过rpc方法配置允许管理交换机的网管。

表2-488 配置允许管理交换机的网管

操作

XPATH

rpc
  • /ietf-snmp:snmp/engine/enabled
  • /ietf-snmp:snmp/notify-filter-profile/name
  • /ietf-snmp:snmp/notify-filter-profile/include
  • /ietf-snmp:snmp/notify-filter-profile/exclude
  • /ietf-snmp:snmp/target/name
  • /ietf-snmp:snmp/target/transport/udp/udp/ip
  • /ietf-snmp:snmp/target/transport/udp/udp/port
  • /ietf-snmp:snmp/target/target-params
  • /ietf-snmp:snmp/target-params/params/usm/usm/user-name
  • /ietf-snmp:snmp/target-params/params/usm/usm/security-level
  • /ietf-snmp:snmp/target-params/notify-filter-profile

数据需求

项目

数据

描述

是否使能交换机的SNMP Agent功能

true

使能交换机的SNMP Agent功能。

网管名称

test

网管名称为test。

网管的IP地址

10.1.1.1

网管的IP地址为10.1.1.1。

网管与交换机连接所使用的UDP端口号

50

网管与交换机连接所使用的UDP端口号为50。

网管侧SNMP参数集的名称

abc

网管侧SNMP参数集的名称为abc。

交换机与网管采用SNMPv3版本通信时，网管侧显示的用户安全名

abcd

交换机与网管采用SNMPv3版本通信时，网管侧显示的用户安全名为abcd。

交换机与网管采用SNMPv3版本通信时的报文安全级别

auth-priv

交换机与网管采用SNMPv3版本通信时的报文安全级别为auth-priv：既认证又加密。

应用到网管的过滤视图名称

test_profile

应用到网管的过滤视图名称为test_profile。

过滤视图可以访问的MIB子树

1.3.6.1.4.1.2011.5.2.1.1.1.2

过滤视图可以访问1.3.6.1.4.1.2011.5.2.1.1.1.2子树。

过滤视图无法访问的MIB子树

1.3.6.1.4.1.2011.5.2.1.1.1.3

过滤视图无法访问1.3.6.1.4.1.2011.5.2.1.1.1.3子树。

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="5" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <snmp:snmp xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp">
        <snmp:engine>
          <snmp:enabled>true</snmp:enabled>
        </snmp:engine>
        <snmp:target>
          <snmp:name>test</snmp:name>
          <snmp:udp>
            <snmp:ip>10.1.1.1</snmp:ip>
            <snmp:port>50</snmp:port>
          </snmp:udp>
          <snmp:target-params>abc</snmp:target-params>
        </snmp:target>
        <snmp:target-params>
          <snmp:name>abc</snmp:name>
          <snmp:usm>
            <snmp:user-name>abcd</snmp:user-name>
            <snmp:security-level>auth-priv</snmp:security-level>
          </snmp:usm>
          <snmp:notify-filter-profile>test_profile</snmp:notify-filter-profile>
        </snmp:target-params>
        <snmp:notify-filter-profile>
          <snmp:name>test_profile</snmp:name>
          <snmp:include>1.3.6.1.4.1.2011.5.2.1.1.1.2</snmp:include>
          <snmp:exclude>1.3.6.1.4.1.2011.5.2.1.1.1.3</snmp:exclude>
        </snmp:notify-filter-profile>
      </snmp:snmp>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="5">
  <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-app-tag>-1</error-app-tag>
    <error-message>Service process failed.</error-message>
    <error-info>Error on node/ietf-snmp:snmp/engine/enabled</error-info>
  </rpc-error>
</rpc-reply>

配置SNMPv3用户和用户组示例

本章节主要介绍通过rpc方法配置SNMPv3用户和用户组。

表2-489 配置SNMPv3用户和用户组

操作

XPATH

rpc
  • /ietf-snmp:snmp/engine/enabled
  • /ietf-snmp:snmp/usm/local/user/name
  • /ietf-snmp:snmp/usm/local/user/auth/protocol/md5/md5/key
  • /ietf-snmp:snmp/usm/local/user/priv/protocol/des/des/key
  • /ietf-snmp:snmp/usm/local/user/priv/protocol/des/des/huawei-snmp:algorithm
  • /ietf-snmp:snmp/vacm/view/name
  • /ietf-snmp:snmp/vacm/view/include
  • /ietf-snmp:snmp/vacm/view/exclude
  • /ietf-snmp:snmp/vacm/group/name
  • /ietf-snmp:snmp/vacm/group/access/context
  • /ietf-snmp:snmp/vacm/group/access/security-model
  • /ietf-snmp:snmp/vacm/group/access/security-level
  • /ietf-snmp:snmp/vacm/group/access/read-view
  • /ietf-snmp:snmp/vacm/group/access/notify-view
  • /ietf-snmp:snmp/vacm/group/member/security-name
  • /ietf-snmp:snmp/vacm/group/member/security-model

数据需求

项目

数据

描述

是否使能交换机的SNMP Agent功能

true

使能交换机的SNMP Agent功能。

SNMPv3用户名称

test

SNMPv3用户名称test。

SNMPv3用户的认证密码

48:75:61:77:65:69:40:31:32:33

SNMPv3用户采用认证协议HMAC-MD5-96进行认证，认证密码为48:75:61:77:65:69:40:31:32:33。

SNMPv3用户的加密密码

48:75:61:77:65:69:40:31:32:34

SNMPv3用户加密密码为48:75:61:77:65:69:40:31:32:34。

SNMPv3用户的加密算法

des56

SNMPv3用户的加密算法为DES-56。

SNMPv3用户组名称

ssq

SNMPv3用户组名称为ssq。

访问权限适用的上下文

1

访问权限适用的上下文为1。

SNMPv3用户组的安全模式

usm

SNMPv3用户组的安全模式为usm。

SNMPv3用户组的安全级别

auth-priv

SNMPv3用户组的安全级别为auth-priv：既认证又加密。

应用到SNMPv3用户组的具有只读权限的MIB视图

test_view

应用到SNMPv3用户组的具有只读权限的MIB视图为test_view。

应用到SNMPv3用户组的具有通知权限的MIB视图

test_view

应用到SNMPv3用户组的具有通知权限的MIB视图为test_view。

MIB视图可以访问的MIB子树

1.3.6.1.2.1.1

MIB视图可以访问1.3.6.1.2.1.1节点所对应的MIB子树。

MIB视图无法访问的MIB子树

1.3.6.1.2.1.2

MIB视图无法访问1.3.6.1.2.1.2节点所对应的MIB子树。

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="3" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <snmp:snmp xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp">
        <snmp:engine>
          <snmp:enabled>true</snmp:enabled>
        </snmp:engine>
        <snmp:usm>
          <snmp:local>
            <snmp:user>
              <snmp:name>test</snmp:name>
              <snmp:auth>
                <snmp:md5>
                  <snmp:key>48:75:61:77:65:69:40:31:32:33</snmp:key>
                </snmp:md5>
              </snmp:auth>
              <snmp:priv>
                <snmp:des>
                  <snmp:key>48:75:61:77:65:69:40:31:32:34</snmp:key>
                  <hw-snmp:algorithm xmlns:hw-snmp="urn:huawei:params:xml:ns:yang:huawei-snmp">des56</hw-snmp:algorithm>
                </snmp:des>
              </snmp:priv>
            </snmp:user>
          </snmp:local>
        </snmp:usm>
        <snmp:vacm>
          <snmp:group>
            <snmp:name>ssq</snmp:name>
            <snmp:member>
              <snmp:security-name>test</snmp:security-name>
              <snmp:security-model>usm</snmp:security-model>
            </snmp:member>
            <snmp:access>
              <snmp:context>1</snmp:context>
              <snmp:security-model>usm</snmp:security-model>
              <snmp:security-level>auth-priv</snmp:security-level>
              <snmp:read-view>test_view</snmp:read-view>
              <snmp:notify-view>test_view</snmp:notify-view>
            </snmp:access>
          </snmp:group>
          <snmp:view>
            <snmp:name>test_view</snmp:name>
            <snmp:include>1.3.6.1.2.1.1</snmp:include>
            <snmp:exclude>1.3.6.1.2.1.2</snmp:exclude>
          </snmp:view>
        </snmp:vacm>
      </snmp:snmp>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3">
  <ok/>
</rpc-reply>
# 配置失败响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message>Service process failed.</error-message>
    <error-info>Error on node/ietf-snmp:snmp/engine/enabled</error-info>
  </rpc-error>
</rpc-reply>

配置通过ACL限制可以访问交换机的网管示例

本章节主要介绍通过rpc方法配置通过ACL限制可以访问交换机的网管。

表2-490 配置通过ACL限制可以访问交换机的网管

操作

XPATH

rpc
  • /ietf-snmp:snmp/engine/enabled
  • /ietf-snmp:snmp/huawei-snmp:acl

数据需求

项目

数据

描述

是否使能交换机的SNMP Agent功能

true

使能交换机的SNMP Agent功能。

用于限制网管的ACL

3000

用于限制网管的ACL为3000。

请求示例

ACL必须已存在，关于如何配置ACL，请参见ACL规则管理。

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="10" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <snmp:snmp xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp">
        <snmp:engine>
          <snmp:enabled>true</snmp:enabled>
        </snmp:engine>
        <hw-snmp:acl xmlns:hw-snmp="urn:huawei:params:xml:ns:yang:huawei-snmp">3000</hw-snmp:acl>
      </snmp:snmp>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10">
  <ok/>
</rpc-reply>
# 配置失败响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message>Service process failed.</error-message>
    <error-info>Error on node/ietf-snmp:snmp/engine/enabled</error-info>
  </rpc-error>
</rpc-reply>

配置SNMP版本和SNMP Agent引擎ID等功能示例

本章节主要介绍通过rpc方法配置SNMP版本和SNMP Agent引擎ID等功能。

表2-491 配置SNMP版本和SNMP Agent引擎ID等功能

操作

XPATH

rpc
  • /ietf-snmp:snmp/engine/enabled
  • /ietf-snmp:snmp/engine/listen/name
  • /ietf-snmp:snmp/engine/listen/transport/udp/ip
  • /ietf-snmp:snmp/engine/listen/transport/udp/port
  • /ietf-snmp:snmp/engine/version/v1
  • /ietf-snmp:snmp/engine/engine-id

数据需求

项目

数据

描述

是否使能交换机的SNMP Agent功能

true

使能交换机的SNMP Agent功能。

交换机名称

test

交换机名称为test。

交换机的IP地址

10.1.1.1

交换机的IP地址为10.1.1.1。

交换机与网管连接所使用的UDP端口号

2000

交换机与网管连接所使用的UDP端口号为2000。

交换机启用的SNMP版本

v1

交换机启用SNMPv1版本。

SNMP Agent引擎ID

80:00:07:DB:03:00:01:00:02:00:B1

SNMP Agent引擎ID为80:00:07:DB:03:00:01:00:02:00:B1。

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="4" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <snmp:snmp xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp">
        <snmp:engine>
          <snmp:enabled>true</snmp:enabled>
          <snmp:listen>
            <snmp:name>test</snmp:name>
            <snmp:udp>
              <snmp:ip>10.1.1.1</snmp:ip>
              <snmp:port>2000</snmp:port>
            </snmp:udp>
          </snmp:listen>
          <snmp:version>
            <snmp:v1></snmp:v1>
          </snmp:version>
          <snmp:engine-id>80:00:07:DB:03:00:01:00:02:00:B1</snmp:engine-id>
        </snmp:engine>
      </snmp:snmp>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="4">
  <ok/>
</rpc-reply>
# 配置失败响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="4">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message>Service process failed.</error-message>
    <error-info>Error on node/ietf-snmp:snmp/engine/enabled</error-info>
  </rpc-error>
</rpc-reply>

配置交换机接收和发送的SNMP报文的最大尺寸示例

本章节主要介绍通过rpc方法配置交换机接收和发送的SNMP报文的最大尺寸。

表2-492 配置交换机接收和发送的SNMP报文的最大尺寸

操作

XPATH

rpc

 /ietf-snmp:snmp/huawei-snmp:mms

数据需求

项目

数据

描述

交换机接收和发送的SNMP报文的最大尺寸

484

交换机接收和发送的SNMP报文的最大尺寸为484字节。

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="15" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <snmp:snmp xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp">
        <snmp:engine>
          <snmp:enabled>true</snmp:enabled>
        </snmp:engine>
        <hw-snmp:mms xmlns:hw-snmp="urn:huawei:params:xml:ns:yang:huawei-snmp">484</hw-snmp:mms>
      </snmp:snmp>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <ok/>
</rpc-reply>
# 配置失败响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message>Service process failed.</error-message>
    <error-info>Error on node/ietf-snmp:snmp/engine/enabled</error-info>
  </rpc-error>
</rpc-reply>

配置交换机发送所有模块Trap报文给网管示例

本章节主要介绍通过rpc方法配置交换机发送所有模块Trap报文给网管。

表2-493 配置交换机发送所有模块Trap报文给网管

操作

XPATH

rpc

 /ietf-snmp:snmp/huawei-snmp:trap-enable

数据需求

项目

数据

描述

交换机是否发送所有模块Trap报文给网管

enable-all

配置交换机发送所有模块Trap报文给网管。

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="15" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <snmp:snmp xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp">
        <snmp:engine>
          <snmp:enabled>true</snmp:enabled>
        </snmp:engine>
        <hw-snmp:trap-enable xmlns:hw-snmp="urn:huawei:params:xml:ns:yang:huawei-snmp">enable-all</hw-snmp:trap-enable>
      </snmp:snmp>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <ok/>
</rpc-reply>
# 配置失败响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message>Service process failed.</error-message>
    <error-info>Error on node/ietf-snmp:snmp/engine/enabled</error-info>
  </rpc-error>
</rpc-reply>

配置交换机发送给网管的Trap报文的源IP地址示例

本章节主要介绍通过rpc方法配置交换机发送给网管的Trap报文的源IP地址。

表2-494 配置交换机发送给网管的Trap报文的源IP地址

操作

XPATH

rpc

 /ietf-snmp:snmp/huawei-snmp:source-interface

数据需求

项目

数据

描述

交换机发送给网管的Trap报文的源IP地址

Vlanif5

交换机使用Vlanif5接口的IP地址作为发送给网管的Trap报文的源IP地址。

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="15" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <snmp:snmp xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp">
        <snmp:engine>
          <snmp:enabled>true</snmp:enabled>
        </snmp:engine>
        <hw-snmp:source-interface xmlns:hw-snmp="urn:huawei:params:xml:ns:yang:huawei-snmp">Vlanif5</hw-snmp:source-interface>
      </snmp:snmp>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <ok/>
</rpc-reply>
# 配置失败响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message>Service process failed.</error-message>
    <error-info>Error on node/ietf-snmp:snmp/engine/enabled</error-info>
  </rpc-error>
</rpc-reply>

配置SNMP团体名复杂度检查示例

本章节主要介绍通过rpc方法配置SNMP团体名复杂度检查。

表2-495 配置SNMP团体名复杂度检查

操作

XPATH

rpc

 /ietf-snmp:snmp/huawei-snmp:complexity-check

数据需求

项目

数据

描述

交换机是否使能SNMP团体名复杂度检查功能

true

使能交换机SNMP团体名复杂度检查功能。

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="15" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <snmp:snmp xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp">
        <snmp:engine>
          <snmp:enabled>true</snmp:enabled>
        </snmp:engine>
        <hw-snmp:complexity-check xmlns:hw-snmp="urn:huawei:params:xml:ns:yang:huawei-snmp">true</hw-snmp:complexity-check>
      </snmp:snmp>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <ok/>
</rpc-reply>
# 配置失败响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message>Service process failed.</error-message>
    <error-info>Error on node/ietf-snmp:snmp/engine/enabled</error-info>
  </rpc-error>
</rpc-reply>

配置SNMP团体名示例

本章节主要介绍通过rpc方法配置SNMP团体名。

表2-496 配置SNMP团体名

操作

XPATH

rpc
  • /ietf-snmp:snmp/engine/enable-authen-traps
  • /ietf-snmp:snmp/community/index
  • /ietf-snmp:snmp/community/text-name
  • /ietf-snmp:snmp/community/security-name
  • /ietf-snmp:snmp/community/huawei-snmp:authority

数据需求

项目

数据

描述

是否使能交换机向网管发送团体名认证失败告警功能

true

使能交换机向网管发送团体名认证失败告警功能。

团体名索引

1

团体名索引为1。

团体名

root@123

团体名为root@123。

团体安全名

aa

团体安全名为aa。

团体名权限

read-write

该团体名具有读写权限。

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="15" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <snmp:snmp xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp">
        <snmp:engine>
          <snmp:enabled>true</snmp:enabled>
          <snmp:enable-authen-traps>true</snmp:enable-authen-traps>
        </snmp:engine>
        <snmp:community>
          <snmp:index>1</snmp:index>
          <snmp:text-name>root@123</snmp:text-name>
          <snmp:security-name>aa</snmp:security-name>
          <hw-snmp:authority xmlns:hw-snmp="urn:huawei:params:xml:ns:yang:huawei-snmp">read-write</hw-snmp:authority>
        </snmp:community>
      </snmp:snmp>
    </config>
  </edit-config>
</rpc>

响应示例

# 配置成功响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <ok/>
</rpc-reply>
# 配置失败响应示例。
<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="15">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message>Service process failed.</error-message>
    <error-info>Error on node/ietf-snmp:snmp/engine/enabled</error-info>
  </rpc-error>
</rpc-reply>
翻译
English
下载文档
更新时间：2022-05-25

文档编号：EDOC1100127118

浏览量：14930

下载量：1050

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

相关版本

相关文档

数字签名

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

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

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