3.7.3. 検索構文

検索 パラメーターは、Red Hat Virtualization クエリー言語と同じ形式を使用します。

(criteria) [sortby (element) asc|desc]

(criteria) [sortby (element) asc|desc]

Copy to Clipboard

Toggle word wrap

sortby 句はオプションで、結果を順序付ける場合にのみ必要です。

検索クエリーの例

Expand

コレクション	基準	結果
`hosts`	`vms.status=up`	`稼働` 中の仮想マシンを実行しているすべてのホスト一覧を返します。
`vms`	`domain=example.com`	指定されたドメインで稼働しているすべての仮想マシンの一覧を返します。
`vms`	`users.name=mary`	ユーザー名が `Mary` のユーザーに属する全仮想マシンの一覧を返します。
`events`	`severity > normal sortby time`	重大度が `通常` よりも高いすべてのイベントの一覧を返します。`time` 属性の値でソートされます。
`events`	`severity > normal sortby time desc`	重大度が `通常` よりも高いすべてのイベントの一覧を返します。`time` 属性の値を降順で並び替えます。

search パラメーターの値は、演算子やスペースなどの予約済み文字を変換するために URL エンコードされている必要があります。たとえば、等号記号は %3D としてエンコードする必要があります。

GET /ovirt-engine/api/vms?search=name%3Dmyvm

GET /ovirt-engine/api/vms?search=name%3Dmyvm

Copy to Clipboard

Toggle word wrap

トップに戻る