Roleオブジェクト

次のオブジェクトは、roleAPIに直接関連しています。

ロール

ロールオブジェクトには以下のプロパティがあります。

プロパティ 型 説明
roleid ID ロールのID。

プロパティの動作:
- 読み取り専用
- 更新操作で 必須
name string ロールの名前。

プロパティの動作:
- 作成操作で 必須
type integer ユーザータイプ。

指定可能な値:
1 - (デフォルト) ユーザー;
2 - 管理者;
3 - 特権管理者。

プロパティの動作:
- 作成操作で 必須
readonly integer ロールが読み取り専用かどうか。

指定可能な値:
0 - (デフォルト) いいえ;
1 - はい。

プロパティの動作:
- 読み取り専用

ロールルール

ロールルールオブジェクトには、以下のプロパティがあります。

Property Type Description
ui array UI要素オブジェクトの配列。
ui.default_access integer 新しいUI要素へのアクセスを有効にするかどうか。

使用可能な値:
0 - 無効;
1 - (デフォルト) 有効。
services.read.mode integer サービスへの読み取り専用アクセス。

使用可能な値:
0 - services.read.listで指定された、またはservices.read.tagプロパティに一致したサービスへの読み取り専用アクセス;
1 - (デフォルト) すべてのサービスへの読み取り専用アクセス。
services.read.list array Serviceオブジェクトの配列。

指定されたサービスおよびその子サービスに対して、ユーザーロールに読み取り専用アクセスが付与されます。読み取り専用アクセスは、サービスへの読み書きアクセスを上書きしません。

プロパティの動作:
- services.read.modeが"0"に設定されている場合にサポートされます
services.read.tag object Service tagオブジェクトの配列。

タグに一致したサービスおよびその子サービスに対して、ユーザーロールに読み取り専用アクセスが付与されます。読み取り専用アクセスは、サービスへの読み書きアクセスを上書きしません。

プロパティの動作:
- services.read.modeが"0"に設定されている場合にサポートされます
services.write.mode integer サービスへの読み書きアクセス。

使用可能な値:
0 - (デフォルト) services.write.listで指定された、またはservices.write.tagプロパティに一致したサービスへの読み書きアクセス;
1 - すべてのサービスへの読み書きアクセス。
services.write.list array Serviceオブジェクトの配列。

指定されたサービスおよびその子サービスに対して、ユーザーロールに読み書きアクセスが付与されます。読み書きアクセスは、サービスへの読み取り専用アクセスを上書きします。

プロパティの動作:
- services.write.modeが"0"に設定されている場合にサポートされます
services.write.tag object Service tagオブジェクトの配列。

タグに一致したサービスおよびその子サービスに対して、ユーザーロールに読み書きアクセスが付与されます。読み書きアクセスは、サービスへの読み取り専用アクセスを上書きします。

プロパティの動作:
- services.write.modeが"0"に設定されている場合にサポートされます
modules array moduleオブジェクトの配列。
modules.default_access integer 新しいモジュールへのアクセスを有効にするかどうか。

使用可能な値:
0 - 無効;
1 - (デフォルト) 有効。
api.access integer APIへのアクセスを有効にするかどうか。

使用可能な値:
0 - 無効;
1 - (デフォルト) 有効。
api.mode integer apiプロパティに一覧表示されたAPIメソッドの扱いを決定するモード。

使用可能な値:
0 - (デフォルト) 拒否リスト;
1 - 許可リスト。
api array APIメソッドの配列。
actions array actionオブジェクトの配列。
actions.default_access integer 新しいアクションへのアクセスを有効にするかどうか。

使用可能な値:
0 - 無効;
1 - (デフォルト) 有効。

UI要素

UI要素オブジェクトには、次のプロパティがあります。

Property Type Description
name string UI要素の名前。

type が Role オブジェクトで "User"、"Admin"、または "Super admin" に設定されている場合の可能な値:
monitoring.dashboard - ダッシュボード;
monitoring.problems - 監視 > 障害;
monitoring.hosts - 監視 > ホスト;
monitoring.latest_data - 監視 > 最新データ;
monitoring.maps - 監視 > マップ;
services.services - サービス > サービス;
services.sla_report - サービス > SLAレポート;
inventory.overview - インベントリ > 概要;
inventory.hosts - インベントリ > ホスト;
reports.availability_report - レポート > 可用性レポート;
reports.top_triggers - レポート > トリガー上位100件.

