netapp_eseries.santricity.na_santricity_proxy_systems 模块 – NetApp E 系列管理 SANtricity Web 服务代理存储阵列

注意

此模块是 netapp_eseries.santricity 集合 (版本 1.4.1) 的一部分。

如果您使用的是 ansible 软件包,则可能已安装此集合。它不包含在 ansible-core 中。要检查是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install netapp_eseries.santricity

要在剧本中使用它,请指定:netapp_eseries.santricity.na_santricity_proxy_systems

概要

  • 管理可通过 NetApp Web 服务代理访问的 NetApp E 系列存储阵列。

参数

参数

注释

accept_certificate

布尔值

即使存储系统的证书是自签名的,也自动接受该证书。

使用 netapp_eseries.santricity.na_santricity_certificates 将证书添加到 SANtricity Web 服务代理。

SANtricity Web 服务代理将无法添加任何不受信任的存储系统。

选项

  • false

  • true ← (默认)

add_discovered_systems

布尔值

此标志将强制将所有已发现的存储系统添加到 SANtricity Web 服务代理。

选项

  • false ← (默认)

  • true

api_password

字符串 / 必需

用于对 SANtricity Web 服务代理或嵌入式 Web 服务 API 进行身份验证的密码。

api_url

字符串 / 必需

SANtricity Web 服务代理或嵌入式 Web 服务 API 的 URL。

示例 https://prod-1.wahoo.acme.com:8443/devmgr/v2

api_username

字符串 / 必需

用于对 SANtricity Web 服务代理或嵌入式 Web 服务 API 进行身份验证的用户名。

password

字符串

默认存储系统密码,在 *systems* 子选项中未提供密码时将使用。

如果未设置存储系统管理员密码,则将使用提供的管理员密码在设备本身设置。

默认: ""

subnet_mask

字符串

这是用于发现 E 系列存储阵列的 IPv4 搜索范围。

以 CIDR 形式指定的 IPv4 子网掩码。例如,192.168.1.0/24 将搜索范围 192.168.1.0 到 192.168.1.255。

确保在搜索范围内包含所有管理路径。

systems

列表 / 元素=字典

存储系统信息的列表,定义应在 SANtricity Web 服务代理上添加哪些系统。

接受简单的序列号列表或包含子选项列表中至少序列号或地址键的字典列表。

请注意,当未指定标识符时,序列号将用作存储系统标识符。

当 *add_discovered_systems == False* 且未提供任何已发现的系统序列号时,将从代理中删除该系统。

默认: []

addresses

列表 / 元素=字符串

存储系统的 IPv4 地址列表。

与子选项 serial 互斥。

password

字符串

这是存储系统管理员密码。

如果未提供,将使用 *default_password*。

如果未设置存储系统管理员密码,则将使用提供的管理员密码在设备本身设置。

serial

字符串

存储系统的序列号,位于每个 NetApp E 系列机箱的顶部。

包含任何前导零。

与子选项 address 互斥。

ssid

字符串

这是 Web 服务代理为存储系统提供的标识符。

如果未指定 ssid,则将使用序列号或第一个控制器 IPv4 地址代替。

tags

字典

与存储系统关联的可选元标记

tags

字典

如果在 *systems* 子选项中未另行指定,则与所有存储系统关联的默认元标记。

validate_certs

布尔值

是否应验证 https 证书?

选项

  • false

  • true ← (默认)

备注

注意

  • E 系列 Ansible 模块需要 Web 服务代理 (WSP) 实例可用以管理存储系统,或者支持嵌入式 Web 服务 API 的 E 系列存储系统。

  • 嵌入式 Web 服务目前适用于 E2800、E5700、EF570 和更新的硬件型号。

  • netapp_eseries.santricity.netapp_e_storage_system 可用于配置由 WSP 实例管理的系统。

示例

---
    - name: Add storage systems to SANtricity Web Services Proxy
      na_santricity_proxy_systems:
        api_url: "https://192.168.1.100:8443/devmgr/v2"
        api_username: "admin"
        api_password: "adminpass"
        validate_certs: true
        subnet_mask: 192.168.1.0/24
        password: password
        tags:
          tag: value
        accept_certificate: True
        systems:
          - ssid: "system1"
            serial: "056233035640"
            password: "asecretpassword"
            tags:
                use: corporate
                location: sunnyvale
          - ssid: "system2"
            addresses:
                - 192.168.1.100
                - 192.168.2.100     # Second is not be required. It will be discovered
            password: "anothersecretpassword"
          - serial: "021324673799"
          - "021637323454"
    - name: Add storage system to SANtricity Web Services Proxy with serial number list only. The serial numbers will be used to identify each system.
      na_santricity_proxy_systems:
        api_url: "https://192.168.1.100:8443/devmgr/v2"
        api_username: "admin"
        api_password: "adminpass"
        validate_certs: true
        subnet_mask: 192.168.1.0/24
        password: password
        accept_certificate: True
        systems:
          - "1144FG123018"
          - "721716500123"
          - "123540006043"
          - "112123001239"
    - name: Add all discovered storage system to SANtricity Web Services Proxy found in the IP address range 192.168.1.0 to 192.168.1.255.
      na_santricity_proxy_systems:
        api_url: "https://192.168.1.100:8443/devmgr/v2"
        api_username: "admin"
        api_password: "adminpass"
        validate_certs: true
        add_discovered_systems: True
        subnet_mask: 192.168.1.0/24
        password: password
        accept_certificate: True

返回值

常见返回值已记录在 此处,以下是此模块特有的字段

描述

msg

字符串

执行的操作说明。

返回: 始终

示例: "Storage systems [system1, system2, 1144FG123018, 721716500123, 123540006043, 112123001239] were added."

作者

  • Nathan Swartz (@swartzn)

  • Vu Tran (@VuTran007)