4.22. vm
vm 리소스 유형은 Red Hat Virtualization 환경의 모든 가상 머신 리소스를 그룹화합니다.
| 이름 | 유형 | 설명 | 필수 항목 | 사용자 Creatable | 사용자 Updatable |
|---|---|---|---|---|---|
--name
|
string
|
가상 머신의 이름
|
제공됨
|
예
|
제공됨
|
--template-id|name
|
string
|
가상 머신의 기반으로 사용되는 템플릿에 대한 참조입니다.
|
제공됨
|
제공됨
|
없음
|
--cluster-id|name
|
string
|
이 VM이 포함된 클러스터에 대한 참조입니다.
|
제공됨
|
예
|
제공됨
|
--instance_type-id|name
|
string
|
인스턴스 유형을 정의합니다.
사용자 지정,큰,중간,작은,작은 xlarge 를 지정합니다.
|
없음
|
예
|
제공됨
|
--quota-id
|
string
|
가상 머신의 할당량 사용량에 대한 참조입니다.
|
없음
|
예
|
없음
|
--timezone
|
string
|
Windows 가상 머신의 Sysprep 시간대 설정입니다.
|
없음
|
예
|
제공됨
|
--OS-boot
|
컬렉션
|
가상 머신의 부팅 장치입니다.
cdrom,hd 또는 network 를 지정합니다.
|
없음
|
예
|
제공됨
|
--custom_properties-custom_property
|
컬렉션
|
사용자 정의 스크립트에 매개 변수로 전달되는 사용자 정의 환경 변수 집합입니다.
|
없음
|
예
|
제공됨
|
--os-type
|
string
|
이 가상 머신의 운영 체제 유형입니다.
|
없음
|
예
|
제공됨
|
--usb-enabled
|
boolean
|
가상 머신의 USB 정책을 정의합니다. 가상 머신에서 USB를 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--usb-type
|
string
|
활성화된 경우 USB 유형을 정의합니다.
|
없음
|
예
|
제공됨
|
--type
|
string
|
가상 머신 유형을 정의합니다.
desktop 또는 server 를 지정합니다.
|
없음
|
예
|
제공됨
|
--os-initRd
|
string
|
지정된 커널과 함께 사용할 initrd 이미지의 경로입니다. 이 옵션은 BIOS 부트로더를 통과하지 않고 직접 Linux 커널 부팅을 지원합니다.
|
없음
|
예
|
제공됨
|
--display-monitors
|
int
|
사용 가능한 디스플레이 수를 정의합니다.
|
없음
|
예
|
제공됨
|
--display-single_qxl_pci
|
boolean
|
단일 가상 PCI 장치를 사용하여 여러 개의 모니터를 구동하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-type
|
string
|
표시 유형을 정의합니다.
spice 또는 vnc 를 지정합니다.
|
없음
|
예
|
제공됨
|
--display-allow_override
|
boolean
|
가상 머신 콘솔 설정을 재정의할 수 있도록
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-smartcard_enabled
|
boolean
|
스마트 카드 기능을 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-file_transfer_enabled
|
boolean
|
SPICE 파일 전송을 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-copy_paste_enabled
|
boolean
|
SPICE 클립보드 복사 및 붙여넣기를 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--display-keyboard_layout
|
string
|
가상 시스템의 키보드 레이아웃을 정의합니다. 이 옵션은 VNC 프로토콜을 사용하는 경우에만 사용할 수 있습니다.
en-US 와 같은 형식을 지정합니다.
|
없음
|
예
|
제공됨
|
--os-cmdline
|
string
|
정의된 커널과 함께 사용할 커널 명령줄 매개 변수 문자열입니다. 이 옵션은 BIOS 부트로더를 통과하지 않고 직접 Linux 커널 부팅을 지원합니다.
|
없음
|
예
|
제공됨
|
--cpu-topology-cores
|
int
|
가상 머신에서 사용 가능한 CPU 코어 수입니다.
|
없음
|
예
|
제공됨
|
--cpu-architecture
|
string
|
CPU 아키텍처를 정의합니다.
x86_64,ppc64 또는 undefined 를 지정합니다.
|
없음
|
예
|
제공됨
|
--memory
|
long
|
가상 머신의 메모리 양(바이트)입니다.
|
없음
|
예
|
제공됨
|
--memory_policy-guaranteed
|
long
|
가상 머신을 실행하기 위해 호스트에서 보장되는 최소 메모리 양(바이트)입니다.
|
없음
|
예
|
제공됨
|
--memory_policy-ballooning
|
boolean
|
메모리 balloon 장치를 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--high_availability-priority
|
int
|
고가용성을 사용하여 각 가상 머신의 우선 순위 값(migration 및 restart order)을 설정합니다.
|
없음
|
예
|
제공됨
|
--high_availability-enabled
|
boolean
|
가상 머신에 고가용성이 활성화되었는지 여부를 정의합니다.
|
없음
|
예
|
제공됨
|
--domain-name
|
string
|
가상 머신의 도메인 이름입니다.
|
없음
|
예
|
제공됨
|
--description
|
string
|
가상 머신에 대한 설명입니다.
|
없음
|
예
|
제공됨
|
--comment
|
string
|
가상 머신에 대한 주석입니다.
|
없음
|
예
|
제공됨
|
--stateless
|
boolean
|
가상 머신이 상태 비저장인 경우
true 로 설정합니다. 상태 비저장 가상 머신에는 부팅 시 생성된 디스크 이미지의 스냅샷이 포함되어 있습니다. 즉, 재부팅 후 상태 변경 사항이 유지되지 않습니다.
|
없음
|
예
|
제공됨
|
--permissions-clone
|
boolean
|
소스 가상 머신의 권한을 템플릿에 복사하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--delete_protected
|
boolean
|
이 템플릿에서 생성된 가상 머신을 삭제할 수 없도록 하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--sso-methods-method
|
컬렉션
|
사용된 Single Sign-On 메서드를 정의합니다. 예를 들면
--sso-methods-method method.id=GUEST_AGENT 입니다.
|
없음
|
예
|
제공됨
|
--rng_device-rate-bytes
|
int
|
마침표당 사용할 수 있는 바이트 수를 지정합니다.
|
없음
|
예
|
제공됨
|
--rng_device-rate-period
|
int
|
밀리초 단위의 기간을 지정합니다. 지정된 경우
--rng_device-rate-bytes 도 지정해야 합니다.
|
없음
|
예
|
제공됨
|
--rng_device-source
|
string
|
난수 생성기의 소스입니다.
random 또는 hwrng 를 지정합니다.
|
없음
|
예
|
제공됨
|
--console-enabled
|
boolean
|
VirtIO 콘솔 장치 기능을 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--cpu-mode
|
string
|
CPU 모드를 정의합니다.
사용자 지정,host_model 또는 host_passthrough 를 지정합니다.
|
없음
|
예
|
제공됨
|
--cpu-topology-sockets
|
int
|
가상 머신에서 사용 가능한 CPU 소켓 수입니다.
|
없음
|
예
|
제공됨
|
--cpu_shares
|
int
|
가상 머신에서 다른 가상 머신에 상대적으로 요청할 수 있는 CPU 리소스의 수준입니다. 예를 들어 우선순위가 낮은 가상 머신의 경우
512, 중간 우선 순위 가상 머신의 경우 1024, 우선 순위가 높은 가상 머신의 경우 2048 입니다.
|
없음
|
예
|
제공됨
|
--placement_policy-affinity
|
string
|
각 가상 머신의 마이그레이션 선호도입니다.
migratable,user_migratable 또는 pinned 를 지정합니다.
|
없음
|
예
|
제공됨
|
--placement_policy-host-id|name
|
string
|
마이그레이션 선호도에 대한 기본 호스트에 대한 참조입니다.
|
없음
|
예
|
제공됨
|
--origin
|
string
|
가상 머신의 원본입니다.
rhev,vmware 또는 xen 을 지정합니다.
|
없음
|
예
|
제공됨
|
--os-kernel
|
string
|
가상 시스템이 부팅되도록 구성된 커널 이미지의 경로입니다. 이 옵션은 BIOS 부트로더를 통과하지 않고 직접 Linux 커널 부팅을 지원합니다.
|
없음
|
예
|
제공됨
|
--disks-clone
|
boolean
|
정의된
템플릿에서 디스크를 복제할지 여부를 정의합니다.
|
없음
|
예
|
없음
|
--disks-disk
|
컬렉션
|
가상 머신에 연결된 디스크에 대한 참조입니다.
|
없음
|
예
|
제공됨
|
--tunnel_migration
|
boolean
| libvirt 데몬을 통한 데이터 전송을 활성화하려면 true 로 설정합니다. 터널링된 전송은 더 강력한 암호화 알고리즘을 사용하지만 전송 중에 데이터 로드를 늘립니다.
|
없음
|
예
|
제공됨
|
--migration_downtime
|
int
|
실시간 마이그레이션 중에 가상 머신을 중단할 수 있는 최대 시간(밀리초)을 정의합니다.
|
없음
|
예
|
제공됨
|
--virtio_scsi-enabled
|
boolean
|
VirtIO 콘솔 장치를 가상 머신에 연결할 수 있도록 하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--soundcard_enabled:
|
boolean
|
건전한 카드를 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--payloads-payload
|
컬렉션
|
부팅 시 가상 머신에 전송할 콘텐츠를 정의합니다.
|
없음
|
예
|
제공됨
|
--initialization-configuration-type
|
string
| 가상 머신 형식을 정의합니다. ovf 만 허용합니다. |
없음
|
예
|
제공됨
|
--initialization-configuration-data
|
string
|
이 매개변수는
--initialization-configuration-type 매개변수와 일치해야 합니다. ovf 만 허용합니다.
|
없음
|
예
|
제공됨
|
--cpu-cpu_tune-vcpu_pin
|
컬렉션
|
호스트의 실제 CPU에 고정할 가상 시스템의 가상 CPU를 정의합니다.
|
없음
|
예
|
제공됨
|
--serial_number-policy
|
string
|
가상 머신 템플릿의 일련 번호 정책을 정의합니다.
호스트,vm 또는 custom 를 지정합니다. custom 를 사용하는 경우 --serial_number-value 를 사용하여 일련 번호 값도 정의합니다.
|
없음
|
예
|
제공됨
|
--serial_number-value
|
string
|
가상 머신 템플릿의 일련 번호를 정의합니다.
|
없음
|
예
|
제공됨
|
--bios-boot_menu-enabled
|
boolean
|
부팅 메뉴를 활성화하려면
true 로 설정합니다.
|
없음
|
예
|
제공됨
|
--numa_tune_mode
|
string
|
NUMA 호스트에서 도메인 프로세스에 대한 메모리를 할당하는 방법을 정의합니다.
interleave,strict 또는 preferred 을 지정합니다. 값을 지정하지 않으면 매개변수는 기본적으로 strict 로 설정됩니다.
|
없음
|
예
|
제공됨
|
--cpu_profile-id
|
string
|
사용할 CPU 프로필을 정의합니다. cpuprofiles 목록 명령을 사용하여 전체 CPU 프로필 ID 목록을 검색합니다.
|
없음
|
예
|
제공됨
|
--expect
|
'201-created'
|
예상 HTTP 헤더가 반환될 때까지 요청이 비동기 상태가 됩니다. 작업이 완료되기 전에 성공으로 반환하는 장기 실행 작업에 유용합니다.
|
없음
|
제공되지 않음
|
없음
|
--correlation_id
|
string
|
시스템 간 로깅에 대한 작업의 태그 지정 식별자입니다. 클라이언트가 식별자를 정의하지 않으면 한 개가 생성됩니다.
|
없음
|
예
|
없음
|
--os-boot 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
boot.dev
|
string
|
가상 머신 템플릿의 부팅 장치입니다.
cdrom,hd 또는 network 를 지정합니다.
|
--custom_properties-custom_property 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
custom_property.name
|
string
|
사용자 지정 속성 이름입니다.
|
custom_property.value
|
string
|
사용자 지정 속성 값입니다.
|
--sso-methods-method 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
method.id
|
string
|
사용된 Single Sign-On 방법:
GUEST_AGENT.
|
--disks-disk 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
disk.id
|
string
|
가상 디스크에 대한 참조입니다.
|
storage_domains.storage_domain
|
컬렉션
|
디스크 스토리지 도메인의 하위 매개변수 세트를 정의합니다.
|
--knativeloads-knativeload 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
payload.type
|
string
|
페이로드 제공 유형.
cdrom 또는 pluginppy를 지정합니다.
|
payload.file.name
|
string
|
가상 머신의 루트 파일 시스템에 있는 페이로드 파일 이름 및 위치입니다.
|
payload.file.content
|
string
|
파일에 전달할 내용입니다.
|
--cpu-cpu_tune-vcpu_pin 매개변수는 다음 표의 하위 매개변수를 사용하는 컬렉션입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
vcpu_pin.vcpu
|
int
|
할당할 가상 CPU입니다.
|
vcpu_pin.cpu_set
|
string
|
호스트의 물리적 CPU입니다.
|
예 4.45. 새 가상 머신 생성
[RHEVM shell (connected)]# add vm --name MyVM --template-name Blank --cluster-name Default --memory 536870912
예 4.46. 가상 머신 업데이트
[RHEVM shell (connected)]# update vm MyVM --memory 1073741824
예 4.47. 가상 머신 삭제
[RHEVM shell (connected)]# remove vm MyVM
다음 표에는 가상 머신 리소스에 대한 작업이 나열되어 있습니다.
| 동작 | 설명 |
|---|---|
start | 가상 머신을 시작합니다. |
중지 | 가상 머신을 중지합니다. |
shutdown | 가상 머신을 종료합니다. |
일시 중단 | 가상 머신 일시 중단. |
detach | 풀에서 가상 머신을 분리합니다. |
migrate | 가상 머신을 다른 호스트로 마이그레이션 |
마이그레이션 취소 | 진행 중인 마이그레이션을 중지합니다. |
내보내기 | 내보내기 스토리지 도메인으로 가상 머신을 내보냅니다. |
이동 | 가상 디스크를 다른 스토리지 도메인으로 이동합니다. |
ticket | 콘솔 액세스 티켓을 생성합니다. |
logon | 타사 애플리케이션을 사용하여 콘솔 액세스에 대한 사용자 로그를 활성화합니다. |
