:DescribeDomainUsageData

Usage notes

• You can query the resource usage data of up to 100 domain names at a time. Separate domain names with commas (,). If you do not specify the DomainName parameter, the resource usage data of all domain names within your Alibaba Cloud account is returned.
• The resource usage data includes network traffic that is measured in bytes, bandwidth that is measured in bit/s, and the number of requests.
• If you do not specify the Interval parameter, you can query the resource usage data in the last 12 months that spans a period of up to 31 days per call. If you specify a time range of 1 to 3 days in a call, the time interval between the entries that are returned is 1 hour. If you specify a time range of more than 3 days in a call, the time interval between the entries that are returned is 1 day.
• The following table describes the maximum time range per query, the time period within which historical data is available, and the data delay if you specify the Interval parameter.

QPS limit

You can call this operation up to 10 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.

Request parameters

Response parameters

Examples

Sample requests

http://live.aliyuncs.com/?Action=DescribeDomainUsageData&DomainName=example.com
&StartTime=2015-12-10T20:00:00Z
&EndTime=2015-12-10T21:00:00Z
&Type=all
&Area=CN
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDomainUsageDataResponse>
    <DomainName>example.com</DomainName>
    <DataInterval>300</DataInterval>
    <UsageDataPerInterval>
        <DataModule>
            <TimeStamp>2015-12-10T20:00:00Z</TimeStamp>
            <Value>423304182</Value>
        </DataModule>
        <DataModule>
            <TimeStamp>2015-12-10T20:05:00Z</TimeStamp>
            <Value>454680793</Value>
        </DataModule>
        <DataModule>
            <TimeStamp>2015-12-10T20:10:00Z</TimeStamp>
            <Value>501718342</Value>
        </DataModule>
        <DataModule>
            <TimeStamp>2015-12-10T20:15:00Z</TimeStamp>
            <Value>434816025</Value>
        </DataModule>
    </UsageDataPerInterval>
    <RequestId>B955107D-E658-4E77-B913-E0AC3D31693E</RequestId>
    <StartTime>2015-12-10T20:00Z</StartTime>
    <EndTime>2015-12-10T21:00Z</EndTime>
    <Area>CN</Area>
    <Type>all</Type>
</DescribeDomainUsageDataResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DomainName" : "example.com",
  "DataInterval" : "300",
  "UsageDataPerInterval" : {
    "DataModule" : [ {
      "TimeStamp" : "2015-12-10T20:00:00Z",
      "Value" : "423304182"
    }, {
      "TimeStamp" : "2015-12-10T20:05:00Z",
      "Value" : "454680793"
    }, {
      "TimeStamp" : "2015-12-10T20:10:00Z",
      "Value" : "501718342"
    }, {
      "TimeStamp" : "2015-12-10T20:15:00Z",
      "Value" : "434816025"
    } ]
  },
  "RequestId" : "B955107D-E658-4E77-B913-E0AC3D31693E",
  "StartTime" : "2015-12-10T20:00Z",
  "EndTime" : "2015-12-10T21:00Z",
  "Area" : "CN",
  "Type" : "all"
}

Error codes

For a list of error codes, see Service error codes.

Special error codes