Skip to main content
GET
/
cdn
/
origin_groups
Python
from gcore import Gcore

client = Gcore(
    api_key="My API Key",
)
origin_groups_list = client.cdn.origin_groups.list()
print(origin_groups_list)
[
  {
    "id": 1,
    "name": "YourOriginGroup",
    "use_next": true,
    "proxy_next_upstream": [
      "error",
      "timeout",
      "invalid_header",
      "http_500",
      "http_502",
      "http_503",
      "http_504"
    ],
    "auth_type": "none",
    "sources": [
      {
        "backup": false,
        "enabled": true,
        "source": "yourwebsite.com"
      },
      {
        "backup": true,
        "enabled": true,
        "source": "1.2.3.4:5500"
      }
    ],
    "path": "",
    "has_related_resources": true
  }
]

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Query Parameters

​
name
string

Origin group name.

​
sources
string

Origin sources (IP addresses or domains) in the origin group.

​
has_related_resources
boolean

Defines whether the origin group has related CDN resources.

Possible values:

  • true – Origin group has related CDN resources.
  • false – Origin group does not have related CDN resources.

Response

Successful.

  • None Auth
  • AWS Signature V4
​
id
integer

Origin group ID.

Example:

1

​
name
string

Origin group name.

Example:

"YourOriginGroup"

​
use_next
boolean

Defines whether to use the next origin from the origin group if origin responds with the cases specified in proxy_next_upstream. If you enable it, you must specify cases in proxy_next_upstream.

Possible values:

  • true - Option is enabled.
  • false - Option is disabled.
Example:

true

​
proxy_next_upstream
string[]

Defines cases when the request should be passed on to the next origin.

Possible values:

  • error - an error occurred while establishing a connection with the origin, passing a request to it, or reading the response header
  • timeout - a timeout has occurred while establishing a connection with the origin, passing a request to it, or reading the response header
  • invalid_header - a origin returned an empty or invalid response
  • http_403 - a origin returned a response with the code 403
  • http_404 - a origin returned a response with the code 404
  • http_429 - a origin returned a response with the code 429
  • http_500 - a origin returned a response with the code 500
  • http_502 - a origin returned a response with the code 502
  • http_503 - a origin returned a response with the code 503
  • http_504 - a origin returned a response with the code 504
Example:
[
  "error",
  "timeout",
  "invalid_header",
  "http_500",
  "http_502",
  "http_503",
  "http_504"
]
​
auth_type
string

Origin authentication type.

Possible values:

  • none - Used for public origins.
  • awsSignatureV4 - Used for S3 storage.
Example:

"none"

​
sources
object[]

List of origin sources in the origin group.

Example:
[
  {
    "backup": false,
    "enabled": true,
    "source": "yourwebsite.com"
  },
  {
    "backup": true,
    "enabled": true,
    "source": "1.2.3.4:5500"
  }
]
​
path
string

Parameter is deprecated.

Example:

""

​
has_related_resources
boolean

Defines whether the origin group has related CDN resources.

Possible values:

  • true - Origin group has related CDN resources.
  • false - Origin group does not have related CDN resources.
Example:

true

⌘I