This product(
Cdn/2018-05-10) OpenAPI adopts RPC Signature style. See signature details in Description of the signature mechanism. We have packaged SDKs for common programming languages for developers. Developers can directly call the OpenAPI of this product by downloading the SDK without paying attention to the technical details. If the existing SDK cannot meet the usage requirements, you can connect through the signature mechanism. It will take about 5 working days. Therefore, it is recommended to join our DingTalk service group (78410016550) and sign under the guidance of experts. Before using the API, you need to prepare your identity account and access key (AccessKey) to effectively access the API through client tools (SDK, CLI, etc.). For details see getAccessKey.
Domain name management
| API | Title | Description |
|---|---|---|
| Adding or removing domain names | Adding or removing domain names | |
| AddCdnDomain | AddCdnDomain | Adds a domain name to accelerate. |
| BatchAddCdnDomain | BatchAddCdnDomain | Adds one or more domain names to Alibaba Cloud CDN. You can add a maximum of 50 domain names at a time. |
| DeleteCdnDomain | DeleteCdnDomain | Removes an accelerated domain name from Alibaba Cloud CDN. |
| DescribeCdnDeletedDomains | DescribeCdnDeletedDomains | Queries the domain names that are deleted from your account. |
| Domain name ownership verification | Domain name ownership verification | |
| VerifyDomainOwner | VerifyDomainOwner | Verifies the ownership of a specified domain name. |
| DescribeVerifyContent | DescribeVerifyContent | Queries the ownership verification content of an accelerated domain name. |
| DescribeDomainVerifyData | DescribeDomainVerifyData | Queries the verification content of a domain name, including the host record and record value. |
| Enabling or disabling domain names | Enabling or disabling domain names | |
| StartCdnDomain | StartCdnDomain | Enables a disabled domain name. After the domain name is enabled, the value of the DomainStatus parameter is changed to Online. |
| BatchStartCdnDomain | BatchStartCdnDomain | Enables one or more domain names at a time. After a domain name is enabled, the value of the DomainStatus parameter is changed to Online. |
| StopCdnDomain | StopCdnDomain | Disables an accelerated domain name. After the domain name is disabled, the value of the DomainStatus parameter is changed to Offline. |
| BatchStopCdnDomain | BatchStopCdnDomain | Disables one or more accelerated domain names at a time. After an accelerated domain name is disabled, the value of the DomainStatus parameter is changed to Offline. |
| Domain name configuration | Domain name configuration | |
| DescribeUserDomains | DescribeUserDomains | Queries all accelerated domain names in your Alibaba Cloud account and the status of the accelerated domain names. You can filter domain names by name or status. Fuzzy match is supported. |
| DescribeDomainCname | DescribeDomainCname | Detects the CNAME for an accelerated domain name. You can check the resolution result to determine whether the CNAME is configured. |
| DescribeDomainsBySource | DescribeDomainsBySource | Queries accelerated domain names by origin server. |
| DescribeCdnUserDomainsByFunc | DescribeCdnUserDomainsByFunc | Queries accelerated domain names that have specified features configured and the status of the domain names. |
| DescribeCdnDomainDetail | DescribeCdnDomainDetail | Queries the basic information about an accelerated domain name. |
| DescribeCdnDomainConfigs | DescribeCdnDomainConfigs | Queries the configurations of an accelerated domain name. You can query the configurations of one or more features at the same time. |
| BatchSetCdnDomainConfig | BatchSetCdnDomainConfig | Configures multiple accelerated domain names at a time. |
| BatchDeleteCdnDomainConfig | BatchDeleteCdnDomainConfig | Deletes configurations of multiple accelerated domain names at a time. |
| BatchUpdateCdnDomain | BatchUpdateCdnDomain | Updates the configurations of multiple accelerated domain names at a time. |
| DeleteSpecificConfig | DeleteSpecificConfig | Deletes specified configurations of an accelerated domain name. |
| ModifyCdnDomainSchdmByProperty | ModifyCdnDomainSchdmByProperty | Changes the acceleration region for an accelerated domain name. |
| ModifyCdnDomain | ModifyCdnDomain | Modifies the configuration of an accelerated domain name. |
| Domain name configuration management in the staging environment | Domain name configuration management in the staging environment | |
| DescribeCdnDomainStagingConfig | DescribeCdnDomainStagingConfig | Queries the configurations of features in the staging environment. |
| SetCdnDomainStagingConfig | SetCdnDomainStagingConfig | Configures a domain name to be accelerated in the staging environment. |
| RollbackStagingConfig | RollbackStagingConfig | Rolls back configurations in the staging environment. After you call this operation, all configurations in the staging environment are cleared. |
| PublishStagingConfigToProduction | PublishStagingConfigToProduction | Publishes the configurations of the staging environment to the production environment. |
| DeleteSpecificStagingConfig | DeleteSpecificStagingConfig | Deletes a specified configuration of the staging environment. |
| Security settings | Security settings | |
| SetWaitingRoomConfig | SetWaitingRoomConfig | Configures the virtual waiting room feature for an accelerated domain name. This operation is available only for accelerated domain names of the Dynamic CDN workload type. |
| DescribeCdnUserConfigs | DescribeCdnUserConfigs | Queries configurations of security features. |
| DescribeBlockedRegions | DescribeBlockedRegions | Queries countries and regions that can be added to the blacklist. |
Refresh and prefetch
| API | Title | Description |
|---|---|---|
| DescribeRefreshQuota | DescribeRefreshQuota | DescribeRefreshQuota |
| PushObjectCache | PushObjectCache | Prefetches content from origin servers to points of presence (POPs). This reduces loads on origin servers because users can directly hit cache upon their first visits. |
| RefreshObjectCaches | RefreshObjectCaches | Refreshes files on Alibaba Cloud CDN points of presence (POPs). After files are refreshed, the original file content immediately becomes invalid. If clients request the original file content, Alibaba Cloud CDN forwards the requests to the origin server. Then, Alibaba Cloud CDN caches the latest content to the POPs and returns the content to the clients. Alibaba Cloud CDN allows you to refresh content from multiple URLs at the same time. |
| DescribeRefreshTasks | DescribeRefreshTasks | Queries the status of refresh or prefetch tasks that belong to an accelerated domain name. |
| DescribeRefreshTaskById | DescribeRefreshTaskById | Queries the statuses of refresh or prefetch tasks by task ID. |
| DescribePreloadDetailById | DescribePreloadDetailById | Queries the prefetch details of a task, including the prefetch progress of all resources in the task. Only users who are included in the whitelist can use this operation. If your bandwidth is greater than 100 Gbit/s, contact your business manager to apply for the whitelist. |
| DescribeCdnUserQuota | DescribeCdnUserQuota | Queries the quotas and usage of Alibaba Cloud CDN resources. |
Monitoring and usage analytics
| API | Title | Description |
|---|---|---|
| Resource monitoring | Resource monitoring | |
| Visit data | Visit data | |
| DescribeDomainPathData | DescribeDomainPathData | Queries monitoring data including the amount of network traffic and the number of visits by directory. |
| DescribeDomainQpsData | DescribeDomainQpsData | Queries the number of queries per second (QPS) for an accelerated domain name. The data is collected every 5 minutes. You can query data collected within the last 90 days. |
| DescribeDomainQpsDataByLayer | DescribeDomainQpsDataByLayer | Queries the number of queries per second (QPS) at a specific layer for one or more accelerated domain names. You can query data collected within the last 90 days. |
| DescribeDomainBpsData | DescribeDomainBpsData | Queries bandwidth monitoring data for one or more accelerated domain names. |
| DescribeDomainBpsDataByLayer | DescribeDomainBpsDataByLayer | Queries bandwidth data by protocol. |
| DescribeDomainBpsDataByTimeStamp | DescribeDomainBpsDataByTimeStamp | Queries the bandwidth data at a specified time for an accelerated domain. |
| DescribeDomainTrafficData | DescribeDomainTrafficData | Queries network traffic for one or more accelerated domain names. You can query data that is collected in the last 90 days. |
| DescribeDomainHttpCodeData | DescribeDomainHttpCodeData | Queries the total number and proportions of HTTP status codes returned from an accelerated domain name. The data is collected every 5 minutes. |
| DescribeDomainHttpCodeDataByLayer | DescribeDomainHttpCodeDataByLayer | Queries HTTP status codes by protocol. |
| DescribeDomainHitRateData | DescribeDomainHitRateData | Queries byte hit ratios that are measured in percentage. |
| DescribeDomainReqHitRateData | DescribeDomainReqHitRateData | Queries the request hit ratio in percentage. |
| DescribeDomainsUsageByDay | DescribeDomainsUsageByDay | Queries the monitoring data of an accelerated domain name. Data is collected every day. You can query data collected within the last 90 days. |
| DescribeDomainDetailDataByLayer | DescribeDomainDetailDataByLayer | The domain name that you want to query. You can specify multiple domain names and separate them with commas (,). You can specify at most 30 domain names in each call. |
| DescribeRangeDataByLocateAndIspService | DescribeRangeDataByLocateAndIspService | Queries the bandwidth values by Internet service provider (ISP) and region. |
| Source data | Source data | |
| DescribeDomainSrcBpsData | DescribeDomainSrcBpsData | Queries bandwidth monitoring data of requests that are redirected to origin servers for one or more accelerated domain names. |
| DescribeDomainSrcHttpCodeData | DescribeDomainSrcHttpCodeData | Queries the proportions of HTTP status codes that are returned during back-to-origin routing. |
| DescribeDomainSrcTrafficData | DescribeDomainSrcTrafficData | Queries origin traffic for one or more specified accelerated domain names. |
| DescribeDomainSrcQpsData | DescribeDomainSrcQpsData | Queries the number of queries per second (QPS) that are sent to the origin server. You can query data collected in the last 90 days. |
| Real-time Monitoring | Real-time Monitoring | |
| Visit data | Visit data | |
| DescribeDomainRealTimeTrafficData | DescribeDomainRealTimeTrafficData | Queries the monitoring data of network traffic for one or more accelerated domain names. |
| DescribeDomainRealTimeBpsData | DescribeDomainRealTimeBpsData | Queries the bandwidth data about one or more accelerated domain names. |
| DescribeDomainRealTimeHttpCodeData | DescribeDomainRealTimeHttpCodeData | Queries the total number and proportions of HTTP status codes returned from an accelerated domain name. |
| DescribeDomainRealTimeQpsData | DescribeDomainRealTimeQpsData | Queries the number of queries per second for one or more accelerated domain names. |
| DescribeDomainRealTimeReqHitRateData | DescribeDomainRealTimeReqHitRateData | Queries the request hit ratios for one or more accelerated domain names. |
| DescribeDomainRealTimeByteHitRateData | DescribeDomainRealTimeByteHitRateData | Queries the byte hit ratios of accelerated domain names. |
| Source data | Source data | |
| DescribeDomainRealTimeSrcBpsData | DescribeDomainRealTimeSrcBpsData | Queries origin bandwidth data for accelerated domain names. |
| DescribeDomainRealTimeSrcHttpCodeData | DescribeDomainRealTimeSrcHttpCodeData | Queries the total number and proportions of HTTP status codes returned during back-to-origin routing. |
| DescribeDomainRealTimeSrcTrafficData | DescribeDomainRealTimeSrcTrafficData | Queries the monitoring data of back-to-origin traffic for one or more specified accelerated domains. The data is collected every minute. |
| EdgeScript (ES) monitoring | EdgeScript (ES) monitoring | |
| DescribeEsExecuteData | DescribeEsExecuteData | Queries the execution status of scripts in EdgeScript (ES). |
| DescribeEsExceptionData | DescribeEsExceptionData | Queries the execution errors of a script in EdgeScript (ES). |
Resource usage management
| API | Title | Description |
|---|---|---|
| DescribeCdnUserBillHistory | DescribeCdnUserBillHistory | Queries the billing history under your Alibaba Cloud account. |
| DescribeCdnUserBillPrediction | DescribeCdnUserBillPrediction | Estimates resource usage of the current month. |
| CreateUserUsageDataExportTask | CreateUserUsageDataExportTask | Creates a task to export your resource usage history to a PDF file. |
| DescribeUserUsageDataExportTask | DescribeUserUsageDataExportTask | Queries usage export tasks that were created in the last three months. |
| DeleteUserUsageDataExportTask | DeleteUserUsageDataExportTask | Deletes a task that was used to export usage history. |
| CreateUsageDetailDataExportTask | CreateUsageDetailDataExportTask | Creates a task to export resource usage details to an Excel file. |
| DescribeUserUsageDetailDataExportTask | DescribeUserUsageDetailDataExportTask | Queries tasks that were used to export resource usage details of one or more accelerated domain names that belong to your Alibaba Cloud account. Resource usage information is collected every five minutes. |
| DeleteUsageDetailDataExportTask | DeleteUsageDetailDataExportTask | Deletes a task that was used to export usage details. |
| DescribeDomainUsageData | DescribeDomainUsageData | Queries the resource usage data of specific domain names in a specified billable region. |
| DescribeCdnUserResourcePackage | DescribeCdnUserResourcePackage | Queries the resource plans that you have purchased for Alibaba Cloud CDN. |
Log management
| API | Title | Description |
|---|---|---|
| Log operations | Log operations | |
| DeleteRealTimeLogLogstore | DeleteRealTimeLogLogstore | Deletes the Logstore that is used by a specified configuration record of real-time log delivery. |
| CreateRealTimeLogDelivery | CreateRealTimeLogDelivery | Enables real-time log delivery for specific accelerated domain names. |
| ModifyRealtimeLogDelivery | ModifyRealtimeLogDelivery | Modifies the configurations of real-time log delivery for a specific domain name. Each domain name supports only one Logstore. |
| DeleteRealtimeLogDelivery | DeleteRealtimeLogDelivery | Deletes the configurations of real-time log delivery for specific accelerated domain names. |
| DisableRealtimeLogDelivery | DisableRealtimeLogDelivery | Disables real-time log delivery for specific accelerated domain names. |
| EnableRealtimeLogDelivery | EnableRealtimeLogDelivery | Enables real-time log delivery for an accelerated domain name. |
| DescribeDomainRealtimeLogDelivery | DescribeDomainRealtimeLogDelivery | Queries the real-time log delivery information about an accelerated domain name. |
| DescribeRealtimeDeliveryAcc | DescribeRealtimeDeliveryAcc | Queries the number of real-time log deliveries. |
| ListRealtimeLogDeliveryInfos | ListRealtimeLogDeliveryInfos | Queries the information about the real-time log delivery feature in a specified region. |
| ListRealtimeLogDeliveryDomains | ListRealtimeLogDeliveryDomains | Queries all domain names that are associated with a specific real-time log delivery configuration record. |
| Offline logs | Offline logs | |
| DescribeDomainCustomLogConfig | DescribeDomainCustomLogConfig | Queries the custom log configuration of an accelerated domain name. |
| DescribeCustomLogConfig | DescribeCustomLogConfig | Queries the details about a custom logging configuration. |
| DescribeCdnDomainLogs | DescribeCdnDomainLogs | Queries the address where you can download the log data of a specific domain name. |
| ListDomainsByLogConfigId | ListDomainsByLogConfigId | Queries domain names by log configuration ID. |
| ListUserCustomLogConfig | ListUserCustomLogConfig | Queries all custom log configurations in your account. |
Service management
| API | Title | Description |
|---|---|---|
| OpenCdnService | OpenCdnService | Activates Alibaba Cloud CDN. You must activate Alibaba Cloud CDN before you can manage domain names in Alibaba Cloud CDN. |
| DescribeCdnRegionAndIsp | DescribeCdnRegionAndIsp | Queries Internet service providers (ISPs) and regions that are supported by Alibaba Cloud CDN. |
| DescribeCdnOrderCommodityCode | DescribeCdnOrderCommodityCode | Queries the code of a commodity by account UID. |
| DescribeCdnService | DescribeCdnService | Queries the status of your Alibaba Cloud CDN service. The information includes the service activation time, the current service status, the current metering method, and the metering method for the next cycle. |
Certificate management
| API | Title | Description |
|---|---|---|
| SetDomainServerCertificate | SetDomainServerCertificate | Configures an SSL certificate for an accelerated domain name. |
| BatchSetCdnDomainServerCertificate | BatchSetCdnDomainServerCertificate | Enables, disables, or configures the SSL certificates of one or more accelerated domain names at a time. |
| DescribeCdnDomainByCertificate | DescribeCdnDomainByCertificate | Queries accelerated domain names by SSL certificate. |
| DescribeDomainCertificateInfo | DescribeDomainCertificateInfo | Queries the certificate information of an accelerated domain name. |
| DescribeCdnCertificateDetail | DescribeCdnCertificateDetail | Queries the detailed information about an SSL certificate. |
| DescribeCdnCertificateList | DescribeCdnCertificateList | Queries the certificates of accelerated domain names. |
| DescribeCdnSSLCertificateList | DescribeCdnSSLCertificateList | Queries the certificate list by domain name. |
| DescribeCdnHttpsDomainList | DescribeCdnHttpsDomainList | Queries the information about SSL certificates that belong to your Alibaba Cloud account. |
| DescribeCertificateInfoByID | DescribeCertificateInfoByID | Queries the information about a specific certificate by certificate ID. |
| DescribeCdnCertificateDetailById | DescribeCdnCertificateDetailById | Queries certificate details by certificate ID. |
| DescribeUserCertificateExpireCount | DescribeUserCertificateExpireCount | Queries the number of domain names whose SSL certificates are about to expire or have already expired. |
| CreateCdnCertificateSigningRequest | CreateCdnCertificateSigningRequest | Creates a certificate signing request (CSR). |
| SetCdnDomainCSRCertificate | SetCdnDomainCSRCertificate | You can call this operation to configure an SSL certificate for a specific domain name. |
| SetCdnDomainSMCertificate | SetCdnDomainSMCertificate | Enables or disables a ShangMi (SM) certificate for a domain name. |
| DescribeCdnSMCertificateList | DescribeCdnSMCertificateList | Queries the ShangMi (SM) certificates of an accelerated domain name. |
| DescribeCdnSMCertificateDetail | DescribeCdnSMCertificateDetail | Queries the details about a ShangMi (SM) certificate. |
| SetCdnDomainSSLCertificate | SetCdnDomainSSLCertificate | Enables or disables the certificate for a domain name and updates the certificate information. |
Tag management
| API | Title | Description |
|---|---|---|
| TagResources | TagResources | Adds one or more tags to specific resources. |
| DescribeTagResources | DescribeTagResources | Queries tags that are added to specified resources. |
| DescribeUserTags | DescribeUserTags | Queries user tags. |
| UntagResources | UntagResources | Removes tags from specified resources. |
| ListTagResources | ListTagResources | Queries the tags that are attached to a resource. |
Operations reports
| API | Title | Description |
|---|---|---|
| CreateCdnSubTask | CreateCdnSubTask | Creates a custom operations report. |
| DescribeCdnSubList | DescribeCdnSubList | Queries the tracking tasks that you have created. |
| UpdateCdnSubTask | UpdateCdnSubTask | Updates one or more operations reports. |
| DeleteCdnSubTask | DeleteCdnSubTask | The ID of the request. |
| DescribeCdnReport | DescribeCdnReport | Queries the content of an operations report. |
| DescribeCdnReportList | DescribeCdnReportList | Queries custom operations reports. |
| CreateCdnDeliverTask | CreateCdnDeliverTask | Creates a tracking task. After you create a tracking task, the system sends operations reports to you by email on a regular basis. |
| DescribeCdnDeliverList | DescribeCdnDeliverList | Queries one or more tracking tasks of operations reports. |
| UpdateCdnDeliverTask | UpdateCdnDeliverTask | Updates a tracking task. |
| DeleteCdnDeliverTask | DeleteCdnDeliverTask | Deletes tracking tasks by task ID. |
Auxiliary tool operations
| API | Title | Description |
|---|---|---|
| DescribeIpInfo | DescribeIpInfo | Checks whether a specified IP address is the IP address of a CDN point of presence (POP). |
| DescribeStagingIp | DescribeStagingIp | Queries node IP addresses in the staging environment. |
| DescribeL2VipsByDomain | DescribeL2VipsByDomain | Queries the virtual IP addresses (VIPs) of L2 CDN points of presence (POPs) for a specific domain name. |
| DescribeUserVipsByDomain | DescribeUserVipsByDomain | Queries virtual IP addresses (VIPs) of CDN points of presence (POPs) by domain name. |
| DescribeIpStatus | DescribeIpStatus | Queries the status of IP addresses of points of presence (POPs). The status of an IP address of a POP indicates whether content delivery acceleration is supported by the POP. |
| AddFCTrigger | AddFCTrigger | Adds a Function Compute trigger. |
| UpdateFCTrigger | UpdateFCTrigger | Updates a specified Function Compute trigger. |
| DescribeFCTrigger | DescribeFCTrigger | Queries a specified Function Compute trigger. |
| DeleteFCTrigger | DeleteFCTrigger | Deletes a specified Function Compute trigger. |
| ListFCTrigger | ListFCTrigger | Queries the Function Compute trigger that is set for an Alibaba Cloud CDN event. |
Security information query
| API | Title | Description |
|---|---|---|
| DescribeDomainCcActivityLog | DescribeDomainCcActivityLog | Queries log entries of rate limiting. |
Others
| API | Title | Description |
|---|---|---|
| ModifyCdnDomainOwner | ModifyCdnDomainOwner | Transfer domain names from an Alibaba Cloud account to the current account. |
| DescribeCdnConditionIPBInfo | DescribeCdnConditionIPBInfo | Queries the Internet service provider (ISP), region, and country that are required for advanced conditions. |
| ChangeCdnDomainToDcdn | ChangeCdnDomainToDcdn | Transfer a domain name from Alibaba Cloud CDN to DCDN. |
| DescribeCdnSecFuncInfo | DescribeCdnSecFuncInfo | Queries information about security features of Alibaba Cloud CDN. |
| CheckCdnDomainExist | CheckCdnDomainExist | Checks whether a domain name exists. |
| DescribeCdnMigrateRegisterStatus | DescribeCdnMigrateRegisterStatus | Queries the registration status of the dynamic routing feature of Dynamic Content Delivery Network (DCDN) for a domain name that is added to Alibaba Cloud CDN. |
| CdnMigrateRegister | CdnMigrateRegister | Registers the dynamic routing feature of Dynamic Content Delivery Network (DCDN) for an Alibaba Cloud CDN-accelerated domain name. After the registration is successful, the routing center generates the dynamic routing information and send it to DCDN points of presence (POPs). This is a prerequisite for you to transfer a domain name from Alibaba Cloud CDN to DCDN. |
| CheckCdnDomainICP | CheckCdnDomainICP | Checks whether an ICP filing is obtained for the domain name. |
| BatchDescribeCdnIpInfo | BatchDescribeCdnIpInfo | Queries whether one or more IP addresses are assigned to Alibaba Cloud CDN. |