2.3.2.2. list

list 메서드는 컬렉션에서 여러 개체의 표현을 검색합니다.

가상 머신 컬렉션 나열

Find the service that manages the collection of virtual
machines:

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

Copy to Clipboard

Toggle word wrap

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

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

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

Ten Virtual Machines calleded "my*" 나열

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

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

Copy to Clipboard

Toggle word wrap

참고

모든 목록 방법이 search 또는 max 매개변수를 지원하는 것은 아닙니다. 일부 목록 방법은 다른 매개변수를 지원할 수 있습니다. 자세한 내용은 참조 문서를 참조하십시오.

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

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

맨 위로 이동