netapp_eseries.santricity.na_santricity_host 模块 – NetApp E-Series 管理 eseries 主机

注意

此模块是 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_host。

概要

  • 在 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:8443/devmgr/v2

api_username

字符串 / 必需

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

force_port

布尔值

允许将已分配的端口重新分配给当前主机

选项

  • false ←（默认）

  • true

host_type

别名：host_type_index

字符串

主机类型包括操作系统和多路径注意事项。

如果未指定，将使用默认主机类型。可以使用 netapp_eseries.santricity.na_santricity_global 设置默认主机类型。

有关存储阵列特定选项，请参阅 netapp_eseries.santricity.na_santricity_facts。

所有值都不区分大小写。

AIX MPIO - 高级交互执行（AIX）操作系统和本机 MPIO 驱动程序

AVT 4M - Silicon Graphics, Inc. (SGI) 专有多路径驱动程序

HP-UX - 带有本机多路径驱动程序的 HP-UX 操作系统

Linux ATTO - Linux 操作系统和 ATTO Technology, Inc. 驱动程序（必须使用 ATTO FC HBA）

Linux DM-MP - Linux 操作系统和本机 DM-MP 驱动程序

Linux Pathmanager - Linux 操作系统和 SGI 专有多路径驱动程序

Mac - Mac 操作系统和 ATTO Technology, Inc. 驱动程序

ONTAP - FlexArray

Solaris 11 或更高版本 - Solaris 11 或更高版本操作系统和本机 MPxIO 驱动程序

Solaris 10 或更早版本 - Solaris 10 或更早版本操作系统和本机 MPxIO 驱动程序

SVC - IBM SAN Volume Controller

VMware - ESXi 操作系统

Windows - Windows Server 操作系统和带有 DSM 驱动程序的 Windows MPIO

Windows 集群 - 集群 Windows Server 操作系统和带有 DSM 驱动程序的 Windows MPIO

Windows ATTO - Windows 操作系统和 ATTO Technology, Inc. 驱动程序

name

别名：label

字符串 / 必需

如果主机尚不存在，则在创建时分配的标签/名称。

如果主机已存在，则这将用于唯一标识主机以进行任何必需的更改

ports

列表 / 元素=字典

您希望与主机关联的主机端口列表。

主机端口由其 WWN 或 IQN 唯一标识。它们到特定主机的分配由标签唯一标识，并且这些标签必须是唯一的。

label

字符串 / 必需

要为此端口分配分配的唯一标签。

port

字符串 / 必需

要分配给此端口定义的主机端口的 WWN 或 IQN。

type

字符串 / 必需

要定义的端口的接口类型。

可接受的选择取决于目标硬件/软件平台的功能。

选项

  • "iscsi"

  • "sas"

  • "fc"

  • "ib"

  • "nvmeof"

ssid

字符串

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

默认： "1"

state

字符串

设置为 absent 以删除现有主机

设置为 present 以修改或创建新的主机定义

选项

  • "absent"

  • "present" ←（默认）

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: Define or update an existing host named "Host1"
  na_santricity_host:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    name: "Host1"
    state: present
    host_type_index: Linux DM-MP
    ports:
      - type: "iscsi"
        label: "PORT_1"
        port: "iqn.1996-04.de.suse:01:56f86f9bd1fe"
      - type: "fc"
        label: "FC_1"
        port: "10:00:FF:7C:FF:FF:FF:01"
      - type: "fc"
        label: "FC_2"
        port: "10:00:FF:7C:FF:FF:FF:00"

- name: Ensure a host named "Host2" doesn"t exist
  na_santricity_host:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    name: "Host2"
    state: absent

返回值

通用返回值记录在 此处，以下是此模块特有的字段

键

描述

api_url

字符串

此请求处理所使用的 API 的 URL

返回: 成功时

示例: "https://webservices.example.com:8443"

id

字符串

E 系列存储系统上主机的唯一标识符

返回: 当 state=present 时成功

示例: "00000000600A098000AAC0C3003004700AD86A52"

msg

字符串

对执行的操作的用户可读描述。

返回: 成功时

示例: "主机已创建。"

ssid

字符串

当前 API 中 E 系列存储系统的唯一标识符

返回: 成功时

示例: "1"

作者

  • Kevin Hulquest (@hulquest)

  • Nathan Swartz (@swartzn)

  • Vu Tran (@VuTran007)