6.226. SystemPermissions

特定のエンティティーのユーザーまたはグループに新しいパーミッションを割り当てます。

たとえば、UserVmManager ロールを ID が 123 の仮想マシン、id が 456 のユーザーに割り当てるには、以下のようなリクエストを送信します。

POST /ovirt-engine/api/vms/123/permissions

リクエスト本文は以下のようになります。

<permission>
  <role>
    <name>UserVmManager</name>
  </role>
  <user id="456"/>
</permission>

id が 456 のユーザーに SuperUser ロールを割り当てるには、以下のように要求を送信します。

POST /ovirt-engine/api/permissions

リクエスト本文は以下のようになります。

<permission>
  <role>
    <name>SuperUser</name>
  </role>
  <user id="456"/>
</permission>

ユーザーの代わりにグループにパーミッションを割り当てる場合は、user 要素を group の適切な ID に置き換えます。たとえば、UserRole ロールを ID が 123 のクラスター、ID が 789 のグループに割り当てるには、以下のような要求を送信します。

POST /ovirt-engine/api/clusters/123/permissions

リクエスト本文は以下のようになります。

<permission>
  <role>
    <name>UserRole</name>
  </role>
  <group id="789"/>
</permission>

特定のエンティティーのすべてのパーミッションをリスト表示します。

たとえば、id 123 のクラスターのすべての権限をリスト表示するには、以下のように要求を送信します。

GET /ovirt-engine/api/clusters/123/permissions

<permissions>
  <permission id="456">
    <cluster id="123"/>
    <role id="789"/>
    <user id="451"/>
  </permission>
  <permission id="654">
    <cluster id="123"/>
    <role id="789"/>
    <group id="127"/>
  </permission>
</permissions>

返されるパーミッションの順序は保証されません。