用途:在 Confluence 页面和博客文章上管理内容属性(content properties),即以键值对形式附加的自定义元数据,用于存储应用专用数据、配置或自定义字段。
主要能力:读取、创建、更新、列出和删除属性;支持字符串、数字、布尔值和复杂 JSON 对象;支持按 key 前缀或正则过滤、按 key 或版本排序、展开版本信息;支持文本或 JSON 输出。属性支持版本控制,更新时可自动获取当前版本并递增,版本不同步会返回 409 冲突。
使用方式:通过 CLI 命令操作,如 confluence property get 12345、confluence property set 12345 my-property --value "text value"、confluence property set 12345 config --file config.json、confluence property set 12345 my-property --value "updated" --update、confluence property delete 12345 my-property --force、confluence property list 12345 --prefix app.。底层使用 Confluence REST API v1 的 /rest/api/content/{id}/property 系列端点。
适用场景:存储评审状态与审批日期、实现基于属性的工作流状态跟踪、保存外部集成配置、为自动化处理标记结构化数据。
限制:属性为内容专属,不会被子页面继承;key 区分大小写;list 命令最多返回 100 个属性;属性默认不包含在页面导出中;最大属性大小取决于 Confluence 实例限制。编辑页面内容、添加标签或设置权限应使用其他对应技能。