6.253. Vm

표 6.769. 메서드 요약
이름	요약
`autopincpuandnumanodes`	VM에 자동 CPU 및 NUMA 구성을 적용합니다.
`cancelmigration`	이 작업은 가상 시스템의 다른 물리적 호스트로의 마이그레이션을 중지합니다.
`clone`
`commitsnapshot`	가상 머신을 프리뷰된 스냅샷의 상태로 영구적으로 복원합니다.
`detach`	풀에서 가상 머신을 분리합니다.
`export`	가상 머신을 내보냅니다.
`freezefilesystems`	가상 머신 파일 시스템을 정지합니다.
`get`	가상 머신에 대한 설명을 검색합니다.
`logon`	자동 사용자 로그온을 시작하여 외부 콘솔에서 가상 머신에 액세스합니다.
`maintenance`	호스팅 엔진 가상 시스템에서 글로벌 유지 관리 모드를 설정합니다.
`migrate`	가상 머신을 다른 물리적 호스트로 마이그레이션합니다.
`previewsnapshot`	가상 머신을 임시로 스냅샷 상태로 복원합니다.
`reboot`	가상 머신에 재부팅 요청을 보냅니다.
`제거`	연결된 가상 디스크를 포함하여 가상 머신을 제거합니다.
`localaddresses의 재정렬`
`reset`	가상 머신에 재설정 요청을 보냅니다.
`스크린샷`	VM의 현재 상태 스크린샷을 캡처합니다.
`shutdown`	이 작업은 가상 머신에 종료 요청을 보냅니다.
`start`	가상 머신을 시작합니다.
`중지`	이 작업은 가상 시스템의 전원을 끄도록 강제 적용합니다.
`일시 중단`	이 작업은 가상 시스템 상태를 디스크에 저장하고 중지합니다.
`thawfilesystems`	가상 머신 파일 시스템 thaws.
`ticket`	가상 머신의 디스플레이에 액세스하기 위한 시간에 민감한 인증 토큰을 생성합니다.
`undosnapshot`	스냅샷을 미리 보기 전에 가상 머신을 해당 상태로 복원합니다.
`update`	지정된 가상 머신 ID의 시스템에서 가상 머신을 업데이트합니다.

6.253.1. autopincpuandnumanodes POST

VM에 자동 CPU 및 NUMA 구성을 적용합니다.

중요

엔진의 버전 4.5 이후 이 작업은 더 이상 사용되지 않으며 이전 버전과의 호환성을 위해서만 유지됩니다. 이는 향후 삭제될 예정입니다. 대신 PUT 다음 업데이트 작업을 사용하십시오.

요청의 예는 다음과 같습니다.

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

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

<action>
  <optimize_cpu_settings>true</optimize_cpu_settings>
</action>

표 6.770. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	분리 작업을 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the detach action should be performed asynchronously.
`optimize_cpu_settings`	부울	in	자동 CPU 및 NUMA 구성이 적용되는 방법을 지정합니다.

6.253.1.1. optimize_cpu_settings

자동 CPU 및 NUMA 구성이 적용되는 방법을 지정합니다. true로 설정하면 VM 고정된 호스트 하드웨어에 맞게 CPU 토폴로지가 조정됩니다. 그렇지 않으면 VM CPU 토폴로지를 사용합니다.

6.253.2. 마이그레이션 취소 POST

이 작업은 가상 시스템의 다른 물리적 호스트로의 마이그레이션을 중지합니다.

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

취소 마이그레이션 작업은 작업별 매개변수를 사용하지 않으므로 요청 본문에 빈 작업이 포함되어야 합니다.

<action/>

표 6.771. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	마이그레이션이 비동기식으로 취소되었는지 여부를 나타냅니다.

6.253.3. clone POST

표 6.772. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	복제를 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the clone should be performed asynchronously.
`discard_snapshots`	부울	in	가상 머신이 축소된 스냅샷과 함께 복제되어야 하는 경우 `discard_snapshots` 매개변수를 사용합니다.
`storage_domain`	StorageDomain	in	가상 머신 디스크가 복사될 스토리지 도메인입니다.
`vm`	Vm	in

6.253.3.1. discard_snapshots

