netapp_eseries.santricity.na_santricity_iscsi_target 模块 – NetApp E 系列管理 iSCSI 目标配置

注意

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

概要

  • 配置 E 系列 iSCSI 目标的设置

参数

参数

注释

api_password

字符串 / 必需

用于验证 SANtricity Web Services 代理或嵌入式 Web Services API 的密码。

api_url

字符串 / 必需

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

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

api_username

字符串 / 必需

用于验证 SANtricity Web Services 代理或嵌入式 Web Services API 的用户名。

chap_secret

别名:chap,password

字符串

启用质询握手身份验证协议 (CHAP),使用此值作为密码。

指定此值时,我们将始终触发更新 (changed=True)。我们无法验证密码是否已更改。

chap 密钥只能使用十进制值为 32 到 126 之间的 ASCII 字符。

chap 密钥的长度不得少于 12 个字符,也不得超过 57 个字符。

未指定或为空字符串时,chap 密钥将被清除。

name

别名:alias

字符串

分配给 iSCSI 目标的名称/别名。

发起程序软件通常使用此别名来更容易地识别 iSCSI 目标。

ping

布尔值

启用来自已配置 iSCSI 端口的 ICMP ping 响应。

选项

  • false

  • true ← (默认)

ssid

字符串

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

默认: "1"

unnamed_discovery

布尔值

当发起程序向发起程序端口发起发现会话时,如果请求中未指定 iSCSI 目标 iqn,则将其视为未命名发现会话。

如果需要,可以禁用此选项以提高安全性。

选项

  • false

  • true ← (默认)

validate_certs

布尔值

是否应验证 https 证书?

选项

  • false

  • true ← (默认)

注释

注意

  • 支持检查模式。

  • 某些设置取决于应用于 iSCSI 接口的设置。可以使用 netapp_eseries.santricity.na_santricity_iscsi_interface 配置这些设置。

  • 此模块需要 Web Services API 版本 >= 1.3。

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

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

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

示例

- name: Enable ping responses and unnamed discovery sessions for all iSCSI ports
  na_santricity_iscsi_target:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    name: myTarget
    ping: true
    unnamed_discovery: true

- name: Set the target alias and the CHAP secret
  na_santricity_iscsi_target:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    name: myTarget
    chap: password1234

返回值

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

描述

alias

字符串

分配给 iSCSI 目标的别名。

返回: 成功时

示例: "myArray"

iqn

字符串

分配给 iSCSI 目标的 iqn(iSCSI 限定名称)。

返回: 成功时

示例: "iqn.1992-08.com.netapp:2800.000a132000b006d2000000005a0e8f45"

msg

字符串

成功消息

返回: 成功时

示例: "The iSCSI target settings have been updated."

作者

  • Michael Price (@lmprice)

  • Vu Tran (@VuTran007)