All Products
Search
Document Center

DescribeDomainLogs

Last Updated: Oct 20, 2021

Queries the operation logs of domain names.

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

DescribeDomainLogs

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

Lang

String

No

en

The language of the operation logs to be queried.

KeyWord

String

No

test

The keyword for searches in "%KeyWord%" mode. The value is not case-sensitive.

GroupId

String

No

2223

The ID of the domain name group.

PageNumber

Long

No

1

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

PageSize

Long

No

20

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

StartDate

String

No

2019-07-04

The beginning of the time range to query. Specify the time in the YYYY-MM-DD format.

endDate

String

No

2019-07-04

The end of the time range to query. Specify the time in the YYYY-MM-DD format.

Type

String

No

domain

The type of the object whose operation logs are to be queried.

  • domain: domain name.

  • slavedns: secondary Domain Name System (DNS).

Response parameters

Parameter

Type

Example

Description

DomainLogs

Array of DomainLog

The operation logs returned.

DomainLog

Action

String

Add

The operation recorded in the operation log.

ActionTime

String

2015-12-12T09:23Z

The time when the operation was performed.

ActionTimestamp

Long

143562300000

The timestamp when the operation was performed.

ClientIp

String

182.92.253.20

The IP address from which the operation was performed.

DomainName

String

abc.com

The domain name.

Message

String

To the DNS record list

The message for the operation.

ZoneId

String

cxfd345sd234

The ID of the private zone.

PageNumber

Long

1

The page number of the returned page.

PageSize

Long

2

The number of operation logs returned by this query.

RequestId

String

536E9CAD-DB30-4647-AC87-AA5CC38C5382

The ID of the request.

TotalCount

Long

2

The total number of existing operation logs.

Examples

Sample requests

http(s)://alidns.aliyuncs.com/?Action=DescribeDomainLogs
&<Common request parameters>

Sample success responses

XML format

<DescribeDomainLogsResponse>
      <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
      <TotalCount>2</TotalCount>
      <PageNumber>1</PageNumber>
      <PageSize>2</PageSize>
      <DomainLogs>
            <DomainLog>
                  <ActionTime>2015-12-12T09:23Z</ActionTime>
                  <DomainName>abc.com</DomainName>
                  <Action>Add</Action>
                  <Message>To the DNS record list</Message>
                  <ClientIp>182.92.253.20</ClientIp>
            </DomainLog>
            <DomainLog>
                  <ActionTime>2015-12-12T09:23Z</ActionTime>
                  <DomainName>example.com</DomainName>
                  <Action>Retrieved</Action>
                  <Message>And added to the DNS record list</Message>
                  <ClientIp>182.92.253.20</ClientIp>
            </DomainLog>
      </DomainLogs>
</DescribeDomainLogsResponse>

JSON format

{
  "DescribeDomainLogsResponse": {
    "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
    "TotalCount": "2",
    "PageNumber": "1",
    "PageSize": "2",
    "DomainLogs": {
      "DomainLog": [
        {
          "ActionTime": "2015-12-12T09:23Z",
          "DomainName": "abc.com",
          "Action": "Add",
          "Message": "To the DNS record list",
          "ClientIp": "182.92.253.20"
        },
        {
          "ActionTime": "2015-12-12T09:23Z",
          "DomainName": "example.com",
          "Action": "Retrieved",
          "Message": "And added to the DNS record list",
          "ClientIp": "182.92.253.20"
        }
      ]
    }
  }
}

Error codes

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