PUT /api/hosts/:id/puppetrun
Force a Puppet agent run on the host

Examples

PUT /api/hosts/15/puppetrun
{
  "controller": "puppet_hosts",
  "puppet_host": {
    "controller": "puppet_hosts"
  }
}
200
{
  "id": 15,
  "name": "host133",
  "last_compile": null,
  "last_report": null,
  "updated_at": "2020-05-20T13:15:27.912Z",
  "created_at": "2020-05-20T13:15:27.912Z",
  "root_pass": "$5$qg7zn6wSzwm5A9vi$i1T89lGQElN.yt3Crbex9S1.T7YDCt5uM6FmmWY9kMD",
  "architecture_id": null,
  "operatingsystem_id": null,
  "environment_id": 687036938,
  "ptable_id": null,
  "medium_id": null,
  "build": false,
  "comment": null,
  "disk": null,
  "installed_at": null,
  "model_id": null,
  "hostgroup_id": null,
  "owner_id": 135138680,
  "owner_type": "User",
  "enabled": true,
  "puppet_ca_proxy_id": null,
  "managed": false,
  "use_image": null,
  "image_file": "",
  "uuid": null,
  "compute_resource_id": null,
  "puppet_proxy_id": 982965214,
  "certname": "host133",
  "image_id": null,
  "organization_id": 447626438,
  "location_id": 255093256,
  "otp": null,
  "realm_id": null,
  "compute_profile_id": null,
  "provision_method": "build",
  "grub_pass": "$6$Xgf8MHkHROOIHFLI$VlxOKGdSms7YQ4DZ8IVDIe2R6l0x3HU/2BgLeub6ENVo5szwv1j/HNRzAVPXVF22cjLXsGMRu5JS3CqvdFTEY.",
  "global_status": 0,
  "lookup_value_matcher": "fqdn=host133",
  "pxe_loader": null,
  "initiated_at": null,
  "build_errors": null
}

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
id
required

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, dot(.), space, underscore(_), hypen(-) with no leading or trailing space.