Update a Debian upstream config for this repository.

put https://api.cloudsmith.io/v1/repos/{owner}/{identifier}/upstream/deb/{slug_perm}/

Path Params

owner

string

required

identifier

string

required

slug_perm

string

required

Body Params

auth_mode

string

Defaults to None

The authentication mode to use when accessing this upstream.

auth_secret

string | null

Secret to provide with requests to upstream.

auth_username

string | null

Username to provide with requests to upstream.

component

string

length between 1 and 64

The component to fetch from the upstream

distro_versions

array of strings

required

The distribution version that packages found on this upstream could be associated with.

distro_versions*

extra_header_1

string | null

The key for extra header #1 to send to upstream.

extra_header_2

string | null

The key for extra header #2 to send to upstream.

extra_value_1

string | null

The value for extra header #1 to send to upstream. This is stored as plaintext, and is NOT encrypted.

extra_value_2

string | null

The value for extra header #2 to send to upstream. This is stored as plaintext, and is NOT encrypted.

gpg_key_inline

string | null

A public GPG key to associate with packages found on this upstream. When using the Cloudsmith setup script, this GPG key will be automatically imported on your deployment machines to allow upstream packages to validate and install.

gpg_key_url

uri | null

When provided, Cloudsmith will fetch, validate, and associate a public GPG key found at the provided URL. When using the Cloudsmith setup script, this GPG key will be automatically imported on your deployment machines to allow upstream packages to validate and install.

gpg_verification

string

Defaults to Allow All

The GPG signature verification mode for this upstream.

include_sources

boolean

When true, source packages will be available from this upstream.

is_active

boolean

Whether or not this upstream is active and ready for requests.

mode

string

Defaults to Proxy Only

The mode that this upstream should operate in. Upstream sources can be used to proxy resolved packages, as well as operate in a proxy/cache or cache only mode.

name

string

required

length between 1 and 64

A descriptive name for this upstream source. A shortened version of this name will be used for tagging cached packages retrieved from this upstream.

priority

integer

1 to 32767

Upstream sources are selected for resolving requests by sequential order (1..n), followed by creation date.

upstream_distribution

string | null

The distribution to fetch from the upstream

upstream_url

uri

required

length between 1 and 200

The URL for this upstream source. This must be a fully qualified URL including any path elements required to reach the root of the repository.

verify_ssl

boolean

If enabled, SSL certificates are verified when requests are made to this upstream. It's recommended to leave this enabled for all public sources to help mitigate Man-In-The-Middle (MITM) attacks. Please note this only applies to HTTPS upstreams.

Responses

Response body

object

auth_mode

string

Defaults to None

The authentication mode to use when accessing this upstream.

None Username and Password

auth_secret

string | null

Secret to provide with requests to upstream.

auth_username

string | null

Username to provide with requests to upstream.

component

string

length between 1 and 64

The component to fetch from the upstream

created_at

date-time

The datetime the upstream source was created.

disable_reason

string

Defaults to N/A

N/A Upstream points to its own repository Missing upstream source Upstream was disabled by request of user

distro_versions

array of strings

required

The distribution version that packages found on this upstream could be associated with.

distro_versions*

extra_header_1

string | null

The key for extra header #1 to send to upstream.

extra_header_2

string | null

The key for extra header #2 to send to upstream.

extra_value_1

string | null

The value for extra header #1 to send to upstream. This is stored as plaintext, and is NOT encrypted.

extra_value_2

string | null

The value for extra header #2 to send to upstream. This is stored as plaintext, and is NOT encrypted.

gpg_key_inline

string | null

gpg_key_url

uri | null

gpg_verification

string

Defaults to Allow All

The GPG signature verification mode for this upstream.

Allow All Warn on Invalid Reject Invalid

include_sources

boolean

When true, source packages will be available from this upstream.

is_active

boolean

Whether or not this upstream is active and ready for requests.

mode

string

Defaults to Proxy Only

The mode that this upstream should operate in. Upstream sources can be used to proxy resolved packages, as well as operate in a proxy/cache or cache only mode.

Proxy Only Cache and Proxy

name

string

required

length between 1 and 64

A descriptive name for this upstream source. A shortened version of this name will be used for tagging cached packages retrieved from this upstream.

pending_validation

boolean

When true, this upstream source is pending validation.

priority

integer

1 to 32767

Upstream sources are selected for resolving requests by sequential order (1..n), followed by creation date.

slug_perm

string

length ≥ 1

updated_at

date-time

upstream_distribution

string | null

The distribution to fetch from the upstream

upstream_url

uri

required

length between 1 and 200

The URL for this upstream source. This must be a fully qualified URL including any path elements required to reach the root of the repository.

verification_status

string

Defaults to Unknown

The signature verification status for this upstream.

Unknown Invalid Valid Invalid (No Key)

verify_ssl

boolean

Language

Credentials


xxxxxxxxxx
11
1
curl --request PUT \
2
     --url https://api.cloudsmith.io/v1/repos/owner/identifier/upstream/deb/slug_perm/ \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "auth_mode": "None",
8
  "gpg_verification": "Allow All",
9
  "mode": "Proxy Only"
10
}
11
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Request could not be processed (see detail).

422Missing or invalid parameters (see detail).

Cloudsmith is the new standard in Package / Artifact Management and Software Distribution