7.145. InstanceType struct

가상 시스템의 하드웨어 구성을 설명합니다.

예를 들어 중간 인스턴스 유형에는 1개의 가상 CPU 및 4GiB의 메모리가 포함됩니다. 최상위 엔터티(예: 데이터 센터 또는 클러스터에 바인딩되지 않음)입니다. 인스턴스 유형에 사용되며 가상 머신 및 템플릿 유형에 공통되는 속성은 다음과 같습니다.

console
cpu
custom_cpu_model
custom_emulated_machine
표시
high_availability
io
memory
memory_policy
마이그레이션
migration_downtime
os
rng_device
soundcard_enabled
usb
virtio_scsi

인스턴스 유형과 템플릿 모두에서 가상 머신을 생성할 때 가상 머신은 인스턴스 유형에서 하드웨어 구성을 상속합니다.

참고

인스턴스 유형은 템플릿 개체에서 해당 특성을 상속하지만 대부분의 템플릿 속성은 인스턴스 유형에 사용되지 않습니다.

Expand

표 7.195. 특성 요약
이름	유형	요약
`auto_pinning_policy`	AutoPinningPolicy	자동 CPU 및 NUMA 구성 적용 여부를 지정합니다.
`BIOS`	BIOS	가상 머신의 BIOS 구성에 대한 참조입니다.
`주석`	문자열	이 오브젝트에 대한 주석이 포함된 자유 텍스트입니다.
`console`	콘솔	이 가상 시스템에 맞게 구성된 콘솔입니다.
`cpu`	Cpu	가상 머신 CPU의 구성입니다.
`cpu_pinning_policy`	CpuPinningPolicy	CPU 및 NUMA 구성 적용 여부를 지정합니다.
`cpu_shares`	정수
`creation_time`	날짜	가상 머신 생성 날짜입니다.
`custom_compatibility_version`	버전	가상 머신 사용자 정의 호환성 버전.
`custom_cpu_model`	문자열
`custom_emulated_machine`	문자열
`custom_properties`	CustomProperty[]	다양한 후크를 구성하기 위해 VDSM으로 전송되는 속성입니다.
`delete_protected`	부울	`true` 인 경우 가상 머신을 삭제할 수 없습니다.
`description`	문자열	일반 텍스트로 사람이 읽을 수 있는 설명입니다.
`표시`	표시	가상 머신 표시 구성입니다.
`domain`	domain	이 가상 시스템에 대해 구성된 도메인입니다.
`high_availability`	고가용성	가상 머신 고가용성 구성입니다.
`id`	문자열	고유 식별자입니다.
`초기화`	초기화	가상 시스템의 초기화 구성에 대한 참조입니다.
`io`	Io	IO 스레딩 성능 튜닝.
`large_icon`	icon	가상 시스템의 큰 아이콘.
`리스`	StorageDomainLease	이 가상 시스템/템플릿 리스가 있는 스토리지 도메인에 대한 참조입니다.
`memory`	정수	가상 시스템의 메모리(바이트)입니다.
`memory_policy`	MemoryPolicy	가상 머신의 메모리 관리 구성에 대한 참조입니다.
`마이그레이션`	MigrationOptions	실행 중인 가상 머신을 다른 호스트로 마이그레이션하는 구성 참조입니다.
`migration_downtime`	정수	ms의 다른 호스트로 실시간 마이그레이션 중에 가상 머신이 응답하지 않을 수 있는 최대 시간입니다.
`multi_queues_enabled`	부울	`true` 인 경우 각 가상 인터페이스에서 사용 가능한 가상 Cpus에 따라 최적의 대기열 수를 가져옵니다.
`name`	문자열	일반 텍스트로 사람이 읽을 수 있는 이름입니다.
`origin`	문자열	이 가상 머신의 출처입니다.
`os`	OperatingSystem	가상 머신에 설치된 운영 체제 유형입니다.
`placement_policy`	VmPlacementPolicy	가상 머신 배치 정책의 구성.
`rng_device`	RngDevice	이 가상 머신의 난수 생성기 장치 구성입니다.
`serial_number`	serialNumber	클러스터의 가상 머신의 일련 번호입니다.
`small_icon`	icon	가상 시스템의 작은 아이콘.
`soundcard_enabled`	부울	`true` 인 경우 사운드 카드가 가상 머신에 추가됩니다.
`sso`	SSO	이 가상 머신이 구성된 Single Sign On 구성에 대한 참조입니다.
`start_paused`	부울	`true` 이면 시작 후 가상 머신이 처음에 'paused' 상태가 됩니다.
`상태 비저장`	부울	`true` 인 경우 가상 시스템은 상태 비저장 - 종료 후 상태(디스크)를 롤백합니다.
`status`	TemplateStatus	템플릿의 상태.
`storage_error_resume_behaviour`	VmStorageErrorResumeBehaviour	스토리지 오류 후 가상 머신을 다시 시작하는 방법을 결정합니다.
`time_zone`	TimeZone	oVirt로 설정된 가상 머신의 시간대입니다.
`tpm_enabled`	부울	`true` 인 경우 TPM 장치가 가상 머신에 추가됩니다.
`tunnel_migration`	부울	`true` 인 경우 가상 머신 실시간 마이그레이션 중에 네트워크 데이터 전송이 암호화됩니다.
`type`	VmType	가상 머신이 데스크탑 또는 서버에 최적화되었는지 여부를 확인합니다.
`usb`	usb	이 가상 머신의 USB 장치 구성(count, 유형).
`version`	TemplateVersion	이것이 기본 버전인지 다른 템플릿의 하위 버전인지 여부를 나타냅니다.
`virtio_scsi`	VirtioScsi	VirtIO SCSI 구성에 대한 참조입니다.
`virtio_scsi_multi_queues`	정수	Virtio-SCSI contoller의 대기열 수 이 필드에 virtioScsiMultiQueuesEnabled가 true여야 합니다. 자세한 내용은 virtioScsiMultiQueuesEnabled를 참조하십시오.
`virtio_scsi_multi_queues_enabled`	부울	`true` 인 경우 Virtio-SCSI 장치는 사용 가능한 가상 Cpus 및 디스크 또는 지정된 virtioScsiMultiQueues에 따라 여러 개의 큐를 가져옵니다.
`vm`	Vm	이 템플릿과 연결된 가상 머신 구성입니다.

