Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

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>
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る