지원콘솔개발자평가판 시작연락처

15.6. 하위 항목

15.6.1. 디스크 하위 항목

15.6.1.1. 디스크 하위 항목

디스크 하위 수집은 가상 머신의 모든 가상 하드 디스크 장치를 나타냅니다. 디스크 표현에는 다음 요소가 포함됩니다.
표 15.2. 가상 디스크의 요소
요소 유형 설명 속성
link rel="statistics" 관계 가상 시스템의 디스크 통계에 대한 통계 하위 수집 링크입니다.
link rel="permissions" 관계 권한 하위 수집에 대한 링크입니다.
별칭 string 디스크의 고유 식별자입니다. 이름 대신 alias 를 사용합니다.
image_id string 정의된 스토리지 도메인에 저장된 가상 머신 이미지에 대한 참조입니다.
storage_domains complex 이 디스크와 연결된 스토리지 도메인입니다. 각 storage_domain 요소에는 연결된 스토리지 도메인의 GUID가 있는 id 속성이 포함되어 있습니다. 이 요소를 POST 로 업데이트하여 한 데이터 스토리지 도메인에서 다른 데이터 스토리지 도메인으로 디스크의 실시간 마이그레이션을 수행합니다. [a]
크기 integer 디스크 크기(바이트)입니다. 더 이상 사용되지 않으며 provisioned_size 로 교체되었습니다.
provisioned_size integer 디스크의 프로비저닝된 크기(바이트)입니다.
actual_size integer 디스크의 실제 크기(바이트)입니다.
status 잘못된 , 잘못된 , 잠기 또는 확인중 하나 디스크 장치의 상태입니다. 이러한 상태는 기능 아래의 disk_states 에 나열됩니다.
인터페이스 enumerated 디스크 장치에 연결하는 데 사용되는 인터페이스 드라이버 유형입니다. 기능 에서는 열거된 값 목록을 사용할 수 있습니다.  
형식 enumerated 기본 스토리지 형식입니다. 기능 에서는 열거된 값 목록을 사용할 수 있습니다. COW(Copy On Write)를 사용하면 성능이 작은 스냅샷을 사용할 수 있습니다. Raw는 스냅샷을 허용하지 않지만 성능이 향상됩니다.
스파스 boolean: true 또는 false 디스크의 물리 스토리지를 사전 할당하지 않아야 하는 경우 True 입니다.
부팅 가능 boolean: true 또는 false 이 디스크가 부팅 가능으로 표시되면 true 입니다.  
공유 가능 boolean: true 또는 false 여러 가상 시스템과 디스크를 공유하는 true 입니다.  
wipe_after_delete boolean: true 또는 false 디스크를 삭제할 때 디스크의 기본 물리 스토리지를 0으로 설정해야 하는 경우 True 입니다. 이로 인해 보안이 강화되지만 보다 집약적인 작업이며 삭제 시간이 길어질 수 있습니다.  
propagate_errors boolean: true 또는 false 디스크 오류가 발생하면 가상 머신이 일시 중지되지 않고 대신 디스크 오류를 게스트 OS로 전달해야 합니다.  
vm id= GUID 포함된 가상 머신의 ID입니다.
할당량 id= GUID 디스크에 대한 할당량을 설정합니다.  
lun_storage complex 스토리지 사용을 위한 직접 LUN 매핑에 대한 참조입니다. iSCSI 또는 FCP 장치 세부 정보가 포함된 logical_unit 요소가 필요합니다.
활성 상태 부울 디스크가 가상 머신에 연결되어 있는지 여부를 정의합니다.
read_only 부울 디스크가 읽기 전용인지 여부를 정의합니다.
link rel="disk_profile" 관계 disk_profile 하위 수집에 대한 링크입니다.
[a] 이 요소는 디스크가 가상 머신에 추가되고 가상 머신 템플릿에서 생성되지 않는 경우에만 필요합니다.

예 15.11. 디스크 장치의 XML 표현