7.145.1. auto_pinning_policy
링크 복사

자동 CPU 및 NUMA 구성 적용 여부를 지정합니다.

중요

엔진의 버전 4.5 이후 이 작업은 더 이상 사용되지 않으며 이전 버전과의 호환성을 위해서만 유지됩니다. 나중에 제거될 수 있습니다. 대신 CpuPinningPolicy를 사용하십시오.

7.145.2. cpu
링크 복사

가상 머신 CPU의 구성입니다.

가상 머신을 재부팅하지 않고 소켓 구성을 업데이트할 수 있습니다. 코어 및 스레드를 재부팅해야 합니다.

예를 들어, 소켓 수를 즉시 4로 변경하고 재부팅 후 코어 수와 스레드 수를 2로 변경하려면 다음 요청을 보냅니다.

PUT /ovirt-engine/api/vms/123

PUT /ovirt-engine/api/vms/123

Copy to Clipboard

Toggle word wrap

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

<vm>
  <cpu>
    <topology>
      <sockets>4</sockets>
      <cores>2</cores>
      <threads>2</threads>
    </topology>
  </cpu>
</vm>

<vm>
  <cpu>
    <topology>
      <sockets>4</sockets>
      <cores>2</cores>
      <threads>2</threads>
    </topology>
  </cpu>
</vm>

Copy to Clipboard

Toggle word wrap

7.145.3. cpu_pinning_policy
링크 복사

