Queries the operation logs of a domain name.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes QueryChangeLogList

The operation that you want to perform. Set the value to QueryChangeLogList.

PageNum Integer Yes 1

The number of the page to return. Pages start from page 1.

PageSize Integer Yes 1

The number of entries to return on each page. Valid values: 1 to 100.

StartDate Long No 1522080000000

The beginning of the time range to query. Set the value to a UNIX timestamp representing the number of milliseconds that have elapsed since the epoch time January 1, 1970, 00:00:00 UTC.

EndDate Long No 1522080000000

The end of the time range to query. Set the value to a UNIX timestamp representing the number of milliseconds that have elapsed since the epoch time January 1, 1970, 00:00:00 UTC.

DomainName String No example.com

The domain name whose operation logs you want to query.

Lang String No en

The language in which the system returns the error message. Valid values:

  • zh: Chinese
  • en: English

Default value: en

UserClientIp String No 127.0.0.1

The IP address of the client. Set the value to 127.0.0.1.

Response parameters

Parameter Type Example Description
CurrentPageNum Integer 1

The page number of the returned page.

Data Array of ChangeLog

The list of returned operation logs.

ChangeLog
Details String dns1;dns2 -> dns3;dns4

The details of the operation log.

DomainName String test1.com

The domain name.

Operation String DNS modification

The operation that was performed.

OperationIPAddress String 127.0.0.1

The IP address of the client that was used to perform the operation.

Result String Failed

The result of the operation.

Time String 2017-12-26 12:00:00

The time when the operation was performed. The time is in UTC, such as 2017-12-25 12:00:00. The format depends on the Lang parameter in the request.

NextPage Boolean true

Indicates whether the current page is followed by a page.

PageSize Integer 1

The number of entries returned per page.

PrePage Boolean false

Indicates whether the current page is preceded by a page.

RequestId String 2DEDFF32-7827-46B1-BE90-3DB8ABD91A58

The ID of the request.

ResultLimit Boolean true

The limit on the result. Only the specified page of log entries is returned for the current query. In addition, the server can process a maximum of 1,000 most recent entries. If the result includes more than 1,000 entries, the value of ResultLimit is true. In this case, you need to narrow down the time range and perform a query again. If the result includes 1,000 or less than 1,000 entries, the value of ResultLimit is false.

TotalItemNum Integer 1000

The total number of entries returned.

TotalPageNum Integer 1000

The total number of pages returned.

Examples

Sample requests

http(s)://[Endpoint]/?Action=QueryChangeLogList
&PageNum=1
&PageSize=1
&<Common request parameters>

Sample success responses

XML format 

<PrePage>false</PrePage>
<CurrentPageNum>1</CurrentPageNum>
<PageSize>1</PageSize>
<RequestId>2DEDFF32-7827-46B1-BE90-3DB8ABD91A58</RequestId>
<TotalPageNum>1000</TotalPageNum>
<Data>
    <ChangeLog>
        <OperationIPAddress>127.0.0.1</OperationIPAddress>
        <Details>dns1;dns2 -&amp;gt; dns3;dns4</Details>
        <DomainName>example.com</DomainName>
        <Time>2017-12-26 12:00:00</Time>
        <Operation>DNS modification</Operation>
        <Result>Failed</Result>
    </ChangeLog>
</Data>
<ResultLimit>true</ResultLimit>
<TotalItemNum>1000</TotalItemNum>
<NextPage>true</NextPage>

JSON format 

{
    "PrePage": false,
    "CurrentPageNum": 1,
    "PageSize": 1,
    "RequestId": "2DEDFF32-7827-46B1-BE90-3DB8ABD91A58",
    "TotalPageNum": 1000,
    "Data": {
        "ChangeLog": {
            "OperationIPAddress": "127.0.0.1",
            "Details": "dns1;dns2 -&gt; dns3;dns4",
            "DomainName": "example.com",
            "Time": "2017-12-26 12:00:00",
            "Operation": "DNS modification",
            "Result": "Failed"
        }
    },
    "ResultLimit": true,
    "TotalItemNum": 1000,
    "NextPage": true
}

Error codes

For a list of error codes, visit the API Error Center.