2.3.4. list

list 메서드는 컬렉션에서 여러 개체의 표현을 검색합니다.The list method retrieves the representations of multiple objects in a collection.

# Find the service that manages the collection of virtual
# machines:
vms_service = system_service.vms_service
vms = vms_service.list

결과는 해당 유형의 인스턴스를 포함하는 Ruby 배열입니다. 위의 예에서 응답은 Ruby 클래스 Vm 의 인스턴스 목록입니다.

일부 서비스의 list 방법은 추가 매개변수를 지원합니다.

예를 들어 거의 모든 최상위 컬렉션은 결과를 필터링하기 위해 검색 매개 변수와 max 매개 변수를 지원하여 서버에서 반환된 결과 수를 제한합니다.

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

결과 목록이 비어 있으면 반환된 값은 빈 Ruby 배열이 됩니다. NIL은 절대 될 수 없습니다.

결과 목록을 검색할 수 없는 경우 SDK는 실패 세부 정보가 포함된 Error 예외가 발생합니다.