GET /katello/api/repositories
Elenco di repositori abilitati

GET /katello/api/content_views/:id/repositories
Elenco di repositori per una visualizzazione del contenuto

GET /katello/api/organizations/:organization_id/repositories
List of repositories in an organization

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

GET /katello/api/products/:product_id/repositories
List of repositories for a product

GET /katello/api/environments/:environment_id/products/:product_id/repositories
List of repositories belonging to a product in an environment

Parametri

Nome parametro Descrizione
organization_id
opzionale

ID di una organizzazione nella quale visualizzare i repositori

Validations:

  • number.

product_id
opzionale

ID di un prodotto del quale visualizzare i repositori

Validations:

  • number.

environment_id
opzionale

ID di un ambiente nel quale visualizzare i repositori

Validations:

  • number.

content_view_id
opzionale

ID di una visualizzazione del contenuto nel quale mostrare i repositori

Validations:

  • number.

content_view_version_id
opzionale

ID di una versione della visualizzazione del contenuto nei quali visualizzare i repository

Validations:

  • number.

deb_id
opzionale

Id of a deb package to find repositories that contain the deb

Validations:

  • String

erratum_id
opzionale

Id of an erratum to find repositories that contain the erratum

Validations:

  • String

rpm_id
opzionale

Id of a rpm package to find repositories that contain the rpm

Validations:

  • String

ostree_branch_id
opzionale

Id of an ostree branch to find repositories that contain that branch

Validations:

  • String

library
opzionale

mostra i repositori in Libreria e la visualizzazione del contenuto predefinita

Validations:

  • boolean

content_type
opzionale

limit to only repositories of this type

Validations:

  • Must be one of: docker, ostree, yum, puppet, file, deb.

name
opzionale

nome del repositorio

Validations:

  • String

available_for
opzionale

interpret specified object to return only Repositories that can be associated with specified object. Only 'content_view' is supported.

Validations:

  • String

search
opzionale

Cerca stringa

Validations:

  • String

page
opzionale

Numero pagina, iniziando da 1

Validations:

  • number.

per_page
opzionale

Numero di risultati per pagina da ritornare

Validations:

  • number.

order
opzionale

Campo e ordine per la ricerca, es. 'nome DISC'

Validations:

  • String

full_result
opzionale

Indica se mostrare tutti i risultati

Validations:

  • boolean

sort
opzionale

Versione hash del parametro 'order'

Validations:

  • Hash

sort[by]
opzionale

Campo nel quale ordinare i risultati

Validations:

  • String

sort[order]
opzionale

Come ordinare i risultati (es. ASC per ascendente)

Validations:

  • String


POST /katello/api/repositories
Crea un repositorio personalizzato

Parametri

Nome parametro Descrizione
name
richiesto

Validations:

  • String

label
opzionale

Validations:

  • String

product_id
richiesto

Prodotto al quale appartiene il repositorio

Validations:

  • number.

content_type
richiesto

type of repo (either 'yum', 'deb', 'puppet', 'docker', or 'ostree')

Validations:

  • Must be one of: docker, ostree, yum, puppet, file, deb.

url
opzionale

URL sorgente del repositorio

Validations:

  • String

gpg_key_id
opzionale

id della chiave gpg da assegnare al nuovo repositorio

Validations:

  • number.

unprotected
opzionale

vero se questo repositorio può essere pubblicato tramite HTTP

Validations:

  • boolean

checksum_type
opzionale

checksum of the repository, currently 'sha1' & 'sha256' are supported.

Validations:

  • String

docker_upstream_name
opzionale

nome del repositorio docker dell'upstream

Validations:

  • String

download_policy
opzionale

download policy for yum repos (either 'immediate', 'on_demand', or 'background')

Validations:

  • Must be one of: immediate, on_demand, background.

mirror_on_sync
opzionale

true if this repository when synced has to be mirrored from the source and stale rpms removed.

Validations:

  • boolean

verify_ssl_on_sync
opzionale

if true, Katello will verify the upstream url's SSL certifcates are signed by a trusted CA.

Validations:

  • boolean

upstream_username
opzionale

Username of the upstream repository user used for authentication

Validations:

  • String

upstream_password
opzionale

Password of the upstream repository user used for authentication

Validations:

  • String

ostree_upstream_sync_policy
opzionale

policies for syncing upstream ostree repositories.

Validations:

  • Must be one of: latest, all, custom.

ostree_upstream_sync_depth
opzionale

if a custom sync policy is chosen for ostree repositories then a 'depth' value must be provided.

Validations:

  • number.

deb_releases
opzionale

comma separated list of releases to be synched from deb-archive

Validations:

  • String

deb_components
opzionale

comma separated list of repo components to be synched from deb-archive

Validations:

  • String

deb_architectures
opzionale

comma separated list of architectures to be synched from deb-archive

Validations:

  • String

ignore_global_proxy
opzionale

if true, will ignore the globally configured proxy when syncing.

Validations:

  • boolean


GET /katello/api/repositories/repository_types
Show the available repository types

Parametri

Nome parametro Descrizione
creatable
opzionale

When set to 'True' repository types that are creatable will be returned

Validations:

  • boolean


PUT /katello/api/repositories/:id/republish
Forces a republish of the specified repository, regenerating metadata and symlinks on the filesystem.

Parametri

Nome parametro Descrizione
id
richiesto

Repository identifier

Validations:

  • number.


GET /katello/api/repositories/:id
Show a repository

Parametri

Nome parametro Descrizione
id
richiesto

ID del repositorio

Validations:

  • number.


POST /katello/api/repositories/:id/sync
Sincronizza un repositorio

Parametri

