本文档为您介绍了CDN新旧两个版本API接口的差异。

旧版API文档请参见旧版API参考。
说明 旧版API将不再维护，请您使用新版API。

涉及变更接口

旧版接口名 变更详情
DescribeDomainFlowData 变更为：DescribeDomainTrafficData。
  • DescribeDomainBpsData
  • DescribeDomainHitRateData
  • DescribeDomainHttpCodeData
  • DescribeDomainQpsData
  • DescribeDomainTrafficData
  • 时间格式由YYYY-MM-DDThh:mmZ变更为YYYY-MM-DDThh:mm:ssZ。
  • 去掉fixTimeGap和timeMerge参数。
  • 去掉动态和静态数据。
AddCdnDomain 去掉如下入参：
  • SourceType
  • SourcePort
  • Priorities
  • Region
ModifyCdnDomain
  • 去掉SourceType、SourcePort、Priorities参数。
  • 参数Sources格式改为： [{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]。
DescribeCdnDomainDetail
  • 去掉SourceType、Sources、SourcePort、Region出参。
  • 补充Description、Scope、CertificateName出参说明。
DescribeDomainBpsData
  • 最多可获取最近90天的数据变更为：最多可获取90天的数据。
  • 去掉DomainType入参。
  • 入参Interval说明变更为查询数据时间粒度由支持300, 3600, 14400, 28800和86400秒，不传和传的值不支持时，默认值300秒变更为：
    • 支持300，3600，86400秒。
    • 不传和传的值不支持时，时间跨度不超过3天，默认值300秒；超过3天默认值3600秒，超过30天默认值86400秒。
  • 补充LocationNameEn、IspNameEn出参说明。
  • 去掉SupplyBpsDatas出参说明。
DescribeCdnDomainLogs
  • 时间格式由YYYY-MM-DDThh:mmZ变更为：YYYY-MM-DDThh:mm:ssZ。
  • 去掉LogDay入参。
  • 出参模型调整，详情请见下方。
DeleteSpecificConfig 去掉FunctionName参数。
DescribeDomainAverageResponseTime 时间格式由YYYY-MM-DDThh:mmZ变更为：YYYY-MM-DDThh:mm:ssZ。
DescribeUserDomains
  • 去掉SourceType出参。
  • 去掉Sources入参。
  • 出参Sources格式调整。
DescribeDomainRegionData
  • 时间格式由YYYY-MM-DDThh:mmZ变更为：YYYY-MM-DDThh:mm:ssZ。
  • 最多可获取最近90天的数据变更为：最多可获取90天的数据。
  • 去掉ByteHitRate、ReqErrRate、ReqHitRate出参。
DescribeExtensiveDomainData
  • 时间格式由YYYY-MM-DDThh:mmZ变更为：YYYY-MM-DDThh:mm:ssZ。
  • 去掉ExtensiveDomain入参泛域名格式是否合法。
  • 去掉只能查询最近90天内的数据校验。
  • 不支持不传时间默认时间范围的查询，起止时间改成必传。
DescribeDomainBpsDataByTimeStam 时间格式由YYYY-MM-DDThh:mmZ变更为：YYYY-MM-DDThh:mm:ssZ。
  • DescribeDomainFileSizeProportion
  • DescribeDomainPvData
  • DataDescribeDomainUvData
  • 时间格式由YYYY-MM-DDThh:mmZ变更为：YYYY-MM-DDThh:mm:ssZ。
  • 入参DomainName改成必传。
  • DescribeDomainMax95BpsData
  • DescribeDomainsUsageByDay
  • DescribeDomainReqHitRateData
  • DescribeTopDomainsByFlow
  • 时间格式由YYYY-MM-DDThh:mmZ变更为：YYYY-MM-DDThh:mm:ssZ。
  • 最多可获取最近90天的数据变更为：最多可获取90天的数据。
  • DescribeDomainTopReferVisit
  • DescribeDomainTopUrlVisit
 入参DomainName改成必传。
DescribeDomainHttpsData
  • 去掉DomainType、TimeMerge、Cls、FixTimeGap入参。
  • 时间格式由YYYY-MM-DDThh:mmZ变更为：YYYY-MM-DDThh:mm:ssZ。
  • 最多可获取最近90天的数据变更为：最多可获取90天的数据。
  • 去掉动态、静态数据的出参。
  • SetPageCompressConfig
  • SetIgnoreQueryStringConfig
  • SetVideoSeekConfig
  • SetOptimizeConfig
  • SetRemoveQueryStringConfig
 参数值由On/Off 变更为：on/off。
SetFileCacheExpiredConfig 去掉参数Weight。
SetIpBlackListConfig 不支持设置空值。
DeleteCacheExpiredConfig 去掉必填参数CacheType。 
{
"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"
}
]
}
}

未涉及变更接口

新旧版本没有变更的接口如下所示。

  • 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

新增接口

新版API新增如下接口。

  • 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