外观
批量设置元数据值
POST
/v1/metadata/values/batchSet
对同一 resourceType 的一组资源(单批最多 100 个)写入相同的元数据值。逐资源 WRITE 鉴权并独立处理,支持部分成功;返回逐资源的成功 / 失败结果与汇总计数(totalCount / successCount / failureCount)。
授权
apiKey
类型
API Key (header: Authorization)
参数
请求头参数
X-Atk-User-Token
强通道:系统自签的不透明用户会话 token,用于 Client 代表用户调用。 与 X-Atk-Act-As-Source / X-Atk-Act-As-Source-Id 互斥,同时携带服务端返回 400 INVALID_DELEGATION_HEADERS。
类型
string
X-Atk-Act-As-Source
弱通道:身份 source 主张(要求 Client 已开启 actAsAllowed)。 必须与 X-Atk-Act-As-Source-Id 成对携带,缺一服务端返回 400 INCOMPLETE_ACT_AS_HEADERS;与 X-Atk-User-Token 互斥,同时携带服务端返回 400 INVALID_DELEGATION_HEADERS。
类型
string
X-Atk-Act-As-Source-Id
弱通道:身份 sourceId 主张(要求 Client 已开启 actAsAllowed)。 必须与 X-Atk-Act-As-Source 成对携带,缺一服务端返回 400 INCOMPLETE_ACT_AS_HEADERS;与 X-Atk-User-Token 互斥,同时携带服务端返回 400 INVALID_DELEGATION_HEADERS。
类型
string
请求体
application/json
JSON "resourceType": "string", "resourceIds": [ "string" ], "values": { "additionalProperties": { } }, "partialUpdate": true, "creation": true
{
}
响应
OK
*/*
JSON "code": 0, "data": { "totalCount": 0, "successCount": 0, "failureCount": 0, "results": [ { "resourceId": "string", "success": true, "errorMessage": "string" } ] }, "ts": 0, "rid": "string", "msg": "string", "success": true
{
}