Skip to main content
Version: v1

Traffic Consumption

When using services for all main objects (domain, s3_resource, s3_bucket, vod, stream), network traffic consumption in bytes is recorded.

To obtain consumption statistics, you need to use API methods.

Request Parameters​

Traffic consumption can be retrieved for different intervals: day (day), hour (hour), 10 minutes (ten_minutes).

  • Object ID
  • Start date and time of measurement (inclusive)
  • End date and time of measurement (exclusive)
  • Measurement grouping interval

Example Request​

{
    "id": 23,
    "from_datetime": "2024-11-01T00:00:00Z",
    "to_datetime": "2024-11-05T00:00:00Z",
    "group_by": "day"
}

Example response for domain, s3_resource, s3_bucket, vod objects​

[
    {
        "datetime_utc": "2024-11-01T00:00:00Z",
        "in_bytes": 7360,
        "out_bytes": 874000,
        "features": {}
    },
    {
        "datetime_utc": "2024-11-02T00:00:00Z",
        "in_bytes": 14720,
        "out_bytes": 1748000,
        "features": {
            "geo_filter": {
                "requests": 8,
                "in_bytes": 14720,
                "out_bytes": 1748000
            },
            "waf": {
                "requests": 6,
                "in_bytes": 8234,
                "out_bytes": 435987
            }
        }
    },
    {
        "datetime_utc": "2024-11-03T00:00:00Z",
        "in_bytes": 7360,
        "out_bytes": 874000,
        "features": {
            "waf": {
                "requests": 4,
                "in_bytes": 5948,
                "out_bytes": 441298
            }
        }
    },
    {
        "datetime_utc": "2024-11-04T00:00:00Z",
        "in_bytes": 0,
        "out_bytes": 0,
        "features": {}
    }
]

Example response for stream object​

[
    {
        "datetime_utc": "2024-11-01T00:00:00Z",
        "sent_bytes": 0,
        "rescaled_to_480_bytes": 0,
        "rescaled_to_720_bytes": 0,
        "rescaled_to_1080_bytes": 0,
        "rescaled_to_custom_height_bytes": 0,
        "in_bytes": 7360,
        "out_bytes": 874000
    },
    {
        "datetime_utc": "2024-11-02T00:00:00Z",
        "sent_bytes": 2349546,
        "rescaled_to_480_bytes": 2348576,
        "rescaled_to_720_bytes": 2348576,
        "rescaled_to_1080_bytes": 0,
        "rescaled_to_custom_height_bytes": 0,
        "in_bytes": 2348576,
        "out_bytes": 298374569
    },
    {
        "datetime_utc": "2024-11-03T00:00:00Z",
        "sent_bytes": 2323873,
        "rescaled_to_480_bytes": 2322813,
        "rescaled_to_720_bytes": 2322813,
        "rescaled_to_1080_bytes": 0,
        "rescaled_to_custom_height_bytes": 0,
        "in_bytes": 2322813,
        "out_bytes": 368371169
    },
    {
        "datetime_utc": "2024-11-04T00:00:00Z",
        "sent_bytes": 2368142,
        "rescaled_to_480_bytes": 198541,
        "rescaled_to_720_bytes": 198541,
        "rescaled_to_1080_bytes": 2124272,
        "rescaled_to_custom_height_bytes": 0,
        "in_bytes": 2368142,
        "out_bytes": 2633614
    },
]

In the statistics for domains, S3, and VoD, traffic consumption is also recorded for additional features:

  • image_converter - requests using the image processing function (for domains)
  • geo_filter - requests with country access restriction enabled (for all types of static objects)
  • secure_access - requests with access restriction enabled using signed URLs (for VoD)
  • adaptive_bitrate - requests with adaptive bitrate option enabled (for VoD)
  • waf - requests with web application firewall enabled (for domains)

Streaming statistics include traffic consumption during restreaming (field sent_bytes) and rescaling (field rescaled_to_*_bytes).

API Methods​