6.184. ロール
名前 | Summary |
---|---|
| ロールを取得します。 |
| ロールを削除します。 |
| ロールを更新します。 |
6.184.1. get GET
ロールを取得します。
GET /ovirt-engine/api/roles/123
以下のような XML 応答を受け取ります。
<role id="123"> <name>MyRole</name> <description>MyRole description</description> <link href="/ovirt-engine/api/roles/123/permits" rel="permits"/> <administrative>true</administrative> <mutable>false</mutable> </role>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | たどる 必要のある内部リンクを指定します。 | |
| Out | ロールを取得しました。 |
6.184.1.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.184.2. remove DELETE
ロールを削除します。
ロールを削除するには、その ID を知る必要があります。以下のようにリクエストを送信します。
DELETE /ovirt-engine/api/roles/{role_id}
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | 削除を非同期的に実行するかどうかを指定します。 |
6.184.3. update PUT
ロールを更新します。ロールの作成後に、name
、description
、および administrative
属性を更新できます。このエンドポイント内では、ロールの permits を管理する サービス を使用するために、必要なロールの permits を追加または削除することはできません。
たとえば、ロールの name
、description
、および administrative
属性を更新するには、以下のようなリクエストを送信します。
PUT /ovirt-engine/api/roles/123
リクエスト本文は以下のようになります。
<role> <name>MyNewRoleName</name> <description>My new description of the role</description> <administrative>true</administrative> </group>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | 更新を非同期的に実行するかどうかを指定します。 | |
| In/Out | ロールを更新しました。 |