Skip to content

更新容器

POST
/v1/containers/update

以 containerId 定位目标容器,更新名称、描述、排序、类型、ACL 继承开关等自身属性。注意:请求体中的 metadataColumns 在 update 下为只读输出字段,写时忽略——容器元数据的修改请走 /v1/metadata/values/set。(与 create 不同:create 会写入 metadataColumns,update 只忽略)

参数

请求头参数

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
{
  
"id": 0,
  
"containerId": "string",
  
"parentId": "string",
  
"parentName": "string",
  
"containerTypeId": "string",
  
"containerTypeName": "string",
  
"name": "string",
  
"description": "string",
  
"sortOrder": 0,
  
"status": "string",
  
"createBy": "string",
  
"createByName": "string",
  
"createTime": "string",
  
"updateBy": "string",
  
"updateTime": "string",
  
"purgeAt": "string",
  
"metadataColumns": {
  
  
"additionalProperties": {
  
  
}
  
},
  
"aclInheritEnabled": true,
  
"effectivePermissions": {
  
  
"read": true,
  
  
"download": true,
  
  
"write": true,
  
  
"share": true,
  
  
"manage": true,
  
  
"effectiveRole": "string",
  
  
"delete": true
  
},
  
"hasChildren": true
}

响应

OK

*/*
JSON
{
  
"code": 0,
  
"data": {
  
  
"id": 0,
  
  
"containerId": "string",
  
  
"parentId": "string",
  
  
"parentName": "string",
  
  
"containerTypeId": "string",
  
  
"containerTypeName": "string",
  
  
"name": "string",
  
  
"description": "string",
  
  
"sortOrder": 0,
  
  
"status": "string",
  
  
"createBy": "string",
  
  
"createByName": "string",
  
  
"createTime": "string",
  
  
"updateBy": "string",
  
  
"updateTime": "string",
  
  
"purgeAt": "string",
  
  
"metadataColumns": {
  
  
  
"additionalProperties": {
  
  
  
}
  
  
},
  
  
"aclInheritEnabled": true,
  
  
"effectivePermissions": {
  
  
  
"read": true,
  
  
  
"download": true,
  
  
  
"write": true,
  
  
  
"share": true,
  
  
  
"manage": true,
  
  
  
"effectiveRole": "string",
  
  
  
"delete": true
  
  
},
  
  
"hasChildren": true
  
},
  
"ts": 0,
  
"rid": "string",
  
"msg": "string",
  
"success": true
}

试验场

服务器
请求头
主体

示例

技术支持 VitePress OpenAPI