netapp_eseries.santricity.netapp_e_hostgroup 模块 – NetApp E 系列管理阵列主机组

注意

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

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

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

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

netapp_eseries.santricity 2.2.0 中的新增功能

概要

  • 在 NetApp E 系列存储阵列上创建、更新或销毁主机组。

参数

参数

注释

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/devmgr/v2

api_username

字符串 / 必需

用于向 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。

hosts

列表 / 元素=字符串

要添加到组的主机名/标签列表

id

字符串

要管理的主机组的主机引用标识符。

此选项与 *name* 互斥。

name

字符串

要管理的主机组的名称

此选项与 *id* 互斥。

new_name

字符串

当您需要更新主机组的名称时指定此参数

ssid

字符串

要管理的阵列的 ID。此值对于每个阵列必须唯一。

默认值: "1"

state

字符串 / 必需

指定的主机组是否存在。

选项

  • "present"

  • "absent"

validate_certs

布尔值

是否应验证 https 证书?

选项

  • false

  • true ← (默认)

备注

注意

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

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

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

示例

- name: Configure Hostgroup
  netapp_e_hostgroup:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present

返回值

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

描述

clusterRef

字符串

此对象的唯一标识值。其他对象可以使用此引用值来引用集群。

返回: 除 state 为 absent 外始终返回

示例: "3233343536373839303132333100000000000000"

confirmLUNMappingCreation

布尔值

如果为 true,则表示创建 LUN 到卷映射需要最终用户的仔细确认,因为此类映射除了此集群之外,还会更改其他集群的卷访问权限。

返回: 始终返回

示例: false

hosts

列表 / 元素=字符串

所有操作后,主机组中包含的主机列表。

返回: 除 state 为 absent 外始终返回

示例: ["HostA", "HostB"]

id

字符串

主机组的 ID 号

返回: 除 state 为 absent 外始终返回

示例: "3233343536373839303132333100000000000000"

isSAControlled

布尔值

如果为 true,则表示来自此集群的 I/O 访问受存储阵列的默认 LUN 到卷映射的约束。如果为 false,则表示来自集群的 I/O 访问受集群特定的 LUN 到卷映射的约束。

返回: 除 state 为 absent 外始终返回

示例: false

label

字符串

集群的用户分配的描述性标签字符串。

返回: 始终返回

示例: "MyHostGroup"

name

字符串

与 label 相同

返回: 除 state 为 absent 外始终返回

示例: "MyHostGroup"

protectionInformationCapableAccessMethod

布尔值

如果主机具有 PI 功能访问方法,则此字段为 true。

返回: 除 state 为 absent 外始终返回

示例: true

作者

  • Kevin Hulquest (@hulquest)

  • Nathan Swartz (@ndswartz)