Nome parametro Descrizione
id
richiesto

ID del repositorio

Validations:

  • number.

source_url
opzionale

temporarily override feed URL for sync

Validations:

  • String

incremental
opzionale

perform an incremental import

Validations:

  • boolean

skip_metadata_check
opzionale

Force sync even if no upstream changes are detected. Only used with yum repositories.

Validations:

  • boolean

validate_contents
opzionale

Force a sync and validate the checksums of all content. Only used with yum repositories.

Validations:

  • boolean


POST /katello/api/repositories/:id/export
Export a repository

Parametri

Nome parametro Descrizione
id
richiesto

Repository identifier

Validations:

  • number.

export_to_iso
opzionale

Export to ISO format

Validations:

  • boolean

iso_mb_size
opzionale

maximum size of each ISO in MB

Validations:

  • number.

since
opzionale

Optional date of last export (ex: 2010-01-01T12:00:00Z)

Validations:

  • Date


PUT /katello/api/repositories/:id
Aggiorna un repositorio

Parametri

Nome parametro Descrizione
id
richiesto

ID del repositorio

Validations:

  • number.

name
opzionale

Validations:

  • String

url
opzionale

URL sorgente del repositorio

Validations:

  • String

gpg_key_id
opzionale

id della chiave gpg da assegnare al nuovo repositorio

Validations:

  • number.

unprotected
opzionale

vero se questo repositorio può essere pubblicato tramite HTTP

Validations:

  • boolean

checksum_type
opzionale

checksum of the repository, currently 'sha1' & 'sha256' are supported.

Validations:

  • String

docker_upstream_name
opzionale

nome del repositorio docker dell'upstream

Validations:

  • String

download_policy
opzionale

download policy for yum repos (either 'immediate', 'on_demand', or 'background')

Validations:

  • Must be one of: immediate, on_demand, background.

mirror_on_sync
opzionale

true if this repository when synced has to be mirrored from the source and stale rpms removed.

Validations:

  • boolean

verify_ssl_on_sync
opzionale

if true, Katello will verify the upstream url's SSL certifcates are signed by a trusted CA.

Validations:

  • boolean

upstream_username
opzionale

Username of the upstream repository user used for authentication

Validations:

  • String

upstream_password
opzionale

Password of the upstream repository user used for authentication

Validations:

  • String

ostree_upstream_sync_policy
opzionale

policies for syncing upstream ostree repositories.

Validations:

  • Must be one of: latest, all, custom.

ostree_upstream_sync_depth
opzionale

if a custom sync policy is chosen for ostree repositories then a 'depth' value must be provided.

Validations:

  • number.

deb_releases
opzionale

comma separated list of releases to be synched from deb-archive

Validations:

  • String

deb_components
opzionale

comma separated list of repo components to be synched from deb-archive

Validations:

  • String

deb_architectures
opzionale

comma separated list of architectures to be synched from deb-archive

Validations:

  • String

ignore_global_proxy
opzionale

if true, will ignore the globally configured proxy when syncing.

Validations:

  • boolean


DELETE /katello/api/repositories/:id
Elimina un repositorio personalizzato

Parametri

Nome parametro Descrizione
id
richiesto

Validations:

  • number.


POST /katello/api/repositories/sync_complete

URL for post sync notification from pulp

Parametri

Nome parametro Descrizione
token
richiesto

token segreto condiviso

Validations:

  • String

payload
richiesto

Validations:

  • Hash

payload[repo_id]
richiesto

Validations:

  • String

call_report
richiesto

Validations:

  • Hash

call_report[task_id]
richiesto

Validations:

  • String


PUT /katello/api/repositories/:id/remove_packages

PUT /katello/api/repositories/:id/remove_docker_manifests

PUT /katello/api/repositories/:id/remove_puppet_modules

PUT /katello/api/repositories/:id/remove_content

Remove content from a repository

Parametri

Nome parametro Descrizione
id
richiesto

ID del repositorio

Validations:

  • number.

ids
richiesto

Array of content ids to remove

Validations:

  • Must be an array of any type

sync_capsule
opzionale

Whether or not to sync an external capsule after upload. Default: true

Validations:

  • boolean


POST /katello/api/repositories/:id/upload_content
Carica il contenuto nel repositorio

Parametri

Nome parametro Descrizione
id
richiesto

ID del repositorio

Validations:

  • number.

content
richiesto

File di contenuto da caricare. Può essere un file singolo o un insieme di file.

Validations:

  • File


PUT /katello/api/repositories/:id/import_uploads
Importa caricamento in un repositorio

Parametri

Nome parametro Descrizione
id
richiesto

id repositorio

Validations:

  • number.

upload_ids
opzionale

Insieme di id per il caricamento da importare

Validations:

  • Must be an array of any type

async
opzionale

Do not wait for the ImportUpload action to finish. Default: false

Validations:

  • boolean

publish_repository
opzionale

Whether or not to regenerate the repository on disk. Default: true

Validations:

  • boolean

sync_capsule
opzionale

Whether or not to sync an external capsule after upload. Default: true

Validations:

  • boolean

uploads
opzionale

Array of uploads to import

Validations:

  • Must be an Array of nested elements

uploads[id]
richiesto

Validations:

  • String

uploads[size]
opzionale

Validations:

  • String

uploads[checksum]
opzionale

Validations:

  • String

uploads[name]
opzionale

Needs to only be set for file repositories

Validations:

  • String


GET /katello/api/repositories/:id/gpg_key_content
Ritorna il contenuto di una chiave gpg del repositorio usata direttamente da yum

Parametri

Nome parametro Descrizione
id
richiesto

Validations:

  • number.