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

6.63. 디스크

시스템에서 사용 가능한 디스크 컬렉션을 관리합니다.

Expand
표 6.192. 메서드 요약
이름요약

add

새 유동 디스크를 추가합니다.

list

디스크 목록을 가져옵니다.

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
Copy to Clipboard Toggle word wrap

다음과 같이 요청 본문을 사용합니다. 

<disk>
  <storage_domains>
    <storage_domain id="123"/>
  </storage_domains>
  <name>mydisk</name>
  <provisioned_size>1048576</provisioned_size>
  <format>cow</format>
  <backup>incremental</backup>
</disk>
Copy to Clipboard Toggle word wrap

새로운 직접 LUN 디스크를 추가합니다.

API를 통해 새 유동 LUN을 추가할 때 사용할 수 있는 두 가지 플레이버가 있습니다.

  1. 호스트 요소 사용 - 이 경우 호스트는 온전성 검사(예: LUN이 표시됨)에 사용되고 LUN(예: 크기 및 직렬)에 대한 기본 정보를 검색합니다.
  2. 호스트 요소 없음 - 이 경우 작업은 데이터베이스 전용 작업이며 스토리지에 액세스하지 않습니다.

id 123, 지정된 별칭,type 및 logical_unit 을 사용하여 id 456 (속성 주소,포트 및 대상)을 사용하여 호스트 요소를 사용하여 새 부동 직접 LUN 디스크를 생성하려면 다음과 같이 요청을 보냅니다. 

POST /ovirt-engine/api/disks
Copy to Clipboard Toggle word wrap

다음과 같이 요청 본문을 사용합니다. 

<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>
Copy to Clipboard Toggle word wrap

호스트를 사용하지 않고 새 유동 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
Copy to Clipboard Toggle word wrap

위에 표시된 qemu-img info 명령으로 얻은 디스크 식별자 및 이미지 식별자를 사용하여 디스크를 생성하려면 다음과 같은 요청을 보냅니다. 

POST /ovirt-engine/api/disks
Copy to Clipboard Toggle word wrap

다음과 같이 요청 본문을 사용합니다. 

<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>
Copy to Clipboard Toggle word wrap
Expand
표 6.193. 매개변수 요약
이름유형방향요약

disk

디스크

in/Out

디스크입니다.

6.63.2. GET나열
링크 복사

디스크 목록을 가져옵니다. 

GET /ovirt-engine/api/disks
Copy to Clipboard Toggle word wrap

다음과 같은 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>
Copy to Clipboard Toggle word wrap

반환된 디스크 목록의 순서는 sortby 절이 검색 매개 변수에 포함된 경우에만 보장됩니다.

Expand
표 6.194. 매개변수 요약
이름유형방향요약

case_sensitive

부울

in

검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다.

디스크

Disk[]

Out

검색된 디스크 목록.

팔로우

문자열

in

따라야 할 내부 링크를 나타냅니다.

max

정수

in

반환할 최대 디스크 수를 설정합니다.

search

문자열

in

반환된 디스크를 제한하는 데 사용되는 쿼리 문자열입니다.

6.63.2.1. case_sensitive
링크 복사

검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다. 기본값은 true 입니다. 즉, 해당 케이스가 고려됩니다. 대소문자를 무시하고자 하는 경우 false 로 설정합니다.

6.63.2.2. 팔로우
링크 복사

따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.

6.63.2.3. max
링크 복사

반환할 최대 디스크 수를 설정합니다. 지정하지 않으면 모든 디스크가 반환됩니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat