netapp.ontap.na_ontap_bgp_config 模块 – NetApp ONTAP 网络 BGP 配置
注意
此模块是 netapp.ontap 集合 (版本 22.13.0) 的一部分。
如果您使用的是 ansible 包,则可能已安装此集合。它不包含在 ansible-core 中。要检查是否已安装,请运行 ansible-galaxy collection list。
要安装它,请使用:ansible-galaxy collection install netapp.ontap。您需要其他要求才能使用此模块,请参阅 要求了解详细信息。
要在剧本中使用它,请指定:netapp.ontap.na_ontap_bgp_config。
netapp.ontap 22.13.0 中的新增功能
概要
- 创建/修改/删除节点的 BGP 配置。 
要求
执行此模块的主机需要以下要求。
- Ansible 2.9 或更高版本 - 建议使用 2.12 或更高版本。 
- Python3 - 建议使用 3.9 或更高版本。 
- 使用 ZAPI 时,需要 netapp-lib 2018.11.13 或更高版本(使用“pip install netapp-lib”安装),强烈建议使用 netapp-lib 2020.3.12,因为它可以为连接问题提供更好的错误报告。 
- 物理或虚拟集群式 Data ONTAP 系统,模块支持 Data ONTAP 9.1 及更高版本,REST 支持需要 ONTAP 9.6 或更高版本。 
参数
| 参数 | 注释 | 
|---|---|
| 指定自治系统编号 (ASN)。ASN 属性是一个正整数,范围从 1 到 4,294,967,295。 通常应从 RFC6996“专用用途的自治系统 (AS) 预留”或分配给运营商组织的 AS 号中选择。 | |
| SSL 客户端证书文件(.pem)的路径。 不支持 python 2.6。 | |
| 启用或禁用新功能。 这可用于启用实验性功能或禁用破坏向后兼容性的新功能。 支持的键和值可能会随时更改,恕不另行通知。未知键将被忽略。 | |
| 使用 REST 时覆盖集群 ONTAP 版本。 如果版本与目标集群不匹配,则行为未定义。 这是在由于权限问题无法读取集群版本时提供的解决方法。请参阅 https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues。 这应采用 9.10 或 9.10.1 的形式,每个元素都是一个整数。 | |
| 指定保持时间(秒)。默认值为 180。 默认值:  | |
| ONTAP 实例的主机名或 IP 地址。 | |
| 使用此端口覆盖默认端口 (80 或 443) | |
| 启用和禁用 https。 使用 REST 时忽略,因为仅支持 https。 使用 SSL 证书身份验证时忽略,因为它需要 SSL。 选项 
 | |
| SSL 客户端密钥文件的路径。 | |
| 指定将管理其配置详细信息的节点。 | |
| 指定用户的密码。 | |
| 指定本地路由器 ID。router-id 值采用 IPv4 地址的形式。 如果未为创建操作提供默认路由器 ID,则将使用 admin vserver 中的本地 IPv4 地址进行初始化。 | |
| 指定是创建/更新还是删除节点的边界网关协议 (BGP) 配置。 选项 
 | |
| 此模块仅支持 REST。 always – 将始终使用 REST API。如果模块不支持 REST,则会发出警告。 默认值:  | |
| 这可以是集群范围或 SVM 范围的帐户,具体取决于是否需要集群级或 SVM 级 API。 更多信息,请阅读文档 https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/。 支持两种身份验证方法 
 要使用证书,必须已在 ONTAP 集群中安装证书,并且必须已启用证书身份验证。 | |
| 如果设置为  仅应在使用自签名证书的个人控制站点上将其设置为  选项 
 | 
备注
注意
- 仅支持 REST,并且需要 ONTAP 9.6 或更高版本。 
- 以 na_ontap 为前缀的模块旨在支持 ONTAP 存储平台。 
- 默认情况下启用 https,建议使用。要在集群上启用 http,必须运行以下命令“set -privilege advanced;”“system services web modify -http-enabled true;”。 
示例
- name: Create BGP configuration for a node
  netapp.ontap.na_ontap_bgp_config:
    state: present
    node: "csahu-node1"
    asn: 10
    hold_time: 180
    router_id: "10.0.1.112"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always
- name: Modify BGP configuration for a node
  netapp.ontap.na_ontap_bgp_config:
    state: present
    node: "csahu-node1"
    hold_time: 360
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always
- name: Delete BGP configuration for a node
  netapp.ontap.na_ontap_bgp_config:
    state: absent
    node: "csahu-node1"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always
