edit-icon download-icon

DescribeLiveDomainSnapshotData

Last Updated: Apr 09, 2018

Description

Obtain the number of screenshot data of a live domain name.

  • Support query of the daily screenshot number of a single domain name in a specified time range.

  • Support query of data starting from January 1, 2018. The maximum interval between Starttime and Endtime is 90 days.

Request parameters

Parameters Type Required Example Values Description
Action String Yes DescribeLiveDomainSnapshotData

The name of this interface name. Value: DescribeLiveDomainSnapshotData

DomainName String Yes www.livetest.com

The live domain name to be queried.

StartTime String Yes 2018-01-01T00:00:00Z

Start time of data query.

  • The date format adopts ISO8601 notation and uses the UTC time.
  • Format: YYYY-MM-DDThh:mm:ssZ.
  • Support query of data starting from January 1, 2018, that is, StartTime≥2018-01-01T00:00:00Z.

EndTime String Yes 2018-01-02T00:00:00Z

End time of data query.

  • EndTime must be later than Starttime.
  • The date format adopts ISO8601 notation and uses the UTC time.
  • Format: YYYY-MM-DDThh:mm:ssZ.

Return parameters

Parameters Type Example Values Description
SnapshotDataInfos

Daily statistics of the number of live screenshots.

  └Date String 20180209

Date, accurate to date.

  └Total Integer 110

Total number of screenshots on a single day.

RequestId String B955107D-E658-4E77-B913-E0AC3D31693F

Request ID.

Example

Request example

  1. /?Action=DescribeLiveDomainSnapshotData
  2. &DomainName=www.livetest.com
  3. &EndTime=2018-02-09T00:00:00Z
  4. &StartTime=2018-02-10T00:00:00Z
  5. &<Public request parameter>

Normal return example

JSON format

  1. {
  2. "RequestId":"0B250400-6260-4CBC-85BF-FB0ED3753690",
  3. "SnapshotDataInfos":{
  4. "SnapshotDataInfo":[
  5. {
  6. "Date":"20180209",
  7. "Total":110
  8. },
  9. {
  10. "Date":"20180210",
  11. "Total":310
  12. }
  13. ]
  14. }
  15. }

Exception return example

JSON format

  1. {
  2. "Code":"InvalidEndTime.BeyondCurrent",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"EndTime beyond current time.",
  5. "RequestId":"D561201C-1192-4BCB-BDA9-AD16AA62F6FD"
  6. }

Error code

For more information about error code of this product, see Error code.

Thank you! We've received your feedback.