theforeman.foreman.content_view_info 模块 – 获取内容视图的信息

注意

此模块是 theforeman.foreman 集合(版本 4.2.0)的一部分。

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

要安装它,请使用:ansible-galaxy collection install theforeman.foreman。您需要其他要求才能使用此模块,请参阅 要求 了解详细信息。

要在 playbook 中使用它,请指定:theforeman.foreman.content_view_info

theforeman.foreman 2.1.0 中的新功能

概要

  • 获取有关内容视图的信息

要求

在执行此模块的主机上需要满足以下要求。

  • requests

参数

参数

注释

位置

字符串

用于限定搜索范围的位置标签。

名称

字符串

要获取信息的资源的名称。

与 *search* 互斥。

组织

字符串

用于限定搜索范围的组织名称。

密码

字符串 / 必需

访问 Foreman 服务器的用户的密码。

如果未在任务中指定该值,则将使用环境变量 FOREMAN_PASSWORD 的值。

字符串

要使用的搜索查询

如果为 None 且未设置 *name*,则返回所有资源。

与 *name* 互斥。

服务器 URL

字符串 / 必需

Foreman 服务器的 URL。

如果未在任务中指定该值,则将使用环境变量 FOREMAN_SERVER_URL 的值。

用户名

字符串 / 必需

访问 Foreman 服务器的用户名。

如果未在任务中指定该值,则将使用环境变量 FOREMAN_USERNAME 的值。

验证证书

布尔值

是否验证 Foreman 服务器的 TLS 证书。

如果未在任务中指定该值,则将使用环境变量 FOREMAN_VALIDATE_CERTS 的值。

选项

  • false

  • true ←(默认)

属性

属性

支持

描述

check_mode

支持: 完全

可以在 check_mode 中运行,并返回更改的状态预测,而无需修改实体

diff_mode

支持: 完全

当处于 diff 模式时,将返回已更改的内容的详细信息(或在 check_mode 中可能需要更改的内容)

示例

- name: "Show a content_view"
  theforeman.foreman.content_view_info:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "CentOS 8"

- name: "Show all content_views with name CentOS 8"
  theforeman.foreman.content_view_info:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    search: 'name = "CentOS 8"'

返回值

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

描述

内容视图

字典

有关找到的内容视图的详细信息

返回:成功,并且传递了 *name*

内容视图

列表 / 元素=字典

所有找到的内容视图及其详细信息的列表

返回:成功,并且传递了 *search*

作者

  • Eric Helms (@ehelms)