功能介绍

设置审计日志策略。

接口约束

冻结实例，异常实例不支持该操作。

调试

您可以在API Explorer中调试该接口。

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/auditlog-policy

• URI样例

  https://dds.cn-north-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/5cecca4c20e04146862651b8d385f26ain02/auditlog-policy

• 参数说明

  表1 参数说明

  名称	是否必选	描述
  project_id	是	租户在某一Region下的Project ID。
  instance_id	是	实例ID，可以调用“查询实例列表”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	描述
  keep_days	是	Integer	审计日志保存天数，取值范围为0或7~732。 取值0，表示关闭审计日志策略。 取值7~732，表示开启审计日志策略，并设置审计日志保存天数为该值。
  reserve_auditlogs	否	String	仅关闭审计日志策略时有效。 true（默认），表示关闭审计日志策略的同时，保留历史审计日志。 false，表示关闭审计日志策略的同时，删除已有的历史审计日志。
  audit_scope	否	String	仅打开审计日志策略时有效，并且取值为空或者“all”时，默认全部。 审计范围。 请输入数据库或集合名称，多个库或集合请用英文逗号分隔。若名称中有英文逗号，请在逗号前添加“$”符号，用以区分分隔符。 输入长度范围不能超过1024位，且不能包含空格∧"[]{}():'和特殊字符，$符号只能在转义时使用。
  audit_types	否	Array of strings	仅打开审计日志策略时有效，并且为空时，默认全部。 审计类型。支持auth，insert，delete，update，query，command等。

• 请求体样例
  • 打开或更新审计日志策略

    {
      "keep_days": 7,
      "audit_scope": "all",
      "audit_types": [
        "insert"
      ]
    }

  • 关闭审计日志策略

    {
      "keep_days": 0,
      "reserve_auditlogs": false
    }

响应消息

{}