Examples

PUT /katello/api/repositories/84409059
{
  "docker_upstream_name": "helloworld",
  "repository": {
    "docker_upstream_name": "helloworld"
  }
}
200
{
  "relative_path": "ACME_Corporation/library/busybox",
  "promoted": true,
  "content_view_version_id": 840492357,
  "library_instance_id": null,
  "last_contents_changed": "1970-01-01 00:00:00 UTC",
  "organization_id": 114267492,
  "organization": {
    "name": "Empty Organization",
    "label": "Empty_Organization",
    "id": 114267492
  },
  "created_at": "2023-08-23 19:55:45 UTC",
  "updated_at": "2023-08-23 19:55:45 UTC",
  "backend_identifier": "Default_Organization-Test-busybox-library",
  "container_repository_name": "empty_organization-puppet_product-busybox",
  "full_path": "centos8-katello-devel.cannolo.example.com/empty_organization-puppet_product-busybox",
  "version_href": null,
  "remote_href": null,
  "publication_href": null,
  "content_counts": {
    "docker_manifest": 0,
    "docker_manifest_list": 0,
    "docker_tag": 0
  },
  "mirroring_policy": "mirror_content_only",
  "id": 84409059,
  "name": "busybox",
  "label": "busybox",
  "description": null,
  "content_view_versions": [
    {
      "id": 111397700,
      "version": "2.0",
      "content_view_id": 405955044,
      "content_view_name": "Published LIbrary view"
    },
    {
      "id": 172022917,
      "version": "1.0",
      "content_view_id": 909058347,
      "content_view_name": "Published Library and dev view"
    },
    {
      "id": 531274492,
      "version": "1.0",
      "content_view_id": 405955044,
      "content_view_name": "Published LIbrary view"
    }
  ],
  "filters": [],
  "last_sync": null,
  "content_view": {
    "id": 30237652,
    "name": "ACME Default ContentView"
  },
  "content_view_version": {
    "id": 840492357,
    "name": "ACME Default ContentView 1.0",
    "content_view_id": 30237652
  },
  "kt_environment": {
    "id": 562075838,
    "name": "Library"
  },
  "content_type": "docker",
  "url": "https://quay.io",
  "arch": "noarch",
  "os_versions": null,
  "content_id": "1",
  "generic_remote_options": null,
  "major": null,
  "minor": null,
  "product": {
    "id": 516337990,
    "cp_id": "123123123002",
    "name": "Puppet Product",
    "orphaned": true,
    "redhat": false,
    "sync_plan": null
  },
  "content_label": "fedora",
  "last_sync_words": null,
  "environment": {
    "id": 562075838,
    "registry_unauthenticated_pull": false
  },
  "docker_upstream_name": "libpod/busybox",
  "docker_tags_whitelist": null,
  "include_tags": null,
  "exclude_tags": null,
  "verify_ssl_on_sync": true,
  "unprotected": true,
  "checksum_type": null,
  "download_policy": "immediate",
  "ansible_collection_requirements": null,
  "ansible_collection_auth_url": null,
  "ansible_collection_auth_token": null,
  "gpg_key_id": 591165711,
  "ssl_ca_cert_id": null,
  "ssl_client_cert_id": null,
  "ssl_client_key_id": null,
  "upstream_username": null,
  "deb_releases": null,
  "deb_components": null,
  "deb_architectures": null,
  "http_proxy_policy": "global_default_http_proxy",
  "http_proxy_id": null,
  "http_proxy_name": null,
  "retain_package_versions_count": null,
  "metadata_expire": null,
  "ignorable_content": null,
  "http_proxy": {
    "id": null,
    "name": null,
    "policy": "global_default_http_proxy"
  },
  "ssl_ca_cert": {
    "id": null,
    "name": null
  },
  "ssl_client_cert": {
    "id": null,
    "name": null
  },
  "ssl_client_key": {
    "id": null,
    "name": null
  },
  "gpg_key": {
    "id": 591165711,
    "name": "Fedora GPG Key"
  },
  "permissions": {
    "deletable": true,
    "deletable_across_cv": true
  },
  "upstream_password_exists": false,
  "upstream_auth_exists": false
}

Params

Param name Description
id
required

repository ID

Validations:

  • Must be a number.

name
optional

Validations:

  • String

description
optional

description of the repository

Validations:

  • String

