Sun公司云计算接口规范 - 资源模型

点击数：68362010-06-01 17:34:38　来源: 北京精英达康科技有限公司

Cloud API Specification - Resource Models
云接口规范 - 资源模型

This section specifies the representations of the resources which this API operates on. The representations are made up of fields, each with a name and value, encoded using a JSON dictionary. The values may be numeric or string literals, lists, or dictionaries, each of which are represented in the obvious way in JSON.
本章节指定API在其上操作的各种资源的表达式。这些表达式都由属性组成，每种都是键值对形式，使用JSON字典编码格式。这些值可以是数字或字符串，清单，或字典(类)，每种都使用JSON格式进行直观的表达。

These representations typically nest. For example, the representation of a VDC will include representations of the Clusters which inhabit it, which in turn include representations of the VMs within each cluster. Two points follow from this:
这些表达式通常是嵌套的。例如，一个虚拟数据中心的表达式将包括其中集群的表达式，而且还包括每个集群里的虚拟机的表达式。下面两点也跟嵌套有关：

• Retrieving the representation of a VDC gives a comprehensive snapshot of the current state of everything in it using a single GET request. The size of these representations seems, in practice, not excessive.
  使用一个单纯的GET请求能够获得一个虚拟数据中心中所有资源的当前状态的综合快照。这些表达式的大小看起来，实际上并不过多。
• Many of the models specify that the representation includes a uri field whose value is the URI of the resource being represented. This is present to support URI discovery in nested representations.
  许多模型指明表达式包括一个URI属性，其值为表达该资源的URI。这表明支持嵌套表达式里所发现的URI。

Each type of cloud resource has its own Internet Media Type. The media type SHALL conform to the pattern application/vnd.com.sun.cloud.Xxxxxxxx+json, and the specific media type for each resource model is included in square brackets in the corresponding section header.
每种类型的云资源都有自己的互联网媒体类型。媒体类型应该符合application/vnd.com.sun.cloud.Xxxxxxxx+json模型，每个资源模型的具体的媒体类型包含在相应头信息的中括号里。

In the resource model descriptions, fields annotated with [POST] may be included in a POST request, which is normally used to create new resources. Likewise, fields annotated with [PUT] may be included in a PUT request, which is normally used to update properties of existing resources. Fields not so annotated SHOULD NOT be included in the request body of PUT and POST requests, and will be ignored by the server if they are included.
在资源模型描述里，用[POST]注释的属性可能会包含在一个POST请求里，往往用来生成一个新资源。同样，用[PUT] 来注释的属性可能包含在一个PUT请求里，往往用来更新已有资源的属性。属性注释不应该被包含在PUT和POST请求的正文里，否则将被服务器忽略。

1 Cloud [application/vnd.com.sun.cloud.Cloud+json] 云

A Cloud represents a user's view of all accessible resources in the cloud.
一个云资源表示一个用户在云里的所有可访问资源的视图。

A "Cloud" resource model contains the following fields:
一个“云”资源模型包含以下的属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
uri	URI	1	A GET against this URI refreshes the client representation of the resources accessible to this user. 一个针对这个URI的GET命令将刷新客户端，显示该用户的可访问资源。
vdcs	VDC[]	0..1	Virtual data center(s) accessible to this user. Only the name and uri fields MUST be populated by the server. 该用户的可以访问的虚拟数据中心。服务器仅仅必须提供名字和URI。

 

2 Virtual Data Center (VDC) [application/vnd.com.sun.cloud.VDC+json] 虚拟数据中心

A VDC represents a user's view of available resources in a single virtual data center. It also provides URIs for acquiring related resource representations, as well as URIs for creating new resources of various types.
一个虚拟数据中心资源表示某用户在一个单个的虚拟数据中心里可用资源的视图。它也提供了取得相关资源表达式的URI，以及生成各种新资源的URI。

