6.228. タグ

システムに新しいタグを追加します。

たとえば、mytag という名前の新しいタグをシステムに追加するには、以下のようなリクエストを送信します。

POST /ovirt-engine/api/tags

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

<tag>
  <name>mytag</name>
</tag>

特定の親タグを持つ新しいタグを作成するには、以下のようなリクエスト本文を送信します。

<tag>
  <name>mytag</name>
  <parent>
    <name>myparenttag</name>
  </parent>
</tag>

システム内のタグを一覧表示します。

たとえば、システム内のタグの完全な階層を一覧表示するには、以下のようなリクエストを送信します。

GET /ovirt-engine/api/tags

<tags>
  <tag href="/ovirt-engine/api/tags/222" id="222">
    <name>root2</name>
    <description>root2</description>
    <parent href="/ovirt-engine/api/tags/111" id="111"/>
  </tag>
  <tag href="/ovirt-engine/api/tags/333" id="333">
    <name>root3</name>
    <description>root3</description>
    <parent href="/ovirt-engine/api/tags/222" id="222"/>
  </tag>
  <tag href="/ovirt-engine/api/tags/111" id="111">
    <name>root</name>
    <description>root</description>
  </tag>
</tags>

前の XML 出力では、以下のようなタグの階層を確認できます。

root:        (id: 111)
  - root2    (id: 222)
    - root3  (id: 333)

返されるタグ一覧の順序は保証されません。