POST /katello/api/alternate_content_sources
Create an alternate content source to download content from during repository syncing. Note: alternate content sources are global and affect ALL sync actions on their smart proxies regardless of organization.

Examples

POST /katello/api/alternate_content_sources
{
  "name": "Yum ACS",
  "smart_proxy_ids": [
    767380118
  ],
  "http_proxy_id": 1022235461,
  "ssl_ca_cert_id": 70104267,
  "ssl_client_cert_id": 60750479,
  "ssl_client_key_id": 81778079,
  "content_type": "yum",
  "base_url": "https://fixtures.pulpproject.org/",
  "subpaths": [
    "content/",
    "isos/",
    "packages/"
  ],
  "alternate_content_source_type": "custom",
  "verify_ssl": true,
  "use_http_proxies": null,
  "upstream_username": "admin",
  "upstream_password": "changeme",
  "alternate_content_source": {
    "name": "Yum ACS",
    "ssl_ca_cert_id": 70104267,
    "ssl_client_cert_id": 60750479,
    "ssl_client_key_id": 81778079,
    "base_url": "https://fixtures.pulpproject.org/",
    "subpaths": [
      "content/",
      "isos/",
      "packages/"
    ],
    "content_type": "yum",
    "alternate_content_source_type": "custom",
    "verify_ssl": true,
    "upstream_username": "admin",
    "upstream_password": "changeme",
    "use_http_proxies": null,
    "smart_proxy_ids": [
      767380118
    ]
  }
}
201
{
  "name": "Yum ACS",
  "alternate_content_source_type": "custom",
  "content_type": "yum",
  "base_url": "https://fixtures.pulpproject.org/",
  "subpaths": [
    "content/",
    "isos/",
    "packages/"
  ],
  "upstream_username": "admin",
  "smart_proxies": [],
  "verify_ssl": true,
  "use_http_proxies": null,
  "id": null,
  "label": null,
  "description": null,
  "ssl_ca_cert": {
    "id": 70104267,
    "name": "Fedora CA"
  },
  "ssl_client_cert": {
    "id": 60750479,
    "name": "Fedora Cert"
  },
  "ssl_client_key": {
    "id": 81778079,
    "name": "Fedora Key"
  },
  "last_refresh": null,
  "upstream_password_exists": true
}

Params

Param name Description
content_type
optional

The content type for the Alternate Content Source

Validations:

  • Must be one of: file, yum.
alternate_content_source_type
optional

The Alternate Content Source type

Validations:

  • Must be one of: custom, simplified, rhui.
name
optional

Name of the alternate content source

Validations:

  • String
description
optional

Description for the alternate content source

Validations:

  • String
base_url
optional

Base URL for finding alternate content

Validations:

  • String
subpaths
optional

Path suffixes for finding alternate content

Validations:

  • Must be an array of any type
smart_proxy_ids
optional

Ids of smart proxies to associate

Validations:

  • Must be an array of any type
smart_proxy_names
optional

Names of smart proxies to associate

Validations:

  • Must be an array of any type
upstream_username
optional

Basic authentication username

Validations:

  • String
upstream_password
optional

Basic authentication password

Validations:

  • String
ssl_ca_cert_id
optional

Identifier of the content credential containing the SSL CA Cert

Validations:

  • Must be a number.
ssl_client_cert_id
optional

Identifier of the content credential containing the SSL Client Cert

Validations:

  • Must be a number.
ssl_client_key_id
optional

Identifier of the content credential containing the SSL Client Key

Validations:

  • Must be a number.
verify_ssl
optional

If SSL should be verified for the upstream URL

Validations:

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

If the smart proxies' assigned HTTP proxies should be used

Validations:

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

IDs of products to copy repository information from into a Simplified Alternate Content Source. Products must include at least one repository of the chosen content type.

Validations:

  • Must be an array of any type