A "VDC" resource model contains the following fields:
一个“虚拟数据中心”资源模型含有以下属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
name 名称	String	1	Logical name of this virtual data center. 该虚拟数据中心的逻辑名。
uri	URI	1	A GET against this URI refreshes the client representation of this virtual data center. 一个针对这个URI的GET命令将刷新客户端，显示该虚拟数据中心。
addresses 地址	PublicAddress[]	1	The static public IP addresses which are available for use in this VDC. 该虚拟数据中心可使用的静态公开IP地址。
clusters 集群	Cluster[]	1	The Clusters which currently exist in this VDC. 该虚拟数据中心中当前存在的集群。
tags 标签	[ ]	0..1	Arbitrary values assigned by the user. These values have no semantic impact on the operation of the cloud. 用户指定的任意值。这些值对于操作的云没有语义上的影响。
vnets 虚拟网络	VNet[]	0..1	The collection of virtual private networks associated with this VDC. 该虚拟数据中心相关的虚拟私有网络的集合。
volumes 盘	Volume[]	1	The WebDAV volumes (in the storage service) owned by this user. 该用户所拥有的WebDAV盘(在该存储服务里)。
vm_templates 虚拟机模板	URI	1	A GET request against this URI returns an array of available templates (type=application/vnd.com.sun.cloud.Templates+json). 一个针对这个URI的GET命令将返回一个可用模板的数组。

* WebDAV（Web-based Distributed Authoring and Versioning）

一种基于 HTTP 1.1协议的通信协议.它扩展了HTTP 1.1，在GET、POST、HEAD等几个HTTP标准方法以外添加了一些新的方法，使应用程序可直接对Web Server直接读写，并支持写文件锁定(Locking)及解锁(Unlock)，还可以支持文件的版本控制。

3 Public Address [application/vnd.com.sun.cloud.PublicAddress+json] 公开地址

A public address represents a static, publicly accessible Internet Protocol (IP) address, which can be attached to a particular VM via an interface. The fact that this address is static means it is suitable for registration with the Domain Name Service (DNS) environment for your application domain. Typically, the VM that a public address is attached to will be a firewall appliance, but this is not required by the Cloud API itself.
一个公开地址资源表示一个静态的，公开的可以访问的IP地址，它可以经由一个接口连接到特定的虚拟机。实际上说该地址是静态的是指它在你注册到的应用程序的所在域的DNS环境范围里。通常，一个公开地址连接的虚拟机会附加防火墙，但是这不是云接口本身所需要的。

A public address resource model contains the following fields:
一个公开地址资源模型含有以下属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
name 名字	String	1	Logical name of this Public Address (unique within owning VDC). [POST][PUT] 该公开地址逻辑名(在所属的虚拟数据中心里唯一)。[POST][PUT]
uri	URI	1	URI by which this public address may be addressed as a standalone resource. 该公开地址可以被定位成一个独立资源时的URI。
dns	String[]	1	List of DNS server IP addresses to be used for connecting out through this Internet connection. [POST][PUT] 可以通过DNS服务器的IP地址清单连接到互联网。 [POST][PUT]
domain_names 域名	String[]	0..1	Optional list of domain names associated with this public IP address (informational only). [POST][PUT] 该公开IP地址相关的可选域名清单(仅供参考)。 [POST][PUT]
gateway 网关	String	1	Gateway for this Internet connection. 互联网连接的网关。
ip_address IP地址	String	1	Physical IP address represented by this public address instance. 该公开地址实例所代表的物理IP地址。
netmask 子网掩码	String	1	Netmask for this Internet connection. 互联网连接的子网掩码。
tags 标签	[ ]	0..1	Arbitrary values assigned by the user. These values have no semantic impact on the operation of the cloud. [POST][PUT] 用户指定的任意值。这些值对于操作的云没有语义上的影响。[POST][PUT]
vm 虚拟机	String	0..1	Logical name of the VM to which this address is attached, if any. 该地址附加的虚拟机的逻辑名，如果有的话。

 

4 Cluster [application/vnd.com.sun.cloud.Cluster+json] 集群

A cluster represents a grouping of VM and VNet resources, segregated for purposes of grouping by common functionality, shared access control, or other purposes. At least one cluster must be present in a VDC to contain the set of resources required to run a cloud application, but more than one may be created if desired.
一个集群资源表示一组虚拟机和虚拟网络资源， 按照共通功能目的划分，分享访问控制，或者其他的目的。在一个虚拟数据中心里至少有一个集群，它包含运行云应用程序所需的整套资源，而不仅仅是在需求的时候单独被生成。

