更新数据 V2-RunUpdateData
功能介绍
更新指定服务实例中的对应数据。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/mms/{service_name}/data/update
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释: 用户的项目ID。获取方法请参见获取项目ID和名称。 约束限制: 不涉及。 取值范围: 只能由英文字母和数字组成,且长度为[1-64]个字符。 默认取值: 不涉及。 |
service_name | 是 | String | 参数解释: 服务实例的名称,用户创建服务实例时设置的实例名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
item_id | 是 | String | 参数解释: 数据的服务实例级唯一标识。 约束限制: 不涉及。 取值范围: 数据的服务实例级唯一标识。 默认取值: 不涉及。 |
desc | 否 | String | 参数解释: 数据的描述信息。 约束限制: 不涉及。 取值范围: 字符长度范围为[1, 2048]。 默认取值: 不涉及。 |
custom_tags | 否 | Map<String,String> | 参数解释: 数据的自定义字符标签,用于进行条件过滤。格式为键值对{key:value}。 约束限制:
取值范围: value: 字符长度范围为[1, 64] 默认取值: 不涉及。 |
custom_num_tags | 否 | Map<String,Number> | 参数解释: 数据的自定义数值标签,用于进行条件过滤。格式为键值对{key:value}。 约束限制:
取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码: 200
参数 | 参数类型 | 描述 |
|---|---|---|
result | String | 参数解释: 更新数据完成,返回success。 取值范围: 不涉及。 |
状态码: 400
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 失败响应示例。 |
错误码
请参见错误码。

