You can call this operation to query operations logs of DNS records.

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 DescribeChangeLogs

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

Keyword String No test

The keyword that is used to query operations logs. Specify the keyword in the %Keyword% format. The keyword is case insensitive.

Lang String No en

The language of the specific content returned in the response.

ZoneId String No 6726

The ID of the private zone.

If you specify this parameter, the logs that record the operations on the Domain Name System (DNS) records in specified private zone are queried.

If you do not specify this parameter, the logs that record the operations on all private zones that belong to the current Alibaba Cloud account and the DNS records in these private zones are queried.

PageNumber Integer No 1

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

PageSize Integer No 100

The number of entries to return on each page. Maximum value: 100. Default value: 20.

StartTimestamp Long No 1516779348000

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

EndTimestamp Long No 1516779348000

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

EntityType String No PV_ZONE

The type of operations logs. Valid values:

  • PV_ZONE: the logs that record the operations on private zones.
  • PV_RECORD: the logs that record the operations on DNS records.

If you set this parameter to other values, all types of operations logs are queried.

UserClientIp String No 1.1.1.1

The IP address of the client.

Response parameters

Parameter Type Example Description
RequestId String F0FCB52A-D512-41A0-8595-40234EDCFD8B

The ID of the request.

TotalItems Integer 100

The total number of log entries.

TotalPages Integer 100

The total number of pages.

PageSize Integer 1

The number of entries returned per page.

PageNumber Integer 2

The page number of the returned page.

ChangeLogs Array

The list of log entries.

OperTime String 2018-01-24T07:35Z

The time when the operation was performed.

OperAction String add

The specific operation that was performed.

OperObject String PV_ZONE

The type of the object on which the operation was performed.

EntityId String CAgICA1OA_58

The ID of the object on which the operation was performed.

EntityName String test-api.com

The name of the object on which the operation was performed.

OperIp String 1.1.1.1

The IP address of the client.

OperTimestamp Long 1516779348000

The timestamp when the operation was performed.

Id Long 6726

The ID of the log entry.

Content String add test-api.com

The details of the operation.

Examples

Sample requests

http://pvtz.aliyuncs.com/?Action=AddZoneRecord&ZoneId=CAgICA1OA_58&Rr=www&Type=A&Ttl=60&Value=1.1.1.1&<Common request parameters>

Sample success responses

XML format 

<DescribeChangeLogsResponse>    <PageNumber>1</PageNumber>    <ChangeLogs>    <ChangeLog>    <OperTimestamp>1516779348000</OperTimestamp>    <OperAction>add</OperAction>    <OperObject>PV_ZONE</OperObject>    <OperIp>106.11.34.7</OperIp>    <Id>6726</Id>    <EntityName>test-api.com</EntityName>    <OperTime>2018-01-24T07:35Z</OperTime>    <Content>add test-api.com</Content>    <EntityId>CAgICA1OA_58</EntityId>    </ChangeLog>    </ChangeLogs>    <PageSize>1</PageSize>    <RequestId>F0FCB52A-D512-41A0-8595-40234EDCFD8B</RequestId>    <TotalItems>224</TotalItems>    <TotalPages>224</TotalPages></DescribeChangeLogsResponse>

JSON format

{“PageNumber”: 1,“ChangeLogs”: {“ChangeLog”: [{“OperTimestamp”: 1516779348000,“OperAction”: “add”,“OperObject”: “PV_ZONE”,“OperIp”: “106.11.34.7”,“Id”: 6726,“EntityName”: “test-api.com”,“OperTime”: “2018-01-24T07:35Z”,“Content”: “add test-api.com”,“EntityId”: “CAgICA1OA_58”}]},“PageSize”: 1,“RequestId”: “50C60A29-2E93-425A-ABA8-068686E28873”,“TotalItems”: 224,“TotalPages”: 224}

Error codes

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