Products

>>>

GET /katello/api/products
List products

GET /katello/api/subscriptions/:subscription_id/products
List of subscription products in a subscription

GET /katello/api/activation_keys/:activation_key_id/products
List of subscription products in an activation key

GET /katello/api/organizations/:organization_id/products
List of products in an organization

GET /katello/api/sync_plans/:sync_plan_id/products
List of Products for sync plan

GET /katello/api/organizations/:organization_id/sync_plans/:sync_plan_id/products
List of Products for sync plan

Examples

GET /katello/api/organizations/114267492/products
204

Params

Param name Description
organization_id
required

Filter products by organization

Validations:

  • Must be a number.
subscription_id
optional

Filter products by subscription

Validations:

  • Must be a number.
name
optional

Filter products by name

Validations:

  • String
enabled
optional

Return enabled products only

Validations:

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

Return custom products only

Validations:

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

Return Red Hat (non-custom) products only

Validations:

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

Whether to include available content attribute in results

Validations:

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

Filter products by sync plan id

Validations:

  • Must be a number.
available_for
optional

Interpret specified object to return only Products that can be associated with specified object. Only 'sync_plan' is supported.

Validations:

  • String
search
optional

Search string

Validations:

  • String
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

Sort field and order, eg. 'id DESC'

Validations:

  • String
full_result
optional

Whether or not to show all results

Validations:

  • Must be one of: true, false, 1, 0.
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

Search fields

Field name Type Possible values
description text
label string
name string
organization_id integer
redhat true, false
>>>

POST /katello/api/products
Create a product

Examples

POST /katello/api/products
{
  "product": {
    "name": "fedora product",
    "description": "this is my cool new product."
  },
  "organization_id": "asdfdsafds"
}
404
{
  "message": "Organization with id asdfdsafds not found"
}

Params

Param name Description
organization_id
required

ID of the organization

Validations:

  • Must be a number.
description
optional

Product description

Validations:

  • String
gpg_key_id
optional , nil allowed

Identifier of the GPG key

Validations:

  • Must be a number.
ssl_ca_cert_id
optional , nil allowed

Idenifier of the SSL CA Cert

Validations:

  • Must be a number.
ssl_client_cert_id
optional , nil allowed

Identifier of the SSL Client Cert

Validations:

  • Must be a number.
ssl_client_key_id
optional , nil allowed

Identifier of the SSL Client Key

Validations:

  • Must be a number.
sync_plan_id
optional , nil allowed

Plan numeric identifier

Validations:

  • Must be a number.
name
required

Product name

Validations:

  • String
label
optional

Validations:

  • String
>>>

GET /katello/api/products/:id
Show a product

Examples