<disk id="ed7feafe-9aaf-458c-809a-ed789cdbd5b4"
  href="/ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/
  ed7feafe-9aaf-458c-809a-ed789cdbd5b4">
    <link rel="statistics"
      href="/ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/
      ed7feafe-9aaf-458c-809a-ed789cdbd5b4/statistics"/>
    <link rel="permissions"
      href="/ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/
      ed7feafe-9aaf-458c-809a-ed789cdbd5b4/permissions"/>
    <vm id="082c794b-771f-452f-83c9-b2b5a19c0399"
      href="/ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399"/> 
    <alias>Classic_VM</alias>
    <image_id>cac69a29-ccff-49d4-8a26-e4cdacd83e34</image_id> 
    <storage_domains>
        <storage_domain id="fabe0451-701f-4235-8f7e-e20e458819ed"/>
    </storage_domains> 
    <size>12884901888</size>
    <provisioned_size>12884901888</provisioned_size>
    <actual_size>1073741824</actual_size>
    <type>system</type>
    <status>
        <state>ok</state>
    </status>
    <interface>virtio</interface>
    <format>raw</format>
    <bootable>true</bootable>
    <shareable>true</shareable>
    <wipe_after_disk>true</wipe_after_disk>
    <propagate_errors>false</propagate_errors>
    <active>true</active>
    <read_only>false</read_only>
    <disk_profile id="23fb2e0d-3062-4819-8165-3be88f2f587e"
      href="/ovirt-engine/api/diskprofiles/23fb2e0d-3062-4819-8165-3be88f2f587e"/>
    <lun_storage>
        <logical_unit id="lun1">
                ...
        </logical_unit>
    </lun_storage>
</disk>
새 가상 디스크를 추가합니다. 새 내부 디스크를 추가할 때 provisioned_size 요소가 필요합니다. storage_domains 요소를 사용하여 디스크가 생성될 스토리지 도메인을 지정합니다. 동일한 가상 머신의 여러 디스크는 다른 스토리지 도메인에 있을 수 있습니다.

예 15.12. 가상 머신에 새 디스크 장치 생성

POST /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk>
    <storage_domains>
        <storage_domain id="fabe0451-701f-4235-8f7e-e20e458819ed"/>
    </storage_domains>        
    <provisioned_size>8589934592</provisioned_size>
    <type>system</type>
    <interface>virtio</interface>
    <format>cow</format>
    <bootable>true</bootable>
</disk>
새 외부(직접 LUN) 디스크를 가상 머신에 추가합니다. 이 방법을 사용하려면 lun_storage 요소와 iSCSI 또는 FCP 장치 세부 정보가 포함된 logical_unit 요소가 필요합니다.

예 15.13. 가상 머신에서 새 직접 LUN 디스크 장치 생성

POST /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks HTTP/1.1
Accept: application/xml
Content-type: application/xml
		
<disk>
    <interface>virtio</interface>
    <lun_storage>
        <type>iscsi</type>
        <logical_unit id="lun1">
            <address>iscsi.example.com</address>
            <port>3260</port>
            <target>iqn.2010.05.com.example:iscsi.targetX</target>
        </logical_unit>
    </lun_storage>
</disk>
별칭,설명,storage_domains,provisioned_size,인터페이스,부팅 가능한,공유 가능,delete_after_delete 및 propagate_errors 요소는 updatable post-creation입니다.
사용자는 가상 머신을 일시 중지, 중단 또는 재부팅하지 않고 하나 이상의 가상 머신에서 사용 중인 가상 디스크의 크기를 조정할 수 있습니다.

예 15.14. 가상 디스크 업데이트

PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk>
    <bootable>false</bootable>
    <shareable>false</shareable>
</disk>

예 15.15. 가상 디스크를 20GB로 업데이트

PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk>
    <provisioned_size>21474836480</provisioned_size>
</disk>
참고
이전 예제의 디스크 크기는 다음 공식을 사용하여 바이트로 변환됩니다.
20480MB * 1024 2 = 21474836480 bytes

예 15.16. 가상 디스크 이름 변경

PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk>
    <alias>Classic_VM2</alias>
</disk>
가상 디스크를 삭제하려면 DELETE 요청이 필요합니다.

예 15.17. 가상 디스크 제거

DELETE /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1

HTTP/1.1 204 No Content

15.6.1.2. 디스크 Customizeing

clone 요소를 사용하여 템플릿에서 디스크를 복제합니다. 가상 머신을 생성할 때 디스크 하위 수집 내에서 clone 요소를 true 로 설정합니다. 이렇게 하면 기본 템플릿에서 디스크를 복제하여 가상 머신에 연결합니다.

예 15.18. 템플릿에서 디스크 복제

다음 예제에서는 가상 머신을 생성하는 동안 템플릿에서 디스크를 복제합니다. 
POST /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399 HTTP/1.1
Accept: application/xml
Content-type: application/xml
        
<vm>
    <name>cloned_vm</name>
    <template id="64d4aa08-58c6-4de2-abc4-89f19003b886"/>
    <cluster id="99408929-82cf-4dc7-a532-9d998063fa95"/>
    <disks>
        <clone>true</clone>
        <disk id="4825ffda-a997-4e96-ae27-5503f1851d1b">
            <format>COW</format>
        </disk>
        <disk id="42aef10d-3dd5-4704-aa73-56a023c1464c">
            <format>COW</format>
        </disk>
    </disks>
