文档首页/ 数据安全中心 DSC/ API参考/ API/ 数据流转/ 开启实例数据流转监测功能 - EnableCollectInstanceLogTrace
更新时间:2026-11-13 GMT+08:00
分享

开启实例数据流转监测功能 - EnableCollectInstanceLogTrace

功能介绍

功能介绍:开启实例数据流转监测功能。请求体 instances 支持 1~10 个实例,每个实例需指定 instance_type(DBSS/ADG)与 instance_id;服务端按实例类型分组后逐类开启,已开启或处于开通中状态的实例会被跳过。

响应:请求成功返回HTTP 200,result 固定为 200。

接口约束

  • 无特殊约束。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

POST /v1/{project_id}/logtrace/collect-instances/open

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。可参考获取项目ID获取。

约束限制:

不涉及

取值范围:

以IAM服务接口返回值为准,长度为32个字符,满足正则匹配"^[a-z0-9]{32}$"

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

instances

是

Array of InstanceRequest objects

参数解释:

开启数据流转监测的实例列表,数组中的每个元素为一个InstanceRequest对象,包含实例类型和实例ID

约束限制:

列表最大10个元素

取值范围:

不涉及

默认取值:

不涉及

表4 InstanceRequest

参数

是否必选

参数类型

描述

instance_type

是

String

参数解释:

实例类型,用于指定数据流转监测实例所属的类别

约束限制:

取值必须为 DBSS、ADG 之一

取值范围:

  • DBSS-数据库安全服务实例

  • ADG-应用数据网关实例

默认取值:

不涉及

instance_id

是

String

参数解释:

实例ID,标识一个数据流转监测实例,可通过调用查询数据流转监测实例列表接口获取

约束限制:

满足正则匹配"^[a-zA-Z0-9-]{1,128}$",1到128位英文字母、数字及中划线

取值范围:

1到128个字符

默认取值:

不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

result

Integer

参数解释:

开启数据流转监测的操作结果

取值范围:

200-操作成功

请求示例

无

响应示例

状态码:200

{
  "result" : 200
}

状态码

状态码

描述

200

操作成功

错误码

请参见错误码。

相关文档