Document Center

DescribeDomainUvData

Last Updated: Apr 02, 2018

Description

  • Obtain the independent UV page access statistics of a CDN domain. The minimum granularity is 1 hour.

  • When StartTime and EndTime are not specified, the system reads data from the past 24 hours by default. Query by specified start time and end time is also supported. The two parameters must be both specified.

    • The system supports query of only one domain name or all domain names belonging to the current user.

    • Data from the past 90 days can be obtained at most.

Request parameters

Parameters Type Required Example values Description
Action String Yes DescribeDomainUvData

The name of this interface. Value: DescribeDomainUvData
DomainName String No test.test.com

CDN domain name to be queried. This parameter can be set to support only one domain name. If this parameter is left blank, all domain names belonging to the current user are queried.

EndTime String No 2015-11-29

  • The end time must be later than the start time.
  • The date format adopts ISO8601 notation and uses the UTC time.
  • Format: YYYY-MM-DDThh:mmZ.
StartTime String No 2015-11-29

Start time of data query.

  • The date format adopts ISO8601 notation and uses the UTC time.
  • Format: YYYY-MM-DDThh:mmZ
  • The minimum data granularity is 1 hour.
  • If this parameter is left blank, data from the past 24 hours is read by default.

Return parameters

Parameters Type Example values Description
RequestId String E9D3257A-1B7C-414C-90C1-8D07AC47BCAC

The ID of the request.

DomainName String ttest.test.com

CDN domain name to be quuried.

DataInterval String 3600

Time interval.

StartTime String 2015-11-30

Start time of data query.

EndTime String 2015-11-30

End time of data query.

UvDataInterval

Data.

  └TimeStamp String 2015-11-29T20:00:00Z

Time stamp.

  └Value String 318

UV.

Example

Request example

  1. http://cdn.aliyuncs.com?Action=DescribeDomainUvData&DomainName=test.com
  2. &StartTime=2015-11-29
  3. &EndTime=2015-11-30
  4. &<public request parameter>

Normal return example

JSON format

  1. {
  2.     "DataInterval":"3600",
  3.     "DomainName":"test.com",
  4.     "EndTime":"2015-11-30",
  5.     "RequestId":"E9D3257A-1B7C-414C-90C1-8D07AC47BCAC",
  6.     "StartTime":"2015-11-29",
  7.     "UvDataInterval":{
  8.         "UsageData":[
  9.             {
  10.                 "TimeStamp":"2015-11-29T20:00:00Z",
  11.                 "Value":"318"
  12.             },
  13.             {
  14.                 "TimeStamp":"2015-11-29T18:00:00Z",
  15.                 "Value":"318"
  16.             },
  17.             {
  18.                 "TimeStamp":"2015-11-29T03:00:00Z",
  19.                 "Value":"329"
  20.             },
  21.             {
  22.                 "TimeStamp":"2015-11-29T21:00:00Z",
  23.                 "Value":"316"
  24.             },
  25.             {
  26.                 "TimeStamp":"2015-11-29T07:00:00Z",
  27.                 "Value":"319"
  28.             },
  29.             {
  30.                 "TimeStamp":"2015-11-29T00:00:00Z",
  31.                 "Value":"326"
  32.             },
  33.             {
  34.                 "TimeStamp":"2015-11-29T11:00:00Z",
  35.                 "Value":"321"
  36.             },
  37.             {
  38.                 "TimeStamp":"2015-11-29T10:00:00Z",
  39.                 "Value":"313"
  40.             },
  41.             {
  42.                 "TimeStamp":"2015-11-29T08:00:00Z",
  43.                 "Value":"331"
  44.             },
  45.             {
  46.                 "TimeStamp":"2015-11-29T01:00:00Z",
  47.                 "Value":"324"
  48.             },
  49.             {
  50.                 "TimeStamp":"2015-11-29T04:00:00Z",
  51.                 "Value":"330"
  52.             },
  53.             {
  54.                 "TimeStamp":"2015-11-29T14:00:00Z",
  55.                 "Value":"335"
  56.             },
  57.             {
  58.                 "TimeStamp":"2015-11-29T12:00:00Z",
  59.                 "Value":"318"
  60.             },
  61.             {
  62.                 "TimeStamp":"2015-11-29T23:00:00Z",
  63.                 "Value":"310"
  64.             },
  65.             {
  66.                 "TimeStamp":"2015-11-29T17:00:00Z",
  67.                 "Value":"309"
  68.             },
  69.             {
  70.                 "TimeStamp":"2015-11-29T22:00:00Z",
  71.                 "Value":"320"
  72.             },
  73.             {
  74.                 "TimeStamp":"2015-11-29T16:00:00Z",
  75.                 "Value":"309"
  76.             },
  77.             {
  78.                 "TimeStamp":"2015-11-29T02:00:00Z",
  79.                 "Value":"317"
  80.             },
  81.             {
  82.                 "TimeStamp":"2015-11-29T06:00:00Z",
  83.                 "Value":"309"
  84.             },
  85.             {
  86.                 "TimeStamp":"2015-11-29T19:00:00Z",
  87.                 "Value":"308"
  88.             },
  89.             {
  90.                 "TimeStamp":"2015-11-29T13:00:00Z",
  91.                 "Value":"347"
  92.             },
  93.             {
  94.                 "TimeStamp":"2015-11-29T15:00:00Z",
  95.                 "Value":"341"
  96.             },
  97.             {
  98.                 "TimeStamp":"2015-11-29T05:00:00Z",
  99.                 "Value":"347"
  100.             },
  101.             {
  102.                 "TimeStamp":"2015-11-29T09:00:00Z",
  103.                 "Value":"312"
  104.             }
  105.         ]
  106.     }
  107. }

Exception return example

JSON format 

  1. {
  2.     "Code":"InternalError",
  3.     "HostId":"cdn.aliyuncs.com",
  4.     "Message":"The request processing has failed due to some unknown error.",
  5.     "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  6. }

Error code

For more information, see Error code of this product.

Thank you! We've received your feedback.
Free Trial Free Trial