</vm>
중요
디스크 이름을 기반으로 가상 디스크를 검색하려면 이름 대신 alias 검색 매개 변수가 필요합니다.

15.6.1.3. 디스크 IRQ 하위 항목

각 가상 머신의 디스크에는 디스크별 통계에 대한 통계 하위 수집이 노출됩니다. 각 통계에 는 다음 요소가 포함됩니다.
표 15.3. 가상 디스크 통계 요소
요소 유형 설명
name string 통계 항목의 고유 식별자입니다.
description string 통계에 대한 일반 텍스트 설명입니다.
단위 string 통계 값을 측정하는 단위 또는 비율입니다.
type GAUGE 또는 COUNTER중 하나 통계 조치 유형입니다.
값 type= INTEGER 또는 DECIMAL중 하나 이어지는 통계 값의 데이터 유형입니다.
value complex datum 을 포함하는 데이터 세트입니다.
datum 값 유형참조 값 의 개별 데이터 조각입니다.
디스크 ID= 관계 포함된 디스크 리소스와의 관계입니다.
다음 표에는 가상 디스크의 통계 유형이 나열되어 있습니다.
표 15.4. 가상 디스크 통계 유형
이름
설명
data.current.read
디스크에서 읽을 때 초당 데이터 전송 속도(바이트)입니다.
data.current.write
디스크에 쓸 때 초당 데이터 전송 속도(바이트)입니다.

예 15.19. 가상 머신의 통계 하위 수집에 대한 XML 표현

<statistics>
    <statistic id="33b9212b-f9cb-3fd0-b364-248fb61e1272"
      href="/ovirt-engine/api/vms/3a42530e-3bc5-4094-829d-489257894c2a/disks/
      f28ec14c-fc85-43e1-818d-96b49d50e27b/statistics/
      33b9212b-f9cb-3fd0-b364-248fb61e1272">
        <name>data.current.read</name>
        <description>Read data rate</description>
        <values type="DECIMAL">
            <value>
                <datum>0</datum>
            </value>
        </values>
        <type>GAUGE</type>
        <unit>BYTES_PER_SECOND</unit>
        <disk id="f28ec14c-fc85-43e1-818d-96b49d50e27b" 
          href="/ovirt-engine/api/vms/3a42530e-3bc5-4094-829d-489257894c2a/
          disks/f28ec14c-fc85-43e1-818d-96b49d50e27b"/>
    </statistic>
    ...
</statistics>
참고
이 통계 하위 수집은 읽기 전용입니다.

15.6.1.4. 부동 디스크 연결 및 분리 작업

가상 머신의 디스크 하위 수집에 대한 POST 요청을 사용하여 기본 rel="disks" 컬렉션의 디스크를 연결합니다. 연결할 디스크 의 ID를 포함합니다.

예 15.20. 부동 디스크 연결

POST /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk id="d135f1c5-b5e1-4238-9381-b3277f5a3742">
</disk>
디스크가 제거되지 않도록 디스크 리소스에 대한 DELETE 요청을 사용하여 가상 머신의 디스크 하위 수집에서 디스크를 분리하지만 분리 부울 요소를 포함해야 합니다.

예 15.21. 가상 머신에서 디스크 분리

DELETE /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/
  d135f1c5-b5e1-4238-9381-b3277f5a3742 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<action>
    <detach>true</detach>
</action>

15.6.1.5. 디스크 활성화 및 비활성화 작업

각 가상 머신의 디스크는 가상 머신에서 디스크를 추가하고 제거하는 일련의 활성화 및 비활성화 기능을 제공합니다.

예 15.22. 가상 디스크 활성화 작업

POST /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/a42ada0e-1d69-410d-a392-a6980d873e5d/activate HTTP/1.1
Accept: application/xml
Content-type: application/xml

<action/>

예 15.23. 가상 디스크를 비활성화하는 작업

POST /ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/a42ada0e-1d69-410d-a392-a6980d873e5d/deactivate HTTP/1.1
Accept: application/xml
Content-type: application/xml

<action/>
이러한 작업을 사용하여 디스크를 가상 머신에 핫플러그하고 새로 연결된 부동 디스크를 활성화합니다.
중요
핫플러그 기능은 핫플러그 작업을 지원하는 VirtIO 디스크 및 가상 머신 운영 체제만 지원합니다. 운영 체제의 예는 다음과 같습니다.
  • Red Hat Enterprise Linux 6;
  • Red Hat Enterprise Linux 5;
  • Windows Server 2008; 및
  • Windows Server 2003.
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

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

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.