6.56. 디스크
단일 디스크를 관리합니다.
| 이름 | 요약 |
|---|---|
|
| 디스크 형식 및/또는 사전 할당 모드를 변환합니다. |
|
| 이 작업은 지정된 스토리지 도메인에 디스크를 복사합니다. |
|
| 디스크를 내보내기 스토리지 도메인으로 내보냅니다. |
|
| 디스크의 설명을 검색합니다. |
|
| 디스크를 다른 스토리지 도메인으로 이동합니다. |
|
| 디스크 이미지의 크기를 줄입니다. |
|
| 스토리지의 최신 정보를 사용하여 직접 LUN 디스크를 새로 고칩니다. |
|
| 디스크를 제거합니다. |
|
| 디스크를 확장합니다. |
|
| 지정된 디스크의 매개변수를 업데이트합니다. |
6.56.1. convert POST
디스크 형식 및/또는 사전 할당 모드를 변환합니다.
예를 들어 디스크 형식을 사전allocated-cow에서 sparse-raw 이미지로 변환하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/disks/123/convert
다음과 같은 요청 본문으로:
<action>
<disk>
<sparse>true</sparse>
<format>raw</format>
</disk>
</action>참고: 디스크를 확장하려면 디스크가 블록 스토리지 도메인에 있는 경우 두 개의 변환이 필요할 수 있습니다. 예를 들어 디스크가 RAW인 경우 QCOW로 변환하면 디스크 크기가 커집니다. 크기를 줄이기 위해 디스크를 QCOW로 다시 변환하고 동일한 할당 정책을 유지할 수 있습니다.
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in | 디스크에 대한 설명입니다. | |
|
| in | 따라야 할 내부 링크를 나타냅니다. |
6.56.1.1. 팔로우
따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.
6.56.2. POST복사
이 작업은 지정된 스토리지 도메인에 디스크를 복사합니다.
예를 들어 다음 요청을 사용하여 디스크를 복사할 수 있습니다.
POST /ovirt-engine/api/disks/123/copy
다음과 같이 요청 본문이 있는 경우:
<action>
<storage_domain id="456"/>
<disk>
<name>mydisk</name>
</disk>
</action>디스크에서 현재 사용하는 디스크 프로필 또는 할당량이 새 스토리지 도메인에 대해 정의되지 않은 경우 명시적으로 지정할 수 있습니다. 지정하지 않으면 사용 가능한 첫 번째 디스크 프로필과 기본 할당량이 사용됩니다.
예를 들어, 디스크 프로파일 987 및 할당량 753 을 지정하려면 다음과 같이 요청 본문을 보냅니다.
<action> <storage_domain id="456"/> <disk_profile id="987"/> <quota id="753"/> </action>
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in | 복사본을 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the copy should be performed asynchronously. | |
|
| in | ||
|
| in | 새 스토리지 도메인의 디스크의 디스크 프로필입니다. | |
|
| in | 사용자의 권한에 따라 결과를 필터링해야 하는지 여부를 나타냅니다. | |
|
| in | 새 스토리지 도메인의 디스크 할당량입니다. | |
|
| in | 새 디스크가 생성된 스토리지 도메인입니다. |
6.56.2.1. disk_profile
새 스토리지 도메인의 디스크의 디스크 프로필입니다.
디스크 프로필은 스토리지 도메인에 대해 정의되므로 이전 디스크 프로필이 새 스토리지 도메인에 존재하지 않습니다. 이 매개 변수를 사용하지 않으면 사용자에게 권한이 있는 새 스토리지 도메인의 첫 번째 디스크 프로필이 디스크에 할당됩니다.
6.56.2.2. 할당량
새 스토리지 도메인의 디스크 할당량입니다.
현재 할당량은 새 스토리지 도메인에 대해 정의되지 않을 수 있으므로 이 선택적 매개 변수를 사용하여 디스크에 대한 새 할당량을 지정할 수 있습니다. 이 매개 변수를 사용하지 않고 새 스토리지 도메인에 대해 이전 할당량이 정의되지 않은 경우 default(제한 없음) 할당량이 디스크에 할당됩니다.
6.56.2.3. storage_domain
새 디스크가 생성된 스토리지 도메인입니다. id 또는 name 속성을 사용하여 지정할 수 있습니다. 예를 들어, 디스크를 mydata 라는 스토리지 도메인에 복사하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/storagedomains/123/disks/789
다음과 같이 요청 본문이 있는 경우:
<action>
<storage_domain>
<name>mydata</name>
</storage_domain>
</action>6.56.3. 내보내기 POST
디스크를 내보내기 스토리지 도메인으로 내보냅니다.
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in | 비동기적으로 내보내기를 수행해야 하는지 여부를 나타냅니다.Indicates whether the export should be performed asynchronously. | |
|
| in | 사용자의 권한에 따라 결과를 필터링해야 하는지 여부를 나타냅니다. | |
|
| in | 디스크를 내보낼 내보내기 스토리지 도메인입니다. |
6.56.4. GET가져오기
디스크의 설명을 검색합니다.
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in | 디스크의 모든 속성이 응답에 포함되어야 하는지 여부를 나타냅니다. | |
|
| Out | 디스크에 대한 설명입니다. | |
|
| in | 따라야 할 내부 링크를 나타냅니다. |
6.56.4.1. all_content
디스크의 모든 속성이 응답에 포함되어야 하는지 여부를 나타냅니다.
기본적으로 다음 디스크 속성은 제외됩니다.
-
vms
예를 들어 '123' 디스크의 전체 표현을 검색하려면 다음을 수행합니다.
GET /ovirt-engine/api/disks/123?all_content=true
6.56.4.2. 팔로우
따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.
6.56.5. POST이동
디스크를 다른 스토리지 도메인으로 이동합니다.
예를 들어 식별자가 123 인 디스크를 식별자( 456 )가 있는 스토리지 도메인으로 이동하려면 다음 요청을 보냅니다.
POST /ovirt-engine/api/disks/123/move
다음과 같은 요청 본문으로:
<action> <storage_domain id="456"/> </action>
디스크에서 현재 사용하는 디스크 프로필 또는 할당량이 새 스토리지 도메인에 대해 정의되지 않은 경우 명시적으로 지정할 수 있습니다. 그런 다음 사용 가능한 첫 번째 디스크 프로필이 아닌 경우 기본 할당량이 사용됩니다.
예를 들어 디스크 프로파일 987 및 할당량 753 을 명시적으로 사용하려면 다음과 같이 요청 본문을 보냅니다.
<action> <storage_domain id="456"/> <disk_profile id="987"/> <quota id="753"/> </action>
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in | 비동기적으로 이동을 수행할지 여부를 나타냅니다.Indicates if the move should be performed asynchronously. | |
|
| in | 새 스토리지 도메인의 디스크의 디스크 프로필입니다. | |
|
| in | 사용자의 권한에 따라 결과를 필터링해야 하는지 여부를 나타냅니다. | |
|
| in | 새 스토리지 도메인의 디스크 할당량입니다. | |
|
| in | 디스크를 이동할 스토리지 도메인입니다. |
6.56.5.1. disk_profile
새 스토리지 도메인의 디스크의 디스크 프로필입니다.
디스크 프로필은 스토리지 도메인에 대해 정의되므로 이전 디스크 프로필이 새 스토리지 도메인에 존재하지 않습니다. 이 매개 변수를 사용하지 않으면 사용자에게 권한이 있는 새 스토리지 도메인의 첫 번째 디스크 프로필이 디스크에 할당됩니다.
6.56.5.2. 할당량
새 스토리지 도메인의 디스크 할당량입니다.
현재 할당량은 새 스토리지 도메인에 대해 정의되지 않을 수 있으므로 이 선택적 매개 변수를 사용하여 디스크에 대한 새 할당량을 지정할 수 있습니다. 이 매개 변수를 사용하지 않고 새 스토리지 도메인에 대해 이전 할당량이 정의되지 않은 경우 default(제한 없음) 할당량이 디스크에 할당됩니다.
6.56.6. POST단축
디스크 이미지의 크기를 줄입니다.
논리 볼륨에서 reduce 를 호출합니다(즉, 블록 스토리지 도메인에만 적용 가능). 이는 비실행 중인 가상 머신에 연결된 유동 디스크 및 디스크에 적용됩니다. 최적 크기가 자동으로 계산되므로 크기를 지정할 필요가 없습니다.
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in | 제거가 비동기적으로 수행되어야 하는지 여부를 나타냅니다. |
6.56.7. refreshlun POST
스토리지의 최신 정보를 사용하여 직접 LUN 디스크를 새로 고칩니다.
직접 LUN 디스크를 새로 고치는 것은 다음과 같은 경우에 유용합니다.
- LUN은 host 매개 변수 없이 API를 사용하여 추가되었으므로 스토리지의 정보는 포함하지 않습니다( DisksService::add참조).
- LUN에 대한 새로운 정보는 스토리지에서 사용 가능하며 LUN을 업데이트하려고 합니다.
호스트 456 을 사용하여 직접 LUN 디스크 123 을 새로 고치려면 다음 요청을 보냅니다.
POST /ovirt-engine/api/disks/123/refreshlun
다음과 같은 요청 본문으로:
<action> <host id='456'/> </action>
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in | 직접 LUN 디스크를 새로 고치는 데 사용할 호스트입니다. |
6.56.8. DELETE제거
디스크를 제거합니다.
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in | 제거가 비동기적으로 수행되어야 하는지 여부를 나타냅니다. |
6.56.9. sparsify POST
디스크를 확장합니다.
스파잉은 파일 시스템에서 사용하지 않는 디스크 이미지의 공간을 확보합니다. 결과적으로 이미지는 저장 공간보다 적은 공간을 차지하게 됩니다.
현재 간격은 스냅샷이 없는 디스크에서만 작동합니다. 파생 디스크를 포함하는 디스크도 허용되지 않습니다.
6.56.10. PUT업데이트
지정된 디스크의 매개변수를 업데이트합니다.
이 작업을 사용하면 다음 유동 디스크 속성을 업데이트할 수 있습니다.
-
이미지 디스크의 경우
provisioned_size,alias,description,wipe_after_delete,shareable,backup및disk_profile. -
LUN 디스크의 경우
별칭,설명및공유할 수있습니다. - Cinder 통합은 Managed Block Storage로 교체되었습니다.
-
Managed Block 디스크의 경우
provisioned_size,별칭및설명. -
VM 연결 디스크의 경우
qcow_version도 업데이트할 수 있습니다.
예를 들어 다음 요청을 사용하여 디스크의 업데이트를 수행할 수 있습니다.
PUT /ovirt-engine/api/disks/123
다음과 같이 요청 본문이 있는 경우:
<disk> <qcow_version>qcow2_v3</qcow_version> <alias>new-alias</alias> <description>new-desc</description> </disk>
백엔드 작업이 비동기적이므로 사용자에게 반환되는 disk 요소가 변경된 속성과 동기화되지 않을 수 있습니다.
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in/Out | 디스크에 적용할 업데이트입니다. |
