2.3.2. 서비스 방법

get 메서드는 단일 개체의 표현을 검색합니다.

다음 예제에서는 식별자가 123 인 가상 머신의 표현을 찾아서 검색합니다.

Find the service that manages the virtual machine:
Retrieve the representation of the virtual machine:

# Find the service that manages the virtual machine:
vms_service = system_service.vms_service
vm_service = vms_service.vm_service('123')

# Retrieve the representation of the virtual machine:
vm = vm_service.get

결과는 해당 유형의 인스턴스입니다. 이 경우 결과는 Ruby 클래스 Vm 의 인스턴스입니다.

일부 서비스의 get 메서드는 개체의 표현을 검색하는 방법 또는 하나 이상의 경우 검색할 표현을 제어하는 추가 매개 변수를 지원합니다.

예를 들어 부팅 후 가상 머신의 향후 상태를 검색할 수 있습니다. 가상 머신을 관리하는 서비스의 get 메서드는 next_run 부울 매개 변수를 지원합니다.

Retrieve the representation of the virtual machine; not the
current one, but the one that will be used after the next
boot:

# Retrieve the representation of the virtual machine; not the
# current one, but the one that will be used after the next
# boot:
vm = vm_service.get(next_run: true)

자세한 내용은 소프트웨어 개발 키트 참조 문서를 참조하십시오.

개체를 검색할 수 없는 경우 소프트웨어 개발 키트는 오류에 대한 세부 정보가 포함된 Error 예외를 발생시킵니다. 존재하지 않는 오브젝트를 검색하려고 하면 이 문제가 발생합니다.

다음 예제에서는 get 메서드의 예외를 발생시키는 동안 서비스 로케이터 메서드가 성공합니다.In the following examples, the service locator method will succeed, while the get method will raise an exception:

Find the service that manages a virtual machine that does
not exist. This will succeed.

# Find the service that manages a virtual machine that does
# not exist. This will succeed.
vm_service = vms_service.vm_service('non_existent_VM')

Retrieve the virtual machine. This will raise an exception.

# Retrieve the virtual machine. This will raise an exception.
vm = vm_service.get