CPU 및 NUMA 구성 적용 여부를 지정합니다. CPU 고정 문자열의 이전 동작을 지정하지 않으면 CpuPinningPolicy를 None 또는 Manual로 결정합니다.

7.145.4. custom_compatibility_version
링크 복사

가상 머신 사용자 정의 호환성 버전.

가상 머신을 자체 호환성 버전으로 사용자 지정할 수 있습니다. custom_compatibility_version 이 설정된 경우 이 특정 가상 머신에 대한 클러스터의 호환성 버전을 덮어씁니다.

가상 시스템의 호환성 버전은 가상 시스템이 상주하는 데이터 센터에 의해 제한되며 가상 시스템이 실행하려는 호스트의 기능에 대해 확인됩니다.

7.145.5. high_availability
링크 복사

가상 머신 고가용성 구성입니다. 설정하면 예기치 않게 중단될 때 가상 머신이 자동으로 다시 시작됩니다.

7.145.6. 초기화
링크 복사

가상 시스템의 초기화 구성에 대한 참조입니다.

참고

Red Hat Virtualization 4.1.8 이후에는 빈 태그를 전송하여 이 속성을 지울 수 있습니다.

예를 들어 initialization 특성을 지우려면 다음과 같은 요청을 보냅니다.

PUT /ovirt-engine/api/vms/123

PUT /ovirt-engine/api/vms/123

Copy to Clipboard

Toggle word wrap

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

<vm>
  <initialization/>
</vm>

<vm>
  <initialization/>
</vm>

Copy to Clipboard

Toggle word wrap

이러한 요청에 대한 응답 및 헤더 All-Content: true 가 있는 요청도 여전히 이 속성이 포함됩니다.

7.145.7. large_icon
링크 복사

가상 시스템의 큰 아이콘. 사용자가 설정하거나 운영 체제에 따라 설정된 이미지를 나타냅니다.

리스를 사용하여 실행 중인 가상 시스템에는 리스를 다른 호스트에서 사용하지 않는지 확인하는 동안 이 가상 시스템의 다른 인스턴스가 다른 호스트에서 실행되지 않도록 해야 합니다. 이를 통해 고가용성 가상 머신의 split- percent에 대한 보호 기능을 제공합니다. 이 템플릿에서 생성된 가상 시스템을 리스 위치로 사전 구성하도록 템플릿에도 리스용으로 정의된 스토리지 도메인이 있을 수 있습니다.

7.145.9. memory
링크 복사

가상 시스템의 메모리(바이트)입니다.

예를 들어 1GB(GiB)의 메모리를 포함하도록 가상 머신을 업데이트하려면 다음 요청을 보냅니다.

PUT /ovirt-engine/api/vms/123

PUT /ovirt-engine/api/vms/123

Copy to Clipboard

Toggle word wrap

다음과 같은 요청 본문으로:

<vm>
  <memory>1073741824</memory>
</vm>

<vm>
  <memory>1073741824</memory>
</vm>

Copy to Clipboard

Toggle word wrap

메모리 핫 플러그는 Red Hat Virtualization 3.6 이후에서 지원됩니다. 가상 머신이 실행되는 동안 위의 예제를 사용하여 메모리를 늘릴 수 있습니다. ??? 크기 증분은 HotPlugMemoryBlockSizeMb 구성 값(기본값:256MiB)으로 구분할 수 있어야 합니다. 메모리 크기 증분이 이 값으로 분리되지 않으면 메모리 크기 변경은 다음 실행 구성에만 저장됩니다. 성공적인 각 메모리 핫 플러그 작업은 하나 또는 두 개의 새로운 메모리 장치를 생성합니다.

Red Hat Virtualization 4.2 이후부터는 메모리 핫 플러그가 지원됩니다. 메모리 핫 언플러그는 가상 머신이 상태의 경우에만 수행할 수 있습니다. ??? 핫플러그된 메모리 장치만 핫 플러그 해제 작업으로 제거할 수 있습니다. 이전에 핫플러그된 메모리 장치의 조합과 일치하도록 요청된 메모리 감소가 반올림됩니다. 요청된 메모리 값은 반올림하지 않고 다음 실행 구성에 저장됩니다.