GET /katello/api/products/785257261
200
{
  "sync_state_aggregated": "stopped",
  "redhat": false,
  "id": 785257261,
  "cp_id": "123123123001",
  "name": "Fedora",
  "label": "fedora_label",
  "description": "An open source Linux distribution.",
  "provider_id": 36826545,
  "sync_plan_id": null,
  "sync_summary": {},
  "gpg_key_id": null,
  "ssl_ca_cert_id": null,
  "ssl_client_cert_id": null,
  "ssl_client_key_id": null,
  "sync_state": null,
  "last_sync": null,
  "last_sync_words": null,
  "organization_id": 114267492,
  "organization": {
    "name": "Empty Organization",
    "label": "Empty_Organization",
    "id": 114267492
  },
  "sync_plan": null,
  "repository_count": 13,
  "created_at": "2024-05-23 19:46:02 UTC",
  "updated_at": "2024-05-23 19:46:02 UTC",
  "product_content": [
    {
      "enabled": false,
      "product_id": 785257261,
      "content": {
        "name": "Fedora",
        "label": "fedora",
        "vendor": null,
        "content_url": "/pub/fedora/linux/releases/$releasever/Everything/$basearch/os",
        "gpg_url": null,
        "id": "1",
        "type": null,
        "gpgUrl": null,
        "contentUrl": "/pub/fedora/linux/releases/$releasever/Everything/$basearch/os"
      }
    }
  ],
  "available_content": [
    {
      "enabled": false,
      "product_id": 785257261,
      "content": {
        "name": "Fedora",
        "label": "fedora",
        "vendor": null,
        "content_url": "/pub/fedora/linux/releases/$releasever/Everything/$basearch/os",
        "gpg_url": null,
        "id": "1",
        "type": null,
        "gpgUrl": null,
        "contentUrl": "/pub/fedora/linux/releases/$releasever/Everything/$basearch/os"
      }
    }
  ],
  "repositories": [
    {
      "name": "Fedora 17 x86_64",
      "id": 367202338
    },
    {
      "name": "Fedora 17 x86_64",
      "id": 841170190
    },
    {
      "name": "Fedora 17 x86_64 duplicate",
      "id": 792129035
    },
    {
      "name": "Feedless Fedora 17 x86_64",
      "id": 643402541
    },
    {
      "name": "Fedora 17 no arch",
      "id": 242028598
    },
    {
      "name": "Fedora 17 x86_64 unpublished",
      "id": 841753487
    },
    {
      "name": "Fedora 17 x86_64 2",
      "id": 860533889
    },
    {
      "name": "Source rpm repo",
      "id": 504073478
    },
    {
      "name": "My Files",
      "id": 921033349
    },
    {
      "name": "Pulp3 File 1",
      "id": 752069227
    },
    {
      "name": "Pulp3 Ansible Collection 1",
      "id": 269989997
    },
    {
      "name": "Pulp3 Docker 1",
      "id": 536318648
    },
    {
      "name": "Pulp3 Python 1",
      "id": 16447009
    },
    {
      "name": "Pulp3 OSTree 1",
      "id": 145295987
    }
  ],
  "provider": {
    "name": "Anonymous"
  },
  "sync_status": {
    "id": null,
    "product_id": null,
    "progress": null,
    "sync_id": null,
    "state": null,
    "raw_state": null,
    "start_time": null,
    "finish_time": null,
    "duration": null,
    "display_size": null,
    "size": null,
    "is_running": null,
    "error_details": null
  },
  "permissions": {
    "view_products": true,
    "edit_products": true,
    "destroy_products": false,
    "sync_products": true
  },
  "published_content_view_ids": [
    909058347,
    405955044
  ],
  "has_last_affected_repo_in_filter": false,
  "active_task_count": 0
}

Params

Param name Description
organization_id
optional

Organization ID

Validations:

  • Must be a number.
id
required

product numeric identifier

Validations:

  • Must be a number.
>>>

PUT /katello/api/products/:id
Updates a product

Examples