A cluster resource model contains the following fields:
一个集群资源模型包括以下的属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
name 名字	String	1	Logical name of this cluster, unique within the owning VDC. [POST][PUT] 该集群逻辑名，在所属的虚拟数据中心里唯一。[POST][PUT]
uri	URI	1	URI by which this cluster may be addressed as a standalone resource. 该集群可以被定位成一个独立资源时的URI。
deploy_status 部署状态	String	0..1	Current deployment status of this VDC (UNDEPLOYED, DEPLOYING, DEPLOYED, CHANGED(1), UNDEPLOYING). 该虚拟数据中心的当前的部署状态(未部署, 部署中, 已部署, 已变更(1), 卸载中)。
from_cluster 参照集群	URI	0..1	On a Create Cluster request type, the URI of an existing cluster to initialize default values from. [POST] 创建集群请求时，提供原始默认值的参照用既存集群的URI。[POST]
tags 标签	[ ]	0..1	Arbitrary values assigned by the user. These values have no semantic impact on the operation of the cloud. [POST][PUT] 用户指定的任意值。这些值对于操作的云没有语义上的影响。[POST][PUT]
vms 虚拟机	VM[]	0..1	The collection of virtual machines associated with this cluster. 该集群相关的虚拟机的集合。
controllers 控制器	{}	0..1	Hash of URIs which may be used to request state changes in the cluster via POST requests (see next table), keyed by the type of state change being requested. URI的散列表被用来在集群里经由POST请求(参照下表)，按照被请求的状态变化类型来请求状态变化。

(1) CHANGED means that the cluster has been deployed, and configuration changes have subsequently been made to the cluster definition that have not themselves been deployed yet.
(1) 已变更是指，该集群已部署，但对该集群定义中进行配置变更的部分还没有部署完毕。

Some of the "control" URIs may or may not be accessible based on the state of the cluster, and may not appear in representations of it when not usable. For convenience, these are grouped into the "controllers" list field, in which zero or more of the following URIs (keyeded by the change type) will be included in a representation provided by the server.
一些"控制"URIs根据集群状态可以或不可以被访问，以及当它不可用时可能不出现在表征里。方便起见，这些都被归纳到"控制器"清单属性里，0个或更多的下列URIs (按变化类型分)将被包含在服务器提供的表征里。

Change Type 变更类型	Operation Requested 请求操作
deploy 部署	Deploy all VMs in this cluster. 部署集群里的所有虚拟机。
start 启动	Start up all the VMs in this deployed cluster. 启动该已部署集群里的所有虚拟机。
stop 停止	Shut down all the VMs in this deployed cluster. 停止该已部署集群里的所有虚拟机。
undeploy 卸载	Undeploy this cluster. 卸载该集群。

 

5 Volume [application/vnd.com.sun.cloud.Volume+json] 盘

A Volume represents a remote WebDAV volume that may be accessed by the same credentials used to access this information. Such volumes are global to the calling user, and are therefore enumerated in the containing VDC.
一个盘资源表示一个远程WebDAV盘，它能够被访问这个信息的相同的证书所访问。这些盘对调用它的用户来说是全局的，因而被枚举在虚拟数据中心里。

A Volume resource model contains the following fields:
一个盘资源模型包括以下的属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
name 名字	String	1	Logical name of this volume (unique within the owning VDC). [POST][PUT] 该盘逻辑名，在所属的虚拟数据中心里唯一。[POST][PUT]
uri	URI	1	GET, PUT, and DELETE operations may be used to retrieve, update, or delete this volume. GET，PUT和DELETE操作可以用来取得，更新或删除该盘。
webdav	URI	1	The URI for use in any WebDAV operations. 在任何WebDAV操作时使用。
created 生成日时	Timestamp	1	Date and time when this volume was created. 该盘生成的日时。
snapshots 快照	Snapshot[]	0..1	Collection of snapshots associated with this volume. 与该盘相关联的快照的集合。
tags 标签	[ ]	0..1	Arbitrary values assigned by the user. These values have no semantic impact on the operation of the cloud. [POST][PUT] 用户指定的任意值。这些值对于操作的云没有语义上的影响。[POST][PUT]

 

6 Snapshot [application/vnd.com.sun.cloud.Snapshot+json] 快照

A Snapshot represents a point-in-time representation of the contents of a Volume.
一个快照资源表示某个时间点的一个盘的内容表达式。

