[comment]: # translation:outdated

[comment]: # ({2135842b-2135842b})
# > Roleオブジェクト

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

[comment]: # ({/2135842b-2135842b})

[comment]: # ({84ee8c53-1708e020})
### Role

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

|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|roleid|string|*(読取専用)*ロールID|
|**name**<br>(必須)|string|ロール名|
|**type**<br>(必須)|integer|ユーザータイプ<br><br>使用可能な値:<br>1 - *(デフォルト)*ユーザー<br>2 - 管理者<br>3 - 特権管理者|
|readonly|integer|*(読取専用)*ロールが読み取り専用かどうか<br><br>使用可能な値:<br>0 - *(デフォルト)*いいえ<br>1 - はい|

[comment]: # ({/84ee8c53-1708e020})

[comment]: # ({672ddb55-8a9b3008})
### Role rules

role rules オブジェクトには次のプロパティがあります。

|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|ui|array|[UI element](object#ui_element) オブジェクトの配列|
|ui.default\_access|integer|新しい UIエレメントへのアクセスを有効にするかどうか。<br><br>使用可能な値：<br>0 - 無効<br>1 - *(デフォルト)* 有効|
|services.read.mode|integer|サービスへの読み取り専用アクセス。<br><br>使用可能な値：<br><br>0 - `services.read.list`で指定されるか、`services.read.tag`プロパティで一致するサービスへの読み取り専用アクセス。<br>1 - *(デフォルト)* すべてのサービスへの読み取り専用アクセス。|
|services.read.list|array|[Service](object#service) オブジェクトの配列。<br><br>子サービスを含む指定されたサービスには、ユーザー ロールへの読み取り専用アクセスが付与されます。 読み取り専用アクセスは、サービスへの読み取り/書き込みアクセスをオーバーライドしません。<br><br>`services.read.mode` が 0 に設定されている場合にのみ使用されます。|
|services.read.tag|object|[Service tag](object#service_tag) オブジェクトの配列。<br><br>タグに一致するサービス (子サービスを含む) には、ユーザー ロールへの読み取り専用アクセスが付与されます。 読み取り専用アクセスは、サービスへの読み取り/書き込みアクセスをオーバーライドしません。<br><br>`services.read.mode` が 0 に設定されている場合にのみ使用されます。|
|services.write.mode|integer|サービスへの読み取り/書き込みアクセス。<br><br>使用可能な値:<br><br>0 - (デフォルト) サービスへの読み書きアクセス。`services.write.list` で指定されるか、`services.write.tag` プロパティで一致します。<br>1 - すべてのサービスへの読み取り/書き込みアクセス。|
|services.write.list|array|[Service](object#service) オブジェクトの配列。<br><br>子サービスを含む指定されたサービスには、ユーザー ロールへの読み取り/書き込みアクセスが付与されます。 読み取り/書き込みアクセスは、サービスへの読み取り専用アクセスをオーバーライドします。<br><br>`services.write.mode` が 0 に設定されている場合にのみ使用されます。|
|services.write.tag|object|[Service tag](object#service_tag) オブジェクトの配列。<br><br>タグに一致するサービス (子サービスを含む) には、ユーザー ロールへの読み取り/書き込みアクセスが付与されます。 読み取り/書き込みアクセスは、サービスへの読み取り専用アクセスをオーバーライドします。<br><br>`services.write.mode` が 0 に設定されている場合にのみ使用されます。|
|modules|array|[module](object#module) オブジェクトの配列|
|modules.default\_access|integer|新しいモジュールへのアクセスを有効にするか<br><br>使用可能な値：<br>0 - 無効<br>1 - *(デフォルト)* 有効|
|api.access|integer|API へのアクセスが有効か<br><br>使用可能な値：<br>0 - 無効<br>1 - *(デフォルト)* 有効|
|api.mode|integer|`api` プロパティにリストされた API メソッドを処理するためのモード<br><br>使用可能な値：<br>0 - *(デフォルト)* 拒否リスト<br>1 - 許可リスト|
|api|array|API メソッドの配列。|
|actions|array|[action](object#action) オブジェクトの配列。|
|actions.default\_access|integer|新しいアクションへのアクセスを有効にするか<br><br>使用可能な値：<br>0 - 無効<br>1 - *(デフォルト)* 有効|

[comment]: # ({/672ddb55-8a9b3008})

[comment]: # ({6e1ef027-006cdfb5})
### UI element

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

|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|**name**<br>(必須)|string|UIエレメント名<br><br>使用可能な値：<br>`monitoring.dashboard` - *監視データ → ダッシュボード*;<br>`monitoring.problems` - *監視データ → 障害*;<br>`monitoring.hosts` - *監視データ → ホスト*;<br>`monitoring.latest_data` - *監視データ → 最新データ*;<br>`monitoring.maps` - *監視データ → マップ*;<br>`services.services` - *サービス → サービス*;<br>`services.sla_report` - *サービス → SLAレポート*;<br>`inventory.overview` - *インベントリ → 概要*;<br>`inventory.hosts` - *インベントリ → ホスト*;<br>`reports.availability_report` - *レポート → 稼働レポート*;<br>`reports.top_triggers` - *レポート → 障害発生数上位100項目*.<br><br>*管理者*および*特権管理者*ユーザー タイプのみ使用可能な値:<br>`monitoring.discovery` - *監視データ → ディスカバリ*;<br>`services.actions` - *サービス → サービスアクション*;<br>`services.sla` - *サービス  → SLA*;<br>`reports.scheduled_reports` - *レポート → 定期レポート*;<br>`reports.notifications` - *レポート → 通知レポート*;<br>`configuration.host_groups` - *設定 → ホストグループ*;<br>`configuration.templates` - *設定 → テンプレート*;<br>`configuration.hosts` - *設定 → ホスト*;<br>`configuration.maintenance` - *設定 → メンテナンス*;<br>`configuration.actions` - *設定 → アクション*;<br>`configuration.discovery` - *設定 → ディスカバリ*.<br><br>*特権管理者*ユーザー タイプのみ使用可能な値:<br>`reports.system_info` - *レポート → システム情報*;<br>`reports.audit` - *レポート → 監査*;<br>`reports.action_log` - *レポート → アクションログ*;<br>`configuration.event_correlation` - *設定 → イベント相関関係*;<br>`administration.general` - *管理 → 一般設定*;<br>`administration.proxies` - *管理 → プロキシ*;<br>`administration.authentication` - *管理 → 認証*;<br>`administration.user_groups` - *管理 → ユーザーグループ*;<br>`administration.user_roles` - *管理 → ユーザーロール*;<br>`administration.users` - *管理 → ユーザー*;<br>`administration.media_types` - *管理 → メディアタイプ*;<br>`administration.scripts` - *管理 → スクリプト*;<br>`administration.queue` - *管理 → キュー*|
|status|integer|UI 要素へのアクセスが有効か<br><br>使用可能な値：<br>0 - 無効<br>1 - *(デフォルト)* 有効|

[comment]: # ({/6e1ef027-006cdfb5})

[comment]: # ({1ef3faf9-ebf4bb3a})
### Service

|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|**serviceid**<br>(必須)|string|サービスID|

[comment]: # ({/1ef3faf9-ebf4bb3a})

[comment]: # ({54254705-300e6d5b})
### Service tag

|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|**tag**<br>(必須)|string|タグ名<br><br>空の文字列が指定されている場合、サービスタグはサービスマッチングに使用されません。|
|value|string|タグ値<br><br>値がないか空の文字列の場合、サービスの照合にはタグ名のみが使用されます。|

[comment]: # ({/54254705-300e6d5b})

[comment]: # ({7dead620-f70e75e9})
### Module

module オブジェクトには次のプロパティがあります

|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|**moduleid**<br>(必須)|string|モジュールID|
|status|integer|モジュールへのアクセスが有効か<br><br>使用可能な値：<br>0 - 無効<br>1 - *(デフォルト)*有効|

[comment]: # ({/7dead620-f70e75e9})

[comment]: # ({47103f0e-957a00bb})
### Action

action オブジェクトには次のプロパティがあります

|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|**name**<br>(必須)|string|アクション名<br><br>任意のタイプのユーザーに可能な値：<br>`edit_dashboards` - ダッシュボードの作成と編集<br>`edit_maps` - マップの作成と編集<br>`add_problem_comments` - 障害のコメント追加<br>`change_severity` - 障害の深刻度を変更<br>`acknowledge_problems` - 障害を確認<br>`close_problems` - 障害をクローズします<br>`execute_scripts` - スクリプトを実行<br>`manage_api_tokens ` - APIトークンを管理<br><br>*Admin*および*Superadmin *ユーザータイプのユーザーにのみ可能な値：<br>`edit_maintenance` - メンテナンスの作成および編集<br>`manage_scheduled_reports` - レポートのスケジュール管理|
|status|integer|アクションを実行するためのアクセスが有効か<br><br>使用可能な値：<br>0 - 無効<br>1 - *(デフォルト)*有効|

[comment]: # ({/47103f0e-957a00bb})
