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

24.4. メソッド

24.4.1. イベントの検索
リンクのコピー

events コレクションは、他のリソースコレクションと同様の検索クエリーを提供します。events コレクションを検索する際には、特定のイベント以降のイベントを検索する追加機能があります。これにより、指定されたイベント以降の全イベントに対するクエリーを実行することができます。
イベントからクエリーを実行するには、検索クエリーの前に from パラメーターを追加する必要があります。この from 引数はイベント id コードを参照します。

例24.3 指定したイベント以降のイベントを対象とする検索

GET /api/events;from=1012?search=type%3D30 HTTP/1.1
Accept: application/xml
id="1012" 以降で、type が 30 に指定されたイベントをすべて表示します。 
HTTP/1.1 200 OK
Content-Type: application/xml
<events>
    <event id="1018" href="/api/events/1018">
        <description>User admin logged in.</description>
        <code>30</code>
        <severity>normal</severity>
        <time>2011-07-11T14:03:22.485+10:00</time>
        <user id="80b71bae-98a1-11e0-8f20-525400866c73"
          href="/api/users/80b71bae-98a1-11e0-8f20-525400866c73"/>
    </event>
    <event id="1016" href="/api/events/1016">
        <description>User admin logged in.</description>
        <code>30</code>
        <severity>normal</severity>
        <time>2011-07-11T14:03:07.236+10:00</time>
        <user id="80b71bae-98a1-11e0-8f20-525400866c73"
          href="/api/users/80b71bae-98a1-11e0-8f20-525400866c73"/>
    </event>
    <event id="1014" href="/api/events/1014">
        <description>User admin logged in.</description>
        <code>30</code>
        <severity>normal</severity>
        <time>2011-07-11T14:02:16.009+10:00</time>
        <user id="80b71bae-98a1-11e0-8f20-525400866c73"
          href="/api/users/80b71bae-98a1-11e0-8f20-525400866c73"/>
    </event>
</events>

例24.4 特定のイベント重大度を使用した検索

GET /api/events?search=severity>normal HTTP/1.1
Accept: application/xml
重大度が normal を超えるすべてのイベントを表示します。重大度のレベルには normal、warning、error、および alert があります。 
HTTP/1.1 200 OK
Content-Type: application/xml
<events>
    <event id="2823" href="/api/events/2823">
        <description>Host Host-05 has time-drift of 36002 seconds while maximum configured value is 300 seconds.</description>
        <code>604</code>
        <severity>warning</severity>
        <time>2015-07-11T14:03:22.485+10:00</time>
        <host href= "/api/hosts/44e52bb2-27d6-4d35-8038-0c4b4db89789" id="44e52bb2-27d6-4d35-8038-0c4b4db89789"/>
        <cluster href= "/api/clusters/00000001-0001-0001-0001-00000000021b" id="00000001-0001-0001-0001-00000000021b"/>
        <origin>oVirt</origin>
        <custom_id>-1</custom_id>
        <flood_rate>30</flood_rate>
    </event>
...
</events>

24.4.2. イベントのページネーション処理
リンクのコピー

仮想化環境では、一定時間が経過すると、大量のイベントが生成されますが、API は 1 回の検索でデフォルト数のイベントしか表示しません。デフォルト数以上のイベント数を表示するには、検索クエリーに page コマンドを使用すると、API が結果を複数のページに分割します。
以下の検索クエリーは、page 値を sortby と併用して、結果をページネーションするように API に指示します。
sortby time asc page 1
sortby 句は、結果を昇順または降順に順序付けするためのベース要素を定義します。events の検索クエリーの場合は、ベース要素を time に、順序を昇順 (asc) に指定すると、API は仮想化環境の作成以降の全イベントを表示します。
page 条件はページ数を定義します。1 ページは、表示するイベントのデフォルト数に相当します。ページネーションは page 1 から開始します。さらにページを表示するには、page 値を増やします。
sortby time asc page 2
sortby time asc page 3
sortby time asc page 4

例24.5 イベントのページネーション

以下の例は event リソースのページネーションを行います。URL エンコードされた要求は次のとおりです。 
GET /api/events?search=sortby%20time%20asc%20page%201 HTTP/1.1
Accept: application/xml
page 値を増やして次の結果ページを表示します。 
GET /api/events?search=sortby%20time%20asc%20page%202 HTTP/1.1
Accept: application/xml
from 引数を追加し、開始する id を指定します。 
GET /api/events?search=sortby%20time%20asc%20page%202&from=30 HTTP/1.1
Accept: application/xml

24.4.3. イベントの追加
リンクのコピー

API では、POST 要求でカスタムイベントを events コレクションに追加することができます。新規イベントには、 description、severity、origin、custom_id 要素が必要です。カスタムイベントには、イベントに関連するリソースの flood_rate、user id、id のコードを含めることも可能です。host および storage_domain 要素に external_status を含めて、外部のヘルスステータスを設定することも可能です。

例24.6 カスタムイベントのイベント一覧への追加

POST /api/events HTTP/1.1
Accept: application/xml
Content-type: application/xml

<event>
  <description>The heat of the host is above 30 Oc</description>
  <severity>warning</severity>
  <origin>HP Openview</origin>
  <custom_id>1</custom_id>
  <flood_rate>30</flood_rate>
  <host id="f59a29cd-587d-48a3-b72a-db537eb21957" >
    <external_status>
       <state>warning</state>
    </external_status>
  </host>
</event>

24.4.4. イベントの削除
リンクのコピー

イベント一覧からイベントを削除するには、DELETE 要求が必要になります。

例24.7 イベントの削除

DELETE /api/events/1705 HTTP/1.1

HTTP/1.1 204 No Content
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2026 Red Hatトップに戻る