가상 머신이 축소된 스냅샷과 함께 복제되어야 하는 경우 discard_snapshots 매개변수를 사용합니다. 기본값은 true입니다.

6.253.4. commitsnapshot POST

가상 머신을 프리뷰된 스냅샷의 상태로 영구적으로 복원합니다.

자세한 내용은 preview_snapshot 작업을 참조하십시오.

표 6.773. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	스냅샷을 비동기적으로 커밋해야 하는지 여부를 나타냅니다.

6.253.5. POST분리

풀에서 가상 머신을 분리합니다.

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

분리 작업에서는 작업별 매개 변수를 사용하지 않으므로 요청 본문에 빈 작업이 포함되어야 합니다.

<action/>

표 6.774. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	분리 작업을 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the detach action should be performed asynchronously.

6.253.6. 내보내기 POST

가상 머신을 내보냅니다.

가상 머신을 내보내기 도메인으로 내보낼 수 있습니다. 예를 들어 가상 머신 123 을 내보내기 도메인 myexport 로 내보내려면 다음을 수행합니다.

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

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

<action>
  <storage_domain>
    <name>myexport</name>
  </storage_domain>
  <exclusive>true</exclusive>
  <discard_snapshots>true</discard_snapshots>
</action>

엔진의 버전 4.2부터 가상 시스템을 OVA(가상 어플라이언스)로 내보낼 수도 있습니다. 예를 들어 가상 머신 123 을 호스트 myhost 의 /home/ovirt/ 디렉터리에 있는 myvm.ova 라는 OVA 파일로 내보내려면 다음을 수행합니다.

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

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

<action>
  <host>
    <name>myhost</name>
  </host>
  <directory>/home/ovirt</directory>
  <filename>myvm.ova</filename>
</action>

참고

내보내기 도메인에서 작업을 시도하기 전에 내보내기 작업이 완료되었는지 확인합니다.

표 6.775. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	비동기적으로 내보내기를 수행해야 하는지 여부를 나타냅니다.Indicates whether the export should be performed asynchronously.
`discard_snapshots`	부울	in	가상 머신을 모든 스냅샷과 함께 내보내야 하는 경우 `discard_snapshots` 매개변수를 사용합니다.
`exclusive`	부울	in	가상 머신의 다른 복사본이 내보내기 도메인(override)에 이미 있는 경우에도 가상 머신을 내보내야 하는 경우 `exclusive` 매개 변수를 사용합니다.
`storage_domain`	StorageDomain	in	가상 머신을 내보낼 (export) 스토리지 도메인입니다.

6.253.7. freezefilesystems POST

가상 머신 파일 시스템을 정지합니다.

이 작업을 수행하면 실행 중인 가상 머신의 실시간 스냅샷을 만들 때 QEMU 게스트 에이전트를 사용하여 가상 머신의 파일 시스템이 중지됩니다. 일반적으로 이 작업은 관리자가 자동으로 수행하지만 OpenStack Volume(Cinder) 디스크를 사용하는 가상 시스템의 API를 사용하여 수동으로 실행해야 합니다.

예제:

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

<action/>

표 6.776. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	freeze을 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the freeze should be performed asynchronously.

6.253.8. GET가져오기

가상 머신에 대한 설명을 검색합니다.

표 6.777. 매개변수 요약
이름	유형	방향	요약
`all_content`	부울	in	가상 머신의 모든 속성이 응답에 포함되어야 하는지 여부를 나타냅니다.
`filter`	부울	in	사용자의 권한에 따라 결과를 필터링해야 하는지 여부를 나타냅니다.
`팔로우`	문자열	in	따라야 할 내부 링크를 나타냅니다.
`next_run`	부울	in	반환된 결과가 현재 실행 중인 가상 머신을 나타내는지 또는 이미 수행된 수정 사항이 있는 가상 머신을 설명하는 경우 가상 머신이 다시 시작될 때만 적용됩니다.
`ovf_as_ova`	부울	in	해당 VM의 OVA 파일에 결과가 OVF를 노출해야 하는지 여부를 나타냅니다.
`vm`	Vm	Out	가상 머신에 대한 설명입니다.

6.253.8.1. all_content

가상 머신의 모든 속성이 응답에 포함되어야 하는지 여부를 나타냅니다.

