2.5. 查找服务

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

在 SDK 中，该服务树根由系统服务实施。它获取调用连接的 system_service 方法：

system_service = connection.system_service()

当您对此系统服务的引用时，您可以使用它来获取对其他服务的引用，调用之前服务的 *_service 方法（名为 service locators）。例如，若要获取管理系统虚拟机集合的服务的引用，您可以使用 vms_service 服务 locator：

vms_service = system_service.vms_service()

要获取对使用标识符 123 管理虚拟机的服务的引用，您可以使用管理虚拟机集合的服务 vm_service 服务 locator。它使用虚拟机的标识符作为参数：

vm_service = vms_service.vm_service('123')

重要

调用服务 locators 不会向服务器发送请求。它们返回的 Python 对象是纯服务，不包含任何数据。例如，本例中调用的 vm_service Python 对象并不是虚拟机的表示。它是用于检索、更新、删除、启动和停止该虚拟机的服务。