GET /katello/api/content_views/405955044/content_view_versions 200 { "total": 1, "subtotal": 1, "selectable": 1, "page": 1, "per_page": 20, "error": null, "search": null, "sort": { "by": "version", "order": "desc" }, "results": [ { "version": "2.0", "major": 2, "minor": 0, "composite_content_view_ids": [], "published_in_composite_content_view_ids": [], "content_view_id": 405955044, "default": false, "description": "A nice content view version", "id": 111397700, "name": "Published LIbrary view 2.0", "created_at": "2024-02-22 18:22:29 UTC", "updated_at": "2024-02-22 18:22:29 UTC", "content_view": { "id": 405955044, "name": "Published LIbrary view", "label": "published_library_view", "generated_for": "none" }, "composite_content_views": [], "composite_content_view_versions": [], "published_in_composite_content_views": [], "environments": [ { "id": 562075838, "name": "Library", "label": "library_label", "publish_date": "6 minutes", "permissions": { "readable": true, "promotable_or_removable": true, "all_hosts_editable": true, "all_keys_editable": true }, "host_count": 0, "activation_key_count": 0 } ], "repositories": [ { "id": 952181839, "name": "RHEL 6 x86_64", "label": "rhel_6_x86_64_label", "content_type": "yum", "library_instance_id": 103207400, "mirroring_policy": "mirror_content_only" }, { "id": 129339708, "name": "Fedora 17 x86_64", "label": "fedora_17_x86_64_label", "content_type": "yum", "library_instance_id": 367202338, "mirroring_policy": "mirror_content_only" }, { "id": 1067868180, "name": "busybox", "label": "busybox", "content_type": "docker", "library_instance_id": 84409059, "mirroring_policy": "mirror_content_only" } ], "last_event": { "user": "Admin", "status": "successful", "description": "A nice content view version", "action": "publish", "created_at": "2024-02-22 18:22:29 UTC", "updated_at": "2024-02-22 18:22:29 UTC", "environment": { "id": 562075838, "name": "Library" }, "task": null, "version": "2.0", "publish": false, "version_id": 111397700, "triggered_by": null, "triggered_by_id": null }, "active_history": [], "rpm_count": 0, "modulemd_count": 0, "erratum_count": 0, "package_group_count": 0, "srpm_count": 0, "ansible_collection_count": 0, "deb_count": 0, "docker_manifest_count": 0, "docker_manifest_list_count": 0, "docker_tag_count": 0, "file_count": 0, "ostree_ref_count": 0, "python_package_count": 0, "module_stream_count": 0, "package_count": 0, "component_view_count": 0, "yum_repository_count": 2, "ansible_collection_repository_count": 0, "deb_repository_count": 0, "docker_repository_count": 1, "file_repository_count": 0, "ostree_repository_count": 0, "python_repository_count": 0, "errata_counts": { "security": 0, "bugfix": 0, "enhancement": 0, "total": 0 }, "permissions": { "deletable": true }, "filters_applied": null } ] }
Param name | Description |
---|---|
content_view_id
optional |
Content view identifier Validations:
|
environment_id
optional |
Filter versions by environment Validations:
|
version
optional |
Filter versions by version number Validations:
|
composite_version_id
optional |
Filter versions that are components in the specified composite version Validations:
|
organization_id
optional |
Organization identifier Validations:
|
include_applied_filters
optional |
Whether or not to return filters applied to the content view version Validations:
|
triggered_by_id
optional |
Filter composite versions whose publish was triggered by the specified component version Validations:
|
file_id
optional |
Filter content view versions that contain the file Validations:
|
nondefault
optional |
Filter out default content views Validations:
|
search
optional |
Search string Validations:
|
page
optional |
Page number, starting at 1 Validations:
|
per_page
optional |
Number of results per page to return Validations:
|
order
optional |
Sort field and order, eg. 'id DESC' Validations:
|
full_result
optional |
Whether or not to show all results Validations:
|
sort_by
optional |
Field to sort the results on Validations:
|
sort_order
optional |
How to order the sorted results (e.g. ASC for ascending) Validations:
|
Field name | Type | Possible values |
---|---|---|
content_view_id | integer | |
repository | string | |
version | string |
GET /katello/api/content_view_versions/234564707 200 { "version": "3.0", "major": 3, "minor": 0, "composite_content_view_ids": [], "published_in_composite_content_view_ids": [], "content_view_id": 419082953, "default": false, "description": null, "id": 234564707, "name": "Published Library - dev - staging view 3.0", "created_at": "2024-02-22 18:22:29 UTC", "updated_at": "2024-02-22 18:22:29 UTC", "content_view": { "id": 419082953, "name": "Published Library - dev - staging view", "label": "published_dev_staging_view", "generated_for": "none" }, "composite_content_views": [], "composite_content_view_versions": [], "published_in_composite_content_views": [], "environments": [ { "id": 562075838, "name": "Library", "label": "library_label", "publish_date": "6 minutes", "permissions": { "readable": true, "promotable_or_removable": true, "all_hosts_editable": true, "all_keys_editable": true }, "host_count": 0, "activation_key_count": 0 }, { "id": 292811013, "name": "Dev", "label": "dev_label", "publish_date": "6 minutes", "permissions": { "readable": true, "promotable_or_removable": true, "all_hosts_editable": true, "all_keys_editable": true }, "host_count": 0, "activation_key_count": 1 }, { "id": 1028819239, "name": "Staging", "label": "staging_label", "publish_date": "6 minutes", "permissions": { "readable": true, "promotable_or_removable": true, "all_hosts_editable": true, "all_keys_editable": true }, "host_count": 0, "activation_key_count": 0 } ], "repositories": [], "last_event": null, "active_history": [], "rpm_count": 0, "modulemd_count": 0, "erratum_count": 0, "package_group_count": 0, "srpm_count": 0, "ansible_collection_count": 0, "deb_count": 0, "docker_manifest_count": 0, "docker_manifest_list_count": 0, "docker_tag_count": 0, "file_count": 0, "ostree_ref_count": 0, "python_package_count": 0, "module_stream_count": 0, "package_count": 0, "component_view_count": 0, "yum_repository_count": 0, "ansible_collection_repository_count": 0, "deb_repository_count": 0, "docker_repository_count": 0, "file_repository_count": 0, "ostree_repository_count": 0, "python_repository_count": 0, "errata_counts": { "security": 0, "bugfix": 0, "enhancement": 0, "total": 0 }, "permissions": { "deletable": true }, "filters_applied": null }
Param name | Description |
---|---|
id
required |
Content view version identifier Validations:
|
include_applied_filters
optional |
Whether or not to return filters applied to the content view version Validations:
|
POST /katello/api/content_view_versions/234564707/promote { "environment_ids": [ 261162085 ], "force": 0, "content_view_version": {} } 202 [ ]
Param name | Description |
---|---|
id
required |
Content view version identifier Validations:
|
force
optional |
force content view promotion and bypass lifecycle environment restriction Validations:
|
environment_ids
optional |
Identifiers for Lifecycle Environment Validations:
|
description
optional |
The description for the content view version promotion Validations:
|
PUT /katello/api/content_view_versions/111397700 { "description": "New version description.", "content_view_version": {} } 204
Param name | Description |
---|---|
id
required |
Content view version identifier Validations:
|
description
required |
The description for the content view version Validations:
|
PUT /katello/api/content_view_versions/234564707/republish_repositories { "content_view_version": {} } 202 { "id": "0b29eb71-3c55-49dd-bc42-e9b19fb987bb", "label": "Actions::Katello::ContentViewVersion::RepublishRepositories", "pending": false, "action": "Republish Repositories of Published Library - dev - staging view 3.0 content view 'Published Library - dev - staging view'; organization 'Empty Organization'", "username": "secret_admin", "started_at": "2024-02-22 18:28:28 UTC", "ended_at": "2024-02-22 18:28:28 UTC", "state": "stopped", "result": "success", "progress": 1.0, "input": { "content_view": { "id": 419082953, "name": "Published Library - dev - staging view", "label": "published_dev_staging_view" }, "organization": { "id": 114267492, "name": "Empty Organization", "label": "Empty_Organization" }, "version_id": 234564707 }, "output": {}, "humanized": { "action": "Republish Repositories of Published Library - dev - staging view 3.0", "input": [ [ "content_view", { "text": "content view 'Published Library - dev - staging view'", "link": "/content_views/419082953/versions" } ], [ "organization", { "text": "organization 'Empty Organization'", "link": "/organizations/114267492/edit" } ] ], "output": "", "errors": [] }, "cli_example": null, "start_at": "2024-02-22 18:28:28 UTC", "available_actions": { "cancellable": false, "resumable": false } }
Param name | Description |
---|---|
id
required |
Content view version identifier Validations:
|
force
optional |
Force metadata regeneration to proceed. Dangerous operation when version has repositories with the 'Complete Mirroring' mirroring policy Validations:
|
POST /katello/api/content_view_versions/234564707 { "content_view_version": {} } 204
Param name | Description |
---|---|
id
required |
Content view version identifier Validations:
|
PUT /katello/api/content_view_versions/incremental_update { "content_view_version_environments": [ { "content_view_version_id": 234564707, "environment_ids": [] } ], "update_hosts": { "included": { "search": "" } }, "add_content": { "errata_ids": [ "100dividedby0" ] }, "resolve_dependencies": true, "content_view_version": {} } 202 [ ]
Param name | Description |
---|---|
content_view_version_environments
optional |
Validations:
|
content_view_version_environments[content_view_version_id]
optional |
Content View Version Ids to perform an incremental update on. May contain composites as well as one or more components to update. Validations:
|
content_view_version_environments[environment_ids]
optional |
The list of environments to promote the specified Content View Version to (replacing the older version) Validations:
|
description
optional |
The description for the new generated Content View Versions Validations:
|
resolve_dependencies
optional |
If true, when adding the specified errata or packages, any needed dependencies will be copied as well. Defaults to true Validations:
|
propagate_all_composites
optional |
If true, will publish a new composite version using any specified content_view_version_id that has been promoted to a lifecycle environment Validations:
|
add_content
optional |
Validations:
|
add_content[errata_ids]
optional |
Errata ids to copy into the new versions Validations:
|
add_content[package_ids]
optional |
Package ids to copy into the new versions Validations:
|
add_content[deb_ids]
optional |
Deb Package ids to copy into the new versions Validations:
|
update_hosts
optional |
After generating the incremental update, apply the changes to the specified hosts. Only Errata are supported currently. Validations:
|
update_hosts[included]
required |
Validations:
|
update_hosts[included][search]
optional , nil allowed |
Search string for host to perform an action on Validations:
|
update_hosts[included][ids]
optional , nil allowed |
List of host ids to perform an action on Validations:
|
update_hosts[excluded]
optional , nil allowed |
Validations:
|
update_hosts[excluded][ids]
optional , nil allowed |
List of host ids to exclude and not run an action on Validations:
|