Customizes an operations report template.

Note
  • This operation allows you to customize an operations report template for a specific domain name. Then, you can view statistics about the domain name in the reports.
  • The maximum number of times that each user can call this operation per second is 30.

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 metrics that you want to include in the report template. Separate 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 example.com,aliyundoc.com

The domain names from which data is collected. Separate domain names with commas (,). You can add at most 500 domain names to each report template. If you want to add more domain names, submit a ticket.

Note If you do not specify a domain name, the task collects data from 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(s)://cdn.aliyuncs.com/?Action=CreateCdnSubTask
&ReportIds=1,3,5
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

Error codes

HttpCode Error code Error message Description
400 InvalidParameter The specified parameter is invalid. The error code returned because one or more parameters are set to an invalid value.
400 TimeParseFailed Failed to parse the time parameter. The error code returned because the system failed to parse the time parameter.
400 SubscriptionAlreadyExists The subscription already exists. The error code returned because the report template already exists.
400 SubscriptionNotFound The subscription is not found. The error code returned because report template customization is not activated.
400 NameAlreadyExists The name already exists. The error code returned because the template name already exists.
400 DeliverExceedLimit The maximum number of subscribed tasks is exceeded. The error code returned because the number of existing report templates has reached the upper limit.

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