6.224. SystemOption
システムの特定の設定オプションの値を提供するサービス。
| 名前 | 概要 |
|---|---|
|
| 特定の設定オプションの値を取得します。 |
6.224.1. get GET
特定の設定オプションの値を取得します。
たとえば、設定オプション MigrationPolicies の値を取得するには、以下のようなリクエストを送信します。
GET /ovirt-engine/api/options/MigrationPolicies
そのリクエストに対する応答は以下のようになります。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<system_option href="/ovirt-engine/api/options/MigrationPolicies" id="MigrationPolicies">
<name>MigrationPolicies</name>
<values>
<system_option_value>
<value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
<version>4.2</version>
</system_option_value>
<system_option_value>
<value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
<version>4.3</version>
</system_option_value>
<system_option_value>
<value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
<version>4.4</version>
</system_option_value>
<system_option_value>
<value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
<version>4.5</version>
</system_option_value>
<system_option_value>
<value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
<version>4.6</version>
</system_option_value>
<system_option_value>
<value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
<version>4.7</version>
</system_option_value>
</values>
</system_option>設定オプションをクエリーするには、適切な権限が必要です。一部のオプションは、管理者権限を持つユーザーのみがクエリーできます。
後方互換性はなく、オプションの名前または値についての保証もありません。オプションは削除でき、その意味はいつでも変更することができます。
エンジンと同時にリリースされるアプリケーション以外では、このサービスを使用しないことを強くお勧めします。他のアプリケーションでの使用はサポートされていません。したがって、アクセス可能な設定オプションを記載したドキュメントはありません。
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| Out | システムの返された設定オプション。 | |
|
| In | 設定オプションの特定のバージョンのみを返す必要があることを指定するオプションのバージョンパラメーター。 |
6.224.1.1. version
設定オプションの特定のバージョンのみを返す必要があることを指定するオプションのバージョンパラメーター。このパラメーターが使用されない場合は、すべてのバージョンが返されます。
たとえば、バージョン 4.2 のみの MigrationPolicies オプションの値を取得するには、以下のようなリクエストを送信します。
GET /ovirt-engine/api/options/MigrationPolicies?version=4.2
その要求に対する応答は以下のようになります。
<system_option href="/ovirt-engine/api/options/MigrationPolicies" id="MigrationPolicies">
<name>MigrationPolicies</name>
<values>
<system_option_value>
<value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
<version>4.2</version>
</system_option_value>
</values>
</system_option>