6.119. 호스트
호스트를 관리하는 서비스입니다.
| 이름 | 요약 |
|---|---|
|
| 새 호스트를 생성합니다. |
|
| 사용 가능한 모든 호스트 목록을 가져옵니다. |
6.119.1. POST추가
새 호스트를 생성합니다.
호스트는 호스트 매개 변수의 특성을 기반으로 생성됩니다. 이름,주소, root_password 속성이 필요합니다.
예를 들어 호스트를 추가하려면 다음 요청을 보냅니다.
POST /ovirt-engine/api/hosts
다음과 같은 요청 본문으로:
<host> <name>myhost</name> <address>myhost.example.com</address> <root_password>myrootpassword</root_password> </host>
root_password 요소는 클라이언트 제공 초기 표시에만 포함되며 후속 요청에서 반환된 표현에는 노출되지 않습니다.
엔진의 버전 4.1.2 이후, 호스트가 새로 추가되면 호스트의 방화벽 정의가 기본적으로 재정의됩니다.
호스트 엔진 호스트를 추가하려면 deploy_hosted_engine 매개 변수를 사용합니다.
POST /ovirt-engine/api/hosts?deploy_hosted_engine=true
클러스터에 자동 배포에 지원되는 기본 외부 네트워크 공급자가 있는 경우 호스트를 추가할 때 외부 네트워크 공급자가 배포됩니다. OVN의 외부 네트워크 공급자만 자동 배포에 지원됩니다. 클러스터에 정의된 외부 네트워크 공급자가 아닌 다른 외부 네트워크 공급자를 배포하려면 다음 요청을 전송하여 호스트를 추가할 때 외부 네트워크 공급자를 덮어씁니다.
POST /ovirt-engine/api/hosts
external_network_provider_configuration 에서 원하는 공급자에 대한 참조가 포함된 요청 본문을 사용합니다.
<host>
<name>myhost</name>
<address>myhost.example.com</address>
<root_password>123456</root_password>
<external_network_provider_configurations>
<external_network_provider_configuration>
<external_network_provider name="ovirt-provider-ovn"/>
</external_network_provider_configuration>
</external_network_provider_configurations>
</host>| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in |
| |
|
| in |
| |
|
| in/Out | 새 호스트가 생성되는 호스트 정의가 매개 변수로 전달되고 새로 생성된 호스트가 반환됩니다. | |
|
| in | 설치가 성공한 후 호스트를 재부팅해야 하는지 여부를 나타냅니다. | |
|
| in |
|
6.119.1.1. 활성화
true 로 설정하면 설치가 완료된 후 이 호스트가 활성화됩니다. false 로 설정하면 호스트는 설치 후 유지 관리 상태로 유지됩니다. 이 매개 변수가 없으면 원하는 기본 동작이 설치 후 호스트를 활성화하는 것이므로 이 매개 변수가 true 로 해석됩니다.
6.119.1.2. deploy_hosted_engine
true 로 설정하면 이 호스트는 호스팅 엔진 구성 요소를 배포합니다. 누락된 값은 실제, 즉 호스팅 엔진 구성 요소를 배포합니다. 이 매개변수를 동일하게 생략하면 호스트 는 호스팅 엔진 영역에서 아무 작업도 수행하지 않습니다.
6.119.1.3. reboot
설치가 성공한 후 호스트를 재부팅해야 하는지 여부를 나타냅니다. 기본값은 true입니다.
6.119.1.4. undeploy_hosted_engine
true 로 설정하면 이 호스트는 호스팅 엔진 구성 요소를 배포 취소하며 고가용성 클러스터의 일부로 작동하지 않습니다. 누락된 값은 True, i.e., un-deploy로 처리됩니다. 이 매개변수를 동일하게 생략하면 호스트 는 호스팅 엔진 영역에서 아무 작업도 수행하지 않습니다.
6.119.2. GET나열
사용 가능한 모든 호스트 목록을 가져옵니다.
예를 들어, 호스트가 다음 요청을 전송하도록 하려면 다음을 수행합니다.
GET /ovirt-engine/api/hosts
응답 본문은 다음과 유사합니다.
<hosts>
<host href="/ovirt-engine/api/hosts/123" id="123">
...
</host>
<host href="/ovirt-engine/api/hosts/456" id="456">
...
</host>
...
</host>
반환된 호스트 목록의 순서는 sortby 절이 검색 매개 변수에 포함된 경우에만 보장됩니다.
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| in | 응답에 호스트 특성을 모두 포함해야 하는지 여부를 나타냅니다. | |
|
| in |
검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다. | |
|
| in |
이 매개 변수를 | |
|
| in | 사용자의 권한에 따라 결과를 필터링해야 하는지 여부를 나타냅니다. | |
|
| in | 따라야 할 내부 링크를 나타냅니다. | |
|
| Out | ||
|
| in | 반환할 최대 호스트 수를 설정합니다. | |
|
| in | 쉼표로 구분된 가상 시스템 ID 목록을 수락하고 이러한 가상 시스템을 마이그레이션할 수 있는 호스트를 반환합니다. | |
|
| in | 반환된 호스트를 제한하는 데 사용되는 쿼리 문자열입니다. |
6.119.2.1. all_content
응답에 호스트 특성을 모두 포함해야 하는지 여부를 나타냅니다.
기본적으로 다음 호스트 속성은 제외됩니다.
-
hosted_engine
예를 들어 호스트의 전체 표현을 검색하려면 다음을 수행합니다.
GET /ovirt-engine/api/hosts?all_content=true
이러한 특성을 검색하면 성능에 영향을 미치므로 기본적으로 포함되지 않습니다. 사용되지 않으며 데이터베이스에 대한 추가 쿼리가 필요합니다. 이 매개 변수는 주의해서 사용해야 하며 특히 필요한 경우에만 사용하십시오.
6.119.2.2. case_sensitive
검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다. 기본값은 true 입니다. 즉, 해당 케이스가 고려됩니다. 대소문자를 무시하고자 하는 경우 false 로 설정합니다.
6.119.2.3. check_vms_in_affinity_closure
이 매개 변수를 migration_target_of 와 함께 사용하여 나열된 가상 머신과 나열된 가상 머신과 함께 양의 강제 적용 대상의 유효한 마이그레이션 대상을 가져올 수 있습니다.
이는 양수 선호도 그룹의 다른 가상 머신과 함께 마이그레이션되는 경우에 유용합니다.
기본값은 false입니다.
GET /ovirt-engine/api/hosts?migration_target_of=123,456&check_vms_in_affinity_closure=true
6.119.2.4. 팔로우
따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.
6.119.2.5. max
반환할 최대 호스트 수를 설정합니다. 지정하지 않으면 모든 호스트가 반환됩니다.
6.119.2.6. migration_target_of
쉼표로 구분된 가상 시스템 ID 목록을 수락하고 이러한 가상 시스템을 마이그레이션할 수 있는 호스트를 반환합니다.
예를 들어 ID가 123인 가상 머신과 ID 456이 있는 가상 시스템을 마이그레이션할 수 있는 호스트 목록을 검색하려면 다음 요청을 보냅니다.
GET /ovirt-engine/api/hosts?migration_target_of=123,456