기본적으로 다음 속성은 제외됩니다.

console
initialization.configuration.data - 가상 머신을 설명하는 OVF 문서입니다.
rng_source
soundcard
virtio_scsi

예를 들어 가상 머신 '123'의 전체 표시를 검색하려면 다음을 수행합니다.

GET /ovirt-engine/api/vms/123?all_content=true

참고

이러한 속성은 기본적으로 성능이 저하되므로 포함되지 않습니다. 이러한 속성은 거의 사용되지 않으며 데이터베이스에 추가 쿼리가 필요합니다. 필요한 경우에만 이 매개 변수를 사용하면 성능이 저하됩니다.

6.253.8.2. 팔로우

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

6.253.8.3. next_run

반환된 결과가 현재 실행 중인 가상 머신을 나타내는지 또는 이미 수행된 수정 사항이 있는 가상 머신을 설명하는 경우 가상 머신이 다시 시작될 때만 적용됩니다. 기본값은 false 입니다.

매개변수가 요청에 포함되어 있지만 값이 없는 경우 값이 true 인 것으로 가정합니다. 다음 요청:

GET /vms/{vm:id};next_run

값을 사용하는 것과 동일합니다.

GET /vms/{vm:id};next_run=true

6.253.8.4. ovf_as_ova

해당 VM의 OVA 파일에 결과가 OVF를 노출해야 하는지 여부를 나타냅니다. 가상 머신을 설명하는 OVF 문서입니다. 이 매개변수는 all_content=True가 설정된 경우에만 작동합니다. OVF가 initialization.configuration.data 에 표시됩니다.

예를 들어 다음과 같습니다.

GET /vms/{vm:id}?all_content=true&ovf_as_ova=true

6.253.9. logon POST

자동 사용자 로그온을 시작하여 외부 콘솔에서 가상 머신에 액세스합니다.

이 작업을 수행하려면 ovirt-guest-agent -gdm-plugin 및 ovirt-guest-agent-pam-module 패키지가 설치되어 가상 머신에서 실행 중이어야 합니다.

외부 콘솔에서 가상 시스템에 액세스하려면 가상 시스템에 적절한 사용자 권한이 필요합니다.

예를 들어 다음과 같습니다.

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

요청 본문:

<action/>

표 6.778. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	로그온이 비동기적으로 수행되어야 하는지 여부를 나타냅니다.Indicates if the logon should be performed asynchronously.

6.253.10. 유지 관리 POST

호스팅 엔진 가상 시스템에서 글로벌 유지 관리 모드를 설정합니다.

이 작업은 다른 가상 머신에는 영향을 미치지 않습니다.

예제:

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

<action>
  <maintenance_enabled>true<maintenance_enabled/>
</action>

표 6.779. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	전역 유지 관리 작업을 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the global maintenance action should be performed asynchronously.
`maintenance_enabled`	부울	in	전역 유지 관리를 활성화하거나 비활성화해야 하는지 여부를 나타냅니다.

6.253.11. migrate POST

가상 머신을 다른 물리적 호스트로 마이그레이션합니다.

예제:

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

가상 머신을 마이그레이션할 특정 호스트를 지정하려면 다음을 수행합니다.

<action>
  <host id="2ab5e1da-b726-4274-bbf7-0a42b16a0fc3"/>
</action>

표 6.780. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	마이그레이션을 비동기적으로 수행해야 하는지 여부를 나타냅니다.
`cluster`	Cluster	in	가상 머신이 마이그레이션할 클러스터를 지정합니다.
`force`	부울	in	가상 머신이 비migratable로 정의된 경우에도 가상 머신을 마이그레이션하도록 지정합니다.
`host`	호스트	in	가상 머신이 마이그레이션할 특정 호스트를 지정합니다.
`migrate_vms_in_affinity_closure`	부울	in	또한 동일한 호스트에서 실행 중인 이 가상 머신에서 이 가상 머신의 선호도 그룹을 긍정적으로 강제 적용하여 다른 모든 가상 시스템을 마이그레이션합니다.

6.253.11.1. cluster

