POST /api/hosts/subscriptions
Register a host with subscription and information

Examples

POST /api/hosts/subscriptions
{
  "lifecycle_environment_id": 562075838,
  "content_view_id": 30237652,
  "facts": {
    "network.hostname": "host106"
  },
  "installed_products": [
    {
      "product_id": "1",
      "product_name": "name"
    }
  ],
  "purpose_role": "MyRole",
  "purpose_usage": "MyUsage",
  "purpose_addons": "Addon1,Addon2",
  "host_subscription": {
    "lifecycle_environment_id": 562075838,
    "content_view_id": 30237652,
    "facts": {
      "network.hostname": "host106"
    },
    "installed_products": [
      {
        "product_id": "1",
        "product_name": "name"
      }
    ],
    "purpose_role": "MyRole",
    "purpose_usage": "MyUsage",
    "purpose_addons": "Addon1,Addon2"
  }
}
200
{
  "id": 980191067,
  "name": "host106"
}

Params

Param name Description
name
required

Name of the host

Validations:

  • String
uuid
optional

UUID to use for registered host, random uuid is generated if not provided

Validations:

  • String
facts
optional

Key-value hash of subscription-manager facts, nesting uses a period delimiter (.)

Validations:

  • Hash
hypervisor_guest_uuids
optional

UUIDs of the virtual guests from the host's hypervisor

Validations:

  • Must be an array of any type
installed_products
optional

List of products installed on the host

Validations:

  • Must be an Array of nested elements
installed_products[product_id]
optional

Product id as listed from a host's installed products, this is not the same product id as the products api returns

Validations:

  • String
installed_products[product_name]
optional

Product name as listed from a host's installed products

Validations:

  • String
installed_products[arch]
optional

Product architecture

Validations:

  • String
installed_products[version]
optional

Product version

Validations:

  • String
release_version
optional

Release version of the content host

Validations:

  • String
service_level
optional

A service level for auto-healing process, e.g. SELF-SUPPORT

Validations:

  • String
lifecycle_environment_id
required

Lifecycle Environment ID

Validations:

  • Integer
content_view_id
required

Content View ID

Validations:

  • Integer