Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2023 Intertech Services AG
Yandex Cloud CDN
  • Getting started
  • Access management
  • Troubleshooting
  • Pricing policy
  1. API reference
  2. REST
  3. Origin
  4. get

Cloud CDN API, REST: Origin.get

Written by
Yandex Cloud
  • HTTP request
  • Path parameters
  • Query parameters
  • Response

Get origin in origin group.

HTTP requestHTTP request

GET https://cdn.api.cloud.yandex.net/cdn/v1/origins/{originId}

Path parametersPath parameters

Parameter Description
originId

originId group ID to request origin from.

Value must be greater than 0.

Query parametersQuery parameters

Parameter Description
folderId

Required. ID of the folder that the origin belongs to.

The maximum string length in characters is 50.

ResponseResponse

HTTP Code: 200 - OK

{
  "id": "string",
  "originGroupId": "string",
  "source": "string",
  "enabled": true,
  "backup": true,
  "meta": {

    // `meta` includes only one of the fields `common`, `bucket`, `website`, `balancer`
    "common": {
      "name": "string"
    },
    "bucket": {
      "name": "string"
    },
    "website": {
      "name": "string"
    },
    "balancer": {
      "id": "string"
    },
    // end of the list of possible fields`meta`

  }
}

An origin. For details about the concept, see documentation.

Field Description
id string (int64)

ID of the origin.

originGroupId string (int64)

ID of the parent origin group.

source string

IP address or Domain name of your origin and the port (if custom). Used if meta variant is common.

enabled boolean (boolean)

The setting allows to enable or disable an Origin source in the Origins group.

It has two possible values:

True - The origin is enabled and used as a source for the CDN. An origins group must contain at least one enabled origin. False - The origin is disabled and the CDN is not using it to pull content.

backup boolean (boolean)

Specifies whether the origin is used in its origin group as backup. A backup origin is used when one of active origins becomes unavailable.

meta object

Set up origin of the content.

Origin type. For details about the concept, see documentation.

meta.
common
object
An Object Storage bucket configured as a static site hosting.
meta includes only one of the fields common, bucket, website, balancer
meta.
common.
name
string

Name of the origin.

meta.
bucket
object
A server with a domain name linked to it
meta includes only one of the fields common, bucket, website, balancer
meta.
bucket.
name
string

Name of the origin.

meta.
website
object
An Object Storage bucket not configured as a static site hosting.
meta includes only one of the fields common, bucket, website, balancer
meta.
website.
name
string

Name of the origin.

meta.
balancer
object
An L7 load balancer from Application Load Balancer. CDN servers will access the load balancer at one of its IP addresses that must be selected in the origin settings.
meta includes only one of the fields common, bucket, website, balancer
meta.
balancer.
id
string

ID of the origin.

Was the article helpful?

Yandex project
© 2023 Intertech Services AG
In this article:
  • HTTP request
  • Path parameters
  • Query parameters
  • Response