7.2. 表述
7.2.1. 表述
API 使用以下的 XML 文档结构构建资源表述：
<resource id="resource_id" href="/api/collection/resource_id">
<name>Resource-Name</name>
<description>A description of the resource</description>
...
</resource>
以一个虚拟机为例，它的表述会以以下形式出现：
<vm id="5b9bbce5-0d72-4f56-b931-5d449181ee06"
href="/api/vms/5b9bbce5-0d72-4f56-b931-5d449181ee06">
<name>RHEL6-Machine</name>
<description>Red Hat Enterprise Linux 6 Virtual Machine</description>
...
</vm>
7.2.2. 资源表述的通用属性
所有资源表述都包括了一组通用的属性
| 属性 | 类型 | 描述 | 属性 |
|---|---|---|---|
id | GUID | 虚拟环境中的每个资源都包括一个 id，它被作为一个全局唯一标识（GUID）使用。GUID 是代表资源的主要方法。 | |
href | 字符串 | 作为绝对路径的资源的位置。 |
7.2.3. 资源表述的通用项
所有资源表述都包括了一组通用项。
| 项 | 类型 | 描述 | 属性 |
|---|---|---|---|
name | 字符串 | 用户提供的资源名。在一个类型中，每个资源的 name 必须是是唯一的。 | |
description | 字符串 | 用户提供的、对资源的描述信息。 |
