取消关联数据对象 - DeleteDataobjectRelation
功能介绍
取消关联数据对象
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
DELETE /v1/{project_id}/workspaces/{workspace_id}/soc/{dataclass_type}/{data_object_id}/{related_dataclass_type}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
workspace_id |
是 |
String |
参数解释: 工作空间id。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
dataclass_type |
是 |
String |
关联主体数据对象所属数据类,小写复数,如告警为alerts,事件为incidents |
|
data_object_id |
是 |
String |
关联主体数据对象的id |
|
related_dataclass_type |
是 |
String |
被关联的数据对象所属数据类,小写复数,如告警为alerts,事件为incidents |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。获取用户Token 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
content-type |
是 |
String |
参数解释: 内容类型
约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ids |
否 |
Array of strings |
关联数据对象的ID列表 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
X-request-id |
String |
请求ID,格式为:request_uuid-timestamp-hostname |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
错误码 |
|
message |
String |
错误信息 |
|
data |
BatchOperateDataobjectResult object |
批量操作数据对象结果 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_ids |
Array of strings |
失败id |
|
success_ids |
Array of strings |
成功id |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
X-request-id |
String |
请求ID,格式为:request_uuid-timestamp-hostname |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释: 错误码 取值范围: 不涉及 |
|
message |
String |
参数解释: 错误描述 取值范围: 不涉及 |
请求示例
删除一条ID为f60bf0e7-73b8-4832-8fc4-8c2a12830552的事件关系。
{
"ids" : [ "f60bf0e7-73b8-4832-8fc4-8c2a12830552" ]
}
响应示例
状态码:200
取消关联数据对象返回body体
{
"code" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
"message" : "Error message",
"request_id" : "Error message",
"success" : false,
"total" : 41,
"limit" : 3,
"offset" : 10,
"data" : {
"success_ids" : [ "909494e3-558e-46b6-a9eb-07a8e18ca62f" ],
"error_ids" : [ "909494e3-558e-46b6-a9eb-07a8e18ca62f" ]
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
取消关联数据对象返回body体 |
|
400 |
取消关联数据对象错误返回body体 |
错误码
请参见错误码。