Customizes an operations report.

Note
  • This operation allows you to customize an operations report for a specific domain name. You can view the statistics about the domain name in the report.
  • You can call this API operation up to three 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. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateCdnSubTask

The operation that you want to perform. Set the value to CreateCdnSubTask.

ReportIds String Yes 1,3,5

The IDs of the metrics that you want to include in the report. Separate multiple IDs with commas (,). Valid values:

  • 1: frequently requested URLs (ranked by the number of requests)
  • 3: frequently requested URLs (ranked by the amount of network traffic)
  • 5: frequently used referer headers (ranked by the number of requests)
  • 7: frequently used referer headers (ranked by the amount of network traffic)
  • 9: frequently requested back-to-origin URLs (ranked by the number of requests)
  • 11: frequently requested back-to-origin URLs (ranked by the amount of network traffic)
  • 13: top client IP addresses (ranked by the number of requests)
  • 15: top client IP addresses (ranked by the amount of network traffic)
  • 17: domain names ranked by the amount of network traffic
  • 19: page views and unique visitors
  • 21: regions from which requests are initiated
  • 23: distribution of Internet service providers (ISPs)
DomainName String No www.example1.com,www.example2.com

The domain names to be tracked. Separate multiple domain names with commas (,). You can specify up to 500 domain names. If you want to specify more than 500 domain names, submit a ticket.

Note If you do not specify a domain name, the custom operations reports are created for all domain names that belong to your Alibaba Cloud account.

Response parameters

Parameter Type Example Description
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

The ID of the request.

Examples

Sample requests

http://cdn.aliyuncs.com?Action=CreateCdnSubTask
&ReportIds=1,3,5
&DomainName=www.example1.com,www.example2.com
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateCdnSubTaskResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</CreateCdnSubTaskResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368"
}

Error codes

HttpCode Error code Error message Description
400 InvalidParameter The specified parameter is invalid. The error message returned because one or more parameters are invalid.
400 TimeParseFailed Failed to parse the time parameter. The error message returned because the time parameter failed to be parsed.
400 SubscriptionAlreadyExists The subscription already exists. The error message returned because the tracking task already exists.
400 SubscriptionNotFound The subscription is not found. The error message returned because the tracking task does not exist.
400 NameAlreadyExists The name already exists. The error message returned because the name of the tracking task already exists.
400 DeliverExceedLimit The maximum number of subscribed tasks is exceeded. The error message returned because the maximum number of tracking tasks has been reached.

For a list of error codes, visit the API Error Center.