6.96. 文件
提供了一种方式，供客户端列出可用的文件。
此服务专用于 ISO 存储域，后者包含管理员上传的 ISO 映像和虚拟软盘(VFD)。
向虚拟机中添加 CD-ROM 设备需要来自 ISO 存储域文件的 ISO 映像。
| 名称 | 概述 |
|---|---|
|
| 返回存储域中可用的 ISO 映像和虚拟软盘的列表。 |
6.96.1. 列出 GET
返回存储域中可用的 ISO 映像和虚拟软盘的列表。无法保证返回列表的顺序。
如果 刷新 参数为 false，则返回的列表可能无法反映对存储域的最新更改；例如，它可能不包含最近添加的新 ISO 文件。这是因为服务器缓存文件列表以提高性能。要获得最新结果，请将 refresh 参数设置为 true。
refresh 参数的默认值为 true，但可使用配置值 force RefreshDomainFilesByDefault 更改：
# engine-config -s ForceRefreshDomainFilesByDefault=false
将 refresh 参数的值设置为 true 会影响服务器的性能。必要时才使用。
| 名称 | 类型 | 方向 | 概述 |
|---|---|---|---|
|
| in |
指明是否使用 | |
|
| out | ||
|
| in | 指明应遵循哪些内联链接。 | |
|
| in | 设置要返回的最大文件数。 | |
|
| in | 指明是否应从存储域刷新文件列表，而不显示以特定间隔更新的缓存结果。 | |
|
| in | 用于限制返回文件的查询字符串。 |
6.96.1.1. case_sensitive
指明是否使用 search 参数进行的搜索应考虑大小写。默认值为 true。
6.96.1.2. follow
指明应遵循哪些内联链接。这些链接引用的对象将在当前请求中获取。详情请查看此处。
6.96.1.3. Max
设置要返回的最大文件数。如果未指定，则返回所有文件。
