# 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
Répertorier les environnements dans une organisation

GET /katello/api/organizations/:organization_id/environments
Répertorier les environnements dans une organisation

Params

Param Name Description
organization_id
Required

identifiant de l'organisation

Validations:

  • number.

library
Optional

définir comme vrai si vous souhaitez voir les environnements de bibliothèque uniquement

Validations:

  • Must be one of: true, false.

name
Optional

filtrer uniquement les environnements contenant ce nom

Validations:

  • String


GET /katello/api/environments/:id
Afficher un environnement

GET /katello/api/organizations/:organization_id/environments/:environment_id
Afficher un environnement

Params

Param Name Description
id
Required

ID de l'environnement

Validations:

  • number.

organization_id
Optional

ID de l'organisation

Validations:

  • number.


POST /katello/api/environments
Créer un environnement

POST /katello/api/organizations/:organization_id/environments
Créer un environnement dans une organisation

Params

Param Name Description
organization_id
Required

nom de l'organisation

Validations:

  • number.

name
Required

nom de l'environnement

Validations:

  • String

label
Optional

étiquette de l'environnement

Validations:

  • String

description
Optional

description de l'environnement

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
Mise à jour d'un environnement

PUT /katello/api/organizations/:organization_id/environments/:id
Mettre à jour un environnement dans une organisation

Params

Param Name Description
id
Required

ID de l'environnement

Validations:

  • number.

organization_id
Optional

nom de l'organisation

Validations:

  • number.

new_name
Optional

nouveau nom à donner à l'environnement

Validations:

  • String

description
Optional

description de l'environnement

Validations:

  • String


DELETE /katello/api/environments/:id
Détruire un environnement

DELETE /katello/api/organizations/:organization_id/environments/:id
Détruire un environnement dans une organisation

Params

Param Name Description
id
Required

ID de l'environnement

Validations:

  • number.

organization_id
Optional

identifiant de l'organisation

Validations:

  • number.


GET /katello/api/organizations/:organization_id/environments/paths
Répertorier les chemins d'environnement

Params

Param Name Description
organization_id
Optional

identifiant de l'organisation

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

identifiant d'environnement

Validations:

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

organization_id
Optional

identifiant de l'organisation

Validations:

  • String

content_view_id
Optional

identifiant d'affichage du contenu

Validations:

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