设置条目扩展属性

curl -X PUT 'https://app.memorylake.ai/openapi/memorylake/api/v1/drives/items/sc-5c6bf0f82d624a20a6fa4696997bdd46:7d8cf1e93f634b31b5/xattrs' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "x_attrs": {
      "tenant_id": "acme-corp",
      "review_status": "approved"
    }
  }'

{
  "success": true,
  "message": "Operation completed successfully"
}

PUT /openapi/memorylake/api/v1/drives/items/{item_id}/xattrs

在文件库的文件或文件夹上存储您自己的字符串键值对（扩展属性，即 xattrs）。您可以借此为条目打上应用所关心的元数据 — 例如租户 ID、工作流状态或内容分类 — 而无需改动文件本身。此调用会与条目已有的 xattrs 合并：您发送的键会被新增或覆盖；条目上已有但本次未发送的键保持不变。要移除某个键，请调用删除条目扩展属性。

系统保留了少量由其自行管理的内部 xattr 键。为这些键发送值不会产生任何效果 — 它们会被静默过滤。系统根文件夹（My Space、WPS Space、Lark Space）完全拒绝 xattr 写入并返回 403。

所需权限： drive:item_modify · service

路径参数

string

必填

要设置 xattrs 的文件或文件夹的 ID。

请求体

object

必填

要写入该条目的 字符串 → 字符串 映射（存在则更新，不存在则新增）。每一项对应一个扩展属性。允许传入空映射，但不会产生任何变更。

curl -X PUT 'https://app.memorylake.ai/openapi/memorylake/api/v1/drives/items/sc-5c6bf0f82d624a20a6fa4696997bdd46:7d8cf1e93f634b31b5/xattrs' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "x_attrs": {
      "tenant_id": "acme-corp",
      "review_status": "approved"
    }
  }'

响应

boolean

表示请求是否成功

string

可读的状态消息

{
  "success": true,
  "message": "Operation completed successfully"
}

要读取条目当前的 xattrs，请调用获取条目 — 其响应包含完整的 x_attrs 映射。

删除条目删除条目扩展属性

​路径参数

​请求体

​响应

路径参数

请求体

响应