All Products
Search

This Product

    Edge Security Acceleration:DescribeDcdnDomainRealTimeDetailData

    Document Center

    Edge Security Acceleration:DescribeDcdnDomainRealTimeDetailData

    Last Updated:Sep 28, 2025

    Call DescribeDcdnDomainRealTimeDetailData to batch query traffic and request data for accelerated domain names at a 1-minute granularity. The data is aggregated by region and carrier. The maximum time range for a single query is 10 minutes.

    Operation description

    Note

    • A single user can call this operation up to 10 times per second.

    • This operation is available only to users whose daily peak bandwidth is 1 Gbps or higher. If you meet this requirement, submit a ticket to request permissions to call this operation.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dcdn:DescribeDcdnDomainRealTimeDetailData

    get

    *Domain

    acs:dcdn:*:{#accountId}:domain/{#domainName}

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    DomainName

    string

    Yes

    The accelerated domain name. You can specify multiple domain names and separate them with commas (,).

    example.com
    StartTime

    string

    Yes

    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.

    2019-11-30T05:33:00Z
    EndTime

    string

    Yes

    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.

    Note

    The end time must be later than the start time. The maximum time range that can be queried is 10 minutes.

    2019-11-30T05:40:00Z
    Field

    string

    Yes

    The information to query. You can specify multiple values and separate them with commas (,). Valid values:

    • qps: queries per second (QPS).

    • bps: bandwidth.

    • http_code: HTTP status codes.

    bps
    LocationNameEn

    string

    No

    The English name of the region. You can call the DescribeDcdnRegionAndIsp operation to query regions.

    If you do not set this parameter, data in all regions is queried.

    beijing
    IspNameEn

    string

    No

    The English name of the internet service provider (ISP). You can call the DescribeDcdnRegionAndIsp operation to query ISPs.

    If you do not set this parameter, data from all ISPs is queried.

    unicom
    Merge

    string

    No

    Specifies whether to return aggregated data. Valid values:

    • true

    • false

    The default value is false.

    true
    MergeLocIsp

    string

    No

    Specifies whether to aggregate data by region and ISP. Valid values:

    • true

    • false

    The default value is false.

    true

    Response elements

    Element

    Type

    Description

    Example

    object

    Data

    string

    The list of data returned.

    Note

    This parameter is returned as a JSON string due to API limitations. The following table describes the fields in the JSON string.

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

    string

    The ID of the request.

    A603F324-7A05-4FB3-ADF3-2563233D26CC

    Data fields

    NameTypeDescriptionExample
    domain_nameStringThe domain name that you queried.example.com
    ispStringThe name of the ISP.unicom
    locationStringThe name of the region.qingdao
    qpsLongThe number of queries per second.40
    bpsLongThe bandwidth.100
    http_codeMapThe details of HTTP status codes. The key indicates the name of the status code, and the value indicates the number of times the status code is returned.{"200": 1, "304": 2, "403": 3}
    time_stpStringThe timestamp of the data returned. The time is in the ISO 8601 standard in UTC.2022-10-20T04:00:00Z

    Examples

    Success response

    JSON format

    {
  "Data": "[\n    {\n      \"time_stp\": \"2018-06-05T20:00:00Z\",\n      \"domain_name\": \"example.com\",\n      \"location\": \"Guangdong\",\n      \"isp\": \"telecom\",\n      \"qps\": 10.0\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": "A603F324-7A05-4FB3-ADF3-2563233D26CC"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 MissingTimeParameter The StartTime and EndTime must be both specified. You must set both the start time and the end time.
    400 InvalidStartTime.Malformed The specified StartTime parameter is invalid. The format of the specified start time is invalid. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
    400 InvalidEndTime.Malformed The specified EndTime is invalid. The format of the specified end time is invalid. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
    400 InvalidParameter The specified parameter is invalid. A parameter is set to an invalid value.
    400 InvalidTime.Malformed Specified StartTime or EndTime is malformed. The format of the specified start time or end time is invalid. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
    400 InvalidDomainName.Malformed The specific DomainName is invalid. The specified domain name is invalid.
    400 InvalidStartTime.ValueNotSupported The specified StartTime is invalid. The specified start time is invalid.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.