A Snapshot resource model contains the following fields:
一个快照资源模型包括以下的属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
name 名字	String	1	Logical name of this snapshot, unique within the owning Volume. [POST] 该快照逻辑名，在所属的盘里唯一。[POST]
uri	URI	1	GET, PUT, and DELETE operations may be used to retrieve, update, or delete this snapshot. GET，PUT和DELETE操作可以用来取得，更新或删除该快照。
created 生成日时	Timestamp	1	Date and time when this snapshot was created. 该快照生成的日时。
clone 克隆	URI	0..1	A POST to this URI is a request to clone this snapshot into a new volume with a name included in the request body. 对该URI的一个POST请求，请求使用请求正文里的名字克隆快照到一个新的盘里。
rollback 回滚	URI	0..1	A POST to ths URI is a request to revert the owning volume to the contents as of when this snapshot was created. 对该URI的一个POST请求，请求回复该盘到该快照生成时的内容。

 

7 Virtual Machine (VM) [application/vnd.com.sun.cloud.VM+json] 虚拟机

A VM represents a virtual computer that is associated with a cluster.
一个虚拟机资源表示与一个集群相关的虚拟机。

A VM data model contains the following fields:
一个虚拟机资源模型包括以下的属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
name 名字	String	1	Logical name of this VM, unique within the owning Cluster. [POST][PUT] 该虚拟机逻辑名，在所属的集群里唯一。[POST][PUT]
uri	URI	1	GET, PUT, and DELETE may be used to retrieve representations of the VM, to update it, and to delete it, respectively. GET，PUT和DELETE操作可以分别用来取得该虚拟机的表达式，更新它或删除它。
model_status 建模状态	String	0..1	Current modeling status of this virtual machine (read only). FIXME - enumerate valid values beyond "deployed", "error", etc. 该虚拟机当前的建模状态(只读)。 修正 - 枚举“已部署”，“出错”等以外的有效值。
run_status 运行状态	String	0..1	Current running status of this virtual machine (read only). FIXME - enumerate valid values beyond "halted", "running", "paused". 该虚拟机当前的运行状态(只读)。 修正 - 枚举“停止”，“运行”，“暂停”等以外的有效值。
from_template 参照模板	String	0..1	On a Create VM request type, the URI of an existing VM template to initialize default values from. [POST] 在一个生成虚拟机请求类型里，该既存虚拟机模板的URI用来提供初始默认值。[POST]
from_vm 参照虚拟机	String	0..1	On a Create VM request type, the URI of an existing VM to initialize default values from. [POST] 在一个生成虚拟机请求类型里，该既存虚拟机的URI用来提供初始默认值。[POST]
description 描述	String	0..1	Human friendly description of this virtual machine. [POST][PUT] 该虚拟机的人性化描述。[POST][PUT]
hostname 主机名	String	0..1	Fully qualified (?) host name of this virtual machine. 该虚拟机的主机全称。
os	String	0..1	Operating system running on the VM being modelled. FIXME - enumerate the legal values. [POST] 被建模的虚拟机上运行的操作系统。 修正 - 枚举合法值。
cpu	Integer	0..1	CPU speed in Mhz. [POST] CPU速度(Mhz)。[POST]
memory 内存	Integer	0..1	Main memory size in GB. [POST] 主内存大小(GB)。[POST]
boot_disk 启动盘	Integer	0..1	Boot disk space to allocate in GB. [POST] 分配的启动盘空间大小(GB)。[POST]
data_disk 数据盘	Integer	0..1	Data disk space to allocate in GB. [POST] 分配的数据盘空间大小(GB)。[POST]
temp_disk 临时盘	Integer	0..1	Temporary disk space to allocate in GB. [POST] 分配的临时盘空间大小(GB)。[POST]
params 参数	{ }	0..1	Configuration parameters for this VM, keyed by parameter name. The list of system defined configuration parameters is TBD, but one of them will be "user_params", whose value is a hash of arbitrary user defined configuration parameters. [POST][PUT] 按照参数名，为该虚拟机设置参数。系统定义配置参数清单是TBD，但是其中一个将会是"用户参数"，它的值是任意用户定义的配置参数的散列表。[POST][PUT]
tags 标签	[ ]	0..1	Arbitrary values assigned by the user. These values have no semantic impact on the operation of the cloud. [POST][PUT] 由用户指定的任意值。这些值对于操作的云没有语义上的影响。[POST][PUT]
back_up 备份	URI	1	A POST of a Backup representation to this URI requests creation of a new Backup. 对该URI的备份表达式的POST请求，请求生成一个新的备份。
attach 连接	URI	1	A POST of a PublicAddress representation to this URI requests connection to a Public Address. Or, a POST of a VNet representation to this URI requests connection to a VNet. 对该URI的公开地址表达式的POST请求，请求连接一个公开地址。或者，对该URI的虚拟网络表达式的POST请求，请求连接一个虚拟网络。
detach 分离	URI	1	A POST of a PublicAddress representation to this URI requests disconnection from a Public Address. Or, a POST of a VNet representation to this URI reequests disconnection from a VNet. 对该URI的公开地址表达式的POST请求请，求断开一个公开地址连接。或者，对该URI的虚拟网络表达式的POST请求，请求断开一个虚拟网络。
backups 备份	Backup[]	0..1	Backup snapshots from this virtual machine. 备份该虚拟机的快照。
interfaces 接口	Interface[]	1	Network interfaces associated with this virtual machine. These are created automatically when VNets or Public Addresses are associated with VM. 该虚拟机关联的网络接口。由虚拟网络或公开地址与虚拟机关联时自动生成。
controllers 控制器	{}	0..1	Hash of URIs which may be used to request state changes in the VM via POST requests (see next table), keyed by the type of state change being requested. URI的散列表被用来在集群里经由POST请求(参照下表)，按照被请求的状态变化类型请求状态变化。

