GET /katello/api/content_views/419082953/content_view_versions
200
{
"total": 1,
"subtotal": 1,
"selectable": 1,
"page": 1,
"per_page": 20,
"error": null,
"search": null,
"sort": {
"by": "version",
"order": "ASC"
},
"results": [
{
"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": "2022-11-08 19:09:32 UTC",
"updated_at": "2022-11-08 19:09:32 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": "3 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": "3 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": "3 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,
"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,
"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,
"deb_repository_count": 0,
"docker_repository_count": 0,
"file_repository_count": 0,
"ostree_repository_count": 0,
"python_repository_count": 0,
"yum_repository_count": 0,
"errata_counts": {
"security": 0,
"bugfix": 0,
"enhancement": 0,
"total": 0
},
"permissions": {
"deletable": true
}
}
]
}
| 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:
|
|
triggered_by_id optional |
Filter composite versions whose publish was triggered by the specified component version 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": "2022-11-08 19:09:32 UTC",
"updated_at": "2022-11-08 19:09:32 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": "3 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": "3 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": "3 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,
"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,
"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,
"deb_repository_count": 0,
"docker_repository_count": 0,
"file_repository_count": 0,
"ostree_repository_count": 0,
"python_repository_count": 0,
"yum_repository_count": 0,
"errata_counts": {
"security": 0,
"bugfix": 0,
"enhancement": 0,
"total": 0
},
"permissions": {
"deletable": true
}
}
| Param name | Description |
|---|---|
|
id required |
Content view version identifier 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": {}
}
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
{
"force": true,
"content_view_version": {}
}
202
[
]
| Param name | Description |
|---|---|
|
id required |
Content view version identifier Validations:
|
|
force required |
Force metadata regeneration to proceed. Dangerous when repositories use 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"
],
"deb_ids": [
74643400
]
},
"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:
|