4장. 진입점
사용자는 호스트와 기본으로 구성된 진입점 URI의
GET 요청을 통해 API와 상호 작용을 시작합니다.
예 4.1. API Entry Point에 액세스
호스트가 www.example.com 이고 기반이 /ovirt-engine/api 이면 다음 요청과 함께 진입점이 표시됩니다.
GET /ovirt-engine/api HTTP/1.1
Accept: application/xml
Host: www.example.com
Authorization: [base64 encoded credentials]
HTTP/1.1 200 OK
Content-Type: application/xml
<api>
<link rel="hosts" href="/ovirt-engine/api/hosts"/>
<link rel="vms" href="/ovirt-engine/api/vms"/>
...
<product_info>
<name>Red Hat Virtualization</name>
<vendor>Red Hat</vendor>
<version revision="0" build="0" minor="0" major="4"/>
</product_info>
<special_objects>
<link rel="templates/blank" href="..."/>
<link rel="tags/root" href="..."/>
</special_objects>
<summary>
<vms>
<total>10</total>
<active>3</active>
</vms>
<hosts>
<total>2</total>
<active>2</active>
</hosts>
<users>
<total>8</total>
<active>2</active>
</users>
<storage_domains>
<total>2</total>
<active>2</active>
</storage_domains>
</summary>
</ovirt-engine/api>
참고
단순화를 위해 다른 모든 예에서는
Host: 및 Authorization: 요청 헤더를 생략하고 base 가 기본 /ovirt-engine/api 경로라고 가정합니다. 이 기본 경로는 구현에 따라 다릅니다.
4.1. 제품 정보
API 사용자가 Red Hat Virtualization 환경의 합법성을 결정하는 데 도움이 되는 진입점에는
product_info 요소가 포함되어 있습니다. 여기에는 제품 이름, 벤더 및 버전이 포함됩니다.
예 4.2. 실제 Red Hat Virtualization 환경 확인
다음 요소는 실제 Red Hat Virtualization 4.0 환경을 식별합니다.
<api>
...
<product_info>
<name>Red Hat Virtualization</name>
<vendor>Red Hat</vendor>
<version>
<build>2</build>
<full_version>4.0.2.3-0.1.el7ev</full_version>
<major>4</major>
<minor>0</minor>
<revision>0</revision>
</version>
</product_info>
...
</ovirt-engine/api>