Some of the "control" URIs, such as those identified in the "attach" and "detach" fields, are in principle always accessible and thus appear as first-class values in the representation of a VM. Others may or may not be accessible based on the state of the VM, and may not appear in representations of it when not accessible. For convenience, these are grouped into the "controllers" list field, in which zero or more of the following URIs (keyed by the change type) will be included in a representation provided by the server.
一些"控制"URIs，例如那些定义"连接"和"分离"的属性，原则上总是可访问的，这些在一个虚拟机表达式里表现为一个first-class值。其他的则根据虚拟机的状态能够或不能够被访问，以及当不能访问时可能不出现的虚拟机表达式里。方便起见，这些都被归纳到"控制器"清单属性里，0个或更多的下列URIs (按变化类型分)将被包含在服务器提供的表达式里。

Change Type 变更类型	Operation Requested 请求操作
deploy 部署	Deploy an undeployed VM. 部署一个未部署的虚拟机。
start 启动	Start up a deployed VM. 启动一个部署的虚拟机。
stop 停止	Shut down a running VM. 关闭一个运行中的虚拟机。
undeploy 卸载	Undeploy a halted VM. 卸载一个停止的虚拟机。
reboot 重启	Reboot a running VM. 重启一个运行中的虚拟机。
hibernate 睡眠	Put a running VM to sleep. 是一个运行中的虚拟机睡眠。
resume 唤醒	Wake up a hibernated VM. 唤醒一个睡眠的虚拟机。

8 Backup [application/vnd.com.sun.cloud.Backup+json] 备份

A backup represents a snapshot that was taken of a specific virtual machine.
一个备份资源表示从指定虚拟机上取得的一个快照。

A backup resource model contains the following fields:
一个备份资源模型包括以下的属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
name 名字	String	1	Logical name of this backup, unique within owning VM. 该备份逻辑名，在所属的虚拟机里唯一。
type 类型	String	1	Type of this backup. 该备份类型。
created 生成日时	DateTime	1	Timestamp when this backup was created. 该备份生成的日时。

9 Virtual Network (VNet) [application/vnd.com.sun.cloud.VNet+json] 虚拟网络

A VNet represents a virtual private network to which an interface associated with a VM may be attached. VNets may connect VMs within a Cluster, or they may connect VMs from different clusters together to provide a private communications path.
一个虚拟网络资源表示一个虚拟的私有网络用来连接想要连接的某个虚拟机相关的接口。虚拟网络可以连接一个集群里的虚拟机，也可以将不同集群的虚拟机组合起来提供一个私有的通讯路径。

A VNet resource model contains the following fields:
一个虚拟网络资源模型包括以下的属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
name 名字	String	1	Logical name of this VNet, unique within the owning Cluster. [POST][PUT] 该虚拟网络逻辑名，在所属的集群里唯一。
uri	URI	1	URI that may be used to access this VNet as a standalone resource. 该虚拟网络可以被定位成一个独立资源时的URI。
netmask 子网掩码	String	1	Default network mask for interfaces connected to this VNet. 接口连接该虚拟网络时的默认的子网掩码。
tags 标签	[ ]	0..1	Arbitrary values assigned by the user. These values have no semantic impact on the operation of the cloud. [POST][PUT] 用户指定的任意值。这些值对于操作的云没有语义上的影响。[POST][PUT]

