账户财务 > 使用文档 > 审计日志 > API 参考 >日志查询（log-query）

日志查询（log-query）

最近更新时间: 2023-06-13 11:28:52

请求

GET /audit/log-query HTTP/1.1
Host: api.qiniu.com
Content-Type: application/x-www-form-urlencoded
Authorization: Qiniu <管理凭证>

头部名称	必填	说明
Host	是	固定为 `api.qiniu.com`，必须以 HTTPS 方式访问
Content-Type	是	固定为 `application/x-www-form-urlencoded`
Authorization	是	账号管理凭证，该参数应严格按照账号管理凭证格式进行填充，否则会返回 401 错误码。文档地址

请求参数以表单形式组织，作为请求内容提交。

字段名称	类型	是否必须	说明
start_time	String	是	检索日志的开始时间，日期格式按照 ISO8601 标准，并使用 UTC 时间
end_time	String	是	检索日志的结束时间，日期格式按照 ISO8601 标准，并使用 UTC 时间
service_name	String	否	服务名称，参考
event_names	Array of String	否	事件名称集合，参考
principal_id	String	否	请求者的 ID，参考
access_key_id	String	否	请求身份所属的 AccessKey ID
limit	Integer	否	允许返回的最大结果数目，取值范围：1~50，不传值默认为：20
next_mark	String	否	用于请求下一页检索的结果

HTTP/1.1 200 OK
Content-Type: application/json

头部名称	说明
Content-Type	正常情况下该值将被设为 `application/json`，表示返回 JSON 格式的文本信息。

{
    "audit_log_infos": [],
    "next_mark": "",
}

字段名称	类型	说明
audit_log_infos	Array of Object	日志集合，参考
next_mark	String	返回下一页的检索结果

{
    "error": "",
    "code": 0,
    "message": ""
}

HTTP 状态码	code	message	description
200			成功
400	3	InvalidArgument	请求参数错误

以上内容是否对您有帮助？