가상 머신이 마이그레이션할 클러스터를 지정합니다. 이는 선택적 매개변수입니다. 기본적으로 가상 시스템은 동일한 클러스터 내의 다른 호스트로 마이그레이션됩니다.

주의

다른 클러스터로의 실시간 마이그레이션은 지원되지 않습니다. 마이그레이션을 시도하기 전에 대상 클러스터의 하드웨어 아키텍처 및 네트워크 아키텍처를 강력히 고려하십시오.

6.253.11.2. force

가상 머신이 비migratable로 정의된 경우에도 가상 머신을 마이그레이션하도록 지정합니다. 이는 선택적 매개변수입니다. 기본적으로 false 로 설정됩니다.

6.253.11.3. host

가상 머신이 마이그레이션할 특정 호스트를 지정합니다. 이는 선택적 매개변수입니다. 기본적으로 Red Hat Virtualization Manager는 동일한 클러스터 내에서 마이그레이션할 기본 호스트를 자동으로 선택합니다. API 사용자에게 특정 호스트가 필요한 경우 사용자는 id 또는 name 매개 변수를 사용하여 호스트를 지정할 수 있습니다.

6.253.11.4. migrate_vms_in_affinity_closure

또한 동일한 호스트에서 실행 중인 이 가상 머신에서 이 가상 머신의 선호도 그룹을 긍정적으로 강제 적용하여 다른 모든 가상 시스템을 마이그레이션합니다.

기본값은 false입니다.

6.253.12. previewsnapshot POST

가상 머신을 임시로 스냅샷 상태로 복원합니다.

스냅샷은 snapshot.id 매개 변수로 표시됩니다. 콘텐츠가 검사될 수 있도록 일시적으로 복원됩니다. 검사가 완료되면 commit_snapshot 메서드를 사용하여 가상 머신의 상태를 영구적으로 수행하거나 undo_snapshot 방법을 사용하여 삭제할 수 있습니다.

표 6.781. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	미리 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the preview should be performed asynchronously.
`디스크`	Disk[]	in	스냅샷의 프리뷰에 포함된 디스크를 지정합니다.
`리스`	StorageDomainLease	in	스냅샷 프리뷰에서 사용할 리스 스토리지 도메인 ID를 지정합니다.
`restore_memory`	부울	in
`snapshot`	스냅샷	in
`vm`	Vm	in

6.253.12.1. 디스크

스냅샷의 프리뷰에 포함된 디스크를 지정합니다.

각 disk 매개 변수에 대해 image_id 를 지정해야 합니다.

예를 들어 식별자 111 과 해당 image_id 가 222 인 디스크를 포함하는 식별자(4656)가 있는 스냅샷을 미리 보려면 다음과 같이 요청을 보냅니다.

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

요청 본문:

<action>
  <disks>
    <disk id="111">
      <image_id>222</image_id>
    </disk>
  </disks>
  <snapshot id="456"/>
</action>

6.253.12.2. 리스

스냅샷 프리뷰에서 사용할 리스 스토리지 도메인 ID를 지정합니다. lease 매개 변수가 전달되지 않으면 프리뷰된 스냅샷 리스 스토리지 도메인이 사용됩니다. 리스 매개 변수가 빈 스토리지 도메인 매개변수로 전달되면 스냅샷 프리뷰에 리스가 사용되지 않습니다. 스토리지 도메인 매개변수를 사용하여 리스 매개 변수를 전달하면 스토리지 도메인 ID는 가상 머신 스냅샷 중 하나에 속하는 리스 도메인 ID 중 하나일 수 있습니다. 이는 기본적으로 null로 설정된 선택적 매개변수입니다.

6.253.13. POST재부팅

가상 머신에 재부팅 요청을 보냅니다.

예를 들어 다음과 같습니다.

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

재부팅 작업에서는 작업별 매개 변수를 사용하지 않으므로 요청 본문에 빈 작업이 포함되어야 합니다.

<action/>

백업이 실행 중인 경우에도 VM을 재부팅하려면 'force' 요소를 포함해야 합니다.

예를 들어 가상 머신 123 을 강제로 재부팅하려면 다음을 수행합니다.

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

<action>
    <force>true</force>
</action>

