2.3. 服务

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 对象并不是虚拟机的表示。它是用于检索、更新、删除、启动和停止虚拟机的服务。