# Description

An environment is a basic organization structure that groups systems, products, repositories, etc. Every system belongs to one environment and it's isolated inside so that it can see only content that is in its environment.

## Chains

Environments are ordered into chains and their content (propducts, repositories, tempaltes, packages) can be moved to an environment only from its prior environment. You can have for example chain like:

Library -> Development -> Testing -> Production

Each change in an environment is done through a changeset in an action called promotion.

## Library

Library is a special environment that has no ascendant: All the content starts in this environment. More chains can start from the library environment but no further branching of a chain is enabled.


GET /katello/api/environments
組織内のパスを一覧表示

GET /katello/api/organizations/:organization_id/environments
組織内のパスを一覧表示

Params

Param Name Description
organization_id
Required

組織 ID

Validations:

  • number.

library
Optional

ライブラリー環境のみを表示する場合 true に設定

Validations:

  • Must be one of: true, false.

name
Optional

この名前を含む環境のみをフィルター

Validations:

  • String


GET /katello/api/environments/:id
環境の表示

GET /katello/api/organizations/:organization_id/environments/:environment_id
環境の表示

Params

Param Name Description
id
Required

環境の ID

Validations:

  • number.

organization_id
Optional

組織の ID

Validations:

  • number.


POST /katello/api/environments
環境の作成

POST /katello/api/organizations/:organization_id/environments
組織の環境を作成

Params

Param Name Description
organization_id
Required

組織の名前

Validations:

  • number.

name
Required

環境の名前

Validations:

  • String

label
Optional

環境のラベル

Validations:

  • String

description
Optional

環境の説明

Validations:

  • String

prior_id
Required

ID of an environment that is prior to the new environment in the chain. It has to be either the ID of Library or the ID of an environment at the end of a chain.

Validations:

  • Integer


PUT /katello/api/environments/:id
環境の更新

PUT /katello/api/organizations/:organization_id/environments/:id
組織内の環境を更新

Params

Param Name Description
id
Required

環境の ID

Validations:

  • number.

organization_id
Optional

組織の名前

Validations:

  • number.

new_name
Optional

環境に付与される新規の名前

Validations:

  • String

description
Optional

環境の説明

Validations:

  • String


DELETE /katello/api/environments/:id
環境の破棄

DELETE /katello/api/organizations/:organization_id/environments/:id
組織の環境を破棄

Params

Param Name Description
id
Required

環境の ID

Validations:

  • number.

organization_id
Optional

組織 ID

Validations:

  • number.


GET /katello/api/organizations/:organization_id/environments/paths
環境パスを一覧表示

Params

Param Name Description
organization_id
Optional

組織 ID

Validations:

  • number.

permission_type
Optional

The associated permission type. One of (readable | promotable) Default: readable

Validations:

  • String


GET /katello/api/organizations/:organization_id/environments/:id/repositories
List repositories available in the environment

Params

Param Name Description
id
Optional

環境 ID

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

organization_id
Optional

組織 ID

Validations:

  • String

content_view_id
Optional

コンテンツビュー ID

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..