Skip to content

批量设置元数据值

POST
/v1/metadata/values/batchSet

对同一 resourceType 的一组资源(单批最多 100 个)写入相同的元数据值。逐资源 WRITE 鉴权并独立处理,支持部分成功;返回逐资源的成功 / 失败结果与汇总计数(totalCount / successCount / failureCount)。

参数

请求头参数

Authorization*

访问令牌以 Bearer 方案在 HTTP Authorization 请求头携带。请在此填入完整值(含 Bearer 前缀),例如:Bearer <accessToken>

类型
string
必填
示例"Bearer <accessToken>"
X-Atk-User-Token

强通道(可选):以某已签发的 atkonbase 用户会话 token 调用,ACL 解析与操作归属走该用户。与弱通道 X-Atk-Act-As-Source(-Id) 互斥——同时携带返回业务码 101008。两个 SDK 均由 client 侧拦截器统一注入(actAsToken()),此处仅为门户演练暴露。

类型
string
X-Atk-Act-As-Source

弱通道(可选):外部身份来源标识,须与 X-Atk-Act-As-Source-Id 成对携带,缺一返回业务码 101009。仅当该 Client 的 act_as_user_allowed=true 时生效,否则静默降级为 APP_ONLY;与强通道互斥。两个 SDK 均由 client 侧拦截器统一注入(actAsSource()),此处仅为门户演练暴露。

类型
string
X-Atk-Act-As-Source-Id

弱通道(可选):外部身份在其来源系统内的 ID,须与 X-Atk-Act-As-Source 成对携带,缺一返回业务码 101009

类型
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
}

试验场

服务器
请求头
主体

示例

技术支持 VitePress OpenAPI