3.38. hammer hostgroup
操作主机组
Usage:
hammer hostgroup [OPTIONS] SUBCOMMAND [ARG] ...
Parameters:
SUBCOMMAND Subcommand
[ARG] ... Subcommand arguments
Subcommands:
ansible-roles Manage Ansible roles on a hostgroup
create Create a host group
delete, destroy Delete a host group
delete-parameter Delete parameter for a hostgroup
info, show Show a host group
list, index List all host groups
rebuild-config Rebuild orchestration config
set-parameter Create or update parameter for a hostgroup
update Update a host group
Options:
-h, --help Print help3.38.1. hammer hostgroup ansible-roles
管理主机组上的 Ansible 角色
Usage:
hammer hostgroup ansible-roles [OPTIONS] SUBCOMMAND [ARG] ...
Parameters:
SUBCOMMAND Subcommand
[ARG] ... Subcommand arguments
Subcommands:
assign Assigns Ansible roles to a hostgroup
list, index List all Ansible roles for a hostgroup
play Runs all Ansible roles on a hostgroup
Options:
-h, --help Print help3.38.1.1. hammer hostgroup ansible-roles 分配
将 Ansible 角色分配给主机组
Usage:
hammer hostgroup ansible-roles assign [OPTIONS]
Options:
--ansible-role-ids LIST Ansible roles to assign to a hostgroup
--ansible-roles LIST
--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 Hostgroup name
--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
--title VALUE Hostgroup title
-h, --help Print help
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string3.38.1.2. hammer hostgroup ansible-roles 列表
列出 hostgroup 的所有 Ansible 角色
Usage:
hammer hostgroup ansible-roles <list|index> [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 Hostgroup name
--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
--title VALUE Hostgroup title
-h, --help Print help
Predefined field sets:
------------|-----|---------|-----
FIELDS | ALL | DEFAULT | THIN
------------|-----|---------|-----
Id | x | x | x
Name | x | x | x
Imported at | x | x |
------------|-----|---------|-----
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string3.38.1.3. hammer hostgroup ansible-roles play
在 hostgroup 上运行所有 Ansible 角色
Usage:
hammer hostgroup ansible-roles play [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 Hostgroup name
--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
--title VALUE Hostgroup title
-h, --help Print help
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string3.38.2. hammer hostgroup create
创建主机组
Usage:
hammer hostgroup create [OPTIONS]
Options:
--ansible-role-ids LIST IDs of associated ansible roles
--ansible-roles LIST
--architecture VALUE Architecture name
--architecture-id NUMBER Architecture ID
--ask-root-password BOOLEAN
--compute-profile VALUE Compute profile name
--compute-profile-id NUMBER Compute profile ID
--compute-resource VALUE Compute resource name
--compute-resource-id NUMBER Compute resource ID
--content-source VALUE Content Source name
--content-source-id NUMBER Content source ID
--content-view VALUE Name to search by
--content-view-id NUMBER Content view ID
--description VALUE Host group description
--domain VALUE Domain name
--domain-id NUMBER Domain ID
--group-parameters-attributes SCHEMA Array of parameters
--kickstart-repository VALUE Kickstart repository name
--kickstart-repository-id NUMBER Kickstart repository ID
--lifecycle-environment VALUE Name to search by
--lifecycle-environment-id NUMBER Lifecycle environment ID
--location VALUE Set the current location context for the request
--location-id NUMBER Set the current location context for the request
--location-ids LIST REPLACE locations with given ids
--location-title VALUE Set the current location context for the request
--location-titles LIST
--locations LIST
--medium VALUE Medium name
--medium-id NUMBER Media ID
--name VALUE Name of the host group
--openscap-proxy-id NUMBER ID of OpenSCAP Capsule
--operatingsystem VALUE Operating system title
--operatingsystem-id NUMBER Operating system ID
--organization VALUE Set the current organization context for the request
--organization-id NUMBER Set the current organization context for the request
--organization-ids LIST REPLACE organizations with given ids.
--organization-title VALUE Set the current organization context for the request
--organization-titles LIST
--organizations LIST
--parent VALUE Name of parent hostgroup
--parent-id NUMBER Parent ID of the host group
--parent-title VALUE Title of parent hostgroup
--partition-table VALUE Partition table name
--partition-table-id NUMBER Partition table ID
--puppet-ca-proxy-id NUMBER Puppet CA Capsule ID
--puppet-proxy-id NUMBER Puppet Capsule ID
--pxe-loader ENUM DHCP filename option (Grub2/PXELinux by default)
Possible value(s): 'None', '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'
--query-organization VALUE Organization name to search by
--query-organization-id VALUE Organization ID to search by
--query-organization-label VALUE Organization label to search by
--realm VALUE Name to search by
--realm-id NUMBER Realm ID
--root-password VALUE Root password
--subnet VALUE Subnet name
--subnet-id NUMBER Subnet ID
--subnet6 VALUE Subnet IPv6 name
--subnet6-id NUMBER Subnet IPv6 ID
-h, --help Print help
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string
Following parameters accept format defined by its schema (bold are required; <> contains acceptable type; [] contains acceptable value):
--group-parameters-attributes "name=<string>\,value=<string>\,parameter_type=[string|boolean|integer|real|array|hash|yaml|json]\,hidden_value=[true|false|1|0], ... "3.38.3. hammer hostgroup delete
删除主机组
Usage:
hammer hostgroup <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 Hostgroup name
--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
--title VALUE Hostgroup title
-h, --help Print help
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string3.38.4. hammer hostgroup delete-parameter
hostgroup 的 delete 参数
Usage:
hammer hostgroup delete-parameter [OPTIONS]
Options:
--hostgroup VALUE Hostgroup name
--hostgroup-id NUMBER
--hostgroup-title VALUE Hostgroup title
--name VALUE Parameter name
-h, --help Print help
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string3.38.5. hammer hostgroup info
显示主机组
Usage:
hammer hostgroup <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 Hostgroup name
--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
--show-hidden-parameters BOOLEAN Display hidden parameter values
--title VALUE Hostgroup title
-h, --help Print help
Predefined field sets:
----------------------------------|-----|---------|-----
FIELDS | ALL | DEFAULT | THIN
----------------------------------|-----|---------|-----
Id | x | x | x
Name | x | x | x
Title | x | x | x
Model | x | x |
Description | x | x |
Parent | x | x |
Compute profile | x | x |
Compute resource | x | x |
Network/subnet ipv4 | x | x |
Network/subnet ipv6 | x | x |
Network/realm | x | x |
Network/domain | x | x |
Operating system/architecture | x | x |
Operating system/operating system | x | x |
Operating system/medium | x | x |
Operating system/partition table | x | x |
Operating system/pxe loader | x | x |
Parameters/ | x | x |
Locations/ | x | x |
Organizations/ | x | x |
Openscap proxy | x | x |
Content view/id | x | x |
Content view/name | x | x |
Lifecycle environment/id | x | x |
Lifecycle environment/name | x | x |
Content source/id | x | x |
Content source/name | x | x |
Kickstart repository/id | x | x |
Kickstart repository/name | x | x |
----------------------------------|-----|---------|-----
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string3.38.6. hammer hostgroup list
列出所有主机组
Usage:
hammer hostgroup <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 Scope by locations
--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 Scope by organizations
--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, 'all' to 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
Title | x | x | x
Operating system | x | x |
Model | x | x |
-----------------|-----|---------|-----
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string
Search / Order fields:
architecture string
host string
id integer
label string
location string
location_id integer
medium string
name string
organization string
organization_id integer
os string
os_description string
os_id integer
os_major string
os_minor string
os_title string
oval_policy_id string
params string
template string
title string3.38.7. hammer hostgroup rebuild-config
重建编配配置
Usage:
hammer hostgroup rebuild-config [OPTIONS]
Options:
--children-hosts BOOLEAN Operate on child hostgroup hosts
--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 Hostgroup name
--only LIST Limit rebuild steps, valid steps are DHCP, DNS, TFTP, Content_Host_Status,
Refresh_Content_Host_Status
--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
--title VALUE Hostgroup title
-h, --help Print help
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string3.38.8. hammer hostgroup set-parameter
为 hostgroup 创建或更新参数
Usage:
hammer hostgroup set-parameter [OPTIONS]
Options:
--hidden-value BOOLEAN Should the value be hidden
--hostgroup VALUE Hostgroup name
--hostgroup-id NUMBER
--hostgroup-title VALUE Hostgroup title
--name VALUE Parameter name
--parameter-type ENUM Type of the parameter
Possible value(s): 'string', 'boolean', 'integer', 'real', 'array', 'hash',
'yaml', 'json'
Default: "string"
--value VALUE Parameter value
-h, --help Print help
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string3.38.9. hammer hostgroup 更新
更新主机组
Usage:
hammer hostgroup update [OPTIONS]
Options:
--ansible-role-ids LIST IDs of associated ansible roles
--ansible-roles LIST
--architecture VALUE Architecture name
--architecture-id NUMBER Architecture ID
--ask-root-password BOOLEAN
--compute-profile VALUE Compute profile name
--compute-profile-id NUMBER Compute profile ID
--compute-resource VALUE Compute resource name
--compute-resource-id NUMBER Compute resource ID
--content-source VALUE Content Source name
--content-source-id NUMBER Content source ID
--content-view VALUE Name to search by
--content-view-id NUMBER Content view ID
--description VALUE Host group description
--domain VALUE Domain name
--domain-id NUMBER Domain ID
--group-parameters-attributes SCHEMA Array of parameters
--id VALUE
--kickstart-repository VALUE Kickstart repository name
--kickstart-repository-id NUMBER Kickstart repository ID
--lifecycle-environment VALUE Name to search by
--lifecycle-environment-id NUMBER Lifecycle environment ID
--location VALUE Set the current location context for the request
--location-id NUMBER Set the current location context for the request
--location-ids LIST REPLACE locations with given ids
--location-title VALUE Set the current location context for the request
--location-titles LIST
--locations LIST
--medium VALUE Medium name
--medium-id NUMBER Media ID
--name VALUE Name of the host group
--new-name VALUE Name of the host group
--openscap-proxy-id NUMBER ID of OpenSCAP Capsule
--operatingsystem VALUE Operating system title
--operatingsystem-id NUMBER Operating system ID
--organization VALUE Set the current organization context for the request
--organization-id NUMBER Set the current organization context for the request
--organization-ids LIST REPLACE organizations with given ids.
--organization-title VALUE Set the current organization context for the request
--organization-titles LIST
--organizations LIST
--parent VALUE Name of parent hostgroup
--parent-id NUMBER Parent ID of the host group
--parent-title VALUE Title of parent hostgroup
--partition-table VALUE Partition table name
--partition-table-id NUMBER Partition table ID
--puppet-ca-proxy-id NUMBER Puppet CA Capsule ID
--puppet-proxy-id NUMBER Puppet Capsule ID
--pxe-loader ENUM DHCP filename option (Grub2/PXELinux by default)
Possible value(s): 'None', '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'
--query-organization VALUE Organization name to search by
--query-organization-id VALUE Organization ID to search by
--query-organization-label VALUE Organization label to search by
--realm VALUE Name to search by
--realm-id NUMBER Realm ID
--root-password VALUE Root password
--subnet VALUE Subnet name
--subnet-id NUMBER Subnet ID
--subnet6 VALUE Subnet IPv6 name
--subnet6-id NUMBER Subnet IPv6 ID
--title VALUE Hostgroup title
-h, --help Print help
Option details:
Here you can find option types and the value an option can accept:
BOOLEAN One of true/false, yes/no, 1/0
DATETIME Date and time in YYYY-MM-DD HH:MM:SS or ISO 8601 format
ENUM Possible values are described in the option's description
FILE Path to a file
KEY_VALUE_LIST Comma-separated list of key=value.
JSON is acceptable and preferred way for such parameters
LIST Comma separated list of values. Values containing comma should be quoted or escaped with backslash.
JSON is acceptable and preferred way for such parameters
MULTIENUM Any combination of possible values described in the option's description
NUMBER Numeric value. Integer
SCHEMA Comma separated list of values defined by a schema.
JSON is acceptable and preferred way for such parameters
VALUE Value described in the option's description. Mostly simple string
Following parameters accept format defined by its schema (bold are required; <> contains acceptable type; [] contains acceptable value):
--group-parameters-attributes "name=<string>\,value=<string>\,parameter_type=[string|boolean|integer|real|array|hash|yaml|json]\,hidden_value=[true|false|1|0], ... "