6.224. SystemOption
此服务提供系统特定配置选项的值。
名称 | 概述 |
---|---|
| 获取特定配置选项的值。 |
6.224.1. 获取 GET
获取特定配置选项的值。
例如,要检索配置选项 MigrationPoliciesSupported
的值,发送类似如下的请求:
GET /ovirt-engine/api/options/MigrationPoliciesSupported
对这个请求的响应如下:
<system_option href="/ovirt-engine/api/options/MigrationPoliciesSupported" id="MigrationPoliciesSupported"> <name>MigrationPoliciesSupported</name> <values> <system_option_value> <value>true</value> <version>4.0</version> </system_option_value> <system_option_value> <value>true</value> <version>4.1</version> </system_option_value> <system_option_value> <value>true</value> <version>4.2</version> </system_option_value> <system_option_value> <value>false</value> <version>3.6</version> </system_option_value> </values> </system_option>
查询配置选项需要适当的权限。某些选项仅可由具备管理员权限的用户查询。
没有向后兼容,无法保证选项的名称或值。可以删除选项,也可以随时更改其含义。
我们强烈建议将此服务用于与引擎同时发布的应用程序之外的应用程序。不支持其他应用程序的使用。因此,不会有文档列出可访问的配置选项。
名称 | 类型 | 方向 | 概述 |
---|---|---|---|
| out | 系统返回的配置选项。 | |
| in | 指定仅应返回特定版本的配置选项的可选 version 参数。 |
6.224.1.1. version
指定仅应返回特定版本的配置选项的可选 version 参数。如果未使用这个参数,则会返回所有版本。
例如,要获取 MigrationPoliciesSupported
选项的值,但只有版本 4.2
发送如下请求:
GET /ovirt-engine/api/options/MigrationPoliciesSupported?version=4.2
对这个请求的响应如下:
<system_option href="/ovirt-engine/api/options/MigrationPoliciesSupported" id="MigrationPoliciesSupported"> <name>MigrationPoliciesSupported</name> <values> <system_option_value> <value>true</value> <version>4.2</version> </system_option_value> </values> </system_option>