All Products
Search

This Product

    ApsaraVideo VOD:DescribeVodDomainRealTimeDetailData

    Document Center

    ApsaraVideo VOD:DescribeVodDomainRealTimeDetailData

    Last Updated:Jul 19, 2024

    Queries real-time monitoring data of one or more accelerated domain names.

    Operation description

    You can query data within the last seven days. Data is collected every minute. You can call this API operation up to 10 times per second per account.

    Debugging

    OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

    Authorization information

    There is currently no authorization information disclosed in the API.

    Request parameters

    ParameterTypeRequiredDescriptionExample
    DomainNamestringYes

    The accelerated domain name. You can specify a maximum of 20 accelerated domain names in each call. Separate domain names with commas (,).

    		example.com
    StartTimestringYes

    The beginning of the time range to query.

    Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. Example: 2019-11-30T05:33:00Z.

    		2019-01-23T12:35:12Z
    EndTimestringYes

    The end of the time range to query.

    Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. Example: 2019-11-30T05:40:00Z.

    		2019-01-23T12:40:00Z
    FieldstringYes

    The type of data that you want to query. You can specify multiple data types and separate them with commas (,). Valid values:

    qps: the number of queries per second bps: bandwidth data http_code: HTTP status codes

    		bps
    LocationNameEnstringNo

    The name of the region. If you do not specify a region, data in all regions is queried.

    		shanghai
    IspNameEnstringNo

    The name of the Internet service provider (ISP).

    		unicom
    MergestringNo

    Specifies whether to return a summary value. Valid values:

    true false (default)

    		false
    MergeLocIspstringNo

    Specifies whether to return a summary value. Valid values:

    • true: groups the results by domain name and merges the results by region and ISP.
    • false: groups the results by domain name.

    Default value: false.

    		true

    Response parameters

    ParameterTypeDescriptionExample
    object
    Datastring

    The returned results.

    		[ { "time_stp": "2018-06-05T20:00:00Z", "domain_name": "example.com", "location": "Guangdong", "isp": "telecom", "qps": 10 }, { "time_stp": "2018-06-05T20:00:00Z", "domain_name": "example.com", "location": "Jiangsu", "isp": "unicom", "qps": 11.1 } ]
    RequestIdstring

    The ID of the request.

    		1710298E-8AFA-5F6D-A3E9-47103C52177D

    Examples

    Sample success responses

    JSONformat

    {
  "Data": "[\n      {\n            \"time_stp\": \"2018-06-05T20:00:00Z\",\n            \"domain_name\": \"example.com\",\n            \"location\": \"Guangdong\",\n            \"isp\": \"telecom\",\n            \"qps\": 10\n      },\n      {\n            \"time_stp\": \"2018-06-05T20:00:00Z\",\n            \"domain_name\": \"example.com\",\n            \"location\": \"Jiangsu\",\n            \"isp\": \"unicom\",\n            \"qps\": 11.1\n      }\n]",
  "RequestId": "1710298E-8AFA-5F6D-A3E9-47103C52177D"
}

    Error codes

    For a list of error codes, visit the Service error codes.