표 6.782. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	재부팅이 비동기적으로 수행되어야 하는지 여부를 나타냅니다.
`force`	부울	in	백업이 실행 중인 경우에도 VM을 강제 재부팅해야 하는지 여부를 나타냅니다.

6.253.14. DELETE제거

연결된 가상 디스크를 포함하여 가상 머신을 제거합니다.

예를 들어 식별자가 123 인 가상 머신을 제거하려면 다음을 수행합니다.

DELETE /ovirt-engine/api/vms/123

표 6.783. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	제거가 비동기적으로 수행되어야 하는지 여부를 나타냅니다.
`detach_only`	부울	in	연결된 가상 디스크를 먼저 분리하고 제거하는 대신 보존해야 하는지 여부를 나타냅니다.
`force`	부울	in	가상 머신이 제거되어야 하는지 여부를 나타냅니다.

6.253.14.1. force

가상 머신이 제거되어야 하는지 여부를 나타냅니다.

이 플래그를 true로 설정하지 않으면 디스크 이미지가 잠겼은 가상 머신과 가상 머신을 제거할 수 없습니다.

6.253.15. reordermacaddresses POST

표 6.784. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	비동기적으로 작업을 수행해야 하는지 여부를 나타냅니다.Indicates whether the action should be performed asynchronously.

6.253.16. POST재설정

가상 머신에 재설정 요청을 보냅니다.

예를 들어 다음과 같습니다.

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

reset 작업에서는 동작 특정 매개변수를 사용하지 않으므로 요청 본문에 빈 작업이 포함되어야 합니다.

<action/>

표 6.785. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	재설정이 비동기적으로 수행되어야 하는지 여부를 나타냅니다.

6.253.17. 스크린샷 POST

VM의 현재 상태 스크린샷을 캡처합니다.

예를 들어 다음과 같습니다.

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

스크린샷 작업은 작업별 매개 변수를 사용하지 않으므로 요청 본문에 빈 작업이 포함되어야 합니다.

<action/>

6.253.18. shutdown POST

이 작업은 가상 머신에 종료 요청을 보냅니다.

예를 들어 다음과 같습니다.

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

종료 작업에서는 작업별 매개 변수를 사용하지 않으므로 요청 본문에 빈 작업이 포함되어야 합니다.

<action/>

백업이 실행 중인 경우에도 VM을 종료하려면 'force' 요소를 포함해야 합니다.

예를 들어 가상 머신 123 을 강제 종료하려면 다음을 수행합니다.

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

<action>
    <force>true</force>
</action>

표 6.786. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	종료를 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the shutdown should be performed asynchronously.
`force`	부울	in	백업이 실행 중인 경우에도 VM이 강제 종료되어야 하는지 여부를 나타냅니다.
`reason`	문자열	in	가상 머신이 중지된 이유입니다.

6.253.18.1. reason

가상 머신이 중지된 이유입니다. 선택적으로 가상 머신을 종료할 때 사용자가 설정합니다.

6.253.19. POST시작

가상 머신을 시작합니다.

가상 환경이 완료되고 가상 머신에 작동하는 데 필요한 모든 구성 요소가 포함된 경우 이를 시작할 수 있습니다.

이 예에서는 가상 머신을 시작합니다.

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

요청 본문을 사용하는 경우:

<action/>

표 6.787. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	시작 작업을 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the start action should be performed asynchronously.
`authorized_key`	AuthorizedKey	in
`filter`	부울	in	사용자의 권한에 따라 결과를 필터링해야 하는지 여부를 나타냅니다.
`pause`	부울	in	`true` 로 설정하면 일시 정지 모드에서 가상 머신을 시작합니다.
`use_cloud_init`	부울	in	`true` 로 설정하면 초기화 유형이 cloud-init 로 설정됩니다.
`use_ignition`	부울	in	`true` 로 설정하면 초기화 유형이 Ignition 으로 설정됩니다.
`use_initialization`	부울	in	`true` 로 설정하면 VM의 OS에 의해 초기화 유형이 설정됩니다.
`use_sysprep`	부울	in	`true` 로 설정하면 초기화 유형이 Sysprep 로 설정됩니다.
`vm`	Vm	in	이 특정 실행에 대한 가상 머신 정의입니다.
`volatile`	부울	in	게스트 시작 재부팅의 경우에도 이 실행 구성이 삭제됨을 나타냅니다.

