6.271. VmHostDevices

가상 머신에 연결된 호스트 장치를 관리하는 서비스입니다.

표 6.846. 메서드 요약
이름	요약
`add`	지정된 가상 머신에 대상 장치를 연결합니다.
`list`	지정된 가상 시스템에 할당된 호스트 장치를 나열합니다.

지정된 가상 머신에 대상 장치를 연결합니다.

예제:

POST /ovirt-engine/api/vms/123/hostdevices

HostDevice 유형의 요청 본문이 있는 경우 (예:

<host_device id="123" />

참고

호스트 장치 연결에 필요한 전제 조건은 가상 머신을 정확히 하나의 호스트에 고정해야 한다는 것입니다. 그런 다음 장치 ID가 이 호스트를 기준으로 사용됩니다.

참고

대규모 IOMMU 그룹의 일부인 PCI 장치를 연결하면 IOMMU 그룹에서 "상위자"로 남아 있는 장치를 첨부합니다. 그런 다음 이러한 장치는 HostDevice 유형의 자리 표시자 속성을 true 로 설정하여 식별됩니다.

IOMMU 자리 표시자로 이미 사용되는 장치를 연결하려면 단순히 명시적 추가 작업을 실행하고 해당 자리 표시자 플래그가 지워지며 가상 시스템에서 장치에 액세스할 수 있습니다.

표 6.847. 매개변수 요약
이름	유형	방향	요약
`device`	HostDevice	in/Out	지정된 가상 시스템에 연결할 호스트 장치입니다.

지정된 가상 시스템에 할당된 호스트 장치를 나열합니다.

반환된 장치 목록의 순서는 보장되지 않습니다.

따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.

반환할 최대 장치 수를 설정합니다. 지정하지 않으면 모든 장치가 반환됩니다.