PUT /katello/api/products/785257261
{
  "product": {
    "name": "New Name",
    "description": "Product Description",
    "label": "product_label"
  }
}
200
{
  "sync_state_aggregated": "stopped",
  "redhat": false,
  "id": 785257261,
  "cp_id": "123123123001",
  "name": "Fedora",
  "label": "fedora_label",
  "description": "An open source Linux distribution.",
  "provider_id": 36826545,
  "sync_plan_id": null,
  "sync_summary": {},
  "gpg_key_id": null,
  "ssl_ca_cert_id": null,
  "ssl_client_cert_id": null,
  "ssl_client_key_id": null,
  "sync_state": null,
  "last_sync": null,
  "last_sync_words": null,
  "organization_id": 114267492,
  "organization": {
    "name": "Empty Organization",
    "label": "Empty_Organization",
    "id": 114267492
  },
  "sync_plan": null,
  "repository_count": 13,
  "created_at": "2024-05-23 19:46:02 UTC",
  "updated_at": "2024-05-23 19:46:02 UTC",
  "product_content": [
    {
      "enabled": false,
      "product_id": 785257261,
      "content": {
        "name": "Fedora",
        "label": "fedora",
        "vendor": null,
        "content_url": "/pub/fedora/linux/releases/$releasever/Everything/$basearch/os",
        "gpg_url": null,
        "id": "1",
        "type": null,
        "gpgUrl": null,
        "contentUrl": "/pub/fedora/linux/releases/$releasever/Everything/$basearch/os"
      }
    }
  ],
  "available_content": [
    {
      "enabled": false,
      "product_id": 785257261,
      "content": {
        "name": "Fedora",
        "label": "fedora",
        "vendor": null,
        "content_url": "/pub/fedora/linux/releases/$releasever/Everything/$basearch/os",
        "gpg_url": null,
        "id": "1",
        "type": null,
        "gpgUrl": null,
        "contentUrl": "/pub/fedora/linux/releases/$releasever/Everything/$basearch/os"
      }
    }
  ],
  "repositories": [
    {
      "name": "Fedora 17 x86_64",
      "id": 367202338
    },
    {
      "name": "Fedora 17 x86_64",
      "id": 841170190
    },
    {
      "name": "Fedora 17 x86_64 duplicate",
      "id": 792129035
    },
    {
      "name": "Feedless Fedora 17 x86_64",
      "id": 643402541
    },
    {
      "name": "Fedora 17 no arch",
      "id": 242028598
    },
    {
      "name": "Fedora 17 x86_64 unpublished",
      "id": 841753487
    },
    {
      "name": "Fedora 17 x86_64 2",
      "id": 860533889
    },
    {
      "name": "Source rpm repo",
      "id": 504073478
    },
    {
      "name": "My Files",
      "id": 921033349
    },
    {
      "name": "Pulp3 File 1",
      "id": 752069227
    },
    {
      "name": "Pulp3 Ansible Collection 1",
      "id": 269989997
    },
    {
      "name": "Pulp3 Docker 1",
      "id": 536318648
    },
    {
      "name": "Pulp3 Python 1",
      "id": 16447009
    },
    {
      "name": "Pulp3 OSTree 1",
      "id": 145295987
    }
  ],
  "provider": {
    "name": "Anonymous"
  },
  "sync_status": {
    "id": null,
    "product_id": null,
    "progress": null,
    "sync_id": null,
    "state": null,
    "raw_state": null,
    "start_time": null,
    "finish_time": null,
    "duration": null,
    "display_size": null,
    "size": null,
    "is_running": null,
    "error_details": null
  },
  "permissions": {
    "view_products": true,
    "edit_products": true,
    "destroy_products": false,
    "sync_products": true
  },
  "published_content_view_ids": [
    909058347,
    405955044
  ],
  "has_last_affected_repo_in_filter": false,
  "active_task_count": 0
}

Params

Param name Description
id
required

product numeric identifier

Validations:

  • Must be a number.
description
optional

Product description

Validations:

  • String
gpg_key_id
optional , nil allowed

Identifier of the GPG key

Validations:

  • Must be a number.
ssl_ca_cert_id
optional , nil allowed

Idenifier of the SSL CA Cert

Validations:

  • Must be a number.
ssl_client_cert_id
optional , nil allowed

Identifier of the SSL Client Cert

Validations:

  • Must be a number.
ssl_client_key_id
optional , nil allowed

Identifier of the SSL Client Key

Validations:

  • Must be a number.
sync_plan_id
optional , nil allowed

Plan numeric identifier

Validations:

  • Must be a number.
name
optional

Product name

Validations:

  • String
>>>

DELETE /katello/api/products/:id
Destroy a product

Examples

DELETE /katello/api/products/785257261
{
  "product": {}
}
204

Params

Param name Description
id
optional

product numeric identifier

Validations:

  • Must be a number.
>>>

POST /katello/api/products/:id/sync
Sync all repositories for a product

Examples

POST /katello/api/products/905280015/sync
{
  "product": {}
}
422
{
  "displayMessage": "Unable to synchronize any repository. You either do not have the permission to synchronize or the selected repositories do not have a feed url.",
  "errors": [
    "Unable to synchronize any repository. You either do not have the permission to synchronize or the selected repositories do not have a feed url."
  ]
}

Params

Param name Description
id
required

product ID

Validations:

  • Must be a number.