文档首页/ 图像搜索 ImageSearch/ API参考/ API/ 更新数据 V2-RunUpdateData
更新时间:2025-12-04 GMT+08:00
分享

更新数据 V2-RunUpdateData

功能介绍

更新指定服务实例中的对应数据。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/mms/{service_name}/data/update

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及。

取值范围:

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值:

不涉及。

service_name

String

参数解释:

服务实例的名称,用户创建服务实例时设置的实例名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

item_id

String

参数解释:

数据的服务实例级唯一标识。

约束限制:

不涉及。

取值范围:

数据的服务实例级唯一标识。

默认取值:

不涉及。

desc

String

参数解释:

数据的描述信息。

约束限制:

不涉及。

取值范围:

字符长度范围为[1, 2048]。

默认取值:

不涉及。

custom_tags

Map<String,String>

参数解释:

数据的自定义字符标签,用于进行条件过滤。格式为键值对{key:value}。

约束限制:

  • key: 必须为服务实例custom_tags中已存在的key,可在创建服务实例时进行配置,或在更新服务实例时进行新增。
  • value: 类型为字符串,字符长度范围为[1, 64]。

取值范围:

value: 字符长度范围为[1, 64]

默认取值:

不涉及。

custom_num_tags

Map<String,Number>

参数解释:

数据的自定义数值标签,用于进行条件过滤。格式为键值对{key:value}。

约束限制:

  • key: 必须为服务实例custom_num_tags中已存在的key,可在创建服务实例时进行配置,或在更新服务实例时进行新增。
  • value: 类型为数值,格式为double。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

result

String

参数解释:

更新数据完成,返回success。

取值范围:

不涉及。

状态码: 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

调用成功时无此字段。

取值范围:

不涉及。

error_msg

String

参数解释:

调用失败时的错误信息。

调用成功时无此字段。

取值范围:

不涉及。

请求示例

更新数据

POST https://{endpoint}/v2/{project_id}/mms/{service_name}/data/update

{
  "item_id" : "electronics_01",
  "desc" : "摄与山海之间,水天相接",
  "custom_tags" : {
    "brand" : "HUABAN"
  },
  "custom_num_tags" : {
    "year" : 2023
  }
}

响应示例

状态码: 200

成功响应示例

{
  "result" : "success"
}

状态码: 400

失败响应示例

{
  "error_code" : "MMS.0003",
  "error_msg" : "Invalid parameter: item_id"
}

状态码

状态码

描述

200

成功响应示例。

400

失败响应示例。

错误码

请参见错误码

相关文档