community.general.manageiq_group 模块 – ManageIQ 中组的管理
注意
此模块是 community.general 集合 (版本 10.1.0) 的一部分。
如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install community.general。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。
要在 playbook 中使用它，请指定： community.general.manageiq_group。
概要
manageiq_group 模块支持在 ManageIQ 中添加、更新和删除组。
要求
执行此模块的主机需要以下要求。
manageiq-client
manageiq-client https://github.com/ManageIQ/manageiq-api-client-python/
参数
参数 |
注释 |
|---|---|
包含允许的主机、集群或文件夹引用的字符串列表 |
|
在合并模式下，现有设置将与提供的 在替换模式下，当前值将被提供的 选项
|
|
组描述。 |
|
每个类别的标签值 |
|
ManageIQ 连接配置信息。 |
|
CA 证书包文件或目录的路径。 |
|
ManageIQ 密码。如果已设置，则为 |
|
ManageIQ 令牌。如果已设置，则为 |
|
ManageIQ 环境 URL。如果已设置，则为 |
|
ManageIQ 用户名。如果已设置，则为 |
|
是否应验证 HTTPS 请求的 SSL 证书。 选项
|
|
组角色 ID |
|
absent - 组不应该存在，present - 组应该存在。 选项
|
|
由租户ID标识的组的租户。 |
属性
属性 |
支持 |
描述 |
|---|---|---|
支持: 不支持 |
可以在 |
|
支持: 不支持 |
在差异模式下，将返回有关已更改内容（或可能需要在 |
示例
- name: Create a group in ManageIQ with the role EvmRole-user and tenant 'my_tenant'
community.general.manageiq_group:
description: 'MyGroup-user'
role: 'EvmRole-user'
tenant: 'my_tenant'
manageiq_connection:
url: 'http://127.0.0.1:3000'
username: 'admin'
password: 'smartvm'
validate_certs: false # only do this when you trust the network!
- name: Create a group in ManageIQ with the role EvmRole-user and tenant with tenant_id 4
community.general.manageiq_group:
description: 'MyGroup-user'
role: 'EvmRole-user'
tenant_id: 4
manageiq_connection:
url: 'http://127.0.0.1:3000'
username: 'admin'
password: 'smartvm'
validate_certs: false # only do this when you trust the network!
- name:
- Create or update a group in ManageIQ with the role EvmRole-user and tenant my_tenant.
- Apply 3 prov_max_cpu and 2 department tags to the group.
- Limit access to a cluster for the group.
community.general.manageiq_group:
description: 'MyGroup-user'
role: 'EvmRole-user'
tenant: my_tenant
managed_filters:
prov_max_cpu:
- '1'
- '2'
- '4'
department:
- defense
- engineering
managed_filters_merge_mode: replace
belongsto_filters:
- "/belongsto/ExtManagementSystem|ProviderName/EmsFolder|Datacenters/EmsFolder|dc_name/EmsFolder|host/EmsCluster|Cluster name"
belongsto_filters_merge_mode: merge
manageiq_connection:
url: 'http://127.0.0.1:3000'
username: 'admin'
password: 'smartvm'
validate_certs: false # only do this when you trust the network!
- name: Delete a group in ManageIQ
community.general.manageiq_group:
state: 'absent'
description: 'MyGroup-user'
manageiq_connection:
url: 'http://127.0.0.1:3000'
username: 'admin'
password: 'smartvm'
- name: Delete a group in ManageIQ using a token
community.general.manageiq_group:
state: 'absent'
description: 'MyGroup-user'
manageiq_connection:
url: 'http://127.0.0.1:3000'
token: 'sometoken'
返回值
常见的返回值已在此处记录，以下是此模块特有的字段
键 |
描述 |
|---|---|
组。 返回：成功 |
|
包含允许的主机、集群或文件夹引用的字符串列表 返回：成功 |
|
组创建时间 返回：成功 示例： |
|
组描述 返回：成功 |
|
组类型，系统或用户 返回：成功 |
|
组ID 返回：成功 |
|
每个类别的标签值 返回：成功 |
|
组角色名称 返回：成功 |
|
组租户名称 返回：成功 |
|
组更新日期 返回：成功 示例： |