7.55. 디스크 구조체
가상 디스크 장치를 나타냅니다.
표 7.73. 특성 요약
이름 | 유형 | 요약 |
---|---|---|
| 디스크가 가상 머신에 표시되는지 여부를 나타냅니다. | |
| 디스크의 실제 크기(바이트)입니다. | |
| ||
| 디스크에서 지원하는 백업 동작입니다. | |
| 디스크 백업 유형(full/incremental)은 디스크 백업이 진행 중인 경우에만 표시됩니다. | |
| 디스크가 부팅 가능한 것으로 표시되는지 여부를 나타냅니다. | |
| 이 오브젝트에 대한 주석이 포함된 자유 텍스트입니다. | |
| 디스크에 있는 실제 콘텐츠를 나타냅니다. | |
| 일반 텍스트로 사람이 읽을 수 있는 설명입니다. | |
| 외부 디스크를 사용합니다. | |
| 기본 스토리지 형식입니다. | |
| 고유 식별자입니다. | |
| ||
| 블록 스토리지에 생성된 스파스 이미지 디스크의 초기 크기(바이트)입니다. | |
| 디스크 장치를 가상 머신에 연결하는 데 사용되는 인터페이스 드라이버 유형입니다. | |
| ||
| ||
| 일반 텍스트로 사람이 읽을 수 있는 이름입니다. | |
| 디스크 오류가 가상 머신이 일시 중지되었는지 또는 디스크 오류를 게스트 운영 체제로 전파해야 하는지 여부를 나타냅니다. | |
| 디스크의 가상 크기(바이트)입니다. | |
| QCOW 볼륨의 기본 QCOW 버전입니다. | |
| 디스크가 읽기 전용 모드인지 여부를 나타냅니다. | |
| SCSI passthrough가 활성화되었는지 여부와 해당 정책을 나타냅니다. | |
| 디스크를 여러 가상 머신에 연결할 수 있는지 여부를 나타냅니다. | |
| 디스크의 물리적 스토리지를 사전 할당해야 하는지 여부를 나타냅니다. | |
| 디스크 장치의 상태. | |
| ||
| 모든 스냅샷을 포함한 디스크의 총 크기(바이트)입니다. | |
| ||
| 삭제 후 디스크의 블록을 0으로 다시 읽을지 여부를 나타냅니다. - 블록 스토리지에서 디스크는 0으로 설정된 후 삭제됩니다. |
7.55.1. active
디스크가 가상 머신에 표시되는지 여부를 나타냅니다.
가상 머신에 디스크 연결을 추가할 때 서버에서 이 속성이 포함되지 않은 요청을 수락하면 결과는 정의되지 않습니다. 경우에 따라 디스크는 자동으로 활성화되며 다른 경우에는 그렇지 않습니다. 문제가 발생하지 않도록 하려면 항상 이 속성을 원하는 값과 함께 포함하는 것이 좋습니다.
7.55.2. actual_size
디스크의 실제 크기(바이트)입니다.
실제 크기는 디스크에서 실제로 사용하는 바이트 수입니다. 소
형식을 사용하는 디스크에 대해 프로비저닝된 크기보다 작아집니다.
7.55.3. 부팅 가능
디스크가 부팅 가능한 것으로 표시되는지 여부를 나타냅니다.
이 속성은 가상 머신에 실제로 연결된 디스크에만 의미가 있으며, API 버전 4에서는 DiskAttachment 유형으로 이동했습니다. 이전 버전과의 호환성을 위해서만 여기에 보존되며 나중에 제거됩니다.
7.55.4. external_disk
외부 디스크를 사용합니다.
외부 디스크는 로컬 파일 또는 블록 장치의 경로 또는 QEMU에서 지원하는 URL(예:)일 수 있습니다.
- nbd:<host>:<port>[:exportname=<export>]
- nbd:unix:</path>[:exportname=<export>]
- http://[<username>[:<password>]@]<host>/<path>
- https://[<username>[:<password>]@]<host>/<path>
- ftp://[<username>[:<password>]@]<host>/<path>
- ftps://[<username>[:<password>]@]<host>/<path>
지원되는 추가 프로토콜 및 자세한 내용은 QEMU 설명서를 참조하십시오.
7.55.5. initial_size
블록 스토리지에 생성된 스파스 이미지 디스크의 초기 크기(바이트)입니다.
초기 크기는 스파스 디스크가 블록 스토리지에서 생성될 때 처음에 할당되는 바이트 수입니다. 초기 크기는 프로비저닝된 크기보다 작습니다. 지정하지 않으면 시스템에서 사용하는 기본 초기 크기가 할당됩니다.
7.55.6. 인터페이스
디스크 장치를 가상 머신에 연결하는 데 사용되는 인터페이스 드라이버 유형입니다.
이 속성은 가상 머신에 실제로 연결된 디스크에만 의미가 있으며, API 버전 4에서는 DiskAttachment 유형으로 이동했습니다. 이전 버전과의 호환성을 위해서만 여기에 보존되며 나중에 제거됩니다.
7.55.7. provisioned_size
디스크의 가상 크기(바이트)입니다.
이 속성은 새 디스크를 생성할 때 필수입니다.
7.55.8. qcow_version
QCOW 볼륨의 기본 QCOW 버전입니다. QCOW 버전은 볼륨에서 지원하는 qemu 버전을 지정합니다. 이 필드는 업데이트 API를 사용하여 업데이트할 수 있으며 QCOW 볼륨에 대해서만 보고됩니다. 디스크가 생성되는 스토리지 도메인의 버전에 따라 결정됩니다. V4보다 낮은 버전이 있는 스토리지 도메인은 QCOW2 볼륨을 지원합니다. V4 스토리지 도메인은 QCOW2v3도 지원합니다. 다른 QCOW 버전의 기능에 대한 자세한 내용은 QCOW3 을 참조하십시오.
7.55.9. read_only
디스크가 읽기 전용 모드인지 여부를 나타냅니다.
버전 4.0 이후 이 속성은 API에 표시되지 않고 DiskAttachment 로 이동되었습니다.
Red Hat Virtualization Manager 버전 4.1.2 이후 이 속성은 더 이상 사용되지 않으며 향후 제거될 예정입니다. 읽기 전용 모드로 디스크를 연결하려면 DiskAttachment 유형의 read_only
특성을 사용합니다. 예를 들어 다음과 같습니다.
POST /ovirt-engine/api/vms/123/diskattachments
<disk_attachment> <read_only>true</read_only> ... </disk_attachment>
7.55.10. sgio
SCSI passthrough가 활성화되었는지 여부와 해당 정책을 나타냅니다.
필터링된 /
값을 설정하면 권한이 없는 SCSI I/O가 있는 LUN 디스크의 SCSI 패스스루가 활성화됩니다. SCSI 패스스루를 비활성화하려면 값을 필터링
되지 않은disabled
로 설정해야 합니다.
7.55.11. 공유 가능
디스크를 여러 가상 머신에 연결할 수 있는지 여부를 나타냅니다.
7.55.12. total_size
모든 스냅샷을 포함한 디스크의 총 크기(바이트)입니다.
총 크기는 디스크에서 실제로 사용하는 바이트 수와 해당 스냅샷의 크기입니다. 직접 LUN 및 Cinder 디스크에 대해 채워지지 않습니다. 스냅샷이 없는 디스크의 경우 전체 크기가 실제 크기와 같습니다.
7.55.13. wipe_after_delete
삭제 후 디스크의 블록을 0으로 다시 읽을지 여부를 나타냅니다.
- 블록 스토리지에서 디스크는 0으로 설정된 후 삭제됩니다.
- 파일 스토리지에서 파일 시스템은 이미 파일 시스템에서 이전에 제거된 블록을 0으로 다시 읽도록 보장하므로 디스크가 즉시 삭제됩니다.
표 7.74. 링크 요약
이름 | 유형 | 요약 |
---|---|---|
| ||
| ||
| 선택적으로 장치가 사용되는 인스턴스 유형에 대한 참조입니다. | |
| ||
| 승인 [] | |
| ||
| ||
| 통계 [] | 디스크에 의해 노출되는 통계입니다. |
| ||
| 이 디스크와 연결된 스토리지 도메인입니다. | |
| 필요한 경우 장치가 사용하는 템플릿에 대한 참조입니다. | |
|
이 요소를 사용하지 말고 대신 | |
| Vm[] | 이 장치를 사용하는 가상 머신에 대한 참조입니다. |
7.55.14. 통계
디스크에 의해 노출되는 통계입니다. 예를 들어 다음과 같습니다.
<statistics> <statistic href="/ovirt-engine/api/disks/123/statistics/456" id="456"> <name>data.current.read</name> <description>Read data rate</description> <kind>gauge</kind> <type>decimal</type> <unit>bytes_per_second</unit> <values> <value> <datum>1052</datum> </value> </values> <disk href="/ovirt-engine/api/disks/123" id="123"/> </statistic> ... </statistics>
이러한 통계는 디스크를 검색할 때 직접 포함되지 않으며 링크만 포함됩니다. 통계 정보를 얻으려면 포함된 링크를 따르십시오.
GET /ovirt-engine/api/disks/123/statistics
7.55.15. storage_domains
이 디스크와 연결된 스토리지 도메인입니다.
템플릿에서 새로 생성되지 않은 가상 머신에 첫 번째 디스크를 추가하는 경우에만 필요합니다.
7.55.16. vms
이 장치를 사용하는 가상 머신에 대한 참조입니다. 하나의 장치는 여러 가상 머신에서 사용할 수 있습니다. 예를 들어 두 개 이상의 가상 머신에서 공유 디스크를 동시에 사용합니다.