6.38. Cluster

클러스터에 대한 정보를 가져옵니다.

클러스터 가져오기의 예:

GET /ovirt-engine/api/clusters/123

<cluster href="/ovirt-engine/api/clusters/123" id="123">
  <actions>
    <link href="/ovirt-engine/api/clusters/123/resetemulatedmachine" rel="resetemulatedmachine"/>
  </actions>
  <name>Default</name>
  <description>The default server cluster</description>
  <link href="/ovirt-engine/api/clusters/123/networks" rel="networks"/>
  <link href="/ovirt-engine/api/clusters/123/permissions" rel="permissions"/>
  <link href="/ovirt-engine/api/clusters/123/glustervolumes" rel="glustervolumes"/>
  <link href="/ovirt-engine/api/clusters/123/glusterhooks" rel="glusterhooks"/>
  <link href="/ovirt-engine/api/clusters/123/affinitygroups" rel="affinitygroups"/>
  <link href="/ovirt-engine/api/clusters/123/cpuprofiles" rel="cpuprofiles"/>
  <ballooning_enabled>false</ballooning_enabled>
  <cpu>
    <architecture>x86_64</architecture>
    <type>Intel Nehalem Family</type>
  </cpu>
  <error_handling>
    <on_error>migrate</on_error>
  </error_handling>
  <fencing_policy>
    <enabled>true</enabled>
    <skip_if_connectivity_broken>
      <enabled>false</enabled>
      <threshold>50</threshold>
    </skip_if_connectivity_broken>
    <skip_if_sd_active>
      <enabled>false</enabled>
    </skip_if_sd_active>
  </fencing_policy>
  <gluster_service>false</gluster_service>
  <ha_reservation>false</ha_reservation>
  <ksm>
    <enabled>true</enabled>
    <merge_across_nodes>true</merge_across_nodes>
  </ksm>
  <memory_policy>
    <over_commit>
      <percent>100</percent>
    </over_commit>
    <transparent_hugepages>
      <enabled>true</enabled>
    </transparent_hugepages>
  </memory_policy>
  <migration>
    <auto_converge>inherit</auto_converge>
    <bandwidth>
      <assignment_method>auto</assignment_method>
    </bandwidth>
    <compressed>inherit</compressed>
  </migration>
  <required_rng_sources>
    <required_rng_source>random</required_rng_source>
  </required_rng_sources>
  <scheduling_policy href="/ovirt-engine/api/schedulingpolicies/456" id="456"/>
  <threads_as_cores>false</threads_as_cores>
  <trusted_service>false</trusted_service>
  <tunnel_migration>false</tunnel_migration>
  <version>
    <major>4</major>
    <minor>0</minor>
  </version>
  <virt_service>true</virt_service>
  <data_center href="/ovirt-engine/api/datacenters/111" id="111"/>
</cluster>

클러스터의 모든 볼륨에 대한 Gluster 복구 정보를 새로 고칩니다.

예를 들어 Cluster 123 에서 다음과 같은 요청을 보냅니다.

POST /ovirt-engine/api/clusters/123/refreshglusterhealstatus

시스템에서 클러스터를 제거합니다.

DELETE /ovirt-engine/api/clusters/00000000-0000-0000-0000-000000000000

클러스터의 모든 네트워크를 동기화합니다.

POST /ovirt-engine/api/clusters/123/syncallnetworks

다음과 같이 요청 본문이 있는 경우:

<action/>

클러스터에 대한 정보를 업데이트합니다.

지정된 필드만 업데이트되고 다른 필드는 변경되지 않습니다.

예를 들어 클러스터의 CPU를 업데이트하려면 다음을 수행합니다.

PUT /ovirt-engine/api/clusters/123

다음과 같이 요청 본문이 있는 경우:

<cluster>
  <cpu>
    <type>Intel Haswell-noTSX Family</type>
  </cpu>
</cluster>

작업 값에 따라 클러스터의 업그레이드 프로세스를 시작, 업데이트 또는 완료합니다. 이 작업은 업그레이드용 클러스터를 표시하거나, 진행 상황을 업데이트하거나, 시작,stop 또는 update_progress 값을 사용하는 작업 값을 기반으로 클러스터에서 실행 중인 업그레이드 플래그를 지웁니다.

POST /ovirt-engine/api/clusters/123/upgrade

이와 같은 요청 본문을 사용하면 클러스터를 업그레이드하도록 표시합니다.

<action>
    <upgrade_action>
        start
    </upgrade_action>
</action>

업그레이드를 시작한 후 이와 같은 요청 본문을 사용하여 진행 상황을 15 %로 업데이트합니다.

<action>
    <upgrade_action>
        update_progress
    </upgrade_action>
    <upgrade_percent_complete>
        15
    </upgrade_percent_complete>
</action>