Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 52. location

Manipulate locations

Usage 

# hammer location [OPTIONS] SUBCOMMAND [ARG] ...
Copy to Clipboard Toggle word wrap

Options

  • -h, --help – Print help

52.1. location add-compute-resource
Copy link

Associate a compute resource

Usage 

# hammer location add-compute-resource [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --compute-resource VALUE – Compute resource name
  • --compute-resource-id NUMBER
  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.2. location add-domain
Copy link

Associate a domain

Usage 

# hammer location add-domain [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --domain VALUE – Domain name
  • --domain-id NUMBER – Numerical ID or domain name
  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.3. location add-hostgroup
Copy link

Associate a hostgroup

Usage 

# hammer location add-hostgroup [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --hostgroup VALUE – Hostgroup name
  • --hostgroup-id NUMBER
  • --hostgroup-title VALUE – Hostgroup title
  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.4. location add-medium
Copy link

Associate a medium

Usage 

# hammer location add-medium [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --medium VALUE – Medium name
  • --medium-id NUMBER
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.5. location add-organization
Copy link

Associate an organization

Usage 

# hammer location add-organization [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --organization VALUE – Set the current organization context for the request
  • --organization-id NUMBER – Organization ID
  • --organization-title VALUE – Set the current organization context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.6. location add-provisioning-template
Copy link

Associate provisioning templates

Usage 

# hammer location add-provisioning-template [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --provisioning-template VALUE – Name to search by
  • --provisioning-template-id NUMBER
  • --provisioning-template-ids LIST – List of provisioning template ids
  • --provisioning-template-search VALUE Provisioning template name regex to search, all matching templates will be associated
  • --provisioning-templates LIST – List of provisioning template names
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.7. location add-smart-proxy
Copy link

Associate a smart proxy

Usage 

# hammer location add-smart-proxy [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --smart-proxy VALUE – Name to search by
  • --smart-proxy-id NUMBER
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.8. location add-subnet
Copy link

Associate a subnet

Usage 

# hammer location add-subnet [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --subnet VALUE – Subnet name
  • --subnet-id NUMBER
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.9. location add-user
Copy link

Associate an user

Usage 

# hammer location add-user [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • --user VALUE – User`s login to search by
  • --user-id NUMBER
  • -h, --help – Print help

52.10. location create
Copy link

Create a location

Usage 

# hammer location create [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --compute-resource-ids LIST – Compute resource IDs
  • --compute-resources LIST
  • --description VALUE
  • --domain-ids LIST – Domain IDs
  • --domains LIST
  • --environment-ids LIST – Environment IDs
  • --environments LIST
  • --hostgroup-ids LIST – Host group IDs
  • --hostgroup-titles LIST
  • --hostgroups LIST
  • --ignore-types LIST – List of resources types that will be automatically associated
  • --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
  • --media LIST
  • --medium-ids LIST – Medium IDs
  • --name VALUE
  • --organization VALUE – Set the current organization context for the request
  • --organization-id NUMBER – Set the current organization context for the request
  • --organization-ids LIST – Associated organization IDs
  • --organization-title VALUE – Set the current organization context for the request
  • --organization-titles LIST
  • --organizations LIST
  • --parent-id NUMBER – Parent ID
  • --partition-table-ids LIST – Partition template IDs
  • --partition-tables LIST
  • --provisioning-template-ids LIST Provisioning template IDs
  • --provisioning-templates LIST
  • --puppet-environment-ids LIST – IDs of associated Puppet environment
  • --puppet-environments VALUE – Names of associated Puppet environment
  • --realm-ids LIST – Realm IDs
  • --realms LIST
  • --smart-proxies LIST
  • --smart-proxy-ids LIST – Capsule IDs
  • --subnet-ids LIST – Subnet IDs
  • --subnets LIST
  • --user-ids LIST – User IDs
  • --users LIST
  • -h, --help – Print help

52.11. location delete
Copy link

Delete a location

Usage 

# hammer location <delete|destroy> [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE – Location numeric id to search by
  • --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 – Set the current organization context for the request
  • --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 – Set the current organization context for the request
  • -h, --help – Print help

52.12. location delete-parameter
Copy link

Delete parameter for a location

Usage 

# hammer location delete-parameter [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --location VALUE – Set the current location context for the request
  • --location-id NUMBER
  • --location-title VALUE – Set the current location context for the request
  • --name VALUE – Parameter name
  • -h, --help – Print help

52.13. location info
Copy link

Show a location

Usage 

# hammer location <info|show> [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --fields LIST – Show specified fields or predefined field sets only. (See below)
  • --id VALUE – Location numeric id to search by
  • --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 – Set the current organization context for the request
  • --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 – Set the current organization context for the request
  • -h, --help – Print help

Predefined field sets

Expand
FIELDSALLDEFAULTTHIN

Id

x

x

x

Title

x

x

x

Name

x

x

x

Description

x

x

 

Parent

x

x

 

Users/

x

x

 

Smart proxies/

x

x

 

Subnets/

x

x

 

Compute resources/

x

x

 

Installation media/

x

x

 

Templates/

x

x

 

Partition tables/

x

x

 

