2.6.2. 목록 방법 사용

이러한 서비스 메서드는 컬렉션의 개체의 표현을 검색합니다.These service methods retrieve the representations of the objects of a collection. 이 예에서는 시스템의 가상 머신의 전체 컬렉션을 검색합니다.

# Find the service that manages the collection of virtual
# machines:
vms_service = system_service.vms_service()

# List the virtual machines in the collection
vms = vms_service.list()

그 결과 해당 유형의 인스턴스를 포함하는 Python 목록이 생성됩니다. 예를 들어 이 경우 결과는 ovirtsdk4.types.Vm 클래스의 인스턴스 목록이 됩니다.

일부 서비스의 목록 방법은 추가 매개 변수를 지원합니다. 예를 들어 거의 모든 최상위 컬렉션에서는 검색 매개 변수를 지원하여 결과 또는 max 매개 변수를 필터링하여 서버에서 반환된 결과 수를 제한합니다. 이 예에서는 상위 10개의 결과인 my 부터 시작하는 가상 머신의 이름을 검색합니다.

vms = vms_service.list(search='name=my*', max=10)

어떤 이유로든 반환된 결과 목록이 비어 있으면 반환된 값이 빈 목록이 됩니다. 이는 절대로 None 이 될 수 없습니다.

결과를 검색하는 동안 오류가 발생하면 SDK에서 오류 세부 정보가 포함된 ovirtsdk4.Error 예외가 발생합니다.