调用DescribeChangeLogs接口获取内网DNS解析操作日志。操作日志是记录内置权威、缓存管理、转发管理、服务地址以及查询解析记录的操作日志，可以根据行为、内容等关键字进行模糊查询。
接口说明
使用限制
内网 DNS 操作日志查询时间限制为 6 个月。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
pvtz:DescribeChangeLogs |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Keyword |
string |
否 |
关键字（行为、内容）。支持模糊查询，不区分大小写。 |
test |
| Lang |
string |
否 |
返回值语言，取值：
默认值：en |
en |
| ZoneId |
string |
否 |
Zone ID。 是否为空：
|
df2d03865266bd9842306db586d3**** |
| PageNumber |
integer |
否 |
分页查询时设置查询的页码，起始值为 1，默认为 1。 |
1 |
| PageSize |
integer |
否 |
分页查询时设置的每页数据量，最大值 100，默认为 20。 |
100 |
| StartTimestamp |
integer |
否 |
开始时间（时间戳）。 |
1516779348000 |
| EndTimestamp |
integer |
否 |
结束时间（时间戳）。 |
2516779348000 |
| EntityType |
string |
否 |
获取的日志类型。取值：
说明
其它值则忽略，获取所有类型日志。 |
PV_ZONE |
| UserClientIp |
string |
否 |
用户 Ip。 |
192.0.XX.XX |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| PageSize |
integer |
返回的每页数据量。 |
1 |
| RequestId |
string |
唯一请求识别码。 |
F0FCB52A-D512-41A0-8595-40234EDCFD8B |
| ChangeLogs |
object |
||
| ChangeLog |
array<object> |
变更日志列表。 |
|
|
object |
变更日志详情。 |
||
| OperTimestamp |
integer |
操作发生的时间（时间戳）。 |
1721619906972 |
| EntityId |
string |
域名、自定义解析线路、转发规则、出站终端节点、入站终端节点等的唯一标识码。 |
df2d03865266bd9842306db586d3**** |
| OperObject |
string |
操作对象类型。说明：
|
PV_RECORD |
| OperTime |
string |
操作发生的时间。 |
2024-07-22T03:45Z |
| OperIp |
string |
操作本次变更的 IP 地址（公网 IP，如果操作终端设备为私网 IP，那此处记录的 IP 为用户终端 NAT 之后的公网 IP）。 |
192.0.XX.XX |
| OperAction |
string |
对操作对象的具体操作行为，例如增加、删除、修改、关联等。 |
add |
| Content |
string |
操作内容。记录本次操作的具体内容。 |
Add RR:test.03 Type:A Line:default TTL:300 Value:172.20.XX.XX |
| EntityName |
string |
操作对象名称。指操作的主体，例如域名、自定义解析线路、缓存保持域名、转发规则、出站终端节点、入站终端节点。 |
test.03 |
| Id |
integer |
操作记录 ID。 |
90761578646770**** |
| CreatorId |
string |
操作者 ID。完成这个操作的实施人 ID。 |
141339776561**** |
| CreatorType |
string |
操作者类型。取值为空或 USER |
USER |
| CreatorSubType |
string |
操作者子类型。取值：
|
CUSTOMER |
| CreatorUserId |
string |
操作者 ID。 |
141339776561**** |
| PageNumber |
integer |
返回数据的当前页码。 |
1 |
| TotalPages |
integer |
全部数据的总页数。 |
1 |
| TotalItems |
integer |
日志列表总数。 |
1 |
示例
正常返回示例
JSON格式
{
"PageSize": 1,
"RequestId": "F0FCB52A-D512-41A0-8595-40234EDCFD8B",
"ChangeLogs": {
"ChangeLog": [
{
"OperTimestamp": 1721619906972,
"EntityId": "df2d03865266bd9842306db586d3****",
"OperObject": "PV_RECORD",
"OperTime": "2024-07-22T03:45Z",
"OperIp": "192.0.XX.XX",
"OperAction": "add",
"Content": "Add RR:test.03 Type:A Line:default TTL:300 Value:172.20.XX.XX",
"EntityName": "test.03",
"Id": 0,
"CreatorId": "141339776561****",
"CreatorType": "USER",
"CreatorSubType": "CUSTOMER",
"CreatorUserId": "141339776561****"
}
]
},
"PageNumber": 1,
"TotalPages": 1,
"TotalItems": 1
}异常返回示例
JSON格式
{
"Message": "The request processing has failed due to some unknown error, exception or failure",
"RequestId": "E246E023-F2EB-4034-83F7-B13FCF31459C",
"Code": "InternalError"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。