删除数据 V2

project_id

是

String

用户的项目ID。获取方法请参见获取项目ID和名称。

service_name

是

String

服务实例的名称，用户创建服务实例时指定。

force

否

Boolean

是否幂等删除数据，默认为false。仅对指定ID删除生效。

• false: 数据不存在时返回错误信息。
• true: 数据不存在时返回成功，用于幂等删除场景。

item_id

否

String

数据的服务实例级唯一标识，字符长度范围为[1, 256]。

• item_id/custom_tags/custom_num_tags中必须给定至少一个参数，以支持对服务实例中的数据进行指定ID删除或条件删除。
• 如给定item_id参数，则进行指定ID删除，否则进行条件删除。

custom_tags

否

Map<String,Array<String>>

自定义字符标签，用于对服务实例中的数据进行条件删除。格式为键值对{key:value}。

• key: 必须为服务实例custom_tags中已存在的key，可在创建服务实例时进行配置，或在更新服务实例时进行新增。
• value: 标签值列表，列表内多个标签值为“或”关系，即满足一个即可。列表长度范围为[1, 32]，标签值类型为字符串，字符长度范围为[1, 64]。

custom_num_tags

否

Map<String,RangeParam>

自定义数值标签，用于对服务实例中的数据进行custom_num_tags条件删除。格式为键值对{key:value}。

• key: 必须为服务实例custom_num_tags中已存在的key，可在创建服务实例时进行配置，或在更新服务实例时进行新增。针对没有设置该数值标签的数据，会直接过滤。
• value: 标签值的取值范围，标签值在给定的取值范围内即视为符合条件。

from

否

Double

数值下界，默认包含该下界。

to

否

Double

数值上界，默认包含该上界。

result

String

删除数据完成返回success。

data

DeleteRestInfo object

删除数据的相关信息，仅在条件删除时存在该字段。

items

Array of items objects

删除数据列表。

delete_info

DeleteInfo object

删除结果的相关信息。

id

String

数据唯一ID。

total_num

Integer

符合条件的结果总数。

delete_num

Integer

本次删除的结果总数，目前一次请求最多删除100条结果。

error_code

String

调用失败时的错误码，具体请参见错误码。

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

200

成功响应示例。

400

失败响应示例。