6.253.19.1. pause

true 로 설정하면 일시 정지 모드에서 가상 머신을 시작합니다. 기본값은 false입니다.

6.253.19.2. use_cloud_init

true 로 설정하면 초기화 유형이 cloud-init 로 설정됩니다. 기본값은 false입니다. 자세한 내용은 cloud-init 설명서를 참조하십시오.

6.253.19.3. use_ignition

true 로 설정하면 초기화 유형이 Ignition 으로 설정됩니다. 기본값은 false입니다. 자세한 내용은 Ignition 설명서를 참조하십시오.

6.253.19.4. use_initialization

true 로 설정하면 VM의 OS에 의해 초기화 유형이 설정됩니다. Windows는 Sysprep, Linux를 cloud-init 로, RedHat CoreOS를 Ignition 으로 설정합니다. initialization-types 중 하나를 명시적으로 설정(useCloudInit, useSysprep 또는 useIgnition)하는 경우 우선 순위가 지정되고 이 플래그가 무시됩니다. 기본값은 false입니다.

6.253.19.5. use_sysprep

true 로 설정하면 초기화 유형이 Sysprep 로 설정됩니다. 기본값은 false입니다. 자세한 내용은 Sysprep 을 참조하십시오.

6.253.19.6. vm

이 특정 실행에 대한 가상 머신 정의입니다.

예를 들어 다음과 같습니다.

<action>
  <vm>
    <os>
      <boot>
        <devices>
          <device>cdrom</device>
        </devices>
      </boot>
    </os>
  </vm>
</action>

이렇게 하면 부팅 장치가 이 특정 시작에 대해서만 CDROM으로 설정됩니다. 가상 시스템의 전원이 꺼지면 이 정의가 복원됩니다.

6.253.19.7. volatile

게스트 시작 재부팅의 경우에도 이 실행 구성이 삭제됨을 나타냅니다. 기본값은 false입니다.

6.253.20. POST중지

이 작업은 가상 시스템의 전원을 끄도록 강제 적용합니다.

예를 들어 다음과 같습니다.

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

중지 작업은 작업별 매개 변수를 사용하지 않으므로 요청 본문에 빈 작업이 포함되어야 합니다.

<action/>

백업이 실행 중인 경우에도 VM을 중지하려면 'force' 요소를 포함해야 합니다.

예를 들어 가상 머신 123 을 강제로 중지하려면 다음을 수행합니다.

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

<action>
    <force>true</force>
</action>

표 6.788. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	중지 작업을 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the stop action should be performed asynchronously.
`force`	부울	in	백업이 실행 중인 경우에도 VM을 중지해야 하는지 여부를 나타냅니다.
`reason`	문자열	in	가상 머신이 중지된 이유입니다.

6.253.20.1. reason

가상 머신이 중지된 이유입니다. 선택적으로 가상 머신을 종료할 때 사용자가 설정합니다.

6.253.21. POST일시 중단

이 작업은 가상 시스템 상태를 디스크에 저장하고 중지합니다. 일시 중단된 가상 시스템을 시작하고 시작 작업으로 가상 시스템 상태를 복원합니다.

예를 들어 다음과 같습니다.

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

일시 중지 작업은 작업별 매개 변수를 사용하지 않으므로 요청 본문에 빈 작업이 포함되어야 합니다.

<action/>

표 6.789. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	일시 중단 작업을 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the suspend action should be performed asynchronously.

6.253.22. thawfilesystems POST

가상 머신 파일 시스템 thaws.

이 작업은 실행 중인 가상 머신의 실시간 스냅샷을 만들 때 QEMU 게스트 에이전트를 사용하여 가상 머신의 파일 시스템을 충돌합니다. 일반적으로 이 작업은 관리자가 자동으로 수행하지만 OpenStack Volume(Cinder) 디스크를 사용하는 가상 시스템의 API를 사용하여 수동으로 실행해야 합니다.

예제:

POST /api/vms/123/thawfilesystems

<action/>

표 6.790. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	thaw 파일 시스템 작업을 비동기적으로 수행해야 하는지 여부를 나타냅니다.

6.253.23. 티켓 POST

