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。

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

community.general 2.5.0 中的新增功能

概要 

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

参数 

参数	注释
attributes 列表 / 元素=字典 / 必需	要强制执行的属性名称和值的列表。所有值和参数都区分大小写，并且必须仅作为字符串提供。
name 字符串 / 必需	属性名称或十六进制 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：定位器 -> 设备 -> 按模型名称 -> <输入任何模型> -> 属性选项卡。
value 字符串 / 必需	属性值。空字符串应为 `""` 或 `null`。
name 字符串 / 必需	模型名称。
type 字符串 / 必需	模型类型。
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	支持: 不支持	在差异模式下，将返回有关已更改内容（或可能需要在`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)