开发者社区 问答 正文

云解析怎么获取域名的解析操作日志



描述


根据传入参数获取域名的解析操作日志。

请求参数

名称类型是否必须描述
ActionString操作接口名,系统规定参数,取值:DescribeRecordLogs
DomainNameString域名名称
PageNumberLong当前页数,起始值为1,默认为1
PageSizeLong分页查询时设置的每页行数,最大值100,默认为20
KeyWordString关键字,按照”%KeyWord%”模式搜索,不区分大小写


返回参数


公共返回参数,详见 公共返回参数
名称类型描述
RequestIdString唯一请求识别码
TotalCountLong日志列表总数
PageNumberLong当前页码
PageSizeLong本次查询获取的日志数量
RecordLogsRecordLogType域名操作日志列表


错误码


对于所有接口的通用性错误,请参考 错误代码表
错误代码描述HTTP 状态码语义
IncorrectDomainUserThe domain name does not belong to this user.400域名在本账户下不存在


示例



请求示例

http://alidns.aliyuncs.com/?Action=DescribeRecordLogs&DomainName=example.com&PageNumber=1&PageSize=20&<公共请求参数>

返回示例



XML格式

<DescribeRecordLogsResponse><RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId><TotalCount>2</TotalCount><PageNumber>1</PageNumber><PageSize>2</PageSize><RecordLogs><RecordLog><ActionTime>2015-12-12T09:23Z</ActionTime><Action>暂停解析记录</Action><Message>MX记录 mail 默认 xxxx.top. ( TTL: 600)</Message><ClientIp>182.92.253.20</ClientIp></RecordLog><RecordLog><ActionTime>2015-12-12T09:23Z</ActionTime><Action>新增解析记录</Action><Message>MX记录 mail 默认 xxxx.top. ( TTL: 600)</Message><ClientIp>182.92.253.20</ClientIp></RecordLog></RecordLogs></DescribeRecordLogsResponse>

JSON示例

{"DescribeRecordLogsResponse": {"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382","TotalCount": "2","PageNumber": "1","PageSize": "2","RecordLogs": {"RecordLog": [{"ActionTime": "2015-12-12T09:23Z","Action": "暂停解析记录","Message": "MX记录 mail 默认 xxxx.top. ( TTL: 600)","ClientIp": "182.92.253.20"},{"ActionTime": "2015-12-12T09:23Z","Action": "新增解析记录","Message": "MX记录 mail 默认 xxxx.top. ( TTL: 600)","ClientIp": "182.92.253.20"}]}}}

展开
收起
boxti 2017-10-18 10:47:31 2136 分享
分享
版权
举报
阿里云 AI 助理回答

您所描述的是阿里云DNS服务中通过API接口查询域名解析操作日志的过程。这个过程涉及发送一个HTTP请求到阿里云DNS API的特定端点,以获取与指定域名相关的解析记录操作日志。下面是对您提供信息的一个详细解析和补充说明:

请求目的

  • 主要功能:该API调用(DescribeRecordLogs)旨在帮助用户获取其阿里云账户下某个域名的所有解析记录操作日志。这对于审计、故障排查或了解域名解析历史记录非常有用。

请求参数详解

  • Action: 必填参数,固定值为DescribeRecordLogs,表示要执行的操作是查询解析日志。
  • DomainName: 必填参数,指定了需要查询解析日志的域名名称。
  • PageNumber: 可选参数,默认值为1,用于分页查询时指定当前页码。
  • PageSize: 可选参数,默认值为20,指定了每页返回的日志数量,最大不超过100条。
  • KeyWord: 可选参数,用于过滤日志,支持模糊搜索,系统会在日志内容中查找包含此关键字的记录。

返回参数说明

  • RequestId: 每次请求的唯一标识符,用于问题追踪。
  • TotalCount: 查询结果中总共有多少条日志记录。
  • PageNumber: 实际返回结果的当前页码。
  • PageSize: 实际返回的结果中每页包含的日志数量。
  • RecordLogs: 一个列表,包含了具体的域名操作日志详情,每条记录可能包含操作时间、操作类型、操作者等信息。

错误处理

  • 错误代码示例:“IncorrectDomainUser”错误意味着尝试查询的域名并不属于发起请求的阿里云账户,此时HTTP状态码为400,表示客户端请求有误。

示例请求

您提供的请求示例展示了如何构造一个基本的查询请求:

http://alidns.aliyuncs.com/?Action=DescribeRecordLogs&DomainName=yourdomain.com&PageNumber=1&PageSize=50

在这个例子中,将yourdomain.com替换为您实际想要查询的域名,并可根据需要调整PageNumberPageSize的值。

请注意,实际使用时还需遵循阿里云API调用的签名规则,即在请求中加入AccessKeyId、SignatureMethod、SignatureVersion、SignatureNonce、Timestamp以及Signature等安全认证参数,确保请求的安全性和有效性。这些可以通过阿里云官方文档或SDK来辅助生成。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
AI助理

你好,我是AI助理

可以解答问题、推荐解决方案等