以下内容将详细介绍有关 角色 API的相关功能。
一个角色对象拥有以下属性: |属性|类型|说明| |--------|---------------------------------------------------|-----------| |roleid|字符串|(只读) 角色ID号。| |name
(必要)|字符串|角色名称。| |type
(必需)|整数|用户类型。
可选值:
1 - (缺省值) 普通用户;
2 - 管理员;
3 - 超级管理员。| |readonly|整数|(只读) 设定角色是否为只读。
可选值:
0 - (缺省值) 否;
1 - 是。| 注意,对于某些方法(更新、删除),必需/可选参数组合是不同的。
角色规则拥有下列属性特征:
| 属性 | 类型 | 说明 |
|---|---|---|
| ui | 数组 | 一组包含UI元素 对象的数组。 |
| ui.default_access | 整数 | 表示新的UI元素状态为启动与否。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| services.read.mode | 整数 | 只允许只读性质的业务访问。 可配置的参数包括: 0 - 启动只读模式,通过 services.read.list来限定只读的业务,或者通过与services.read.tag匹配对对应业务进行访问。1 - (缺省值) 对所有业务均采用只读访问。 |
| services.read.list | 数字 | 该数组包含所有业务 对象。 列表中的业务,包含其子业务,会对目标角色用户开启只读访问。对业务来说,只读访问并不会覆盖读写访问。 只有将 services.read.mode设定为0才会开应用属性。 |
| services.read.tag | 对象 | 包含一组业务标签对象的参数。 标签所对应的业务,包含其子业务,会对目标角色用户开启对业务的只读访问。对用户来说,只读访问并不会覆盖读写访问。 只有将 services.read.mode设定为0才会开启该功能。 |
| services.write.mode | 整数 | 对业务开启读写访问。 可配置的参数包括: 0 - (缺省值) 设定业务的读写访问,通过 services.read.list来限定读写的业务,或者通过与services.read.tag匹配对对应业务进行访问。1 - 对所有业务开启读写访问。 |
| services.write.list | 数组 | 包含一组业务对象。 列表中的业务,包含其子业务,会对目标角色用户开启对业务的读写访问。对用户来讲,读写访问权限会覆盖只读访问权限。 只有将 services.write.mode设定为0才会开启该功能。 |
| services.write.tag | 对象 | 包含一组业务标签对象。 标签对应的业务,包含其子业务,会对目标角色用户开启对业务的读写访问。对用户来讲,读写访问权限会覆盖只读访问权限。 只有将 services.write.mode设定为0才会开启该功能。 |
| modules | 数组 | 包含一组模块对象。 |
| modules.default_access | 整数 | 表示对新模块开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| api.access | 证书 | 表示对API开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| api.mode | 整数 | 对罗列在api属性中的API的方式进行模式设定。可配置的参数包括: 0 - (缺省值) 拒绝列表; 1 - 允许列表。 |
| api | 数组 | 包含一组API的方式。 |
| actions | 数组 | 包含一组动作对象。 |
| actions.default_access | 整数 | 表示对新的动作是否开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| services.read.tag | 对象 | 包含一组业务标签对象的参数。 标签所对应的业务,包含其子业务,会对目标角色用户开启对业务的只读访问。对用户来说,只读访问并不会覆盖读写访问。 只有将 services.read.mode设定为0才会开启该功能。 |
| services.write.mode | 整数 | 对业务开启读写访问。 可配置的参数包括: 0 - (缺省值) 设定业务的读写访问,通过 services.read.list来限定读写的业务,或者通过与services.read.tag匹配对对应业务进行访问。1 - 对所有业务开启读写访问。 |
| services.write.list | 数组 | 包含一组业务对象。 列表中的业务,包含其子业务,会对目标角色用户开启对业务的读写访问。对用户来讲,读写访问权限会覆盖只读访问权限。 只有将 services.write.mode设定为0才会开启该功能。 |
| services.write.tag | 对象 | 包含一组业务标签对象。 标签对应的业务,包含其子业务,会对目标角色用户开启对业务的读写访问。对用户来讲,读写访问权限会覆盖只读访问权限。 只有将 services.write.mode设定为0才会开启该功能。 |
| modules | 数组 | 包含一组模块对象。 |
| modules.default_access | 整数 | 表示对新模块开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| api.access | 证书 | 表示对API开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| api.mode | 整数 | 对罗列在api属性中的API的方式进行模式设定。可配置的参数包括: 0 - (缺省值) 拒绝列表; 1 - 允许列表。 |
| api | 数组 | 包含一组API的方式。 |
| actions | 数组 | 包含一组动作对象。 |
| actions.default_access | 整数 | 表示对新的动作是否开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| services.read.tag | 对象 | 包含一组业务标签对象的参数。 标签所对应的业务,包含其子业务,会对目标角色用户开启对业务的只读访问。对用户来说,只读访问并不会覆盖读写访问。 只有将 services.read.mode设定为0才会开启该功能。 |
| services.write.mode | 整数 | 对业务开启读写访问。 可配置的参数包括: 0 - (缺省值) 设定业务的读写访问,通过 services.read.list来限定读写的业务,或者通过与services.read.tag匹配对对应业务进行访问。1 - 对所有业务开启读写访问。 |
| services.write.list | 数组 | 包含一组业务对象。 列表中的业务,包含其子业务,会对目标角色用户开启对业务的读写访问。对用户来讲,读写访问权限会覆盖只读访问权限。 只有将 services.write.mode设定为0才会开启该功能。 |
| services.write.tag | 对象 | 包含一组业务标签对象。 标签对应的业务,包含其子业务,会对目标角色用户开启对业务的读写访问。对用户来讲,读写访问权限会覆盖只读访问权限。 只有将 services.write.mode设定为0才会开启该功能。 |
| modules | 数组 | 包含一组模块对象。 |
| modules.default_access | 整数 | 表示对新模块开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| api.access | 证书 | 表示对API开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| api.mode | 整数 | 对罗列在api属性中的API的方式进行模式设定。可配置的参数包括: 0 - (缺省值) 拒绝列表; 1 - 允许列表。 |
| api | 数组 | 包含一组API的方式。 |
| actions | 数组 | 包含一组动作对象。 |
| actions.default_access | 整数 | 表示对新的动作是否开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| services.read.tag | 对象 | 包含一组业务标签对象的参数。 标签所对应的业务,包含其子业务,会对目标角色用户开启对业务的只读访问。对用户来说,只读访问并不会覆盖读写访问。 只有将 services.read.mode设定为0才会开启该功能。 |
| services.write.mode | 整数 | 对业务开启读写访问。 可配置的参数包括: 0 - (缺省值) 设定业务的读写访问,通过 services.read.list来限定读写的业务,或者通过与services.read.tag匹配对对应业务进行访问。1 - 对所有业务开启读写访问。 |
| services.write.list | 数组 | 包含一组业务对象。 列表中的业务,包含其子业务,会对目标角色用户开启对业务的读写访问。对用户来讲,读写访问权限会覆盖只读访问权限。 只有将 services.write.mode设定为0才会开启该功能。 |
| services.write.tag | 对象 | 包含一组业务标签对象。 标签对应的业务,包含其子业务,会对目标角色用户开启对业务的读写访问。对用户来讲,读写访问权限会覆盖只读访问权限。 只有将 services.write.mode设定为0才会开启该功能。 |
| modules | 数组 | 包含一组模块对象。 |
| modules.default_access | 整数 | 表示对新模块开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| api.access | 证书 | 表示对API开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
| api.mode | 整数 | 对罗列在api属性中的API的方式进行模式设定。可配置的参数包括: 0 - (缺省值) 拒绝列表; 1 - 允许列表。 |
| api | 数组 | 包含一组API的方式。 |
| actions | 数组 | 包含一组动作对象。 |
| actions.default_access | 整数 | 表示对新的动作是否开启访问。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |
UI元素包含下列属性对象: |属性|类型|说明| |--------|---------------------------------------------------|-----------| |name
(必需)|字符串|UI元素的名称。
普通用户可操作的配置数据包括:monitoring.dashboard - 监控 → 仪表板;monitoring.problems - 监控 → 问题;monitoring.hosts - 监控 → 主机;monitoring.overview - 监控 → 概览;monitoring.latest_data - 监控 → 最新数据;monitoring.maps - 监控 → 拓扑图;monitoring.services - 监控 → 服务;inventory.overview - 资产清单 → 概览;inventory.hosts - 资产清单 → 主机;reports.availability_report - 报告 → 可行性报告;reports.top_triggers - 报告 → 前100触发器。
管理员和超级管理员 可操作的配置数据包括:monitoring.discovery - 监控 → 发现;reports.scheduled_reports - 报告 → 规划报告;reports.notifications - 报告 → 通知;configuration.host_groups - 配置 → 用户组;configuration.templates - 配置 → 模板;configuration.hosts - 配置 → 主机;configuration.maintenance - 配置 → 维护;configuration.actions - 配置 → 动作;configuration.discovery - 配置 → 发现.
超级管理员 可操作的配置数据包括:reports.system_info - 报告 → 系统信息;reports.audit - 报告 → 审计;reports.action_log - 报告 → 动作记录;configuration.event_correlation - 配置 → 关联事件;administration.general - 管理 → 通用配置;administration.proxies - 管理 → 代理;administration.authentication - 管理 → 授权;administration.user_groups - 管理 → 用户组;administration.user_roles - 管理 → 用户角色;administration.users - 管理 → 用户;administration.media_types - 管理 → 媒介类型;administration.scripts - 管理 → 脚本;administration.queue - 管理 → 队列.| |status|整数|代表是否开启UI元素的访问。
可选值:
0 - 关闭;
1 - (default) 开启。|
| 属性 | 类型 | 说明 |
|---|---|---|
| serviceid (必要) |
字符串 | 业务ID号。 |
| 属性 | 类型 | 说明 |
|---|---|---|
| tag (必要) |
字符串 | 标签名称。 若无填写内容,则该功能不会被使用。 |
| value | 字符串 | 标签数值。 若该属性没有填写任何参数,那么只有标签名称会被用来对应业务。 |
模块对象拥有下列属性特征: |属性|类型|说明| |--------|---------------------------------------------------|-----------| |moduleid
(必要)|字符串|模块ID。| |status|整数|是否允许访问模块信息。
可配置的参数包括:
0 - 关闭;
1 - (缺省值) 开启。|
动作对象拥有下列属性特征:
| 属性 | 类型 | 说明 |
|---|---|---|
| name (必要) |
字符串 | 动作名称。 对所有类型用户可配置的参数包括: edit_dashboards - 创建和编辑仪表板;edit_maps - 创建和编辑拓扑图;add_problem_comments - 添加问题描述;change_severity - 修改问题级别;acknowledge_problems - 确认问题;close_problems - 关闭问题;execute_scripts - 运行脚本;manage_api_tokens - 管理API令牌。管理员 和 超级管理员 用户类型可配置的参数包括: edit_maintenance - 创建和编辑维护;manage_scheduled_reports - 管理规划报告。 |
| status | 整数 | 是否允许访问运行的动作信息。 可配置的参数包括: 0 - 关闭; 1 - (缺省值) 开启。 |