2014说明书中文整理.docVIP

vCloud API 说明书： 这个说明书总结的是在版本1.5的vCloud API下，用户可进行的操作。 协议： vCloud API浏览器请求的总结： 浏览器请求提供在只读模式下进入一个云或者浏览器自身包含的对象。 1).API-URL形式像：/api。 2).id是唯一标识。 当你得到表示他们操作的对象时，请求的URLs保证可用。URL表单只供参考用途。 表-2：vCloud API浏览器请求的总结 操作 请求 请求主体 返回 为浏览器的操作检索一个列表的入口点[新] GET API-URL/Session 无 200 ok 检索你可以进入的一个列表的组织 GET API-URL/org/id 无 OrgList(组织列表) 检索一个组织的内容 GET API-URL/org/id 无 Org 检索一个网络的属性 GET API-URL/network /id 无 OrgNetwork 检索一个目录的内容 GET API-URL/catalog/id 无 Catalog 检索一个目录子项的属性 GET API-URL/catalogItem/id 无 CatalogItem 检索一个vDC的内容 GET API-URL/vdc/id 无 Vdc 检索一个媒体图片的属性 GET API-URL/media/id 无 Media 检索一个vAPP的模板 GET API-URL/vAppTemplate/vappTemplate-id 无 VAppTemplate 检索一个vAPP的属性 GET API-URL/vAPP/vapp-id 无 VApp 检索一个虚拟机的属性 GET API-URL/vAPP/vm-id 无 Vm vCloud API Provisioning（预配置）请求总结： 预配置请求可为vDC和目录增加一个云应用的模板或者媒体。你也可以利用预配置请求来复制、移动、重命名、删除这些对象。 1).API-URL形式像：/api。 2).id是唯一标识。 当你得到表示他们操作的对象时，请求的URLs保证可用。URL表单只供参考用途。 表-3：预配置请求的总结 操作 请求 请求主体 返回 上传VOF创建一个云应用模板 POST API-URL/vdc/id/ action/uploadVAppTempla UploadVAppTemplateParams VAppTemplate 下载一个云应用模板作为VOF GET download-URL 无 Depends on file type 确保一个云应用模板可被下载 Post APIURL/vApp Template/vApp Templateid/action/enableDownload 无 task 使一个云应用模板无法被下载 POST APIURL/vAppTemplate/ vAppTemplateid/ action/disableDownload 无 204 No Content 没有内容 上传一个媒体图片 POST APIURL/ vdc/id/media Media Media 复制或者移动一个媒体图片 POST APIURL/vdc/ id/action/cloneMedia CloneMediaParams Media 复制或者移动一个云应用模板 POST APIURL/vdc/id/action/ cloneVAppTemplate CloneVApp TemplateParams VAppTemplate 复制或者移动一个云应用 POST APIURL/vdc/ id/action/cloneVApp CloneVAppParams VApp 改变一个云应用模板的名字或者描述 PUT APIURL/ vAppTemplate/vappT emplate-id VAppTemplate Task 改变一个云应用的名字或者描述 PUT API-URL/vApp/vappid VApp Task 改变一个媒体图片的名字或者描述 PUT API-URL/media/id Media Task 删除一个云应用模板，或者云应用，或者媒体图片 DELETE object-URL 无 Task 为目录增加一个子项 POST APIURL/ catalog/id/catalogItems CatalogItem CatalogItem 移除目录的一个子项 DELETE API-URL/ catalog/id/catalogItem/id 无 204 No content 控制进入目录权限 POST APIURL/catalog/ id/action/co