참고

예제의 memory는 다음 공식을 사용하여 바이트로 변환됩니다.
1GiB = 2³⁰ 바이트 = 1073741824 바이트.

참고

Red Hat Virtualization Manager는 내부적으로 값을 whole MiBs로 반올림합니다 (1MiB =²⁰ 바이트)

7.145.10. Migration
링크 복사

실행 중인 가상 머신을 다른 호스트로 마이그레이션하는 구성 참조입니다.

참고

이 메서드에서 반환된 ID로 마이그레이션 정책을 쿼리하는 API는 아직 구현되지 않습니다. /ovirt-engine/api/options/MigrationPolicies 를 사용하여 해당 ID가 있는 모든 마이그레이션 정책 목록을 가져옵니다.

7.145.11. migration_downtime
링크 복사

ms의 다른 호스트로 실시간 마이그레이션 중에 가상 머신이 응답하지 않을 수 있는 최대 시간입니다.

가상 머신에 대해 명시적으로 설정하거나 engine-config -s DefaultMaximumMigrationDowntime=[value]로 설정합니다.

7.145.12. 출처
링크 복사

이 가상 머신의 출처입니다.

가능한 값은 다음과 같습니다.

ovirt
rhev
vmware
xen
external
hosted_engine
managed_hosted_engine
kvm
physical_machine
HyperV

7.145.13. placement_policy
링크 복사

가상 머신 배치 정책의 구성.

가상 머신을 하나 이상의 호스트에 고정하도록 이 구성을 업데이트할 수 있습니다.

참고

여러 호스트에 고정된 가상 시스템은 실시간 마이그레이션할 수 없지만 호스트 장애 발생 시 고가용성으로 구성된 모든 가상 시스템은 가상 머신이 고정된 다른 호스트 중 하나에서 자동으로 다시 시작됩니다.

예를 들어 가상 머신을 두 개의 호스트에 고정하려면 다음 요청을 보냅니다.

PUT /api/vms/123

PUT /api/vms/123

Copy to Clipboard

Toggle word wrap

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

<vm>
  <high_availability>
    <enabled>true</enabled>
    <priority>1</priority>
  </high_availability>
  <placement_policy>
    <hosts>
      <host>
        <name>Host1</name>
      </host>
      <host>
        <name>Host2</name>
      </host>
    </hosts>
    <affinity>pinned</affinity>
  </placement_policy>
</vm>

<vm>
  <high_availability>
    <enabled>true</enabled>
    <priority>1</priority>
  </high_availability>
  <placement_policy>
    <hosts>
      <host>
        <name>Host1</name>
      </host>
      <host>
        <name>Host2</name>
      </host>
    </hosts>
    <affinity>pinned</affinity>
  </placement_policy>
</vm>

Copy to Clipboard

Toggle word wrap

7.145.14. small_icon
링크 복사

가상 시스템의 작은 아이콘. 사용자가 설정하거나 운영 체제에 따라 설정된 이미지를 나타냅니다.

7.145.15. sso
링크 복사

이 가상 머신이 구성된 Single Sign On 구성에 대한 참조입니다. 콘솔이 열리면 가상 머신의 운영 체제에서 자동으로 로그인할 수 있습니다.

7.145.16. tpm_enabled
링크 복사

true 인 경우 TPM 장치가 가상 머신에 추가됩니다. 기본값은 false 입니다. 이 속성은 "All-Content=true" 헤더가 설정된 경우에만 가져옵니다.

Expand

