6.27. AssignedTags
システムの特定のエンティティーへのタグの割り当てを管理するサービス。
名前 | 概要 |
---|---|
| システムの特定のエンティティーにタグを割り当てます。 |
| 特定のエンティティーに割り当てられたすべてのタグを一覧表示します。 |
6.27.1. add POST
システムの特定のエンティティーにタグを割り当てます。
たとえば、ID が 123
の仮想マシンにタグ mytag
を割り当てるには、次のようなリクエストを送信します。
POST /ovirt-engine/api/vms/123/tags
リクエスト本文は以下のようになります。
<tag> <name>mytag</name> </tag>
名前 | タイプ | 方向 | 概要 |
---|---|---|---|
| In/Out | 割り当てられたタグ。 |
6.27.2. list GET
特定のエンティティーに割り当てられたすべてのタグを一覧表示します。
たとえば、id 123
の仮想マシンのタグの一覧を表示するには、以下のようにリクエストを送信します。
GET /ovirt-engine/api/vms/123/tags
<tags> <tag href="/ovirt-engine/api/tags/222" id="222"> <name>mytag</name> <description>mytag</description> <vm href="/ovirt-engine/api/vms/123" id="123"/> </tag> </tags>
返されるタグの順序は保証されません。
名前 | タイプ | 方向 | 概要 |
---|---|---|---|
| In | たどる 必要のある内部リンクを指定します。 | |
| In | 返すタグの最大数を設定します。 | |
| Tag[] | Out | 割り当てられたタグの一覧。 |
6.27.2.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.27.2.2. max
返すタグの最大数を設定します。指定されていない場合は、すべてのタグが返されます。