10 Interface [application/vnd.com.sun.cloud.Interface+json] 接口

An interface represents a network interface card (nic), associated with a specific VM, that documents an IP connection (from this VM) either to a VNet (virtual private network) or to a public address (a static public IP address accessible from the Internet). For the latter scenario, the VM will typically implement firewall and/or load balancing functionality, but this is not required by the API.
一个接口资源表示一个网络接口卡(nic)，关联一个指定的虚拟机，提供一个IP连接(从该虚拟机)到一个虚拟网络(虚拟私有网络)或者到一个公开地址(互联网上一个静态的可访问的公开地址)。对于后者，虚拟机通常会实现防火墙和/或负载平衡机制，但是这对API来说并不是必须的。

Interface instances are created, modified, and removed as a side effect of other operations. Therefore, they do not possess a URI of their own, and support no operations against themselves directly.
接口实例的生成，修改和移除的发生源于其他的一些操作。因此，它们不会有本身的URI，并且不支持对本身的直接操作。

A interface resource model contains the following fields:
一个接口资源模型包括以下的属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
vnet 虚拟网络	URI	0..1	The URI of the VNet instance, if this interface is attached to one. At most one of vnet or public address must be defined. 如果该接口连接到某个虚拟网络的话，该虚拟网络实例的URI。至少一个虚拟网络或公开地址必须被定义。
public_address 公开地址	URI	0..1	The URI of the public address instance, if this interface is attached to one. At most one of vnet or public address must be defined. 如果该接口连接到某个公开地址的话，该公开地址实例的URI。至少一个虚拟网络或公开地址必须被定义。
nic	String	1	Name of the network interface connector as seen by the host operating system. 网络接口连接器看到的主操作系统名称。
mac_address MAC地址	String	1	MAC address of this network interface. 该网络接口的MAC地址。
ip_address IP地址	String	1	IP address of this network interface. If the interface is connected to a Public Address, will be a duplicate of its ip_address field. 该网络接口的IP地址。如果该接口连接到一个公开地址，将是它的IP地址属性的副本。

11 Virtual Machine Template (VMTemplate) 虚拟机模板[application/vnd.com.sun.cloud.VMTemplate+json]

A VMTemplate represents a preconfigured virtual machine image that may be "cloned" in a Create Virtual Machine request, by specifying the URI of a particular template as the value of the from_template field.
一个虚拟机模板资源表示在一个预配置的虚拟机映像，在生成虚拟机的请求时，如果该URI被指定为from_template属性值时将被克隆。

A VMTemplate data model contains the following fields:
一个虚拟机模板资源模型包括以下的属性：

Field Name 属性名	Type 型	Occurs 值	Description 说明
name 名字	String	1	Logical name of this VMTemplate. 该虚拟机模板逻辑名。
uri	URI	1	URI to reference this template in a Create Virtual Machine request. URI用来在一个生成虚拟机的请求里参照该模板。
description	String	0..1	Human friendly description of this virtual machine template. 该虚拟机模板的人性化描述。
os	String	0..1	Operating system running on the VM being modelled. FIXME - enumerate the legal values. 被建模的虚拟机上运行的操作系统。 修正 - 枚举合法值。
cpu	Integer	0..1	CPU speed in Mhz. CPU的速度(Mhz)。
memory	Integer	0..1	Main memory size in GB. 主内存大小(GB)。
boot_disk	Integer	0..1	Boot disk space to allocate in GB. 分配的启动盘空间大小(GB)。
data_disk	Integer	0..1	Data disk space to allocate in GB. 分配的数据盘空间大小(GB)。
temp_disk	Integer	0..1	Temporary disk space to allocate in GB. 分配的临时盘空间大小(GB)。
params	{ }	0..1	Configuration parameters for this VM, keyed by parameter name. The list of system defined configuration parameters is TBD, but one of them will be "user_params", whose value is a hash of arbitrary user defined configuration parameters. 按照参数名，为该虚拟机设置参数。系统定义配置参数清单是TBD，但是其中一个将会是"用户参数"，它的值是任意用户定义的配置参数的散列表。[POST][PUT]
tags	[ ]	0..1	Arbitrary values assigned by the user. These values have no semantic impact on the operation of the cloud. 用户指定的任意值。这些值对于操作的云没有语义上的影响。