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": "2023-08-23 19:55:45 UTC",
"updated_at": "2023-08-23 19:55:45 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": "20 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": "2023-08-23 19:55:45 UTC",
"updated_at": "2023-08-23 19:55:45 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": [],
"ansible_collection_count": 0,
"ostree_ref_count": 0,
"deb_count": 0,
"docker_manifest_count": 0,
"docker_manifest_list_count": 0,
"docker_tag_count": 0,
"file_count": 0,
"python_package_count": 0,
"rpm_count": 0,
"modulemd_count": 0,
"erratum_count": 0,
"package_group_count": 0,
"srpm_count": 0,
"module_stream_count": 0,
"package_count": 0,
"component_view_count": 0,
"ansible_collection_repository_count": 0,
"ostree_repository_count": 0,
"deb_repository_count": 0,
"docker_repository_count": 1,
"file_repository_count": 0,
"python_repository_count": 0,
"yum_repository_count": 2,
"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": "2023-08-23 19:55:45 UTC",
"updated_at": "2023-08-23 19:55:45 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": "20 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": "20 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": "20 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": [],
"ansible_collection_count": 0,
"ostree_ref_count": 0,
"deb_count": 0,
"docker_manifest_count": 0,
"docker_manifest_list_count": 0,
"docker_tag_count": 0,
"file_count": 0,
"python_package_count": 0,
"rpm_count": 0,
"modulemd_count": 0,
"erratum_count": 0,
"package_group_count": 0,
"srpm_count": 0,
"module_stream_count": 0,
"package_count": 0,
"component_view_count": 0,
"ansible_collection_repository_count": 0,
"ostree_repository_count": 0,
"deb_repository_count": 0,
"docker_repository_count": 0,
"file_repository_count": 0,
"python_repository_count": 0,
"yum_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,
292811013
],
"content_view_version": {}
}
202
{
"id": null,
"label": null,
"pending": null,
"username": null,
"started_at": null,
"ended_at": null,
"state": null,
"result": null,
"progress": null,
"input": null,
"output": {},
"humanized": null,
"cli_example": null,
"available_actions": {
"cancellable": null,
"resumable": null
}
}
| 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": {}
}
200
{
"version": "2.0",
"major": 2,
"minor": 0,
"composite_content_view_ids": [],
"published_in_composite_content_view_ids": [],
"content_view_id": 405955044,
"default": false,
"description": "New version description.",
"id": 111397700,
"name": "Published LIbrary view 2.0",
"created_at": "2023-08-23 19:55:45 UTC",
"updated_at": "2023-08-23 19:55:45 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": "20 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": "New version description.",
"action": "publish",
"created_at": "2023-08-23 19:55:45 UTC",
"updated_at": "2023-08-23 20:15:50 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": [],
"ansible_collection_count": 0,
"ostree_ref_count": 0,
"deb_count": 0,
"docker_manifest_count": 0,
"docker_manifest_list_count": 0,
"docker_tag_count": 0,
"file_count": 0,
"python_package_count": 0,
"rpm_count": 0,
"modulemd_count": 0,
"erratum_count": 0,
"package_group_count": 0,
"srpm_count": 0,
"module_stream_count": 0,
"package_count": 0,
"component_view_count": 0,
"ansible_collection_repository_count": 0,
"ostree_repository_count": 0,
"deb_repository_count": 0,
"docker_repository_count": 1,
"file_repository_count": 0,
"python_repository_count": 0,
"yum_repository_count": 2,
"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:
|
|
description
required |
The description for the content view version Validations:
|
PUT /katello/api/content_view_versions/234564707/republish_repositories
{
"content_view_version": {}
}
202
{
"id": "7b4bdaaf-ffc9-4e0f-a573-369223541b2b",
"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": "2023-08-23 20:15:53 UTC",
"ended_at": "2023-08-23 20:15:53 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": "2023-08-23 20:15:53 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": [
261162085
]
}
],
"add_content": {
"errata_ids": [
"100dividedby0"
],
"resolve_dependencies": true
},
"content_view_version": {}
}
204
| 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:
|