Examples

GET /katello/api/environments
200
{
  "total": 14,
  "subtotal": 14,
  "selectable": 14,
  "page": 1,
  "per_page": 20,
  "error": null,
  "search": null,
  "sort": {
    "by": "id",
    "order": "asc"
  },
  "results": [
    {
      "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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": []
    },
    {
      "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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 411008527,
      "name": "Test_env",
      "label": "test_label",
      "description": "Test environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 UTC",
      "prior": null,
      "successor": null,
      "counts": {
        "content_hosts": 2,
        "content_views": 4,
        "packages": 5,
        "module_streams": 2,
        "errata": {
          "security": 1,
          "bugfix": 1,
          "enhancement": 1,
          "total": 3
        },
        "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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 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": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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": 1028819239,
      "name": "Staging",
      "label": "staging_label",
      "description": "Staging environment.",
      "organization_id": 114267492,
      "organization": {
        "name": "Empty Organization",
        "label": "Empty_Organization",
        "id": 114267492
      },
      "created_at": "2024-05-23 19:46:01 UTC",
      "updated_at": "2024-05-23 19:46:01 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
        }
      ]
    }
  ]
}

Params

Param name Description
organization_id
optional

organization identifier

Validations:

  • Must be a number.

library
optional

set true if you want to see only library environments

Validations:

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

name
optional

filter only environments containing this name

Validations:

  • String

label
optional

filter only environments containing this label

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
id integer
label string
name string
organization_id integer