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 元素。