This topic describes the differences between the former and new CDN API versions.

Updated operations

Operation name (former version) Details of changes
DescribeDomainFlowData The operation name was changed to DescribeDomainTrafficData.
  • DescribeDomainBpsData
  • DescribeDomainHitRateData
  • DescribeDomainHttpCodeData
  • DescribeDomainQpsData
  • DescribeDomainTrafficData
  • The time format was changed from YYYY-MM-DDThh:mmZ to YYYY-MM-DDThh:mm:ssZ.
  • The fixTimeGap and timeMerge parameters were removed.
  • The parameters for static and dynamic data were removed.
AddCdnDomain The following request parameters were removed:
  • SourceType
  • SourcePort
  • Priorities
  • Region
ModifyCdnDomain
  • The SourceType, SourcePort, and Priorities parameters were removed.
  • The format of the Sources parameter was changed to [{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}].
DescribeCdnDomainDetail
  • The SourceType, Sources, SourcePort, and Region response parameters were removed.
  • Descriptions were added for the Description, Scope, and CertificateName response parameters.
DescribeDomainBpsData
  • The maximum time range for a data query was changed from the last 90 days to 90 days.
  • The DomainType request parameter was removed.
  • The description for the Interval request parameter was changed. In the former version, you can set the data sampling interval to 300, 3600, 14400, 28800, or 86400 seconds. If you do not specify this parameter or the specified value is invalid, the default value of 300 seconds is used. In the new version:
    • Valid values: 300, 3600, and 86400 seconds.
    • If you do not specify this parameter or the specified value is invalid, the default value is used. For a time range that does not exceed 3 days, the default value is 300 seconds. For a time range that is from 3 days to 30 days, the default value is 3600 seconds. For a time range that exceeds 30 days, the default value is 86400 seconds.
  • Descriptions were added for the LocationNameEn and IspNameEn response parameters.
  • The description for the SupplyBpsDatas response parameter was removed.
DescribeCdnDomainLogs
  • The time format was changed from YYYY-MM-DDThh:mmZ to YYYY-MM-DDThh:mm:ssZ.
  • The LogDay request parameter was removed.
  • The response parameter format was adjusted. For more information, see the following sample response.
DeleteSpecificConfig The FunctionName parameter was removed.
DescribeDomainAverageResponseTime The time format was changed from YYYY-MM-DDThh:mmZ to YYYY-MM-DDThh:mm:ssZ.
DescribeUserDomains
  • The SourceType response parameter was removed.
  • The Sources request parameter was removed.
  • The format of the Sources response parameter was adjusted.
DescribeDomainRegionData
  • The time format was changed from YYYY-MM-DDThh:mmZ to YYYY-MM-DDThh:mm:ssZ.
  • The maximum time range for a data query was changed from the last 90 days to 90 days.
  • The ByteHitRate, ReqErrRate, and ReqHitRate response parameters were removed.
DescribeExtensiveDomainData
  • The time format was changed from YYYY-MM-DDThh:mmZ to YYYY-MM-DDThh:mm:ssZ.
  • The ExtensiveDomain request parameter no longer checks the validity of wildcard domains.
  • The limit of only data in the last 90 days can be queried was removed.
  • In the new version, you must specify both the beginning and end of the time range to query.
DescribeDomainBpsDataByTimeStam The time format was changed from YYYY-MM-DDThh:mmZ to YYYY-MM-DDThh:mm:ssZ.
  • DescribeDomainFileSizeProportion
  • DescribeDomainPvData
  • DataDescribeDomainUvData
  • The time format was changed from YYYY-MM-DDThh:mmZ to YYYY-MM-DDThh:mm:ssZ.
  • The DomainName request parameter was changed from optional to required.
  • DescribeDomainMax95BpsData
  • DescribeDomainsUsageByDay
  • DescribeDomainReqHitRateData
  • DescribeTopDomainsByFlow
  • The time format was changed from YYYY-MM-DDThh:mmZ to YYYY-MM-DDThh:mm:ssZ.
  • The maximum time range for a data query was changed from the last 90 days to 90 days.
  • DescribeDomainTopReferVisit
  • DescribeDomainTopUrlVisit
The DomainName request parameter was changed from optional to required.
DescribeDomainHttpsData
  • The DomainType, TimeMerge, Cls, and FixTimeGap request parameters were removed.
  • The time format was changed from YYYY-MM-DDThh:mmZ to YYYY-MM-DDThh:mm:ssZ.
  • The maximum time range for a data query was changed from the last 90 days to 90 days.
  • The response parameters for static and dynamic data were removed.
  • SetPageCompressConfig
  • SetIgnoreQueryStringConfig
  • SetVideoSeekConfig
  • SetOptimizeConfig
  • SetRemoveQueryStringConfig
