GET /katello/api/capsules/:id/content/lifecycle_environments
List the lifecycle environments attached to the smart proxy

Examples

GET /katello/api/capsules/281110143/content/lifecycle_environments
200
{
  "total": 0,
  "subtotal": 0,
  "selectable": 0,
  "page": null,
  "per_page": null,
  "error": null,
  "search": null,
  "sort": {
    "by": null,
    "order": null
  },
  "results": []
}

Params

Param name Description
id
required

Id of the smart proxy

Validations:

  • Integer

organization_id
optional

Id of the organization to limit environments on

Validations:

  • Integer


GET /katello/api/capsules/:id/content/available_lifecycle_environments
List the lifecycle environments not attached to the smart proxy

Examples

GET /katello/api/capsules/281110143/content/available_lifecycle_environments
200
{
  "total": 14,
  "subtotal": 14,
  "selectable": 14,
  "page": null,
  "per_page": null,
  "error": null,
  "search": null,
  "sort": {
    "by": null,
    "order": null
  },
  "results": [
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 261162085,
      "name": "Beta",
      "label": "beta_label",
      "description": "Beta environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "Test_env",
        "id": 411008527
      },
      "successor": null,
      "counts": {
        "content_hosts": 0,
        "content_views": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    },
    {
      "library": true,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 396772849,
      "name": "Library",
      "label": "candlepin_library",
      "description": "This is the Library",
      "organization_id": 61304186,
      "organization": {
        "name": "Organization 2",
        "label": "Organization_2",
        "id": 61304186
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": null,
      "successor": null,
      "counts": {
        "content_hosts": 0,
        "content_views": 0,
        "packages": 0,
        "module_streams": 0,
        "errata": {
          "security": 0,
          "bugfix": 0,
          "enhancement": 0,
          "total": 0
        },
        "yum_repositories": 0,
        "docker_repositories": 0,
        "ostree_repositories": 0,
        "products": 0,
        "debs": 0,
        "deb_repositories": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": false,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    },
    {
      "library": true,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 562075838,
      "name": "Library",
      "label": "library_label",
      "description": "This is the Library",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": null,
      "successor": null,
      "counts": {
        "content_hosts": 2,
        "content_views": 4,
        "packages": 5,
        "module_streams": 2,
        "errata": {
          "security": 1,
          "bugfix": 0,
          "enhancement": 1,
          "total": 2
        },
        "yum_repositories": 11,
        "docker_repositories": 4,
        "ostree_repositories": 1,
        "products": 8,
        "debs": 4,
        "deb_repositories": 5
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": false,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": [
        {
          "name": "Published LIbrary view",
          "id": 405955044
        },
        {
          "name": "Published Library and dev view",
          "id": 909058347
        },
        {
          "name": "Published Library - dev - staging view",
          "id": 419082953
        },
        {
          "name": "Composite view",
          "id": 64601712
        }
      ]
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 28194273,
      "name": "Dev Path2",
      "label": "dev_path2_label",
      "description": "Dev environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "Library",
        "id": 562075838
      },
      "successor": {
        "name": "QA Path2",
        "id": 427995936
      },
      "counts": {
        "content_hosts": 0,
        "content_views": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    },
    {
      "library": true,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 779215191,
      "name": "Library",
      "label": "organization1_library",
      "description": "This is the Library",
      "organization_id": 447626438,
      "organization": {
        "name": "Organization 1",
        "label": "Organization_1",
        "id": 447626438
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": null,
      "successor": null,
      "counts": {
        "content_hosts": 0,
        "content_views": 0,
        "packages": 0,
        "module_streams": 0,
        "errata": {
          "security": 0,
          "bugfix": 0,
          "enhancement": 0,
          "total": 0
        },
        "yum_repositories": 0,
        "docker_repositories": 0,
        "ostree_repositories": 0,
        "products": 0,
        "debs": 0,
        "deb_repositories": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": false,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 413623389,
      "name": "Dev Path1",
      "label": "dev_path1_label",
      "description": "Dev environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "Library",
        "id": 562075838
      },
      "successor": {
        "name": "QA Path1",
        "id": 9167524
      },
      "counts": {
        "content_hosts": 0,
        "content_views": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 507881024,
      "name": "Staging Path1",
      "label": "staging_path1_label",
      "description": "Staging environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "QA Path1",
        "id": 9167524
      },
      "successor": null,
      "counts": {
        "content_hosts": 0,
        "content_views": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 292811013,
      "name": "Dev",
      "label": "dev_label",
      "description": "Dev environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "Library",
        "id": 562075838
      },
      "successor": {
        "name": "Test_env",
        "id": 411008527
      },
      "counts": {
        "content_hosts": 1,
        "content_views": 2
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": false,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": [
        {
          "name": "Published Library and dev view",
          "id": 909058347
        },
        {
          "name": "Published Library - dev - staging view",
          "id": 419082953
        }
      ]
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 427995936,
      "name": "QA Path2",
      "label": "qa_path2_label",
      "description": "QA environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "Dev Path2",
        "id": 28194273
      },
      "successor": {
        "name": "Staging Path2",
        "id": 122484616
      },
      "counts": {
        "content_hosts": 0,
        "content_views": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 1028819239,
      "name": "Staging",
      "label": "staging_label",
      "description": "Staging environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "Library",
        "id": 562075838
      },
      "successor": null,
      "counts": {
        "content_hosts": 0,
        "content_views": 1
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": [
        {
          "name": "Published Library - dev - staging view",
          "id": 419082953
        }
      ]
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 411008527,
      "name": "Test_env",
      "label": "test_label",
      "description": "Test environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "Dev",
        "id": 292811013
      },
      "successor": {
        "name": "Beta",
        "id": 261162085
      },
      "counts": {
        "content_hosts": 0,
        "content_views": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 9167524,
      "name": "QA Path1",
      "label": "qa_path1_label",
      "description": "QA environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "Dev Path1",
        "id": 413623389
      },
      "successor": {
        "name": "Staging Path1",
        "id": 507881024
      },
      "counts": {
        "content_hosts": 0,
        "content_views": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 797271385,
      "name": "Candlepin Dev",
      "label": "candlepin_dev_label",
      "description": "Dev environment.",
      "organization_id": 61304186,
      "organization": {
        "name": "Organization 2",
        "label": "Organization_2",
        "id": 61304186
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "Library",
        "id": 396772849
      },
      "successor": null,
      "counts": {
        "content_hosts": 0,
        "content_views": 1
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": [
        {
          "name": "Candlepin Library and Dev Content View",
          "id": 566851579
        }
      ]
    },
    {
      "library": false,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 122484616,
      "name": "Staging Path2",
      "label": "staging_path2_label",
      "description": "Staging environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": {
        "name": "QA Path2",
        "id": 427995936
      },
      "successor": null,
      "counts": {
        "content_hosts": 0,
        "content_views": 0
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": true,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": []
    }
  ]
}

Params

Param name Description
id
required

Id of the smart proxy

Validations:

  • Integer

organization_id
optional

Id of the organization to limit environments on

Validations:

  • Integer


POST /katello/api/capsules/:id/content/lifecycle_environments
Add lifecycle environments to the smart proxy

Examples

POST /katello/api/capsules/281110143/content/lifecycle_environments
{
  "environment_id": 562075838,
  "capsule_content": {
    "environment_id": 562075838
  }
}
200
{
  "total": 1,
  "subtotal": 1,
  "selectable": 1,
  "page": null,
  "per_page": null,
  "error": null,
  "search": null,
  "sort": {
    "by": null,
    "order": null
  },
  "results": [
    {
      "library": true,
      "registry_name_pattern": null,
      "registry_unauthenticated_pull": false,
      "id": 562075838,
      "name": "Library",
      "label": "library_label",
      "description": "This is the Library",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2022-11-08 19:09:32 UTC",
      "updated_at": "2022-11-08 19:09:32 UTC",
      "prior": null,
      "successor": null,
      "counts": {
        "content_hosts": 2,
        "content_views": 4,
        "packages": 5,
        "module_streams": 2,
        "errata": {
          "security": 1,
          "bugfix": 0,
          "enhancement": 1,
          "total": 2
        },
        "yum_repositories": 11,
        "docker_repositories": 4,
        "ostree_repositories": 1,
        "products": 8,
        "debs": 4,
        "deb_repositories": 5
      },
      "permissions": {
        "create_lifecycle_environments": true,
        "view_lifecycle_environments": true,
        "edit_lifecycle_environments": true,
        "destroy_lifecycle_environments": false,
        "promote_or_remove_content_views_to_environments": true
      },
      "content_views": [
        {
          "name": "Published LIbrary view",
          "id": 405955044
        },
        {
          "name": "Published Library and dev view",
          "id": 909058347
        },
        {
          "name": "Published Library - dev - staging view",
          "id": 419082953
        },
        {
          "name": "Composite view",
          "id": 64601712
        }
      ]
    }
  ]
}

Params

Param name Description
id
required

Id of the smart proxy

Validations:

  • Integer

environment_id
required

Id of the lifecycle environment

Validations:

  • Integer


DELETE /katello/api/capsules/:id/content/lifecycle_environments/:environment_id
Remove lifecycle environments from the smart proxy

Examples

DELETE /katello/api/capsules/281110143/content/lifecycle_environments/562075838
{
  "capsule_content": {}
}
204

Params

Param name Description
id
required

Id of the smart proxy

Validations:

  • Integer

environment_id
required

Id of the lifecycle environment

Validations:

  • Integer


POST /katello/api/capsules/:id/content/sync
Synchronize the content to the smart proxy

Examples

POST /katello/api/capsules/281110143/content/sync
{
  "content_view_id": 909058347,
  "capsule_content": {
    "content_view_id": 909058347
  }
}
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
  }
}

Params

Param name Description
id
required

Id of the smart proxy

Validations:

  • Integer

environment_id
optional

Id of the environment to limit the synchronization on

Validations:

  • Integer

content_view_id
optional

Id of the content view to limit the synchronization on

Validations:

  • Integer

repository_id
optional

Id of the repository to limit the synchronization on

Validations:

  • Integer

skip_metadata_check
optional

Skip metadata check on each repository on the smart proxy

Validations:

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


GET /katello/api/capsules/:id/content/sync
Get current smart proxy synchronization status

Examples

GET /katello/api/capsules/281110143/content/sync
200
{
  "last_sync_time": null,
  "download_policy": null,
  "active_sync_tasks": [],
  "last_failed_sync_tasks": [],
  "lifecycle_environments": [],
  "unsyncable_content_types": []
}

Params

Param name Description
id
required

Id of the smart proxy

Validations:

  • Integer

organization_id
optional

Id of the organization to get the status for

Validations:

  • Integer


DELETE /katello/api/capsules/:id/content/sync
Cancel running smart proxy synchronization

Examples

GET /katello/api/capsules/281110143/content/sync
200
{
  "message": "There's no running synchronization for this smart proxy."
}

Params

Param name Description
id
required

Id of the smart proxy

Validations:

  • Integer


POST /katello/api/capsules/:id/reclaim_space
Reclaim space from all On Demand repositories on a smart proxy

Examples

POST /katello/api/capsules/281110143/content/reclaim_space
{
  "capsule_content": {}
}
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
  }
}

Params

Param name Description
id
required

Id of the smart proxy

Validations:

  • Must be a number.