G-g-core
CDN Statistics

Origin shielding usage statistics

Changed on

Get origin shielding usage statistics for up to 365 days starting from today.

Request URL parameters should be added as a query string after the endpoint.

get/cdn/statistics/shield_usage/series

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/cdn/statistics/shield_usage/series
  • Auth
    HTTP apikey

Query parameters

fromstring required

Beginning of the requested time period (ISO 8601/RFC 3339 format, UTC.)

tostring required

End of the requested time period (ISO 8601/RFC 3339 format, UTC.)

resourceinteger

CDN resources IDs by that statistics data is grouped.

To request multiple values, use:

  • &resource=1&resource=2

If CDN resource ID is not specified, data related to all CDN resources is returned.

Response

Successful.

idinteger

Identifier of the paid feature usage record.

active_fromstring

Date and time when paid feature was enabled (ISO 8601/RFC 3339 format, UTC.)

active_tostring nullable

Date and time when paid feature was disabled (ISO 8601/RFC 3339 format, UTC.)

It returns null if the paid feature is enabled.

client_idinteger

Client ID.

resource_idinteger

CDN resource ID.

cnamestring

CDN resource CNAME.

Example response

[
  {
    "id": 1,
    "active_from": "2020-01-21T04:36:35.473Z",
    "active_to": null,
    "client_id": 1,
    "resource_id": 1,
    "cname": "cdn1.example.com"
  },
  {
    "id": 2,
    "active_from": "2020-03-21T04:36:30.269Z",
    "active_to": "2020-04-21T04:36:33.062Z",
    "client_id": 1,
    "cname": "cdn2.example.com"
  }
]

Changes