Subscriptions management.


GET /katello/api/organizations/:organization_id/subscriptions
List organization subscriptions

GET /katello/api/activation_keys/:activation_key_id/subscriptions
List an activation key's subscriptions

GET /katello/api/subscriptions

Params

Param Name Description
search
Optional

Search string

Validations:

  • String

page
Optional

Page number, starting at 1

Validations:

  • number.

per_page
Optional

Number of results per page to return

Validations:

  • number.

order
Optional

Sort field and order, eg. 'name DESC'

Validations:

  • String

full_results
Optional

Whether or not to show all results

Validations:

  • boolean

sort
Optional

Hash version of 'order' param

Validations:

  • Hash

sort[by]
Optional

Field to sort the results on

Validations:

  • String

sort[order]
Optional

How to order the sorted results (e.g. ASC for ascending)

Validations:

  • String

organization_id
Required

Organization ID

Validations:

  • number.

host_id
Optional

id of a host

Validations:

  • String

activation_key_id
Optional

Activation key ID

Validations:

  • String

available_for
Optional

Object to show subscriptions available for, either 'host' or 'activation_key'

Validations:

  • String

match_host
Optional

Ignore subscriptions that are unavailable to the specified host

Validations:

  • boolean

match_installed
Optional

Return subscriptions that match installed products of the specified host

Validations:

  • boolean

no_overlap
Optional

Return subscriptions which do not overlap with a currently-attached subscription

Validations:

  • boolean


GET /katello/api/organizations/:organization_id/subscriptions/:id
Show a subscription

GET /katello/api/subscriptions/:id
Show a subscription

Params

Param Name Description
organization_id
Optional

Organization identifier

Validations:

  • number.

id
Required

Subscription identifier

Validations:

  • number.


POST /katello/api/activation_keys/:activation_key_id/subscriptions DEPRECATED
Add a subscription to an activation key

Params

Param Name Description
id
Optional

Subscription Pool uuid

Validations:

  • String

activation_key_id
Optional

ID of the activation key

Validations:

  • String

quantity
Optional

Quantity of this subscriptions to add

Validations:

  • number.

subscriptions
Optional

Array of subscriptions to add

Validations:

  • Must be an Array of nested elements

subscriptions[id]
Required

Subscription Pool uuid

Validations:

  • String

subscriptions[quantity]
Required

Quantity of this subscriptions to add

Validations:

  • number.


DELETE /katello/api/activation_keys/:activation_key_id/subscriptions/:id DEPRECATED
Unattach a subscription

Params

Param Name Description
id
Optional

Subscription ID

Validations:

  • String

activation_key_id
Optional

activation key ID

Validations:

  • String


POST /katello/api/organizations/:organization_id/subscriptions/upload
Upload a subscription manifest

Params

Param Name Description
organization_id
Required

Organization id

Validations:

  • number.

content
Required

Subscription manifest file

Validations:

  • File

repository_url
Optional

repository url

Validations:

  • String


PUT /katello/api/organizations/:organization_id/subscriptions/refresh_manifest
Refresh previously imported manifest for Red Hat provider

Params

Param Name Description
organization_id
Required

Organization id

Validations:

  • number.


POST /katello/api/organizations/:organization_id/subscriptions/delete_manifest
Delete manifest from Red Hat provider

Params

Param Name Description
organization_id
Required

Organization id

Validations:

  • number.


GET /katello/api/organizations/:organization_id/subscriptions/manifest_history
obtain manifest history for subscriptions

Params

Param Name Description
organization_id
Required

Organization ID

Validations:

  • number.