가상 머신의 디스플레이에 액세스하기 위한 시간에 민감한 인증 토큰을 생성합니다.

예를 들어 다음과 같습니다.

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

클라이언트 제공 작업에는 필요한 티켓 값 및/또는 만료 시간(초)이 포함됩니다.

응답은 실제 티켓 값과 사용된 만료 값을 지정합니다.

<action>
  <ticket>
    <value>abcd12345</value>
    <expiry>120</expiry>
  </ticket>
</action>

중요

가상 머신이 하나의 그래픽 프로토콜만 지원하도록 구성된 경우 생성된 인증 토큰이 해당 프로토콜에 유효합니다. 그러나 가상 머신이 여러 프로토콜, VNC 및 SPICE를 지원하도록 구성된 경우 SPICE 프로토콜에만 인증 토큰이 유효합니다.

예를 들어 VNC의 경우 특정 프로토콜에 대한 인증 토큰을 얻으려면 요청을 전송하여 가상 시스템의 그래픽 콘솔을 관리하는 서비스 티켓 방법을 사용합니다.

POST /ovirt-engine/api/vms/123/graphicsconsoles/456/ticket

표 6.791. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	티켓 생성이 비동기적으로 수행되어야 하는지 여부를 나타냅니다.
`ticket`	티켓	in/Out

6.253.24. undosnapshot POST

스냅샷을 미리 보기 전에 가상 머신을 해당 상태로 복원합니다.

자세한 내용은 preview_snapshot 작업을 참조하십시오.

표 6.792. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	실행 취소 스냅샷 작업을 비동기적으로 수행해야 하는지 여부를 나타냅니다.

6.253.25. PUT업데이트

지정된 가상 머신 ID의 시스템에서 가상 머신을 업데이트합니다.

표 6.793. 매개변수 요약
이름	유형	방향	요약
`async`	부울	in	업데이트를 비동기적으로 수행해야 하는지 여부를 나타냅니다.
`next_run`	부울	in	업데이트를 가상 머신에 즉시 적용해야 하는지 또는 가상 머신을 재시작할 때만 적용해야 하는지 여부를 나타냅니다.
`vm`	Vm	in/Out

6.253.25.1. next_run

업데이트를 가상 머신에 즉시 적용해야 하는지 또는 가상 머신을 재시작할 때만 적용해야 하는지 여부를 나타냅니다. 기본값은 false 이므로 기본적으로 변경 사항이 즉시 적용됩니다.

6.253. Vm

6.253.1. autopincpuandnumanodes POST

6.253.1.1. optimize_cpu_settings

6.253.2. 마이그레이션 취소 POST

6.253.3. clone POST

6.253.3.1. discard_snapshots

6.253.4. commitsnapshot POST

6.253.5. POST분리

6.253.6. 내보내기 POST

6.253.7. freezefilesystems POST

6.253.8. GET가져오기

6.253.8.1. all_content

6.253.8.2. 팔로우

6.253.8.3. next_run

6.253.8.4. ovf_as_ova

6.253.9. logon POST

6.253.10. 유지 관리 POST

6.253.11. migrate POST

6.253.11.1. cluster

6.253.11.2. force

6.253.11.3. host

6.253.11.4. migrate_vms_in_affinity_closure

6.253.12. previewsnapshot POST

6.253.12.1. 디스크

6.253.12.2. 리스

6.253.13. POST재부팅

6.253.14. DELETE제거

6.253.14.1. force

6.253.15. reordermacaddresses POST

6.253.16. POST재설정

6.253.17. 스크린샷 POST

6.253.18. shutdown POST

6.253.18.1. reason

6.253.19. POST시작

6.253.19.1. pause

6.253.19.2. use_cloud_init

6.253.19.3. use_ignition

6.253.19.4. use_initialization

6.253.19.5. use_sysprep

6.253.19.6. vm

6.253.19.7. volatile

6.253.20. POST중지

6.253.20.1. reason

6.253.21. POST일시 중단

6.253.22. thawfilesystems POST

6.253.23. 티켓 POST

6.253.24. undosnapshot POST

6.253.25. PUT업데이트

6.253.25.1. next_run

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Red Hat legal and privacy links

Red Hat legal and privacy links