2.3. 服务

2.3.1. 检索服务

API 提供了一组服务,每个服务都与服务器路径相关联。例如,管理系统中虚拟机集合的服务位于 /vms 中,而管理具有标识符 123 的虚拟机的服务则位于 /vms/123 中。

在 Ruby 软件开发套件中,服务的树根由系统 服务实施。它通过调用连接的 system_service 方法来获取:

检索系统服务

system_service = connection.system_service

旦您对系统服务的引用,就可以使用 *_ service 方法(称为服务 locator s)检索对其他服务的引用。

例如,要检索对系统中虚拟机集合的服务的引用,您可以使用 vms_service 服务 locator:

检索其他服务

vms_service = system_service.vms_service

要检索对使用标识符 123 管理虚拟机的服务的引用,请使用 vm_service 服务的 service locator。服务 locator 使用虚拟机标识符作为参数:

使用标识符检索虚拟机服务

vm_service = vms_service.vms_service('123')

重要

服务 locator 调用返回的对象是纯服务,不包含数据。例如,在上一示例中检索到的 vm_service Ruby 对象并不是虚拟机的表示。它是用于检索、更新、删除、启动和停止虚拟机的服务。