표 7.196. 링크 요약
이름	유형	요약
`cdroms`	Cdrom[]	템플릿에 연결된 CD-ROM 장치를 참조합니다.
`cluster`	Cluster	가상 머신이 속하는 클러스터에 대한 참조입니다.
`cpu_profile`	CpuProfile	이 가상 머신에서 사용하는 CPU 프로파일에 대한 참조입니다.
`disk_attachments`	DiskAttachment[]	템플릿에 연결된 디스크를 참조합니다.
`graphics_consoles`	GraphicsConsole[]	템플릿에 연결된 그래픽 콘솔에 대한 참조입니다.
`mediated_devices`	VmMediatedDevice[]	중재된 장치 구성.
`nics`	NIC []	템플릿에 연결된 네트워크 인터페이스를 참조합니다.
`권한`	승인 []	템플릿에 연결된 사용자 권한을 참조합니다.
`quota`	할당량	이 가상 머신에 대한 할당량 구성 세트 참조.
`storage_domain`	StorageDomain	가상 머신이 속하는 스토리지 도메인에 대한 참조입니다.
`tags`	Tag[]	템플릿에 연결된 태그를 참조합니다.
`watchdogs`	Watchdog[]	템플릿에 연결된 워치독 장치에 대한 참조입니다.

맨 위로 이동

7.145. InstanceType struct

7.145.1. auto_pinning_policy
링크 복사

7.145.2. cpu
링크 복사

7.145.3. cpu_pinning_policy
링크 복사

7.145.4. custom_compatibility_version
링크 복사

7.145.5. high_availability
링크 복사

7.145.6. 초기화
링크 복사

7.145.7. large_icon
링크 복사

7.145.8. 리스
링크 복사

7.145.9. memory
링크 복사

7.145.10. Migration
링크 복사

7.145.11. migration_downtime
링크 복사

7.145.12. 출처
링크 복사

7.145.13. placement_policy
링크 복사

7.145.14. small_icon
링크 복사

7.145.15. sso
링크 복사

7.145.16. tpm_enabled
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

7.145. InstanceType struct

7.145.1. auto_pinning_policy링크 복사링크가 클립보드에 복사되었습니다!

7.145.2. cpu링크 복사링크가 클립보드에 복사되었습니다!

7.145.3. cpu_pinning_policy링크 복사링크가 클립보드에 복사되었습니다!

7.145.4. custom_compatibility_version링크 복사링크가 클립보드에 복사되었습니다!

7.145.5. high_availability링크 복사링크가 클립보드에 복사되었습니다!

7.145.6. 초기화링크 복사링크가 클립보드에 복사되었습니다!

7.145.7. large_icon링크 복사링크가 클립보드에 복사되었습니다!

7.145.8. 리스링크 복사링크가 클립보드에 복사되었습니다!

7.145.9. memory링크 복사링크가 클립보드에 복사되었습니다!

7.145.10. Migration링크 복사링크가 클립보드에 복사되었습니다!

7.145.11. migration_downtime링크 복사링크가 클립보드에 복사되었습니다!

7.145.12. 출처링크 복사링크가 클립보드에 복사되었습니다!

7.145.13. placement_policy링크 복사링크가 클립보드에 복사되었습니다!

7.145.14. small_icon링크 복사링크가 클립보드에 복사되었습니다!

7.145.15. sso링크 복사링크가 클립보드에 복사되었습니다!

7.145.16. tpm_enabled링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

7.145.1. auto_pinning_policy
링크 복사

7.145.2. cpu
링크 복사

7.145.3. cpu_pinning_policy
링크 복사

7.145.4. custom_compatibility_version
링크 복사

7.145.5. high_availability
링크 복사

7.145.6. 초기화
링크 복사

7.145.7. large_icon
링크 복사

7.145.8. 리스
링크 복사

7.145.9. memory
링크 복사

7.145.10. Migration
링크 복사

7.145.11. migration_downtime
링크 복사

7.145.12. 출처
링크 복사

7.145.13. placement_policy
링크 복사

7.145.14. small_icon
링크 복사

7.145.15. sso
링크 복사

7.145.16. tpm_enabled
링크 복사