ibm.spectrum_virtualize.ibm_svc_manage_callhome 模块 – 此模块管理 IBM Spectrum Virtualize 系列存储系统上的“Call Home”功能配置

注意

此模块是 ibm.spectrum_virtualize 集合 (版本 2.0.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install ibm.spectrum_virtualize。

要在 playbook 中使用它，请指定： ibm.spectrum_virtualize.ibm_svc_manage_callhome。

注意

ibm.spectrum_virtualize 集合已重命名为 ibm.storage_virtualize，并将从 Ansible 12 中移除。如果您使用 ibm.spectrum_virtualize 中的内容，请更新 playbook 和角色中的 FQCN！创建新的 playbook 或角色时，请直接使用 ibm.storage_virtualize 中的内容。

ibm.spectrum_virtualize 1.7.0 中的新增功能

概要

  • 管理云和电子邮件 Call Home 功能的 Ansible 接口。

参数

参数

注释

address

字符串

指定用户的地址第一行，应显示在 Call Home 电子邮件中。

当 state=enabled 时为必填。

callhome_type

字符串 / 必填

指定传输类型。

选项

  • "cloud services"

  • "email"

  • "both"

censorcallhome

字符串

指定从增强的 Call Home 数据中删除敏感数据。

应用于 state=enabled。

如果未指定，将使用默认值“off”。

选项

  • "on"

  • "off"

city

字符串

指定用户的城市，应显示在 Call Home 电子邮件中。

当 state=enabled 时为必填。

clustername

字符串 / 必填

Spectrum Virtualize 存储系统的 hostname 或管理 IP。

company_name

字符串

指定用户的组织，应显示在 Call Home 电子邮件中。

当 state=enabled 时为必填。

contact_email

字符串

指定人员的电子邮件。

当 state=enabled 时为必填。

contact_name

字符串

指定接收电子邮件的人员的姓名。

当 state=enabled 时为必填。

country

字符串

指定机器所在的国家/地区，应显示在 Call Home 电子邮件中。

当 state=enabled 时为必填。

domain

字符串

Spectrum Virtualize 存储系统的域名。

当使用 hostname 作为参数 clustername 时有效。

enhancedcallhome

字符串

指定 Call Home 功能是否向支持中心发送增强型报告。

应用于 state=enabled。

如果未指定，将使用默认值“off”。

选项

  • "on"

  • "off"

invemailinterval

整数

指定将库存电子邮件发送给已配置的电子邮件收件人的间隔。

间隔以天为单位测量。值必须在 0-15 范围内。

将值设置为“0”将关闭库存电子邮件通知功能。如果 inventory 设置为“on”，则有效。

inventory

字符串

指定参数 contact_email 中提到的收件人是否接收库存电子邮件通知。

应用于 state=enabled。如果未指定，将使用默认值“off”。

选项

  • "on"

  • "off"

location

字符串

指定已报告错误的系统的物理位置。

当 state=enabled 时为必填。

log_path

字符串

调试日志文件的路径。

password

字符串

Spectrum Virtualize 存储系统的 REST API 密码。

如果不使用 token 验证用户，则需要 username 和 password 参数。

phonenumber_primary

字符串

指定主要联系电话号码。

当 state=enabled 时为必填。

phonenumber_secondary

字符串

指定次要联系电话号码。

当 state=enabled 时为必填。

postalcode

字符串

指定用户的邮政编码，应显示在 Call Home 电子邮件中。

当 state=enabled 时为必填。

province

字符串

指定用户的州或省份，应显示在 Call Home 电子邮件中。

当 state=enabled 时为必填。

proxy_password

字符串

指定代理的密码。

应用于 state=enabled 和 proxy_type=basic_authentication。

proxy_port

整数

指定代理服务器端口号。值必须在 1-65535 范围内。

应用于 state=enabled 和 proxy_type=open_proxy 或 proxy_type=basic_authentication。

proxy_type

字符串

指定代理类型。

当 state=enabled 时为必填，用于创建或修改 Call Home 功能。

对于 proxy_type=no_proxy，代理将被删除。

当 callhome_type='cloud services' 或 callhome_type='both' 时，此参数为必填。

选项

  • "open_proxy"

  • "basic_authentication"

  • "certificate"

  • "no_proxy"

proxy_url

字符串

指定具有协议前缀的代理服务器 URL，采用完全限定域名格式。

应用于 state=enabled 和 proxy_type=open_proxy 或 proxy_type=basic_authentication。

proxy_username

字符串

指定代理的用户名。

应用于 state=enabled 和 proxy_type=basic_authentication。

serverIP

字符串

指定电子邮件服务器的 IP 地址。

当 state=enabled 和 callhome_type=email 或 callhome_type=both 时为必填。

serverPort

整数

指定电子邮件服务器的端口号。

值必须在 1-65535 范围内。

当 state=enabled 和 callhome_type=email 或 callhome_type=both 时为必填。

sslcert

字符串

指定代理证书的文件路径。

应用于 state=enabled 和 proxy_type=certificate。

state

字符串 / 必填

启用或更新 (enabled) 或禁用 (disabled) Call Home 功能。

选项

  • "enabled"

  • "disabled"

token

字符串

用于在 Spectrum Virtualize 存储系统上验证用户的身份验证令牌。

要生成令牌，请使用 ibm_svc_auth 模块。

username

字符串

Spectrum Virtualize 存储系统的 REST API 用户名。

如果不使用 token 验证用户，则需要 username 和 password 参数。

validate_certs

布尔值

验证证书。

选项

  • false ← (默认)

  • true

备注

注意

  • 此模块支持 check_mode。

示例

- name: Configure callhome with both email and cloud
  ibm.spectrum_virtualize.ibm_svc_manage_callhome:
    clustername: "{{ clustername }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "/tmp/playbook.debug"
    state: "enabled"
    callhome_type: "both"
    address: "{{ address }}"
    city: "{{ city }}"
    company_name: "{{ company_name }}"
    contact_email: "{{ contact_email }}"
    contact_name: "{{ contact_name }}"
    country: "{{ country }}"
    location: "{{ location }}"
    phonenumber_primary: "{{ primary_phonenumber }}"
    postalcode: "{{ postal_code }}"
    province: "{{ province }}"
    proxy_type: "{{ proxy_type }}"
    proxy_url: "{{ proxy_url }}"
    proxy_port: "{{ proxy_port }}"
    serverIP: "{{ server_ip }}"
    serverPort: "{{ server_port }}"
    inventory: "on"
    invemailinterval: 1
    enhancedcallhome: "on"
    censorcallhome: "on"

作者

  • Sreshtant Bohidar(@Sreshtant-Bohidar)