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

For more information about the former API version, see API Reference (former version).
Note We will stop maintaining the former API version soon. We recommend that you use the new API version.

Updated operations

Operation name (former version) Details of changes
DescribeDomainFlowData 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 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 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 time granularity to 300, 3600, 14400, 28800, or 86400 seconds. If you do not set this parameter or the specified value is invalid, the default value 300 is used. In the new version:
    • Valid values: 300, 3600, and 86400 seconds.
    • If you do not set the 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 exceeds 3 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 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 here.
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 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 the wildcard domain.
  • The limit of only data in the last 90 days can be queried was removed.
  • In new version, you must specify both the beginning and end of the time range where the data is queried.
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 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 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 parameter value was 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": "gc.ggter.com",
"DomainLogDetails": {
"DomainLogDetail": [
{
"EndTime": "2015-05-23T04:00:00Z",
"LogName": "gc.ggter.com_2015_05_23_1100_1200.gz",
"LogPath": "cdnlog.cn-hangzhou.oss.aliyun-inc.com/gc.ggter.com/2015_05_23/gc.ggter.com_2015_05_23_1100_1200.gz? OSSAccessKeyId\u003d3xmgf7JheOfOTUTf\u0026Expires\u003d1432539994\u0026Signature\u003d7Ly4ccKN3afzAGYyWDbxBcOcn2I%3D",
"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=1522659931&OSSAccessKeyId=test&Signature=suZFyJHoD3RzZqK%2Bcu6P4VaNAVI%3D",
"EndTime": "1521975600",
"StartTime": "1521972000",
"LogSize": 2645401
}
]
},
"LogCount": 20,
"PageInfos": {
"PageNumber": 1,
"PageSize": 20,
"Total": 20
},
"DomainName": "test1.test.com"
}
]
}
}

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

  • DescribeCdnUserQuota
  • DescribeCdnUserResourcePackage
  • DescribeCdnCertificateList