Domains/

x

x

 

Realms/

x

x

 

Environments/

x

x

 

Hostgroups/

x

x

 

Parameters/

x

x

 

Organizations/

x

x

 

Created at

x

x

 

Updated at

x

x

 

52.14. location list
Copy link

List all locations

Usage 

# hammer location <list|index> [OPTIONS]
Copy to Clipboard Toggle word wrap

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, all to return all results
  • --search VALUE – Filter results
  • -h, --help – Print help

Predefined field sets

Expand
FIELDSALLDEFAULTTHIN

Id

x

x

x

Title

x

x

x

Name

x

x

x

Description

x

x

 

Search and order fields

  • description – text
  • id – integer
  • location_id – integer
  • name – string
  • title – string

52.15. location remove-compute-resource
Copy link

Disassociate a compute resource

Usage 

# hammer location remove-compute-resource [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --compute-resource VALUE – Compute resource name
  • --compute-resource-id NUMBER
  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.16. location remove-domain
Copy link

Disassociate a domain

Usage 

# hammer location remove-domain [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --domain VALUE – Domain name
  • --domain-id NUMBER – Numerical ID or domain name
  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.17. location remove-hostgroup
Copy link

Disassociate a hostgroup

Usage 

# hammer location remove-hostgroup [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --hostgroup VALUE – Hostgroup name
  • --hostgroup-id NUMBER
  • --hostgroup-title VALUE – Hostgroup title
  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.18. location remove-medium
Copy link

Disassociate a medium

Usage 

# hammer location remove-medium [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --medium VALUE – Medium name
  • --medium-id NUMBER
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.19. location remove-organization
Copy link

Disassociate an organization

Usage 

# hammer location remove-organization [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --organization VALUE – Set the current organization context for the request
  • --organization-id NUMBER – Organization ID
  • --organization-title VALUE – Set the current organization context for the request
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.20. location remove-provisioning-template
Copy link

Disassociate provisioning templates

Usage 

# hammer location remove-provisioning-template [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --provisioning-template VALUE – Name to search by
  • --provisioning-template-id NUMBER
  • --provisioning-template-ids LIST – List of provisioning template ids
  • --provisioning-template-search VALUE Provisioning template name regex to search, all matching templates will be disassociated
  • --provisioning-templates LIST – List of provisioning template names
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.21. location remove-smart-proxy
Copy link

Disassociate a smart proxy

Usage 

# hammer location remove-smart-proxy [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --smart-proxy VALUE – Name to search by
  • --smart-proxy-id NUMBER
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.22. location remove-subnet
Copy link

Disassociate a subnet

Usage 

# hammer location remove-subnet [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --subnet VALUE – Subnet name
  • --subnet-id NUMBER
  • --title VALUE – Set the current location context for the request
  • -h, --help – Print help

52.23. location remove-user
Copy link

Disassociate an user

Usage 

# hammer location remove-user [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --id VALUE
  • --name VALUE – Set the current location context for the request
  • --title VALUE – Set the current location context for the request
  • --user VALUE – User`s login to search by
  • --user-id NUMBER
  • -h, --help – Print help

52.24. location set-parameter
Copy link

Create or update parameter for a location

Usage 

# hammer location set-parameter [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --hidden-value BOOLEAN – Should the value be hidden
  • --location VALUE – Set the current location context for the request
  • --location-id NUMBER
  • --location-title VALUE – Set the current location context for the request
  • --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

52.25. location update
Copy link

Update a location

Usage 

# hammer location update [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --compute-resource-ids LIST – Compute resource IDs
  • --compute-resources LIST
  • --description VALUE
  • --domain-ids LIST – Domain IDs
  • --domains LIST
  • --environment-ids LIST – Environment IDs
  • --environments LIST
  • --hostgroup-ids LIST – Host group IDs
  • --hostgroup-titles LIST
  • --hostgroups LIST
  • --id VALUE – Location numeric id to search by
  • --ignore-types LIST – List of resources types that will be automatically associated
  • --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
  • --media LIST
  • --medium-ids LIST – Medium IDs
  • --name VALUE
  • --new-name VALUE
  • --organization VALUE – Set the current organization context for the request
  • --organization-id NUMBER – Set the current organization context for the request
  • --organization-ids LIST – Associated organization IDs
  • --organization-title VALUE – Set the current organization context for the request
  • --organization-titles LIST
  • --organizations LIST
  • --parent-id NUMBER – Parent ID
  • --partition-table-ids LIST – Partition template IDs
  • --partition-tables LIST
  • --provisioning-template-ids LIST Provisioning template IDs
  • --provisioning-templates LIST
  • --puppet-environment-ids LIST – IDs of associated Puppet environment
  • --puppet-environments VALUE – Names of associated Puppet environment
  • --realm-ids LIST – Realm IDs
  • --realms LIST
  • --smart-proxies LIST
  • --smart-proxy-ids LIST – Capsule IDs
  • --subnet-ids LIST – Subnet IDs
  • --subnets LIST
  • --title VALUE – Set the current location context for the request
  • --user-ids LIST – User IDs
  • --users LIST
  • -h, --help – Print help
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat