6.260. VmCdrom

가상 머신의 CDROM 장치를 관리합니다.

디스크 변경 및 제거는 항상 업데이트 방법을 사용하여 파일 속성의 값을 변경합니다.

표 6.807. 메서드 요약

이름요약

get

이 CDROM 장치에 대한 정보를 반환합니다.

update

이 CDROM 장치에 대한 정보를 업데이트합니다.

6.260.1. GET가져오기

이 CDROM 장치에 대한 정보를 반환합니다.

정보는 CDROM 장치, 가상 머신, 선택적으로 삽입된 디스크에 대한 참조가 포함된 cdrom 속성으로 구성됩니다.

디스크가 삽입되면 file 속성에 ISO 이미지에 대한 참조가 포함됩니다.

<cdrom href="..." id="00000000-0000-0000-0000-000000000000">
  <file id="mycd.iso"/>
  <vm href="/ovirt-engine/api/vms/123" id="123"/>
</cdrom>

디스크가 삽입되지 않으면 file 속성이 보고되지 않습니다.

<cdrom href="..." id="00000000-0000-0000-0000-000000000000">
  <vm href="/ovirt-engine/api/vms/123" id="123"/>
</cdrom>

표 6.808. 매개변수 요약

이름유형방향요약

cdrom

CDROM

Out

CDROM 장치에 대한 정보

current

부울

in

작업에서 현재 실행 중인 가상 머신에 대한 정보를 반환해야 하는지 여부를 나타냅니다.

팔로우

문자열

in

따라야 할 내부 링크를 나타냅니다.

6.260.1.1. current

작업에서 현재 실행 중인 가상 머신에 대한 정보를 반환해야 하는지 여부를 나타냅니다. 이 매개변수는 선택 사항이며 기본값은 false 입니다.

6.260.1.2. 팔로우

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

6.260.2. PUT업데이트

이 CDROM 장치에 대한 정보를 업데이트합니다.

파일 속성의 값을 변경하여 디스크를 변경하거나 제거할 수 있습니다. 예를 들어, 디스크를 삽입하거나 변경하려면 다음과 같은 요청을 보냅니다.

PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000

본문에는 file 속성에 대한 새 값이 포함되어야 합니다.

<cdrom>
  <file id="mycd.iso"/>
</cdrom>

id 속성의 값은 이 예제의 mycd.iso 값은 연결된 ISO 스토리지 도메인에서 사용 가능한 파일에 해당해야 합니다.

디스크에 빈 ID가 있는 파일을 사용하려면 다음을 수행하십시오.

<cdrom>
  <file id=""/>
</cdrom>

기본적으로 위의 작업은 다음 부팅 후 가상 머신에 표시되는 디스크를 영구적으로 변경하지만 현재 실행 중인 가상 머신에는 영향을 미치지 않습니다. 현재 실행 중인 가상 머신에 표시되는 디스크를 변경하려면 current=true 매개 변수를 추가합니다. 예를 들어 현재 디스크를 비우면 다음과 같은 요청을 보냅니다.

PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000?current=true

다음과 같이 요청 본문이 있는 경우:

<cdrom>
  <file id=""/>
</cdrom>
중요

current=true 매개 변수를 사용한 변경 사항은 유지되지 않으므로 가상 머신이 재부팅된 후에는 적용되지 않습니다.

표 6.809. 매개변수 요약

이름유형방향요약

cdrom

CDROM

in/Out

CDROM 장치에 대한 정보

current

부울

in

현재 실행 중인 가상 머신 또는 다음 부팅 후 가상 머신에 업데이트가 적용되는지 여부를 나타냅니다.

6.260.2.1. current

현재 실행 중인 가상 머신 또는 다음 부팅 후 가상 머신에 업데이트가 적용되는지 여부를 나타냅니다. 이 매개변수는 선택 사항이며 기본값은 false 이며 기본값은 false이며 기본적으로 업데이트는 다음 부팅 후에만 적용됩니다.