Red Hat Summit6.119. 호스트
호스트를 관리하는 서비스입니다.
| 이름 | 요약 |
|---|---|
|
| 새 호스트를 생성합니다. |
|
| 사용 가능한 모든 호스트 목록을 가져옵니다. |
6.119.1. POST추가
새 호스트를 생성합니다.
호스트는 호스트 매개 변수의 특성을 기반으로 생성됩니다. 이름,주소, root_password 속성이 필요합니다.
예를 들어 호스트를 추가하려면 다음 요청을 보냅니다.
POST /ovirt-engine/api/hosts
POST /ovirt-engine/api/hosts다음과 같은 요청 본문으로:
<host> <name>myhost</name> <address>myhost.example.com</address> <root_password>myrootpassword</root_password> </host>
<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
POST /ovirt-engine/api/hosts?deploy_hosted_engine=true클러스터에 자동 배포에 지원되는 기본 외부 네트워크 공급자가 있는 경우 호스트를 추가할 때 외부 네트워크 공급자가 배포됩니다. OVN의 외부 네트워크 공급자만 자동 배포에 지원됩니다. 클러스터에 정의된 외부 네트워크 공급자가 아닌 다른 외부 네트워크 공급자를 배포하려면 다음 요청을 전송하여 호스트를 추가할 때 외부 네트워크 공급자를 덮어씁니다.
POST /ovirt-engine/api/hosts
POST /ovirt-engine/api/hosts
external_network_provider_configuration 에서 원하는 공급자에 대한 참조가 포함된 요청 본문을 사용합니다.
| 이름 | 유형 | 방향 | 요약 |
|---|---|---|---|
|
| 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
GET /ovirt-engine/api/hosts응답 본문은 다음과 유사합니다.
반환된 호스트 목록의 순서는 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
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
GET /ovirt-engine/api/hosts?migration_target_of=123,456&check_vms_in_affinity_closure=true6.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
GET /ovirt-engine/api/hosts?migration_target_of=123,456
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}