7.262. 스냅샷 구조
스냅샷 오브젝트를 나타냅니다.
XML 표현의 예:
이름 | 유형 | 요약 |
---|---|---|
| 자동 CPU 및 NUMA 구성 적용 여부를 지정합니다. | |
| 가상 머신의 BIOS 구성에 대한 참조입니다. | |
| 이 오브젝트에 대한 주석이 포함된 자유 텍스트입니다. | |
| 이 가상 시스템에 맞게 구성된 콘솔입니다. | |
| 가상 머신 CPU의 구성입니다. | |
| CPU 및 NUMA 구성 적용 여부를 지정합니다. | |
| ||
| 가상 머신 생성 날짜입니다. | |
| 가상 머신 사용자 정의 호환성 버전. | |
| ||
| ||
| 다양한 후크를 구성하기 위해 VDSM으로 전송되는 속성입니다. | |
| 이 스냅샷이 생성된 날짜입니다. | |
|
| |
| 일반 텍스트로 사람이 읽을 수 있는 설명입니다. | |
| 가상 머신 표시 구성입니다. | |
| 이 가상 시스템에 대해 구성된 도메인입니다. | |
| 가상 머신의 정규화된 도메인 이름입니다. | |
| 가상 머신에 설치된 운영 체제는 무엇입니까. | |
| 가상 머신에서 사용하는 시간대(게스트 에이전트에서 반환됨). | |
|
가상 머신에 ILLEGAL 상태의 디스크가 있는 스냅샷이 있는지 여부 | |
| 가상 머신 고가용성 구성입니다. | |
| 고유 식별자입니다. | |
| 가상 시스템의 초기화 구성에 대한 참조입니다. | |
| IO 스레딩 성능 튜닝. | |
| 가상 시스템의 큰 아이콘. | |
| 이 가상 시스템/템플릿 리스가 있는 스토리지 도메인에 대한 참조입니다. | |
| 가상 시스템의 메모리(바이트)입니다. | |
| 가상 머신의 메모리 관리 구성에 대한 참조입니다. | |
| 실행 중인 가상 머신을 다른 호스트로 마이그레이션하는 구성 참조입니다. | |
| ms의 다른 호스트로 실시간 마이그레이션 중에 가상 머신이 응답하지 않을 수 있는 최대 시간입니다. | |
|
| |
| 일반 텍스트로 사람이 읽을 수 있는 이름입니다. | |
| 가상 머신 구성이 변경되어 가상 머신을 재시작해야 합니다. | |
| NUMA 토폴로지 적용 방법. | |
| 이 가상 머신의 출처입니다. | |
| 가상 머신에 설치된 운영 체제 유형입니다. | |
| ISO를 구성하여 가상 시스템의 선택적 페이로드입니다. | |
| 가상 시스템의 메모리 콘텐츠가 스냅샷에 포함되어 있는지 여부를 나타냅니다. | |
| 가상 머신 배치 정책의 구성. | |
| 이 가상 머신의 난수 생성기 장치 구성입니다. | |
|
| |
| 클러스터의 가상 머신의 일련 번호입니다. | |
| 가상 시스템의 작은 아이콘. | |
| 스냅샷의 상태입니다. | |
| 스냅샷 유형입니다. | |
|
| |
| 이 가상 머신이 구성된 Single Sign On 구성에 대한 참조입니다. | |
|
| |
| 가상 머신이 시작된 날짜입니다. | |
|
| |
| 가상 머신의 현재 상태입니다. | |
| 현재 상태에 대한 사람이 읽을 수 있는 세부 정보입니다. | |
| 가상 머신이 중지된 이유입니다. | |
| 가상 머신이 중지된 날짜입니다. | |
| 스토리지 오류 후 가상 머신을 다시 시작하는 방법을 결정합니다. | |
| oVirt로 설정된 가상 머신의 시간대입니다. | |
|
| |
|
| |
| 가상 머신이 데스크탑 또는 서버에 최적화되었는지 여부를 확인합니다. | |
| 이 가상 머신의 USB 장치 구성(count, 유형). | |
|
| |
| VirtIO SCSI 구성에 대한 참조입니다. | |
| Virtio-SCSI contoller의 대기열 수 이 필드에 virtioScsiMultiQueuesEnabled가 true여야 합니다. 자세한 내용은 virtioScsiMultiQueuesEnabled를 참조하십시오. | |
|
|
7.262.1. auto_pinning_policy 링크 복사링크가 클립보드에 복사되었습니다!
자동 CPU 및 NUMA 구성 적용 여부를 지정합니다.
엔진의 버전 4.5 이후 이 작업은 더 이상 사용되지 않으며 이전 버전과의 호환성을 위해서만 유지됩니다. 나중에 제거될 수 있습니다. 대신 CpuPinningPolicy를 사용하십시오.
7.262.2. cpu 링크 복사링크가 클립보드에 복사되었습니다!
가상 머신 CPU의 구성입니다.
가상 머신을 재부팅하지 않고 소켓 구성을 업데이트할 수 있습니다. 코어 및 스레드를 재부팅해야 합니다.
예를 들어, 소켓 수를 즉시 4로 변경하고 재부팅 후 코어 수와 스레드 수를 2로 변경하려면 다음 요청을 보냅니다.
PUT /ovirt-engine/api/vms/123
PUT /ovirt-engine/api/vms/123
요청 본문을 사용하는 경우:
7.262.3. cpu_pinning_policy 링크 복사링크가 클립보드에 복사되었습니다!
CPU 및 NUMA 구성 적용 여부를 지정합니다. CPU 고정 문자열의 이전 동작을 지정하지 않으면 CpuPinningPolicy를 None 또는 Manual로 결정합니다.
7.262.4. custom_compatibility_version 링크 복사링크가 클립보드에 복사되었습니다!
가상 머신 사용자 정의 호환성 버전.
가상 머신을 자체 호환성 버전으로 사용자 지정할 수 있습니다. custom_compatibility_version
이 설정된 경우 이 특정 가상 머신에 대한 클러스터의 호환성 버전을 덮어씁니다.
가상 시스템의 호환성 버전은 가상 시스템이 상주하는 데이터 센터에 의해 제한되며 가상 시스템이 실행하려는 호스트의 기능에 대해 확인됩니다.
7.262.5. high_availability 링크 복사링크가 클립보드에 복사되었습니다!
가상 머신 고가용성 구성입니다. 설정하면 예기치 않게 중단될 때 가상 머신이 자동으로 다시 시작됩니다.
7.262.6. 초기화 링크 복사링크가 클립보드에 복사되었습니다!
가상 시스템의 초기화 구성에 대한 참조입니다.
Red Hat Virtualization 4.1.8 이후에는 빈 태그를 전송하여 이 속성을 지울 수 있습니다.
예를 들어 initialization
특성을 지우려면 다음과 같은 요청을 보냅니다.
PUT /ovirt-engine/api/vms/123
PUT /ovirt-engine/api/vms/123
다음과 같이 요청 본문이 있는 경우:
<vm> <initialization/> </vm>
<vm>
<initialization/>
</vm>
이러한 요청에 대한 응답 및 헤더 All-Content: true
가 있는 요청도 여전히 이 속성이 포함됩니다.
7.262.7. large_icon 링크 복사링크가 클립보드에 복사되었습니다!
가상 시스템의 큰 아이콘. 사용자가 설정하거나 운영 체제에 따라 설정된 이미지를 나타냅니다.
7.262.8. 리스 링크 복사링크가 클립보드에 복사되었습니다!
이 가상 시스템/템플릿 리스가 있는 스토리지 도메인에 대한 참조입니다.
리스를 사용하여 실행 중인 가상 시스템에는 리스를 다른 호스트에서 사용하지 않는지 확인하는 동안 이 가상 시스템의 다른 인스턴스가 다른 호스트에서 실행되지 않도록 해야 합니다. 이를 통해 고가용성 가상 머신의 split- percent에 대한 보호 기능을 제공합니다. 이 템플릿에서 생성된 가상 시스템을 리스 위치로 사전 구성하도록 템플릿에도 리스용으로 정의된 스토리지 도메인이 있을 수 있습니다.
7.262.9. memory 링크 복사링크가 클립보드에 복사되었습니다!
가상 시스템의 메모리(바이트)입니다.
예를 들어 1GB(GiB)의 메모리를 포함하도록 가상 머신을 업데이트하려면 다음 요청을 보냅니다.
PUT /ovirt-engine/api/vms/123
PUT /ovirt-engine/api/vms/123
다음과 같은 요청 본문으로:
<vm> <memory>1073741824</memory> </vm>
<vm>
<memory>1073741824</memory>
</vm>
메모리 핫 플러그는 Red Hat Virtualization 3.6 이후에서 지원됩니다. 가상 머신이 실행되는 동안 위의 예제를 사용하여 메모리를 늘릴 수 있습니다. ??? 크기 증분은 HotPlugMemoryBlockSizeMb
구성 값(기본값:256MiB)으로 구분할 수 있어야 합니다. 메모리 크기 증분이 이 값으로 분리되지 않으면 메모리 크기 변경은 다음 실행 구성에만 저장됩니다. 성공적인 각 메모리 핫 플러그 작업은 하나 또는 두 개의 새로운 메모리 장치를 생성합니다.
Red Hat Virtualization 4.2 이후부터는 메모리 핫 플러그가 지원됩니다. 메모리 핫 언플러그는 가상 머신이 상태의 경우에만 수행할 수 있습니다. ??? 핫플러그된 메모리 장치만 핫 플러그 해제 작업으로 제거할 수 있습니다. 이전에 핫플러그된 메모리 장치의 조합과 일치하도록 요청된 메모리 감소가 반올림됩니다. 요청된 메모리 값은 반올림하지 않고 다음 실행 구성에 저장됩니다.
예제의 memory는 다음 공식을 사용하여 바이트로 변환됩니다.
1GiB = 230 바이트 = 1073741824 바이트.
Red Hat Virtualization Manager는 내부적으로 값을 whole MiBs로 반올림합니다 (1MiB =20 바이트)
7.262.10. Migration 링크 복사링크가 클립보드에 복사되었습니다!
실행 중인 가상 머신을 다른 호스트로 마이그레이션하는 구성 참조입니다.
이 메서드에서 반환된 ID로 마이그레이션 정책을 쿼리하는 API는 아직 구현되지 않습니다. /ovirt-engine/api/options/MigrationPolicies
를 사용하여 해당 ID가 있는 모든 마이그레이션 정책 목록을 가져옵니다.
7.262.11. migration_downtime 링크 복사링크가 클립보드에 복사되었습니다!
ms의 다른 호스트로 실시간 마이그레이션 중에 가상 머신이 응답하지 않을 수 있는 최대 시간입니다.
가상 머신에 대해 명시적으로 설정하거나 engine-config -s DefaultMaximumMigrationDowntime=[value]
로 설정합니다.
7.262.12. next_run_configuration_exists 링크 복사링크가 클립보드에 복사되었습니다!
가상 머신 구성이 변경되어 가상 머신을 재시작해야 합니다. 변경된 구성은 가상 머신 종료 를 처리할 때 적용됩니다.
7.262.13. numa_tune_mode 링크 복사링크가 클립보드에 복사되었습니다!
NUMA 토폴로지 적용 방법. 더 이상 사용되지 않고 vNUMA 노드당 NUMA 튜닝을 사용합니다.
7.262.14. 출처 링크 복사링크가 클립보드에 복사되었습니다!
이 가상 머신의 출처입니다.
가능한 값은 다음과 같습니다.
-
ovirt
-
rhev
-
vmware
-
xen
-
external
-
hosted_engine
-
managed_hosted_engine
-
kvm
-
physical_machine
-
HyperV
7.262.15. persist_memorystate 링크 복사링크가 클립보드에 복사되었습니다!
가상 시스템의 메모리 콘텐츠가 스냅샷에 포함되어 있는지 여부를 나타냅니다.
스냅샷이 생성되면 기본값은 true
입니다.
7.262.16. placement_policy 링크 복사링크가 클립보드에 복사되었습니다!
가상 머신 배치 정책의 구성.
가상 머신을 하나 이상의 호스트에 고정하도록 이 구성을 업데이트할 수 있습니다.
여러 호스트에 고정된 가상 시스템은 실시간 마이그레이션할 수 없지만 호스트 장애 발생 시 고가용성으로 구성된 모든 가상 시스템은 가상 머신이 고정된 다른 호스트 중 하나에서 자동으로 다시 시작됩니다.
예를 들어 가상 머신을 두 개의 호스트에 고정하려면 다음 요청을 보냅니다.
PUT /api/vms/123
PUT /api/vms/123
다음과 같이 요청 본문이 있는 경우:
7.262.17. small_icon 링크 복사링크가 클립보드에 복사되었습니다!
가상 시스템의 작은 아이콘. 사용자가 설정하거나 운영 체제에 따라 설정된 이미지를 나타냅니다.
7.262.18. sso 링크 복사링크가 클립보드에 복사되었습니다!
이 가상 머신이 구성된 Single Sign On 구성에 대한 참조입니다. 콘솔이 열리면 가상 머신의 운영 체제에서 자동으로 로그인할 수 있습니다.
7.262.19. stop_reason 링크 복사링크가 클립보드에 복사되었습니다!
가상 머신이 중지된 이유입니다. 선택적으로 가상 머신을 종료할 때 사용자가 설정합니다.
7.262.20. tpm_enabled 링크 복사링크가 클립보드에 복사되었습니다!
true
인 경우 TPM 장치가 가상 머신에 추가됩니다. 기본값은 false
입니다. 이 속성은 "All-Content=true" 헤더가 설정된 경우에만 가져옵니다.
이름 | 유형 | 요약 |
---|---|---|
| 선택 사항: | |
| 가상 머신에 설치된 애플리케이션 목록입니다. | |
| CDROM에 마운트된 ISO에 대한 참조입니다. | |
| 가상 머신이 속하는 클러스터에 대한 참조입니다. | |
| 이 가상 머신에서 사용하는 CPU 프로파일에 대한 참조입니다. | |
| 가상 머신에 연결된 디스크를 참조합니다. | |
| 스냅샷에 연결된 디스크 목록입니다. | |
| 가상 머신 CPU의 동적 구성입니다. | |
| ||
| 플로피에 마운트된 ISO에 대한 참조입니다. | |
| 이 가상 머신에 대해 구성된 그래픽 콘솔 목록입니다. | |
| 가상 머신이 실행 중인 호스트에 대한 참조입니다. | |
| 이 가상 머신에 연결된 장치를 참조합니다. | |
| 가상 머신 구성은 인스턴스 유형 중 하나를 통해 선택적으로 사전 정의할 수 있습니다. | |
| 가상 머신에 할당된 모든 Katello 에라타를 나열합니다. | |
| 중재된 장치 구성. | |
| 가상 머신의 네트워크 인터페이스 장치 목록을 참조합니다. | |
| 이 가상 머신에서 사용하는 NUMA 노드 구성을 나타냅니다. | |
| 가상 머신을 생성하는 데 사용된 원본 템플릿을 참조합니다. | |
| 승인 [] | 이 가상 머신에 대한 권한 세트입니다. |
| 이 가상 머신에 대한 할당량 구성 세트 참조. | |
| ||
| 세션 [] | 이 가상 머신에 대해 열려 있는 사용자 세션 목록입니다. |
| 가상 머신에서 가져온 모든 스냅샷을 나타냅니다. | |
| 통계 [] | 이 가상 머신에서 수집한 통계 데이터입니다. |
| 가상 머신이 속하는 스토리지 도메인에 대한 참조입니다. | |
| Tag[] | |
| 가상 머신이 기반으로 하는 템플릿에 대한 참조입니다. | |
| 이 스냅샷이 작성된 가상 머신. | |
| 가상 시스템이 선택적으로 멤버인 풀에 대한 참조입니다. | |
| Watchdog 구성을 나타냅니다. |
7.262.21. affinity_labels 링크 복사링크가 클립보드에 복사되었습니다!
선택 사항: 하위 클러스터의 레이블을 지정하는 데 사용됩니다.
7.262.22. katello_errata 링크 복사링크가 클립보드에 복사되었습니다!
가상 머신에 할당된 모든 Katello 에라타를 나열합니다.
GET /ovirt-engine/api/vms/123/katelloerrata
GET /ovirt-engine/api/vms/123/katelloerrata
다음과 같은 XML로 응답을 받습니다.
7.262.23. original_template 링크 복사링크가 클립보드에 복사되었습니다!
가상 머신을 생성하는 데 사용된 원본 템플릿을 참조합니다.
템플릿 또는 다른 가상 머신에서 가상 머신이 복제되면 템플릿
은 Blank 템플릿에 연결되어 original_template
을 사용하여 기록을 추적합니다.
그렇지 않으면 template
과 original_template
이 동일합니다.
7.262.24. 통계 링크 복사링크가 클립보드에 복사되었습니다!
이 가상 머신에서 수집한 통계 데이터입니다.
일부 통계(특히 memory.buffered
및 memory.cached
)는 Red Hat Virtualization 게스트 에이전트가 가상 머신에 설치된 경우에만 사용할 수 있습니다.