3.7. 検索

一部のサービスの list メソッドには、検索 条件を指定するために使用できる search パラメーターがあります。これを使用すると、サーバーはこれらの条件を満たすコレクション内のオブジェクトのみを返します。たとえば、以下の要求では myvm という名前の仮想マシンのみを返します。

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

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

Copy to Clipboard

Toggle word wrap

max パラメーターを使用して、返されるオブジェクトの数を制限します。たとえば、以下の要求は、システムで利用可能なものに関係なく、仮想マシンが 1 つだけ返されます。

GET /ovirt-engine/api/vms?max=1

GET /ovirt-engine/api/vms?max=1

Copy to Clipboard

Toggle word wrap

max パラメーターのない検索要求は、すべてのオブジェクトを返します。システムの全体的なパフォーマンスにおける要求の影響を減らすために、max パラメーターを指定することが推奨されます。

トップに戻る