属性管理
概述
属性标签页用于管理配置项类型的属性字段。属性是配置项的基本数据单元，定义了配置项可以存储哪些信息。
每个配置项类型都可以定义多个属性，如计算机类型可以定义内存、FQDN、操作系统版本等属性。
属性分类
属性标签页包含三个子标签页，用于查看不同来源的属性：
| 子标签页 | 说明 | 包含内容 |
|---|---|---|
| 全部属性 | 显示所有可用属性 | 当前类型的自有属性 + 从父类型继承的属性 |
| 继承属性 | 仅显示继承的属性 | 从父类型继承的所有属性 |
| 自有属性 | 仅显示自有属性 | 当前类型直接定义的属性（不包括继承的） |
继承机制
子类型会自动继承父类型的所有属性。例如：
计算机类型定义了FQDN、操作系统版本属性Linux继承自计算机，自动拥有这两个属性Linux可以再定义自有属性如发行版
属性类型
系统支持以下属性类型：
| 类型 | 说明 | 示例用途 |
|---|---|---|
| 字符串 | 较长的文本 | 描述信息 |
| 整数 | 整数 | CPU核心数、端口号 |
| 长整数 | 大整数 | 内存大小（MB） |
| 浮点数 | 小数 | CPU使用率 |
| 双精度浮点数 | 大精度小数 | 地理位置坐标 |
| 日期时间 | 日期时间 | 创建时间、更新时间 |
| 布尔值 | 是/否 | 是否启用、是否在线 |
| 字符串列表 | 多个字符串值 | 标签、DNS服务器 |
| 整数列表 | 多个整数值 | 开放端口列表 |
| 键值对列表 | 键值对集合 | 自定义标签、环境变量 |
| 选项 | 预定义的选项列表 | 操作系统类型、状态 |
| 配置项 ID | 引用另一个配置项 | 依附配置项 |
| IP 地址 | IP地址格式 | 主IP、备用IP |
| URL | 网址格式 | 管理地址、下载地址 |
| 电子邮件 | 邮箱地址格式 | 联系人邮箱 |
| 二进制 | 二进制数据 | 文件内容、证书 |
添加属性
操作步骤
- 切换到"自有属性"子标签页
- 点击顶部工具栏的"添加属性"按钮
- 在弹出对话框中填写属性信息
- 点击"确定"关闭对话框(此时属性仅暂存在本地,尚未持久化到服务器)
- 点击页面工具栏的"保存"按钮,提交所有待保存修改
两步保存
属性的添加 / 编辑 / 删除都遵循两步保存模式:对话框中的"确定"只把变更加入本地待保存队列,真正的持久化需要再点击"保存"按钮。这允许你在一次保存中批量提交多个属性的修改。
属性字段说明
| 字段 | 说明 | 何时使用 |
|---|---|---|
| 名称 | 属性的唯一标识符，字母开头，只能包含字母、数字和下划线 | 创建属性时定义，创建后不可修改 |
| 显示名称 | 属性的显示名称 | 需要让用户容易识别 |
| 类型 | 属性的数据类型 | 创建属性时定义，创建后不可修改 |
| 选项类型 | 选项的数据来源 | 仅当类型选择为"选项"时需要设置，用于指定选项的来源 |
| 描述 | 属性的用途说明 | 帮助用户理解属性用途 |
| 组 | 属性所属的分组 | 用于组织相关属性；在配置项详情页面按组分组显示；定义在"基本信息"组的属性会作为默认列显示在实例列表上 |
| 最大长度 | 值的最大长度 | 对字符串、URL、整数列表等类型有效，用于限制输入的字符数或元素个数 |
| 默认值 | 属性的默认值 | 大多数实例都使用相同值时 |
| 必填 | 是否为必填字段 | 关键信息应设置为必填 |
| 只读 | 属性的值在界面上是否只读 | 不允许用户在界面上修改的属性（不影响 API） |
| 隐藏 | 属性是否在界面上隐藏 | 敏感信息或不常用的属性（不影响 API） |
| 跟踪历史记录 | 是否记录属性的变更历史 | 需要审计属性变更 |
| 索引 | 是否为属性创建索引 | 需要频繁查询的属性 |
注意：「跟踪历史记录」和「索引」选项可能会影响系统性能，请谨慎启用：
- 启用「跟踪历史记录」后，系统需要为该属性的每次变更记录历史数据，数据量会显著增加
- 启用「索引」后，系统需要为该属性维护索引结构，在大量数据时可能影响写入性能
- 建议仅对确实需要频繁查询或需要审计变更的属性启用这些选项 |
编辑属性
操作步骤
- 在属性列表中找到要编辑的属性
- 点击该行的"编辑"按钮
- 在弹出对话框中修改属性信息
- 点击"确定"关闭对话框
- 点击页面工具栏的"保存"按钮,提交所有待保存修改
注意：
- 属性名称创建后不可修改
- 属性类型创建后不可修改
- 修改属性定义可能会影响现有配置项数据
删除属性
操作步骤
- 在属性列表中找到要删除的属性
- 点击该行的"删除"按钮
- 在确认对话框中点击"确定"
- 点击页面工具栏的"保存"按钮,提交所有待保存修改
限制：
- 只能删除自有属性，不能删除继承的属性
- 系统内置的属性无法删除
- 如果配置项已经使用该属性存储了数据，删除前请确认
常见问题
Q：选项类型的选项在哪里定义？
A：选项类型的选项在"选项列表"模块中定义。创建选项属性时需要选择已有的选项列表。详见选项管理文档。