6.63. 디스크


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

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

add

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

list

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

6.63.1. POST추가

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

디스크 이미지, 직접 LUN 및 관리형 블록 디스크 등 3가지 유형의 디스크를 추가할 수 있습니다. Cinder 통합은 Managed Block Storage로 교체되었습니다.

새 이미지 디스크 추가:

새 부동 이미지 디스크 를 생성할 때 API에는 storage_domain,provisioned_sizeformat 속성이 필요합니다.

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을 추가할 때 사용할 수 있는 두 가지 플레이버가 있습니다.

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

id 123, 지정된 별칭,typelogical_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>
표 6.193. 매개변수 요약
이름유형방향요약

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 절이 검색 매개 변수에 포함된 경우에만 보장됩니다.

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

© 2024 Red Hat, Inc.