3.5. 表示
在客户端和服务器之间传输对象时,需要表示对象的状态。该 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 元素组成,以对象类型命名,以复数表示。这包含集合对象的表示。例如,虚拟机集合的 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 元素。