6.227. タグ

システム内の特定のタグを管理するサービス。

タグに関する情報を取得します。

たとえば、ID 123 のタグに関する情報を取得するには、以下のようなリクエストを送信します。

GET /ovirt-engine/api/tags/123

<tag href="/ovirt-engine/api/tags/123" id="123">
  <name>root</name>
  <description>root</description>
</tag>

表6.689 パラメーターの概要
名前	タイプ	方向	概要
`follow`	文字列	In	たどる必要のある内部リンクを指定します。
`tag`	タグ	Out	タグ。

たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちらを参照してください。

システムからタグを削除します。

たとえば、ID 123 のタグを削除するには、以下のようなリクエストを送信します。

DELETE /ovirt-engine/api/tags/123

表6.690 パラメーターの概要
名前	タイプ	方向	概要
`async`	Boolean	In	削除を非同期的に実行するかどうかを指定します。

タグエンティティーを更新します。

たとえば、親タグを ID 123 のタグの ID 456 のタグに更新するには、以下のようなリクエストを送信します。

PUT /ovirt-engine/api/tags/123

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

<tag>
  <parent id="456"/>
</tag>

ID の代わりにタグ名を指定することもできます。たとえば、親タグを ID 123 のタグの mytag という名前のタグに更新するには、以下のようなリクエストを送信します。

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

表6.691 パラメーターの概要
名前	タイプ	方向	概要
`async`	Boolean	In	更新を非同期的に実行するかどうかを指定します。
`tag`	タグ	In/Out	更新されたタグ。