2.3.3. Get

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

다음 예제에서는 식별자 4.6.1을 사용하여 가상 머신의 표현을 찾아 검색합니다.

# 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:
vm = vm_service.get(next_run: true)

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

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

다음 예에서 service locator 메서드가 성공적으로 수행되고 get 메서드에서 예외가 발생합니다.

# 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.
vm = vm_service.get