2.3. 服务

API 提供了一组服务，每个服务都与服务器路径相关联。例如，管理系统中虚拟机集合的服务位于 /vms 中，而用于管理 ID 为 123 的虚拟机的服务位于 /vms/123 中。

在 Ruby 软件开发工具包中，该服务树的 root 是由系统服务 实施的。它通过调用连接的 system_service 方法来检索：

检索系统服务

system_service = connection.system_service

引用系统服务后，您可以使用 *_ service 方法（称为服务 定位器）来检索对其他服务的引用。

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

检索其他服务

vms_service = system_service.vms_service

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

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

vm_service = vms_service.vms_service('123')

重要

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