2.5. サービスの場所

API は一連のサービスを提供し、それぞれがサーバーの URL スペース内のパスに関連付けられています。たとえば、システムの仮想マシンのコレクションを管理するサービスは /vms にあり、識別子 123 の仮想マシンを管理するサービスは /vms/123 にあります。

SDK では、そのサービスツリーのルートはシステムサービスによって実装されます。これは、接続の system_service メソッドを呼び出して取得されます。

system_service = connection.system_service()

このシステムサービスへの参照がある場合、それを使用し、前のサービスのサービスロケーターと呼ばれる *_service メソッドを呼び出して、他のサービスへの参照を取得できます。たとえば、システムの仮想マシンのコレクションを管理するサービスへの参照を取得するには、vms_service サービスロケーターを使用します。

vms_service = system_service.vms_service()

識別子 123 の仮想マシンを管理するサービスへの参照を取得するには、仮想マシンのコレクションを管理するサービスの vm_service サービスロケーターを使用します。これは、仮想マシンの識別子をパラメーターとして使用します。

vm_service = vms_service.vm_service('123')