23.3. タグの関連付け

23.3.1. ホスト、ユーザー、仮想マシンへのタグの関連付け

host、user、または vms の link rel="tags" によって参照されるコレクションは、そのエンティティーに関連付けられたタグセットを示します。
これらの tag 表現には、対象となるエンティティーへの host id、user id、vm id 参照も含まれます。
エンティティーへのタグの関連付けは、コレクションに対してタグ参照を POST (id または name のいずれかでタグを特定) することによって行います。

例23.2 仮想マシンへのタグの関連付け

POST /api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720/tags HTTP/1.1
Accept: application/xml
Content-Type: application/xml

<tag>
    <name>Finance</name>
</tag>

HTTP/1.1 201 Created
Content-Type: application/xml

<tag id="f436ebfc-67f2-41bd-8ec6-902b6f7dcb5e"
  href="/api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720/tags/
  f436ebfc-67f2-41bd-8ec6-902b6f7dcb5e">
    <name>Finance</name>
    <description>Resources for the Finance department</description>
    <vm id="5114bb3e-a4e6-44b2-b783-b3eea7d84720"
      href="/api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720"/>
</tag>

23.3.2. タグの削除

タグの関連付けを削除するには、コレクション内の適切な要素に対して DELETE 要求を実行します。

例23.3 仮想マシンからのタグ削除

DELETE /api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720/tags/f436ebfc-67f2-41bd-8ec6-902b6f7dcb5e HTTP/1.1

HTTP/1.1 204 No Content

23.3.3. タグ付けしたリソースのコレクションに対するクエリーの実行

特定のタグに関連付けられたリソースセットに対してクエリーを実行する場合は、適切なコレクションの collection/search URI テンプレートを使用して tag=MyTag に一致するエンティティーの検索を行います。

例23.4 タグ付けしたリソースのコレクションに対するクエリーの実行

GET /api/vms?search=tag%3DFinance HTTP/1.1
Accept: application/xml

HTTP/1.1 200 OK
Content-Type: application/xml

<vms>
    <vm id="5114bb3e-a4e6-44b2-b783-b3eea7d84720"
      href="/api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720">
        ...
    </vm>
    ...
</vms>