theforeman.foreman.scap_content – Manage SCAP content
Note
This plugin is part of the theforeman.foreman collection (version 1.5.1).
To install it use: ansible-galaxy collection install theforeman.foreman
.
To use it in a playbook, specify: theforeman.foreman.scap_content
.
New in version 1.0.0: of theforeman.foreman
Synopsis
- Create, update, and delete SCAP content
Requirements
The below requirements are needed on the host that executes this module.
- requests
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
locations
list /
elements=string
|
List of locations the entity should be assigned to
|
|
organizations
list /
elements=string
|
List of organizations the entity should be assigned to
|
|
original_filename
string
|
Original file name of the XML file.
If unset, the filename of
scap_file will be used.
|
|
password
string /
required
|
Password of the user accessing the Foreman server.
If the value is not specified in the task, the value of environment variable
FOREMAN_PASSWORD will be used instead.
|
|
scap_file
path
|
File containing XML DataStream content.
Required when creating a new DataStream.
|
|
server_url
string /
required
|
URL of the Foreman server.
If the value is not specified in the task, the value of environment variable
FOREMAN_SERVER_URL will be used instead.
|
|
state
string
|
|
State of the entity
|
title
string /
required
|
Title of SCAP content.
|
|
updated_title
string
|
New SCAP content title.
When this parameter is set, the module will not be idempotent.
|
|
username
string /
required
|
Username accessing the Foreman server.
If the value is not specified in the task, the value of environment variable
FOREMAN_USERNAME will be used instead.
|
|
validate_certs
boolean
|
|
Whether or not to verify the TLS certificates of the Foreman server.
If the value is not specified in the task, the value of environment variable
FOREMAN_VALIDATE_CERTS will be used instead.
|
Examples
- name: Create SCAP content theforeman.foreman.scap_content: title: "Red Hat firefox default content" scap_file: "/home/user/Downloads/ssg-firefox-ds.xml" original_filename: "ssg-firefox-ds.xml" organizations: - "Default Organization" locations: - "Default Location" server_url: "https://foreman.example.com" username: "admin" password: "changeme" state: present - name: Update SCAP content theforeman.foreman.scap_content: title: "Red Hat firefox default content" updated_title: "Updated scap content title" scap_file: "/home/user/Downloads/updated-ssg-firefox-ds.xml" original_filename: "updated-ssg-firefox-ds.xml" organizations: - "Org One" - "Org Two" locations: - "Loc One" - "Loc Two" server_url: "https://foreman.example.com" username: "admin" password: "changeme" state: present - name: Delete SCAP content theforeman.foreman.scap_content: title: "Red Hat firefox default content" server_url: "https://foreman.example.com" username: "admin" password: "changeme" state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description | |
---|---|---|---|
entity
dictionary
|
success |
Final state of the affected entities grouped by their type.
|
|
scap_contents
list /
elements=dictionary
|
success |
List of scap contents.
|
Authors
- Jameer Pathan (@jameerpathan111)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/theforeman/foreman/scap_content_module.html