The valid parameter values were changed from On/Off to on/off.
SetFileCacheExpiredConfig The Weight parameter was removed.
SetIpBlackListConfig You can no longer leave parameters empty.
DeleteCacheExpiredConfig The required parameter CacheType was removed.
{
"RequestId": "1805F349-0A2B-41D9-B4AD-33632AFC27F1",
"DomainLogModel": {
"DomainName": "example.com",
"DomainLogDetails": {
"DomainLogDetail": [
{
"EndTime": "2015-05-23T04:00:00Z",
"LogName": "example.com_2015_05_23_1100_1200.gz",
"LogPath": "cdnlog.cn-hangzhou.oss.aliyun-inc.com/example.com/2015_05_23/example.com_2015_05_23_1100_1200.gz? OSSAccessKeyId\u003d3xmgf7Jhexxxxxx\u0026Expires\u003d143253xxxx\u0026Signature\u003d7Ly4ccKN3afzAGYyWDbxBcOxxxxx",
"LogSize": 257,
"StartTime": "2015-05-23T03:00:00Z"
}
]
}
},
"PageNumber": 1,
"TotalCount": 3,
"PageSize": 100
}
--------->
{
"RequestId": "077D0284-F041-4A41-A932-B48377FDAA25",
"DomainLogDetails": {
"DomainLogDetail": [
{
"LogInfos": {
"LogInfoDetail": [
{
"LogName": "test1.test.com_2018_03_25_180000_190000.gz",
"LogPath": "cdnlog2.aliyuncs.com/test1.test.com/2018_03_25/test1.test.com_2018_03_25_180000_190000.gz? Expires=1522659xxx&OSSAccessKeyId=test&Signature=suZFyJHoD3RzZqK%2Bcu6P4Vaxxxx",
"EndTime": "1521975600",
"StartTime": "1521972000",
"LogSize": 2645401
}
]
},
"LogCount": 20,
"PageInfos": {
"PageNumber": 1,
"PageSize": 20,
"Total": 20
},
"DomainName": "test1.test.com"
}
]
}
}

Unchanged operations

The following operations remain unchanged:

  • StartCdnDomain
  • StopCdnDomain
  • DeleteCdnDomain
  • PushObjectCache
  • RefreshObjectCaches
  • PreloadObjectCaches
  • PurgeObjectCaches
  • OpenCdnService
  • ModifyCdnService
  • BlockObjectCaches
  • DescribeUserConfigs
  • DescribeCdnService
  • DescribeCdnTypes
  • SetDomainServerCertificate
  • DescribeDomainCertificateInfo
  • BatchDeleteCdnDomainConfig
  • BatchStartCdnDomain
  • BatchStopCdnDomain
  • SetRangeConfig
  • SetUserAgentAcessRestriction
  • BatchSetCdnDomainConfig
  • SetL2OssKeyConfig
  • SetForwardSchemeConfig
  • SetPathCacheExpiredConfig
  • SetForceRedirectConfig
  • SetReqAuthConfig
  • SetErrorPageConfig
  • SetIpAllowListConfig
  • SetDomainGreenManagerConfig
  • SetHttpErrorPageConfig
  • SetCcConfig
  • SetHttpsOptionConfig
  • SetSourceHostConfig
  • SetRemoteReqAuthConfig
  • SetUserGreenManagerConfig
  • SetHttpHeaderConfig
  • SetRefererConfig
  • SetReqHeaderConfig
  • ModifyFileCacheExpiredConfig
  • ModifyPathCacheExpiredConfig
  • ModifyHttpHeaderConfig
  • DeleteHttpHeaderConfig

Newly added operations

The following operations were added to the new version:

  • DescribeDomainSrcHttpCodeData
  • DescribeDomainAverageResponseTime
  • DescribeDomainRealTimeSrcBpsData
  • DescribeDomainRealTimeSrcHttpCodeData
  • DescribeDomainRealTimeSrcTrafficData
  • DescribeDomainRealTimeHttpCodeData
  • DescribeDomainRealTimeTrafficData
  • DescribeDomainSrcTrafficData
  • DescribeDomainTrafficData
  • BatchAddCdnDomain
  • BatchStartCdnDomain
  • BatchStopCdnDomain
  • BatchSetCdnDomainConfig
  • DescribeCdnCertificateList
  • DescribeDomainCertificateInfo
  • DescribeCdnDomainConfigs
  • DescribeUserVipsByDomain
  • DescribeCdnHttpsDomainList
  • CreateRealtimeLogDelivery
  • DeleteRealtimeLogDelivery
  • DescribeDomainRealtimeLogDelivery
  • DescribeRealtimeDeliveryAcc
  • DisableRealtimeLogDelivery
  • EnableRealtimeLogDelivery
  • ListRealtimeLogDeliveryDomains
  • ModifyRealtimeLogDelivery
  • ListRealtimeLogDeliveryInfos
  • ListUserCustomLogConfig
  • DescribeCdnUserResourcePackage
  • DescribeCdnUserResourcePackage
  • DescribeUserUsageDataExportTask
  • CreateUserUsageDataExportTask
  • CreateUsageDetailDataExportTask
  • DescribeUserUsageDetailDataExportTask
  • DescribeUserUsageDetailDataExportTask
  • DescribeTagResources
  • DescribeUserTags
  • TagResources
  • UntagResources