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

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

概要

  • 管理通过 NetApp Web Services Proxy 访问的 NetApp E 系列存储阵列。

参数

参数

注释

accept_certificate

布尔值

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

使用 netapp_eseries.santricity.na_santricity_certificates 将证书添加到 SANtricity Web Services Proxy。

SANtricity Web Services Proxy 将无法添加任何不受信任的存储系统。

选项

  • false

  • true ← (默认)

add_discovered_systems

布尔值

此标志将强制将所有发现的存储系统添加到 SANtricity Web Services Proxy。

选项

  • false ← (默认)

  • true

api_password

字符串 / 必需

用于使用 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。

api_url

字符串 / 必需

SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。

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

api_username

字符串 / 必需

用于使用 SANtricity Web Services Proxy 或嵌入式 Web Services 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 Services Proxy 上添加哪些系统。

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

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

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

默认值: []

addresses

列表 / 元素=字符串

存储系统的 IPv4 地址列表。

与子选项 serial 互斥。

password

字符串

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

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

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

serial

字符串

存储系统的序列号,可在每个 NetApp E 系列机箱的顶部找到。

包括任何前导零。

与子选项 address 互斥。

ssid

字符串

这是 Web Services Proxy 用于存储系统的标识符。

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

tags

字典

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

tags

字典

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

validate_certs

布尔值

是否应验证 https 证书?

选项

  • false

  • true ← (默认)

备注

注意

  • E 系列 Ansible 模块需要 Web Services Proxy (WSP) 的实例可用,才能管理存储系统,或者需要支持嵌入式 Web Services 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

字符串

对执行的操作的描述。

返回: 总是

示例: "已添加存储系统 [system1, system2, 1144FG123018, 721716500123, 123540006043, 112123001239]。"

作者

  • Nathan Swartz (@swartzn)

  • Vu Tran (@VuTran007)