role.create

説明

object role.create(object/array roles)

このメソッドで、新しいロールを作成できます。

このメソッドはSuper adminユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細についてはユーザーの役割を参照してください。

パラメータ

(object/array) 作成するロール

このメソッドは標準のロールプロパティに加えて、次のパラメーターを受け入れます。

パラメータ タイプ 説明
rules array ロール用に作成されるロールルール

戻り値

(object) roleidsプロパティの下に作成されたロールのIDを含むオブジェクトを返します。 返されるIDの順序は、渡されたロールの順序と一致します。

ロールの作成

タイプが"ユーザー"で、2つのUI要素へのアクセスを拒否するロールを作成します。

Request:

{
           "jsonrpc": "2.0",
           "method": "role.create",
           "params": {
               "name": "Operator",
               "type": "1",
               "rules": {
                   "ui": [
                       {
                           "name": "monitoring.hosts",
                           "status": "0"
                       },
                       {
                           "name": "monitoring.maps",
                           "status": "0"
                       }
                   ]
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "roleids": [
                   "5"
               ]
           },
           "id": 1
       }

参照

ソース

CRole::create() in ui/include/classes/api/services/CRole.php.