2.3. サービス

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

Ruby ソフトウェア開発キットでは、そのサービスツリーの root は system service によって実装されます。これは、接続の system_service メソッドを呼び出すことによって取得されます。

system_service = connection.system_service

system_service = connection.system_service

system service への参照を取得したら、それを使用して、*_service メソッド (service locators と呼ばれる) を使用して、他のサービスへの参照を取得できます。

たとえば、システム内の仮想マシンのコレクションを管理するサービスへの参照を取得するには、vms_service サービスロケーターを使用します。

vms_service = system_service.vms_service

vms_service = system_service.vms_service

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

vm_service = vms_service.vms_service('123')

vm_service = vms_service.vms_service('123')