3.5. representations
오브젝트의 상태는 클라이언트와 서버가 전송될 때 표시되어야 합니다. API는 입력 및 출력에 대해 오브젝트 상태를 나타내는 XML 및 JSON을 지원합니다.
3.5.1. XML 표현
개체의 XML 표현은 개체의 형식에 해당하는 XML 요소, id
및 href
특성에 대한 XML 속성, 나머지 특성에 대해 중첩된 XML 요소로 구성됩니다. 예를 들어 가상 머신의 XML 표현은 다음과 같습니다.
<vm id="123" href="/ovirt-engine/api/vms/123"> <name>myvm</name> <description>My VM</description> <memory>1073741824</memory> ... </vm>
개체 컬렉션의 XML 표현은 여러 개체의 형식 뒤에 지정된 XML 요소로 구성됩니다.The XML representation of a collection of objects consists of an XML element, named after the type of the objects, in plural. 컬렉션의 개체의 표현을 포함합니다.This contains the representations of the objects of the collection. 예를 들어 가상 머신 컬렉션에 대한 XML 반환은 다음과 같습니다.
<vms> <vm id="123" href="/ovirt-engine/api/vms/123"> <name>yourvm</name> <description>Your VM</description> <memory>1073741824</memory> ... </vm> <vm id="456" href="/ovirt-engine/api/vms/456"> <name>myname</name> <description>My description</description> <memory>2147483648</memory> ... </vm> ... </vms>
개체의 XML 표현에서 id
및 href
특성은 XML 속성으로 표시되는 유일한 속성이며 나머지는 중첩된 XML 요소로 표시됩니다.
3.5.2. JSON 표현
오브젝트의 JSON 표현은 각 속성( ID
및 href
포함)에 대한 이름/값 쌍을 포함하는 JSON 문서로 구성됩니다. 예를 들어 가상 머신의 JSON 표시는 다음과 같습니다.
{ "id": "123", "href": "/ovirt-engine/api/vms/123", "name": "myvm", "description": "My VM", "memory": 1073741824, ... }
오브젝트 컬렉션의 JSON 표현은 JSON 문서의 이름/값 쌍(오틀 형식)으로 구성되며, 이에는 컬렉션의 개체가 포함된 배열이 포함되어 있습니다. 예를 들어 가상 머신 컬렉션에 대한 JSON respresentation은 다음과 같습니다.
{ "vm": [ { "id": "123", "href": "/ovirt-engine/api/vms/123", "name": "myvm", "description": "My VM", "memory": 1073741824, ... }, { "id": "456", "href": "/ovirt-engine/api/vms/456", "name": "yourvm", "description": "Your VM", "memory": 2147483648, ... }, ] }