Upstream_subscriptions

Red Hat subscriptions management platform.

>>>

GET /katello/api/organizations/:organization_id/upstream_subscriptions
List available subscriptions from Red Hat Subscription Management

Params

Param name Description
organization_id
required

Organization ID

Validations:

  • Must be a number.
page
optional

Page number, starting at 1

Validations:

  • Must be a number.
per_page
optional

Number of results per page to return.

Validations:

  • Must be a number.
order
optional

The order to sort the results in. ['asc', 'desc'] Defaults to 'desc'.

Validations:

  • String
sort_by
optional

The field to sort the data by. Defaults to the created date.

Validations:

  • String
pool_ids
optional

Return only the upstream pools which map to the given Katello pool IDs

Validations:

  • Must be an array of any type
quantities_only
optional

Only returns id and quantity fields

Validations:

  • Must be one of: true, false, 1, 0.
attachable
optional

Return only subscriptions which can be attached to the upstream allocation

Validations:

  • Must be one of: true, false, 1, 0.
>>>

PUT /katello/api/organizations/:organization_id/upstream_subscriptions
Update the quantity of one or more subscriptions on an upstream allocation

Params

Param name Description
organization_id
required

Organization ID

Validations:

  • Must be a number.
pools
required

Array of Pools to be updated. Only pools originating upstream are accepted.

Validations:

  • Must be an Array of nested elements
pools[id]
required

Katello ID of local pool to update

Validations:

  • String
pools[quantity]
required

Desired quantity of the pool

Validations:

  • Integer
>>>

DELETE /katello/api/organizations/:organization_id/upstream_subscriptions
Remove one or more subscriptions from an upstream manifest

Params

Param name Description
organization_id
required

Organization ID

Validations:

  • Must be a number.
pool_ids
required

Array of local pool IDs. Only pools originating upstream are accepted.

Validations:

  • Must be an array of any type
>>>

POST /katello/api/organizations/:organization_id/upstream_subscriptions
Add subscriptions consumed by a manifest from Red Hat Subscription Management

Params

Param name Description
pools
required

Array of pools to add

Validations:

  • Must be an Array of nested elements
pools[id]
required

Candlepin ID of pool to add

Validations:

  • String
pools[quantity]
required

Quantity of entitlements to bind

Validations:

  • Must be a number.
organization_id
required

Organization ID

Validations:

  • Must be a number.
>>>

GET /katello/api/organizations/:organization_id/upstream_subscriptions/ping
Check if a connection can be made to Red Hat Subscription Management.