6.104. GlusterVolume
이 서비스는 단일 gluster 볼륨을 관리합니다.
이름 | 요약 |
---|---|
| gluster 볼륨 세부 정보를 가져옵니다. |
| gluster 볼륨 프로파일 통계를 가져옵니다. |
| gluster 볼륨을 리밸런스합니다. |
| gluster 볼륨을 제거합니다. |
| gluster 볼륨에 설정된 모든 옵션을 재설정합니다. |
| gluster 볼륨에서 특정 옵션을 재설정합니다. |
| gluster 볼륨에 특정 옵션을 설정합니다. |
| gluster 볼륨을 시작합니다. |
| gluster 볼륨 프로파일링을 시작합니다. |
| gluster 볼륨을 중지합니다. |
| gluster 볼륨 프로파일링을 중지합니다. |
| gluster 볼륨 리밸런싱을 중지합니다. |
6.104.1. GET가져오기
gluster 볼륨 세부 정보를 가져옵니다.
예를 들어 클러스터 456
에서 식별자 123
가 있는 gluster 볼륨의 세부 정보를 얻으려면 다음과 같은 요청을 보냅니다.
GET /ovirt-engine/api/clusters/456/glustervolumes/123
이 GET 요청은 다음 출력을 반환합니다.
<gluster_volume id="123"> <name>data</name> <link href="/ovirt-engine/api/clusters/456/glustervolumes/123/glusterbricks" rel="glusterbricks"/> <disperse_count>0</disperse_count> <options> <option> <name>storage.owner-gid</name> <value>36</value> </option> <option> <name>performance.io-cache</name> <value>off</value> </option> <option> <name>cluster.data-self-heal-algorithm</name> <value>full</value> </option> </options> <redundancy_count>0</redundancy_count> <replica_count>3</replica_count> <status>up</status> <stripe_count>0</stripe_count> <transport_types> <transport_type>tcp</transport_type> </transport_types> <volume_type>replicate</volume_type> </gluster_volume>
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 따라야 할 내부 링크를 나타냅니다. | |
| Out | gluster 볼륨 표현입니다. |
6.104.1.1. 팔로우
따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.
6.104.2. getprofilestatistics POST
gluster 볼륨 프로파일 통계를 가져옵니다.
예를 들어 클러스터 456
에서 식별자가 123
인 gluster 볼륨에 대한 프로필 통계를 얻으려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/getprofilestatistics
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| Out | 작업에서 반환된 Gluster 볼륨 프로파일링 정보. |
6.104.3. 리밸런스 POST
gluster 볼륨을 리밸런스합니다.
gluster 볼륨을 리밸런싱하면 모든 brick에 데이터를 균등하게 분산하는 데 도움이 됩니다. gluster 볼륨을 확장하거나 축소한 후(데이터 마이그레이션 없이) brick에 데이터를 리밸런싱해야 합니다. 복제되지 않은 볼륨에서 리밸런스 작업을 수행하려면 모든 brick이 온라인 상태여야 합니다. 복제 볼륨에서 하나 이상의 복제본은 온라인 상태여야 합니다.
예를 들어 클러스터 456
에서 식별자가 123
인 gluster 볼륨을 리밸런스하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/rebalance
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 리밸런스가 비동기적으로 수행되어야 하는지 여부를 나타냅니다.Indicates if the rebalance should be performed asynchronously. | |
| in | true로 설정하면 리밸런스가 레이아웃을 수정하여 볼륨에 추가된 새 데이터가 모든 호스트에 분산되도록 합니다. | |
| in | 리밸런스가 강제로 시작되었는지를 나타냅니다. |
6.104.3.1. fix_layout
true로 설정하면 리밸런스가 레이아웃을 수정하여 볼륨에 추가된 새 데이터가 모든 호스트에 분산되도록 합니다. 그러나 기존 데이터를 마이그레이션/재밸런스하지 않습니다. 기본값은 false
입니다.
6.104.3.2. force
리밸런스가 강제로 시작되었는지를 나타냅니다. 이전 클라이언트가 클러스터에 연결된 경우에도 rebalance 명령을 force 옵션으로 실행할 수 있습니다. 그러나 이로 인해 데이터 손실 상황이 발생할 수 있습니다. 기본값은 false
입니다.
6.104.4. DELETE제거
gluster 볼륨을 제거합니다.
예를 들어 클러스터 456
에서 식별자가 123
인 볼륨을 제거하려면 다음과 같은 요청을 보냅니다.
DELETE /ovirt-engine/api/clusters/456/glustervolumes/123
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 제거가 비동기적으로 수행되어야 하는지 여부를 나타냅니다. |
6.104.5. resetalloptions POST
gluster 볼륨에 설정된 모든 옵션을 재설정합니다.
예를 들어 클러스터 456
에서 식별자 123
가 있는 gluster 볼륨의 모든 옵션을 재설정하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/resetalloptions
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 재설정이 비동기적으로 수행되어야 하는지 여부를 나타냅니다. |
6.104.6. resetoption POST
gluster 볼륨에서 특정 옵션을 재설정합니다.
예를 들어 클러스터 456
에서 식별자가 123
인 gluster 볼륨에서 특정 옵션 option1
을 재설정하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/resetoption
다음과 같은 요청 본문으로:
<action> <option name="option1"/> </action>
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 재설정이 비동기적으로 수행되어야 하는지 여부를 나타냅니다. | |
| in | ||
| in | 재설정할 수 있는 옵션입니다. |
6.104.7. setoption POST
gluster 볼륨에 특정 옵션을 설정합니다.
예를 들어 클러스터 456
에 식별자가 123
인 gluster 볼륨에서 value1
값이 value1인 option1
을 설정하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/setoption
다음과 같은 요청 본문으로:
<action> <option name="option1" value="value1"/> </action>
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 비동기적으로 작업을 수행해야 하는지 여부를 나타냅니다.Indicates whether the action should be performed asynchronously. | |
| in | 설정할 옵션입니다. |
6.104.8. POST시작
gluster 볼륨을 시작합니다.
Gluster Volume은 데이터를 읽기/쓰기로 시작해야 합니다. 예를 들어 클러스터 456
에서 식별자가 123
인 gluster 볼륨을 시작하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/start
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 비동기적으로 작업을 수행해야 하는지 여부를 나타냅니다.Indicates whether the action should be performed asynchronously. | |
| in | 볼륨을 강제로 시작해야 하는지 여부를 나타냅니다. |
6.104.8.1. force
볼륨을 강제로 시작해야 하는지 여부를 나타냅니다. gluster 볼륨이 이미 시작되지만 몇/all의 brick이 다운되면 force start를 사용하여 모든 brick을 가져올 수 있습니다. 기본값은 false
입니다.
6.104.9. startprofile POST
gluster 볼륨 프로파일링을 시작합니다.
예를 들어 클러스터 456
에서 식별자 123
가 있는 gluster 볼륨 프로파일링을 시작하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/startprofile
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 비동기적으로 작업을 수행해야 하는지 여부를 나타냅니다.Indicates whether the action should be performed asynchronously. |
6.104.10. POST중지
gluster 볼륨을 중지합니다.
볼륨을 중지하면 데이터에 액세스할 수 없게 됩니다.
예를 들어 클러스터 456
에서 식별자가 123
인 gluster 볼륨을 중지하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/stop
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 비동기적으로 작업을 수행해야 하는지 여부를 나타냅니다.Indicates whether the action should be performed asynchronously. | |
| in |
6.104.11. stopprofile POST
gluster 볼륨 프로파일링을 중지합니다.
예를 들어 클러스터 456
에서 식별자가 123
인 gluster 볼륨 프로파일링을 중지하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/stopprofile
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 비동기적으로 작업을 수행해야 하는지 여부를 나타냅니다.Indicates whether the action should be performed asynchronously. |
6.104.12. stoprebalance POST
gluster 볼륨 리밸런싱을 중지합니다.
예를 들어 클러스터 456
에서 식별자 123
가 있는 gluster 볼륨의 재조정을 중지하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/456/glustervolumes/123/stoprebalance
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 비동기적으로 작업을 수행해야 하는지 여부를 나타냅니다.Indicates whether the action should be performed asynchronously. |