type が Role オブジェクトで "Admin" または "Super admin" に設定されている場合の可能な値:
monitoring.discovery - 監視 > ディスカバリ;
services.sla - サービス > SLA;
reports.scheduled_reports - レポート > スケジュール済みレポート;
reports.notifications - レポート > 通知;
configuration.template_groups - データ収集 > テンプレートグループ;
configuration.host_groups - データ収集 > ホストグループ;
configuration.templates - データ収集 > テンプレート;
configuration.hosts - データ収集 > ホスト;
configuration.maintenance - データ収集 > メンテナンス;
configuration.discovery - データ収集 > ディスカバリ;
configuration.trigger_actions - アラート > アクション > トリガーアクション;
configuration.service_actions - アラート > アクション > サービスアクション;
configuration.discovery_actions - アラート > アクション > ディスカバリアクション;
configuration.autoregistration_actions - アラート > アクション > 自動登録アクション;
configuration.internal_actions - アラート > アクション > 内部アクション.

type が Role オブジェクトで "Super admin" に設定されている場合の可能な値:
reports.system_info - レポート > システム情報;
reports.audit - レポート > 監査ログ;
reports.action_log - レポート > アクションログ;
configuration.event_correlation - データ収集 > イベント相関;
administration.media_types - アラート > メディアタイプ;
administration.scripts - アラート > スクリプト;
administration.user_groups - ユーザー > ユーザーグループ;
administration.user_roles - ユーザー > ユーザーロール;
administration.users - ユーザー > ユーザー;
administration.api_tokens - ユーザー > APIトークン;
administration.authentication - ユーザー > 認証;
administration.general - 管理 > 一般;
administration.audit_log - 管理 > 監査ログ;
administration.housekeeping - 管理 > ハウスキーピング;
administration.proxy_groups - 管理 > プロキシグループ;
administration.proxies - 管理 > プロキシ;
administration.macros - 管理 > マクロ;
administration.queue - 管理 > キュー.

Property behavior:
- 必須
status integer UI要素へのアクセスが有効かどうか。

可能な値:
0 - 無効;
1 - (default) 有効.

サービス

プロパティ 型 説明
serviceid ID サービスのID。

プロパティの動作:
- 必須

サービスタグ

プロパティ Type 説明
tag string タグ名。

空文字列が指定された場合、サービスタグはサービスのマッチングに使用されません。

プロパティの動作:
- 必須
value string タグ値。

値が指定されていない場合、または空文字列が指定された場合、サービスのマッチングにはタグ名のみが使用されます。

モジュール

モジュールオブジェクトには、以下のプロパティがあります。

プロパティ 型 説明
moduleid ID モジュールのID。

プロパティの動作:
- 必須
status integer モジュールへのアクセスが有効かどうか。

使用可能な値:
0 - 無効;
1 - (デフォルト) 有効。

アクション

アクションオブジェクトには、以下のプロパティがあります。

プロパティ 型 説明
name string アクション名。

Role オブジェクトの type が "User"、"Admin"、または "Super admin" に設定されている場合の指定可能な値:
edit_dashboards - ダッシュボードの作成と編集;
edit_maps - マップの作成と編集;
add_problem_comments - 障害コメントの追加;
change_severity - 障害の深刻度の変更;
acknowledge_problems - 障害の確認;
suppress_problems - 障害の抑制;
close_problems - 障害のクローズ;
execute_scripts - スクリプトの実行;
manage_api_tokens - APIトークンの管理;
change_problem_ranking - 障害の順位付けを原因から症状へ、またはその逆に変更;
edit_own_media - 自身のメディアの作成/編集を許可。

Role オブジェクトの type が "Admin" または "Super admin" に設定されている場合の指定可能な値:
edit_maintenance - メンテナンスの作成と編集;
manage_scheduled_reports - 定期レポートの管理,
manage_sla - SLAの管理。

Role オブジェクトの type が "User" または "Admin" に設定されている場合の指定可能な値:
invoke_execute_now - ホストに対して読み取り権限のみを持つユーザーがアイテムチェックを実行できるようにします。

Role オブジェクトの type が "Super admin" に設定されている場合の指定可能な値:
edit_user_media - ユーザーのメディアの作成/編集を許可。

プロパティの動作:
- 必須
status integer アクションの実行アクセスが有効かどうか。

指定可能な値:
0 - 無効;
1 - (デフォルト) 有効。