netapp_eseries.santricity.netapp_e_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.netapp_e_iscsi_target。

netapp_eseries.santricity 2.7.0 中的新增功能

概要

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

参数

参数

注释

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 进行身份验证的用户名。

chap_secret

别名：chap，password

字符串

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

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

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

chap 密码的长度必须不小于 12 个字符，但不大于 57 个字符。

未指定或为空字符串时，将清除 chap 密码。

log_path

字符串

Ansible 控制器上的本地路径，用于调试日志的文件。

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.netapp_e_iscsi_interface 配置这些设置。

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

  • E 系列 Ansible 模块需要 Web Services Proxy (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
  netapp_e_iscsi_target:
    api_url: "https://127.0.0.1:8443/devmgr/v2"
    api_username: admin
    api_password: myPassword
    ssid: "1"
    validate_certs: no
    name: myTarget
    ping: yes
    unnamed_discovery: yes

- name: Set the target alias and the CHAP secret
  netapp_e_iscsi_target:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    name: myTarget
    chap: password1234

返回值

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

键

描述

别名

字符串

分配给 iSCSI 目标的别名。

返回：成功时

示例： "myArray"

iqn

字符串

分配给 iSCSI 目标的 iqn（iSCSI 合格名称）。

返回：成功时

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

msg

字符串

成功消息

返回：成功时

示例： "iSCSI 目标设置已更新。"

作者

  • Michael Price (@lmprice)