community.general.spectrum_model_attrs 模块 – 在 CA Spectrum 中强制执行模型的属性

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

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

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

要在 playbook 中使用它，请指定：community.general.spectrum_model_attrs。

community.general 2.5.0 中的新增功能

概要 

此模块可用于在 CA Spectrum 中强制执行模型的属性。

参数 

参数	注释
属性列表 / 元素=字典 / 必需	要强制执行的属性名称和值的列表。所有值和参数都区分大小写，并且必须仅以字符串形式提供。
名称字符串 / 必需	属性名称或十六进制 ID。当前定义的名称是 `App_Manufacturer` (`0x230683`) `CollectionsModelNameString` (`0x12adb`) `Condition` (`0x1000a`) `Criticality` (`0x1290c`) `DeviceType` (`0x23000e`) `isManaged` (`0x1295d`) `Model_Class` (`0x11ee8`) `Model_Handle` (`0x129fa`) `Model_Name` (`0x1006e`) `Modeltype_Handle` (`0x10001`) `Modeltype_Name` (`0x10000`) `Network_Address` (`0x12d7f`) `Notes` (`0x11564`) `ServiceDesk_Asset_ID` (`0x12db9`) `TopologyModelNameString` (`0x129e7`) `sysDescr` (`0x10052`) `sysName` (`0x10b5b`) `Vendor_Name` (`0x11570`) `Description` (`0x230017`) 十六进制 ID 是 Spectrum 中的直接标识符，并且始终有效。要查找十六进制 ID，请转到 UI：定位器 -> 设备 -> 按模型名称 -> <输入任何模型> -> 属性选项卡。
值字符串 / 必需	属性值。空字符串应为 `""` 或 `null`。
名称字符串 / 必需	模型名称。
类型字符串 / 必需	模型类型。
url 字符串 / 必需	OneClick 服务器的 URL。
url_password 别名：password 字符串 / 必需	OneClick 密码。
url_username 别名：username 字符串 / 必需	OneClick 用户名。
use_proxy 布尔值	如果 `false`，即使在目标主机上的环境变量中定义了代理，也不会使用代理。选择 `false` `true` ← (默认)
validate_certs 布尔值	验证 SSL 证书。仅当您可以保证您正在与正确的端点通信并且没有发生中间人攻击时，才将此项更改为 `false`。选择 `false` `true` ← (默认)

属性 

属性	支持	描述
check_mode	支持：完整	可以在 `check_mode` 中运行，并返回已更改的状态预测，而无需修改目标。
diff_mode	支持：无	当处于 diff 模式时，将返回有关已更改内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

备注 

注意

在 CA Spectrum 版本 10.4.2.0.189 上进行了测试。
此模块无法创建和删除模型。为此，请改用 community.general.spectrum_device。

示例 

- name: Enforce maintenance mode for modelxyz01 with a note about why
  community.general.spectrum_model_attrs:
    url: "http://oneclick.url.com"
    username: "{{ oneclick_username }}"
    password: "{{ oneclick_password }}"
    name: "modelxyz01"
    type: "Host_Device"
    validate_certs: true
    attributes:
      - name: "isManaged"
        value: "false"
      - name: "Notes"
        value: "MM set on {{ ansible_date_time.iso8601 }} via CO {{ CO }} by {{ tower_user_name | default(ansible_user_id) }}"
  delegate_to: localhost
  register: spectrum_model_attrs_status

返回值 

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

键	描述
changed_attrs 字典	已更改的名称或十六进制 ID (以指定者为准) 及其新的对应值的字典。返回: 总是示例: `{"Notes": "MM set on 2021-02-03T22:04:02Z via CO CO9999 by tgates", "isManaged": "true"}`
msg 字符串	关于作业结果的信息性消息。返回: 总是示例: `"Success"`

作者

Tyler Gates (@tgates81)