Red Hat SummitDieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.
Chapter 63. policy
Manipulate policies
Usage
hammer policy [OPTIONS] SUBCOMMAND [ARG] ...
# hammer policy [OPTIONS] SUBCOMMAND [ARG] ...Options
-
-h,--help– Print help
63.1. policy create
Create a Policy
Usage
hammer policy create [OPTIONS]
# hammer policy create [OPTIONS]Options
-
--cron-line VALUE– Policy schedule cron line (only if period == “custom”) -
--day-of-month NUMBER– Policy schedule day of month (only if period == “monthly”) -
--deploy-by ENUM– How the policy should be deployed Possible value(s):puppet,ansible,manual -
--description VALUE– Policy description -
--host-ids LIST– Apply policy to hosts -
--hostgroup-ids LIST– Apply policy to host groups -
--hostgroups LIST -
--hosts LIST -
--location VALUE– Name to search by -
--location-id NUMBER– Set the current location context for the request -
--location-ids LIST– REPLACE locations with given ids -
--locations LIST -
--name VALUE– Policy name -
--organization VALUE– Name to search by -
--organization-id NUMBER– Set the current organization context for the request -
--organization-ids LIST– REPLACE organizations with given ids. -
--organizations LIST -
--period VALUE– Policy schedule period (weekly, monthly, custom) -
--scap-content VALUE– SCAP content title -
--scap-content-id NUMBER– Policy SCAP content ID -
--scap-content-profile VALUE– Name to search by -
--scap-content-profile-id NUMBER– Policy SCAP content profile ID -
--tailoring-file VALUE– Tailoring file name -
--tailoring-file-id NUMBER– Tailoring file ID -
--tailoring-file-profile-id NUMBERTailoring file profile ID -
--weekday VALUE– Policy schedule weekday (only if period == “weekly”) -
-h,--help– Print help
63.2. policy delete
Delete a Policy
Usage
hammer policy <delete|destroy> [OPTIONS]
# hammer policy <delete|destroy> [OPTIONS]Options
-
--id VALUE -
--location VALUE– Set the current location context for the request -
--location-id NUMBER– Set the current location context for the request -
--location-title VALUE– Set the current location context for the request -
--name VALUE– Name to search by -
--organization VALUE– Set the current organization context for the request -
--organization-id NUMBER– Set the current organization context for the request -
--organization-title VALUE– Set the current organization context for the request -
-h,--help– Print help
63.3. policy hosts
List all hosts
Usage
hammer policy hosts [OPTIONS]
# hammer policy hosts [OPTIONS]Options
-
--environment VALUE– Name to search by -
--environment-id VALUE– ID of puppet environment -
--fields LIST– Show specified fields or predefined field sets only. (See below) -
--hostgroup VALUE– Hostgroup name -
--hostgroup-id VALUE– ID of host group -
--hostgroup-title VALUE– Hostgroup title -
--id VALUE– Policy Id -
--include ENUM– Array of extra information types to include Possible value(s):parameters,all_parameters -
--location VALUE– Set the current location context for the request -
--location-id VALUE– ID of location -
--location-title VALUE– Set the current location context for the request -
--name VALUE– Policy name -
--order VALUE– Sort and order by a searchable field, e.g.<field> DESC -
--organization VALUE– Set the current organization context for the request -
--organization-id VALUE– ID of organization -
--organization-title VALUE– Set the current organization context for the request -
--page NUMBER– Page number, starting at 1 -
--per-page VALUE– Number of results per page to return,allto return all results -
--search VALUE– Filter results -
--thin BOOLEAN– Only list ID and name of hosts -
-h,--help– Print help
Predefined field sets
| FIELDS | ALL | DEFAULT | THIN |
|---|---|---|---|
| Id | x | x | x |
| Name | x | x | x |
| Operating system | x | x | |
| Host group | x | x | |
| Ip | x | x | |
| Mac | x | x | |
| Global status | x | x | |
| Organization | x | ||
| Location | x | ||
| Additional information | x | ||
| Content view environments | x | x | |
| Multi content view environment | x | x | |
| Security | x | ||
| Bugfix | x | ||
| Enhancement | x | ||
| Running image | x | ||
| Running image digest | x | ||
| Staged image | x | ||
| Staged image digest | x | ||
| Available image | x | ||
| Available image digest | x | ||
| Rollback image | x | ||
| Rollback image digest | x | ||
| Trace status | x | x |
Search and order fields
-
activation_key– string -
activation_key_id– string -
applicable_debs– string -
applicable_errata– string -
applicable_errata_issued– date -
applicable_rpms– string -
architecture– string -
autoheal– boolean -
boot_time -
bootc_available_digest– string -
bootc_available_image– string -
bootc_booted_digest– string -
bootc_booted_image– string -
bootc_rollback_digest– string -
bootc_rollback_image– string -
bootc_staged_digest– string -
bootc_staged_image– string -
build– Values: true, false -
build_status– Values: built, pending, token_expired, build_failed -
comment– text -
compute_resource– string -
compute_resource_id– integer -
configuration_status.applied– integer -
configuration_status.enabled– Values: true, false -
configuration_status.failed– integer -
configuration_status.failed_restarts– integer -
configuration_status.interesting– Values: true, false -
configuration_status.pending– integer -
configuration_status.restarted– integer -
configuration_status.skipped– integer -
content_source– string -
content_views– string - convert2rhel_through_foreman integer
-
created_at– datetime -
domain– string -
domain_id– integer -
errata_status– Values: security_needed, errata_needed, updated, unknown -
execution_status– Values: ok, error -
facts– string -
global_status– Values: ok, warning, error -
has_ip– string - has_ip6 string
-
has_mac– string -
hostgroup– string -
hostgroup_fullname– string -
hostgroup_id– integer -
hostgroup_name– string -
hostgroup_title– string -
hypervisor– boolean -
hypervisor_host– string -
id– integer -
image– string -
image_mode– Values: true, false -
infrastructure_facet.foreman– Values: true, false -
infrastructure_facet.smart_proxy_id -
insights_client_report_status– Values: reporting, no_report -
insights_inventory_sync_status– Values: disconnect, sync -
insights_recommendations_count– integer -
insights_uuid– string -
installable_errata– string -
installed_at– datetime -
ip– string - ip6 string
-
job_invocation.id– string -
job_invocation.result– Values: cancelled, failed, pending, success -
last_checkin– datetime -
last_report– datetime -
lifecycle_environments– string -
location– string -
location_id– integer -
mac– string -
managed– Values: true, false -
model– string -
name– string -
organization– string -
organization_id– integer -
origin– string -
os– string -
os_description– string -
os_id– integer -
os_major– string -
os_minor– string -
os_title– string -
owner– string -
owner_id– integer -
owner_type– string -
params– string -
params_name– string -
parent_hostgroup– string -
puppet_ca– string -
puppet_proxy_id– integer -
puppetmaster– string -
pxe_loader– Values: PXELinux_BIOS, PXELinux_UEFI, Grub_UEFI, Grub2_BIOS, Grub2_ELF, Grub2_UEFI, Grub2_UEFI_SecureBoot, Grub2_UEFI_HTTP, Grub2_UEFI_HTTPS, Grub2_UEFI_HTTPS_SecureBoot, iPXE_Embedded, iPXE_UEFI_HTTP, iPXE_Chain_BIOS, iPXE_Chain_UEFI -
realm– string -
realm_id– integer -
registered_at– datetime -
registered_through– string -
release_version– string -
reported.bios_release_date -
reported.bios_vendor -
reported.bios_version -
reported.boot_time -
reported.cores -
reported.disks_total -
reported.kernel_version -
reported.ram -
reported.sockets -
reported.virtual– Values: true, false -
repository– string -
repository_content_label– string -
rhel_lifecycle_status– Values: full_support, maintenance_support, approaching_end_of_maintenance, extended_support, approaching_end_of_support, support_ended -
role– text -
service_level– string -
smart_proxy– string -
status.applied– integer -
status.enabled– Values: true, false -
status.failed– integer -
status.failed_restarts– integer -
status.interesting– Values: true, false -
status.pending– integer -
status.restarted– integer -
status.skipped– integer -
subnet– string -
subnet.name– text - subnet6 string
- subnet6.name text
-
subscription_id– string -
subscription_name– string -
subscription_uuid– string -
trace_status– Values: reboot_needed, process_restart_needed, updated -
upgradable_debs– string -
upgradable_rpms– string -
usage– text -
user.firstname– string -
user.lastname– string -
user.login– string -
user.mail– string -
usergroup– string -
usergroup.name– string -
uuid– string
63.4. policy info
Show a Policy
Usage
hammer policy <info|show> [OPTIONS]
# hammer policy <info|show> [OPTIONS]Options
-
--fields LIST– Show specified fields or predefined field sets only. (See below) -
--id VALUE -
--location VALUE– Set the current location context for the request -
--location-id NUMBER– Set the current location context for the request -
--location-title VALUE– Set the current location context for the request -
--name VALUE– Name to search by -
--organization VALUE– Set the current organization context for the request -
--organization-id NUMBER– Set the current organization context for the request -
--organization-title VALUE– Set the current organization context for the request -
-h,--help– Print help
Predefined field sets
| FIELDS | ALL | DEFAULT | THIN |
|---|---|---|---|
| Id | x | x | x |
| Name | x | x | x |
| Created at | x | x | |
| Period | x | x | |
| Weekday | x | x | |
| Day of month | x | x | |
| Cron line | x | x | |
| Scap content id | x | x | |
| Scap content profile id | x | x | |
| Tailoring file id | x | x | |
| Tailoring file profile id | x | x | |
| Deployment option | x | x | |
| Locations/ | x | x | |
| Organizations/ | x | x | |
| Hostgroups/ | x | x |
63.5. policy list
List Policies
Usage
hammer policy <list|index> [OPTIONS]
# hammer policy <list|index> [OPTIONS]Options
-
--fields LIST– Show specified fields or predefined field sets only. (See below) -
--location VALUE– Set the current location context for the request -
--location-id NUMBER– Set the current location context for the request -
--location-title VALUE– Set the current location context for the request -
--order VALUE– Sort and order by a searchable field, e.g.<field> DESC -
--organization VALUE– Set the current organization context for the request -
--organization-id NUMBER– Set the current organization context for the request -
--organization-title VALUE– Set the current organization context for the request -
--page NUMBER– Page number, starting at 1 -
--per-page VALUE– Number of results per page to return,allto return all results -
--search VALUE– Filter results -
-h,--help– Print help
Predefined field sets
| FIELDS | ALL | DEFAULT | THIN |
|---|---|---|---|
| Id | x | x | x |
| Name | x | x | x |
| Created at | x | x |
Search and order fields
-
content– string -
location– string -
location_id– integer -
name– string -
organization– string -
organization_id– integer -
profile– string -
tailoring_file– string -
tailoring_file_profile– string
63.6. policy update
Update a Policy
Usage
hammer policy update [OPTIONS]
# hammer policy update [OPTIONS]Options
-
--cron-line VALUE– Policy schedule cron line (only if period == “custom”) -
--day-of-month NUMBER– Policy schedule day of month (only if period == “monthly”) -
--deploy-by ENUM– How the policy should be deployed Possible value(s):puppet,ansible,manual -
--description VALUE– Policy description -
--host-ids LIST– Apply policy to hosts -
--hostgroup-ids LIST– Apply policy to host groups -
--hostgroups LIST -
--hosts LIST -
--id VALUE -
--location VALUE– Name to search by -
--location-id NUMBER– Set the current location context for the request -
--location-ids LIST– REPLACE locations with given ids -
--locations LIST -
--name VALUE– Policy name -
--new-name VALUE– Policy name -
--organization VALUE– Name to search by -
--organization-id NUMBER– Set the current organization context for the request -
--organization-ids LIST– REPLACE organizations with given ids. -
--organizations LIST -
--period VALUE– Policy schedule period (weekly, monthly, custom) -
--scap-content VALUE– SCAP content title -
--scap-content-id NUMBER– Policy SCAP content ID -
--scap-content-profile VALUE– Name to search by -
--scap-content-profile-id NUMBER– Policy SCAP content profile ID -
--tailoring-file VALUE– Tailoring file name -
--tailoring-file-id NUMBER– Tailoring file ID -
--tailoring-file-profile-id NUMBERTailoring file profile ID -
--weekday VALUE– Policy schedule weekday (only if period == “weekly”) -
-h,--help– Print help
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}