DescribeRequest

1. API Description

This API (DescribeRequest) is used to query the number of CDN requests.

Preparation

• Query Billing Region: Use DescribeBillingRegions.

2. Request Parameters

The following table lists the required request parameters for the API:

Parameter Name	Required	Type	Description
startTime	Yes	String	Start time
endTime	Yes	String	End time
domain	No	String	Accelerated domain
region	No	String	Billing region
protocol	No	String	Protocol type
group	No	String	Group type

3. Output Parameterss

Parameter Name	Type	Description
dataSet	Array of BandwithData	Number of requests.
requestId	String	Unique request ID, which is returned with every request. This request ID is needed to locate issues.

4. Code Example

Example

1. Query CDN Request Count.

POST / HTTP/1.1
Host: console.zenlayer.com/api/v2/cdn
Content-Type: application/json
X-TC-Action: DescribeRequest
<Common Request Params>

Request:
{
}

Response:
{
  "requestId": "T6883FCD0-3E7D-44EA-A517-A421A52A27F4",
  "response": {
    "requestId": "T6883FCD0-3E7D-44EA-A517-A421A52A27F4",
    "dataSet": [{
      "data": [{
        "time": "2022-06-14T00:00:00.000Z",
        "value": 114
      },
      {
        "time": "2022-06-14T00:05:00.000Z",
        "value": 140
      },
      {
        "time": "2022-06-14T00:10:00.000Z",
        "value": 243
      }],
      "domain": "www.ddd123.com",
      "region": "ALL"
    }]
  }
}

5. Error Codes

The following includes error codes encountered in business logic. For other error codes, see Common Error Codes.