POST /api/registration_commands
Generate global registration command

Examples

POST /api/registration_commands
{
  "insecure": true,
  "jwt_expiration": 23,
  "smart_proxy_id": 980190962,
  "registration_command": {
    "insecure": true,
    "jwt_expiration": 23,
    "smart_proxy_id": 980190962
  }
}
200
{
  "registration_command": "curl -sS --insecure 'https://somewhere.net:8443/register' -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxMzUxMzg2ODAsImlhdCI6MTYyMTM1MzQ5NiwianRpIjoiZjFlMDdjZWQxNTA3MzUxYjk2Y2E5YjM4ZTAxYThjNzM4OGMxMTcwMjZjNTQ4MzIwODk1ZjI5OTIxNDQ1NDI4YyIsImV4cCI6MTYyMTQzNjI5Niwic2NvcGUiOiJyZWdpc3RyYXRpb24jZ2xvYmFsIHJlZ2lzdHJhdGlvbiNob3N0In0.btMhtqBPvM078E-k-1PvBtoZv2wdJPqR8VuVXcKPRII' | bash"
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
registration_command
optional , nil allowed

Validations:

  • Must be a Hash
registration_command[organization_id]
optional , nil allowed

ID of the Organization to register the host in

Validations:

  • Must be a number.
registration_command[location_id]
optional , nil allowed

ID of the Location to register the host in

Validations:

  • Must be a number.
registration_command[hostgroup_id]
optional , nil allowed

ID of the Host group to register the host in

Validations:

  • Must be a number.
registration_command[operatingsystem_id]
optional , nil allowed

ID of the Operating System to register the host in

Validations:

  • Must be a number.
registration_command[smart_proxy_id]
optional , nil allowed

ID of the Smart Proxy

Validations:

  • Must be a number.
registration_command[setup_insights]
optional , nil allowed

Set ‘host_registration_insights’ parameter for the host. If it is set to true, insights client will be installed and registered on Red Hat family operating systems

Validations:

  • Must be one of: true, false, 1, 0.
registration_command[setup_remote_execution]
optional , nil allowed

Set ‘host_registration_remote_execution’ parameter for the host. If it is set to true, SSH keys will be installed on the host

Validations:

  • Must be one of: true, false, 1, 0.
registration_command[jwt_expiration]
optional , nil allowed

Expiration of the authorization token (in hours)

Validations:

  • Must be a number.
registration_command[insecure]
optional , nil allowed

Enable insecure argument for the initial curl

Validations:

  • Must be one of: true, false, 1, 0.
registration_command[repo]
optional , nil allowed

Repository URL / details, for example for Debian OS family: ‘deb http://deb.example.com/ buster 1.0’, for Red Hat OS family: ‘http://yum.theforeman.org/client/latest/el8/x86_64/’

Validations:

  • Must be a String
registration_command[repo_gpg_key_url]
optional , nil allowed

URL of the GPG key for the repository

Validations:

  • Must be a String