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. 资源表述的通用属性

所有资源表述都包括了一组通用的属性

表 7.2. 资源表述的通用属性

属性类型描述属性
idGUID虚拟环境中的每个资源都包括一个 id,它被作为一个全局唯一标识(GUID)使用。GUID 是代表资源的主要方法。
href字符串作为绝对路径的资源的位置。

7.2.3. 资源表述的通用项

所有资源表述都包括了一组通用项。

表 7.3. 资源表述的通用项

类型描述属性
name字符串用户提供的资源名。在一个类型中,每个资源的 name 必须是是唯一的。
description字符串用户提供的、对资源的描述信息。