15장. 가상 머신
15.1. 가상 머신
vms
컬렉션은 Red Hat Virtualization 환경에서 가상 머신에 대한 정보를 제공합니다. API 사용자는 진입점 URI에서 얻은 rel="vms"
링크를 통해 이 정보에 액세스합니다.
All-Content: true
헤더를 사용하여 GET
요청에 대한 추가 정보를 검색할 수 있습니다.
다음 표에서는 가상 머신 리소스 표현에 포함된 특정 요소를 보여줍니다.
요소 | 유형 | 설명 | 속성 |
---|---|---|---|
link rel="applications" | 관계 | 가상 머신 리소스에 대한 애플리케이션 하위 수집 링크로, 가상 머신에 설치된 애플리케이션이 표시됩니다. | |
link rel="disks" | 관계 | 가상 머신 리소스에 대한 디스크 하위 수집 링크입니다. | |
link rel="nics" | 관계 | 가상 머신 리소스에 대한 nics 하위 수집 링크입니다. | |
link rel="numanodes" | 관계 | 가상 머신 리소스에 대한 numanodes 하위 수집 링크입니다. | |
link rel="cdroms" | 관계 | 가상 머신 리소스에 대한 cdroms 하위 수집 링크입니다. | |
link rel="snapshots" | 관계 | 가상 머신 리소스의 스냅샷 하위 수집 링크입니다. | |
link rel="tags" | 관계 | 가상 머신 리소스에 대한 태그 하위 수집 링크입니다. | |
link rel="permissions" | 관계 | 가상 머신 권한에 대한 권한 하위 수집 링크입니다. | |
link rel="statistics" | 관계 | 가상 머신 리소스의 통계 하위 수집 링크입니다. | |
link rel="reporteddevices" |
관계
|
가상 머신 리소스에 대한
보고된 장치 하위 수집 링크입니다.
| |
link rel="watchdogs" |
관계
|
가상 머신 리소스
의 워치독 하위 수집 링크입니다.
| |
link rel="sessions" |
관계
|
가상 머신 리소스에 대한
세션 하위 수집 링크입니다.
| |
type | enumerated | 가상 머신 유형입니다. 기능에서 열거된 값 목록을 사용할 수 있습니다. | |
status | 아래 참조 | 가상 머신 상태. | |
memory | integer | 게스트에 할당된 메모리 양(바이트)입니다. | |
cpu | complex |
가상 머신의 CPU 세부 정보를 정의합니다.
토폴로지 하위 요소는 게스트에서 사용할 수 있는 논리 소켓 수와 소켓당 코어 수를 설정합니다. 가상 시스템에서 사용 가능한 총 코어는 소켓당 코어 수를 곱한 소켓 수와 동일합니다.
cputune 하위 요소는 일련의 vcpupin 요소를 사용하여 가상 CPU를 물리적 호스트 CPU에 매핑합니다. 각 vcpupin 요소에는 가상 CPU 특성(vcpu )과 사용할 물리(CPU세트 )를 정의하는 속성이 포함됩니다. cpuset 를 단일 CPU(cpuset="0" ), 여러 CPU(cpuset="0,2" ), CPU 범위(cpuset="0-3" ) 또는 제외된 CPU 범위(cpuset="0-3,^2" )로 설정합니다.
cpu_mode 하위 요소는 가상 CPU가 호스트 CPU와 얼마나 밀접하게 관련된지를 정의합니다. 모드가 제공되지 않는 경우 custom 는 기본값입니다. host_model 은 libvirt가 이해할 수 있는 대로 호스트 CPU를 복사하고, host_passthrough 는 호스트의 모든 측면을 게스트에 전달합니다. 그러나 host_passthrough 는 해당 가상 머신의 마이그레이션을 방지합니다.
| |
os type= | 문자열(예: RHEL5 또는 WindowsXP ) | 게스트 운영 체제 유형입니다. | |
OS 부팅 dev= | enumerated | 부팅 요소에서 dev 속성으로 설명된 부팅 장치 목록입니다. 기능에서 열거된 값 목록을 사용할 수 있습니다. | |
os kernel | string | 가상 시스템이 부팅되도록 구성된 커널 이미지의 경로입니다. 이 옵션은 BIOS 부트로더를 통과하지 않고 직접 Linux 커널 부팅을 지원합니다. | |
OS initrd | string | 이전에 지정한 커널과 함께 사용할 initrd 이미지의 경로입니다. 이 옵션은 BIOS 부트로더를 통과하지 않고 직접 Linux 커널 부팅을 지원합니다. | |
os cmdline | string | 정의된 커널과 함께 사용할 커널 명령줄 매개 변수 문자열입니다. 이 옵션은 BIOS 부트로더를 통과하지 않고 직접 Linux 커널 부팅을 지원합니다. | |
high_availability | complex | 가상 머신 또는 해당 호스트가 충돌하는 경우 가상 머신을 자동으로 재시작해야 하는 경우 enabled 를 true 로 설정합니다. 우선순위 요소는 가상 머신을 다시 시작하는 순서를 제어합니다. | |
디스플레이 | complex |
디스플레이
유형 ( vnc 또는 spice ), 포트 및 모니터 수입니다. allow_reconnect 부울 값은 디스플레이를 통해 클라이언트가 시스템에 다시 연결할 수 있는지 여부를 지정합니다.
smartcard_enabled 하위 요소는 부울(true 또는 false )으로, 클라이언트에 연결된 스마트 카드가 가상 머신에 전달되는지 여부를 지정합니다. 기본값은 false 입니다.
| |
클러스터 ID= | GUID | 가상 머신의 호스트 클러스터에 대한 참조입니다. | |
템플릿 id= | GUID | 이 가상 머신을 기반으로 하는 템플릿에 대한 참조입니다. | |
도메인 ID= | GUID | 가상 머신의 도메인에 대한 참조입니다. | |
start_time | XSD:dateTime 형식: YYYY-MM-DDThh:mm:ss | 이 가상 머신이 시작된 날짜 및 시간입니다. | |
stop_time | XSD:dateTime 형식: YYYY-MM-DDThh:mm:ss | 이 가상 머신이 중지된 날짜 및 시간입니다. | |
creation_time | XSD:dateTime 형식: YYYY-MM-DDThh:mm:ss | 이 가상 머신이 생성된 날짜 및 시간입니다. | |
origin | rhev ,ovirt ,vmware 또는 xen 중 하나 | 이 가상 머신이 시작된 시스템입니다. | |
상태 비저장 | boolean: true 또는 false | 가상 머신이 상태 비저장인 경우 True 입니다. 상태 비저장 가상 머신에는 부팅 시 생성된 디스크 이미지의 스냅샷이 포함되어 있습니다. 즉, 재부팅 후 상태 변경 사항이 유지되지 않습니다. | |
delete_protected | boolean: true 또는 false | true 로 설정하면 가상 머신을 삭제할 수 없습니다. | |
sso | string | 가상 머신에 대한 Single Sign-On 방법에 대한 참조입니다. ip 속성이 있는 메서드 요소를 포함합니다. | |
placement_policy | complex | 가상 머신 마이그레이션에 대한 배치 정책을 설정합니다. 기본 host= 및 affinity ( migratable ,user_migratable 또는 고정 )가 필요합니다. 호스트 요소를 비워 두면 기본 호스트를 설정하지 않습니다. 여러 호스트 요소를 사용하여 클러스터 내에서 기본 호스트의 하위 집합을 지정합니다. | |
memory_policy | complex | 가상 머신에 대한 메모리 정책을 설정합니다. 가상 머신을 실행하기 위해 호스트의 최소 메모리 양을 정의합니다. | |
할당량 id= | GUID | 가상 머신에 대한 할당량을 설정합니다. | |
custom_properties | complex | 사용자 정의 스크립트에 매개 변수로 전달되는 사용자 정의 환경 변수 집합입니다. 각 custom_property 에는 name 및 value 속성이 포함되어 있습니다. 기능에서 열거된 값 목록을 사용할 수 있습니다. | |
usb | complex | 가상 머신의 USB 정책을 정의합니다. 부울 값에 enabled 요소를 설정하고 native 또는 legacy 로 설정된 type 요소가 필요합니다.
중요
레거시 USB 옵션은 더 이상 사용되지 않으며 Red Hat Virtualization 4.1에서 제거될 예정입니다.
| |
migration_downtime | integer | 실시간 마이그레이션 중에 가상 머신을 중단할 수 있는 최대 시간(밀리초)을 나타냅니다. 값이 0이면 VDSM 기본값이 사용됩니다. | |
cpu_profile id= | GUID | 가상 머신의 cpu 프로필에 대한 참조입니다. | |
next_run_configuration | boolean: true 또는 false | 가상 머신을 다시 시작하면 가상 머신 구성 변경 사항이 적용됩니다. | |
numa_tune_mode | string | 호스트 NUMA 노드의 메모리 할당 모드(대신 ,엄격한 , 기본 설정 )에 대한 참조입니다. | |
guest_info | complex | 게스트 클라이언트 정보에 대한 참조입니다. address= 속성이 있는 ip 요소를 포함합니다. | |
vmpool | complex | 가상 머신 풀에 대한 참조입니다. 이 요소는 풀의 가상 머신 부분에만 나타납니다. | |
timezone | TZ 데이터베이스 형식: 지역/지역 | Windows 가상 머신에 대한 Sysprep 시간대 설정입니다. | |
domain | complex | Windows 가상 머신의 Sysprep 도메인 설정입니다. 도메인 컬렉션의 이름이 필요합니다. | |
초기화 | complex |
Linux 기반 가상 머신용 Cloud-Init를 사용하여 부팅 시 가상 머신에 적용되는 값 목록을 정의하거나 Windows 기반 가상 머신의 경우 Sysprep을 정의합니다.
| |
페이로드 | complex |
부팅 시 가상 머신에 콘텐츠를 전달하는
페이로드 요소 세트를 정의합니다. 각 페이로드 에는 cdrom 또는 lbppy , 요소 집합 등 type 속성이 필요합니다. 각 파일 요소 내에는 파일의 이름과 위치를 지정하는 name 요소와 파일에 전달할 콘텐츠 를 정의하는 content 요소가 있습니다.
payloads 요소는 cloud-init 기능에서 사용합니다. cloud-init 를 사용하여 가상 머신을 구성하는 경우, 구성 매개변수를 가상 머신에 전달하는 openstack/latest/meta_data.json, openstack/latest/meta_data.json 및 openstack/latest/user_data 로 설정된 type 속성과 두 개의 파일 하위 요소를 사용하여 페이로드가 자동으로 생성됩니다.
|
상태에
는 할당되지 않은 , down , up ,powering_up
,powered_down
, paused ,migrating_to
, unknown , not_responding , unassigned
, down , powering_up ,paused
_from
,unknown
,not_responding
중 하나가 포함됩니다. wait_for_launch
,reboot_in_progress
,saving_state
,restoring_state
,suspended
,image_illegal
,image_locked
또는 powering_down
. 이러한 상태는 capabilities
아래의 vm_states
에 나열됩니다.