6.63. 디스크
시스템에서 사용 가능한 디스크 컬렉션을 관리합니다.
이름 | 요약 |
---|---|
| 새 유동 디스크를 추가합니다. |
| 디스크 목록을 가져옵니다. |
6.63.1. POST추가
새 유동 디스크를 추가합니다.
디스크 이미지, 직접 LUN 및 관리형 블록 디스크 등 3가지 유형의 디스크를 추가할 수 있습니다. Cinder 통합은 Managed Block Storage로 교체되었습니다.
새 이미지 디스크 추가:
새 부동 이미지 디스크 를 생성할 때 API에는 storage_domain
,provisioned_size
및 format
속성이 필요합니다.
iSCSI 또는 FCP의 스토리지 유형을 사용하는 블록 스토리지 도메인은 스파스=true와 원시
를 명시적으로 지정해야 합니다.
형식
의 조합을 지원하지 않으므로 sparse=
false
지정된 provisioned_size
,포맷
및 이름을
사용하여 새 유동 이미지 디스크를 생성하려면 ID가 123
이고 증분 백업에 대해 활성화된 스토리지 도메인에서 다음과 같이 요청을 보냅니다.
POST /ovirt-engine/api/disks
다음과 같이 요청 본문을 사용합니다.
<disk> <storage_domains> <storage_domain id="123"/> </storage_domains> <name>mydisk</name> <provisioned_size>1048576</provisioned_size> <format>cow</format> <backup>incremental</backup> </disk>
새로운 직접 LUN 디스크를 추가합니다.
API를 통해 새 유동 LUN을 추가할 때 사용할 수 있는 두 가지 플레이버가 있습니다.
-
호스트
요소 사용 - 이 경우 호스트는 온전성 검사(예: LUN이 표시됨)에 사용되고 LUN(예: 크기 및 직렬)에 대한 기본 정보를 검색합니다. -
호스트
요소 없음 - 이 경우 작업은 데이터베이스 전용 작업이며 스토리지에 액세스하지 않습니다.
id 123
, 지정된 별칭
,type
및 logical_unit
을 사용하여 id 456
(속성 주소
,포트
및 대상
)을 사용하여 호스트
요소를 사용하여 새 부동 직접 LUN 디스크를 생성하려면 다음과 같이 요청을 보냅니다.
POST /ovirt-engine/api/disks
다음과 같이 요청 본문을 사용합니다.
<disk> <alias>mylun</alias> <lun_storage> <host id="123"/> <type>iscsi</type> <logical_units> <logical_unit id="456"> <address>10.35.10.20</address> <port>3260</port> <target>iqn.2017-01.com.myhost:444</target> </logical_unit> </logical_units> </lun_storage> </disk>
호스트를 사용하지 않고 새 유동 LUN 디스크를 만들려면 host
요소를 제거합니다.
새 Cinder 디스크를 추가합니다.
Cinder 통합은 Managed Block Storage로 교체되었습니다.
디스크 스냅샷을 업로드하기 위해 유동 디스크를 추가합니다.
엔진의 버전 4.2부터 스냅샷으로 디스크를 업로드할 수 있습니다. 이 요청은 이미지 체인의 기본 이미지(스냅 샷 생성 시 disk-attachments
요소)를 사용하여 생성해야 합니다.
디스크는 업로드된 이미지의 동일한 디스크 식별자와 이미지 식별자를 사용하여 생성해야 합니다. 즉, 식별자는 백업 프로세스의 일부로 저장해야 합니다. 이미지 식별자는 qemu-img info
명령을 사용하여 가져올 수도 있습니다. 예를 들어 디스크 이미지가 b7a4c6c5-443b-47c5-967f-6abc79675e8b/myimage.img
라는 파일에 저장된 경우:
$ qemu-img info b7a4c6c5-443b-47c5-967f-6abc79675e8b/myimage.img image: b548366b-fb51-4b41-97be-733c887fe305 file format: qcow2 virtual size: 1.0G (1073741824 bytes) disk size: 196K cluster_size: 65536 backing file: ad58716a-1fe9-481f-815e-664de1df04eb backing file format: raw
위에 표시된 qemu-img info
명령으로 얻은 디스크 식별자 및 이미지 식별자를 사용하여 디스크를 생성하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/disks
다음과 같이 요청 본문을 사용합니다.
<disk id="b7a4c6c5-443b-47c5-967f-6abc79675e8b"> <image_id>b548366b-fb51-4b41-97be-733c887fe305</image_id> <storage_domains> <storage_domain id="123"/> </storage_domains> <name>mydisk</name> <provisioned_size>1048576</provisioned_size> <format>cow</format> </disk>
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in/Out | 디스크입니다. |
6.63.2. GET나열
디스크 목록을 가져옵니다.
GET /ovirt-engine/api/disks
다음과 같은 XML 응답이 표시됩니다.
<disks> <disk id="123"> <actions>...</actions> <name>MyDisk</name> <description>MyDisk description</description> <link href="/ovirt-engine/api/disks/123/permissions" rel="permissions"/> <link href="/ovirt-engine/api/disks/123/statistics" rel="statistics"/> <actual_size>5345845248</actual_size> <alias>MyDisk alias</alias> ... <status>ok</status> <storage_type>image</storage_type> <wipe_after_delete>false</wipe_after_delete> <disk_profile id="123"/> <quota id="123"/> <storage_domains>...</storage_domains> </disk> ... </disks>
반환된 디스크 목록의 순서는 sortby
절이 검색
매개 변수에 포함된 경우에만 보장됩니다.
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in |
검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다. | |
| Out | 검색된 디스크 목록. | |
| in | 따라야 할 내부 링크를 나타냅니다. | |
| in | 반환할 최대 디스크 수를 설정합니다. | |
| in | 반환된 디스크를 제한하는 데 사용되는 쿼리 문자열입니다. |
6.63.2.1. case_sensitive
검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다. 기본값은
true
입니다. 즉, 해당 케이스가 고려됩니다. 대소문자를 무시하고자 하는 경우 false
로 설정합니다.
6.63.2.2. 팔로우
따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.
6.63.2.3. max
반환할 최대 디스크 수를 설정합니다. 지정하지 않으면 모든 디스크가 반환됩니다.