url
optional

repository source url

Validations:

  • String

os_versions
optional

Identifies whether the repository should be unavailable on a client with a non-matching OS version. Pass [] to make repo available for clients regardless of OS version. Maximum length 1; allowed tags are: rhel-6, rhel-7, rhel-8, rhel-9

Validations:

  • Must be an array of any type

gpg_key_id
optional , nil allowed

id of the gpg key that will be assigned to the new repository

Validations:

  • Must be a number.

ssl_ca_cert_id
optional , nil allowed

Identifier of the content credential containing the SSL CA Cert

Validations:

  • Must be a number.

ssl_client_cert_id
optional , nil allowed

Identifier of the content credential containing the SSL Client Cert

Validations:

  • Must be a number.

ssl_client_key_id
optional , nil allowed

Identifier of the content credential containing the SSL Client Key

Validations:

  • Must be a number.

unprotected
optional

true if this repository can be published via HTTP

Validations:

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

checksum_type
optional

Checksum of the repository, currently 'sha1' & 'sha256' are supported

Validations:

  • String

docker_upstream_name
optional

Name of the upstream docker repository

Validations:

  • String

docker_tags_whitelist DEPRECATED
optional

Comma-separated list of tags to sync for Container Image repository (Deprecated)

Validations:

  • Must be an array of any type

include_tags
optional

Comma-separated list of tags to sync for a container image repository

Validations:

  • Must be an array of any type

exclude_tags
optional

Comma-separated list of tags to exclude when syncing a container image repository. Default: any tag ending in “-source”

Validations:

  • Must be an array of any type

download_policy
optional

download policy for yum, deb, and docker repos (either 'immediate' or 'on_demand')

Validations:

  • Must be one of: immediate, on_demand.

download_concurrency
optional

Used to determine download concurrency of the repository in pulp3. Use value less than 20. Defaults to 10

Validations:

  • Must be a number.

mirroring_policy
optional

Policy to set for mirroring content. Must be one of additive.

Validations:

  • Must be one of: additive, mirror_complete, mirror_content_only.

verify_ssl_on_sync
optional

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

Validations:

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

upstream_username
optional

Username of the upstream repository user used for authentication

Validations:

  • String

upstream_password
optional

Password of the upstream repository user used for authentication

Validations:

  • String

upstream_authentication_token
optional

Password of the upstream authentication token.

Validations:

  • String

deb_releases
optional

whitespace-separated list of releases to be synced from deb-archive

Validations:

  • String

deb_components
optional

whitespace-separated list of repo components to be synced from deb-archive

Validations:

  • String

deb_architectures
optional

whitespace-separated list of architectures to be synced from deb-archive

Validations:

  • String

ignorable_content
optional

List of content units to ignore while syncing a yum repository. Must be subset of srpm,treeinfo

Validations:

  • Must be an array of any type

ansible_collection_requirements
optional

Contents of requirement yaml file to sync from URL

Validations:

  • String

ansible_collection_auth_url
optional

The URL to receive a session token from, e.g. used with Automation Hub.

Validations:

  • String

ansible_collection_auth_token
optional

The token key to use for authentication.

Validations:

  • String

http_proxy_policy
optional

policies for HTTP proxy for content sync

Validations:

  • Must be one of: global_default_http_proxy, none, use_selected_http_proxy.

http_proxy_id
optional

ID of a HTTP Proxy

Validations:

  • Must be a number.

arch
optional

Architecture of content in the repository

Validations:

  • String

retain_package_versions_count
optional

The maximum number of versions of each package to keep.

Validations:

  • Must be a number.

metadata_expire
optional

Time to expire yum metadata in seconds. Only relevant for custom yum repositories.

Validations:

  • Must be a number.

excludes
optional

Python packages to exclude from the upstream URL, names separated by newline. You may also specify versions, for example: django~=2.0.

Validations:

  • Must be an array of any type

includes
optional

Python packages to include from the upstream URL, names separated by newline. You may also specify versions, for example: django~=2.0. Leave empty to include every package.

Validations:

  • Must be an array of any type

package_types
optional

Package types to sync for Python content, separated by comma. Leave empty to get every package type. Package types are: bdist_dmg, bdist_dumb, bdist_egg, bdist_msi, bdist_rpm, bdist_wheel, bdist_wininst, sdist.

Validations:

  • Must be an array of any type