![Upload Example:
Sending the data
Using simple PUT
PUT https://../adfe4..55cbdef/disk0.vmdk
Content-length: 1950489088
[disk0 data]
Using ranged PUT
PUT https://../adfe4..55cbdef/disk1.vmdk
Content-Range: 105639111-205639110/205639111
Content-length: 100000000
[disk0 data range]](https://image.slidesharecdn.com/de-03-introduction-to-vcloud-api-v1-100412062920-phpapp01/85/De-03-Introduction-To-V-Cloud-Api-V1-31-320.jpg)
![Download Example:
Getting the data
Getting the OVF descriptor
GET https://vcloud.example.com/ad3...782a/example.ovf
Response
<Envelope ...>
<ovf:References>
<ovf:File ovf:href="disks/example.vmdk"
ovf:id="file1" ovf:size="1950489088"/>
</ovf:References>
...
</Envelope>
Getting the <References> files
GET https://vcloud.example.com/ad3...782a/disk/example.vmdk
Response
[example.vmdk data]](https://image.slidesharecdn.com/de-03-introduction-to-vcloud-api-v1-100412062920-phpapp01/85/De-03-Introduction-To-V-Cloud-Api-V1-33-320.jpg)
De 03 Introduction To V Cloud Api V1
- 1. DE-03 Introduction to vCloud API Tichomir Tenev
- 2. Disclaimer This session may contain product features that are currently under development. This session/overview of the new technology represents no commitment from VMware to deliver these features in any generally available product. Features are subject to change, and must not be included in contracts, purchase orders, or sales agreements of any kind. Technical feasibility and market demand will affect final delivery. Pricing and packaging for any new technologies or features discussed or presented have not been determined.
- 3. About the Speaker Tichomir Tenev, Sr. Staff Engineer, vCloud Currently at VMware’s Cloud Service Mgmt & Automation Group With VMware since 2001 Worked on Workstation and vCenter Helped design the vSphere API and several internal APIs and frameworks. Prior to VMware, designed and implemented an energy trading system for a startup. Education M.Eng. in Electrical Engineering & Computer Science from MIT BS in Computer Science and Mathematics from MIT
- 5. vCloud API Salient Points Standardizable Pure-virtual Platform independent Resource semantics described Can be used from virtually any independent of physical platform semantics Can be implemented on a Physical infrastructure is hidden variety of platforms Virtualization features are Straightforward to use and obscured implement Simpler semantics focused on Powerful and extensible end-use and not on virtualizing Standards-based
- 6. vCloud API Features Interface for: Providing and consuming resources in the Cloud Deploying and managing virtualized workloads in the Cloud Migrating virtualized workloads between Clouds. REST-based Multi-tenant Self-service Service provider automation
- 7. vCloud API and vSphere API vSphere API – vCloud API – “Under the Hood” API “Driver Seat” API Used to create virtual resources Uses virtual resources Virtualization API Pure-virtual API Exposes physical<->virtual mapping Hides underlying physical resources Targeted at sys-admins Targeted at cloud tenants Product specific Product agnostic Exposes vSphere’s capabilities Standardizable Tied to a specific implementation Variety of implementations Rich and powerful Simple yet powerful VMware’s Cloud OS Platform API Implementable on the vSphere API Does not replace the vSphere API
- 8. vCloud Ecosystem Content Providers Developers, IT Admins, ISVs, Enthusiasts Content Virtualized Software Solutions (vApps) Existing legacy solutions, or new apps written for the Cloud Content Respositories Web Servers, Object Stores, Virtual Appliance Marketplace Cloud Service Providers Enterprises
- 9. vApp – Next generation VM concept An uplifting of a virtualized workload Instructions 1. Name=eCommerce VM = Virtualized Hardware Box 2. Only port 80 is used vApp = Virtualized Software 3. 100 ms web response Solution 4. VRM: Encrypt w/ SHA-1 5. DR RPO: 1 hour Encapsulation, isolation and 6. Decommission in 1 month mobility higher up the stack My eCommerce Solution Properties: Fire Wall Tomcat IIS Load Balance Oracle Comprised of one or more VMs Encapsulates requirements on the deployment environment Distributed as an OVF package
- 10. vDC – vApp Deployment Environment vDC Type of Commodity Compute, Storage and vApp vApp Network SLAs Quantity MB of RAM, MHz of CPU, GB foo of Storage VDCNet (fenced) Scope for Over-provisioning bar (isolated) Other features Trust Network L2 Networks DMZ Network Persistent vApps
- 11. Deep Dive
- 12. Simple Example: Power On Request POST https://vcloud.example.com/vapp/413/power/action/powerO n
- 13. Simple Example: Power On Request POST https://vcloud.example.com/vapp/413/power/action/powerO n
- 14. Simple Example: Power On Response 202 Accepted <?xml version="1.0" encoding="UTF-8"?> <Task href="https://vcloud.example.com/task/389" type="application/vnd.vmware.vcloud.task+xml" startTime="2009-7-31T09:30:47Z" status="running" ...> <Link rel="task:cancel” href="htt.../task/389/action/cancel"/> <Owner href="https://vcloud.example.com/vapp/413" type="application/vnd.vmware.vcloud.vapp+xml“ name="My vApp"/> </Task>
- 15. Simple Example: Look at a vApp Request GET https://vcloud.example.com/vapp/413 Content-type: vnd.vmware.cloud.vapp+xml
- 16. Simple Example: Look at a vApp Request GET https://vcloud.example.com/vapp/413 Content-type: vnd.vmware.cloud.vapp+xml
- 17. Simple Example: Look at a vApp Response <VApp name="My vApp" status="1" href="https://vcloud.example.com/vapp/413" ...> <Link rel="up" href= "https://vcloud.example.com/vdc/128"/> <NetworkSection>...</NetworkSection> <ovf:OperatingSystemSection ...> <Link rel="edit" href="http..." ... /> <Description>Microsoft Windows Server 2003</Description> </ovf:OperatingSystemSection> <ovf:VirtualHardwareSection ovf:transport="iso"> <Link rel="edit" href="http..." ... /> <Item>…</Item> … </ovf:VirtualHardwareSection> </VApp>
- 18. Entity Model UML Notation: “whole-part” relationship “part” is exclusively owned by “whole” UML Notation: One-way association UML Notation: “group-member” relationship “member” maybe shared between “groups”
- 19. Entity Model
- 20. Entity Model UML Notation: “general-specific” relationship
- 21. Entity Model
- 22. Example Workflow: Instantiating a vApp Template
- 23. Finding a vApp Template Request GET https://vcloud.example.com/vdc/128
- 24. Finding a vApp Template Response <Vdc href="https://vcloud.example.com/vdc/128" name="Main Vdc" ...> <ResourceEntities> <ResourceEntity href="https://vcloud.example.com/vAppTemplate/111" type="application/vnd.vmware.vcloud.vAppTemplate+xml" name="Ubuntu Template with vsftpd"/> <ResourceEntity href="https://vcloud.example.com/media/112" type="application/vnd.vmware.vcloud.media+xml" name="Ubuntu Boot Floppy"/> <ResourceEntity href="https://vcloud.example.com/media/113" type="application/vnd.vmware.vcloud.media+xml" name="Ubuntu ISO Image"/> </ResourceEntities> ... </Vdc>
- 25. Get Information about a vApp Template Request GET https://vcloud.example.com/vAppTemplate/111 Response <VAppTemplate href="https://vcloud.example.com/vAppTemplate/111" name="Ubuntu Template with vsftpd" status="1" ...> <Description>Description of Ubuntu Template with vsftpd</Description> </VAppTemplate>
- 26. Instantiating a vApp Template Request POST https://vcloud.example.com/vdc/128/action/instantiateVAppTemplate <InstantiateVAppTemplateParams name="Linux FTP server" ...> <VAppTemplate href="https://.../vAppTemplate/111" /> <InstantiationParams ...> <NetworkConfigSection> <NetworkConfig name="My vApp Net"> <Features> <vmw:FenceMode>allowInOut</vmw:FenceMode> <vmw:Dhcp>true<vmw:Dhcp> </Features> <NetworkAssociation href="https://.../network/14"> </NetworkConfig> </NetworkConfigSection> </InstantiationParams> </InstantiateVAppTemplateParams>
- 27. Instantiating a vApp Template Response <VApp name="Linux FTP server" status="0" ...> <Link rel="up" href="https://vcloud.example.com/vdc/128" type="application/vnd.vmware.vcloud.vdc+xml" /> ... </VApp>
- 28. Example Workflow: Upload/Download of a vApp Template
- 29. Upload Example: Initiating the upload Request POST https://vcloud.example.com/vdc/128/action/uploadVAppTemplate <UploadVAppTemplateParams name="Example Image" ...> <Description>Example VApp Template</Description> <ovf:Envelope> <ovf:References> <ovf:File ovf:href="disk0.vmdk" ovf:id="file1" ovf:size="1950489088"/> ... </ovf:References> ... </ovf:Envelope> </UploadVAppTemplateParams>
- 30. Upload Example: Initiating the upload Response <VAppTemplate name="Example Image" status="0" href="https://vcloud.example.com/vAppTemplate/268"...> ... <Files> <File name="example.mf" bytesTransferred="0" ...> <Link rel="upload:default" href="https://../adfe4..55cbdef/example.mf"/> </File> <File name="example-disk0.vmdk" size="1950489088" bytesTransferred="0"> <Link rel="upload:default" href="https://../adfe4..55cbdef/disk0.vmdk"/> </File> ... </Files> </VAppTemplate>
- 31. Upload Example: Sending the data Using simple PUT PUT https://../adfe4..55cbdef/disk0.vmdk Content-length: 1950489088 [disk0 data] Using ranged PUT PUT https://../adfe4..55cbdef/disk1.vmdk Content-Range: 105639111-205639110/205639111 Content-length: 100000000 [disk0 data range]
- 32. Download Example: Finding the download URL Request GET https://vcloud.example.com/vAppTemplate/222 Response <VAppTemplate name="Ubuntu Image with vsftpd" href="https://vcloud.example.com/vAppTemplate/112" status="1"...> ... <Link rel="data" href="https://vcloud.example.com/ad3...782a/example.ovf" type="application/ovf+xml" /> <Link rel="data" href="https://vcloud.example.com/ad3...782a/example.ova" type="application/ova+xml" /> </VAppTemplate>
- 33. Download Example: Getting the data Getting the OVF descriptor GET https://vcloud.example.com/ad3...782a/example.ovf Response <Envelope ...> <ovf:References> <ovf:File ovf:href="disks/example.vmdk" ovf:id="file1" ovf:size="1950489088"/> </ovf:References> ... </Envelope> Getting the <References> files GET https://vcloud.example.com/ad3...782a/disk/example.vmdk Response [example.vmdk data]
- 34. Complete list of operations vApp Operations Upload/Download/Provisioning Operations POST <vapp‐uri>/action/{deploy, undeploy} POST <vdc‐uri>/action/composeVApp POST <vapp‐uri>/power/action/{powerOn, powerOff} POST <vdc‐uri>/action/instantiateVAppTemplate POST <vapp‐uri>/power/action/{reset, suspend} POST <vdc‐uri>/action/instantiateOvf POST <vapp‐uri>/power/action/{shutdown, reboot} POST <vdc‐uri>/action/annotate GET <vapp‐uri>/screen POST <vdc‐uri>/action/uploadVAppTemplate POST <vapp‐uri>/screen/action/acquireTicket POST <vdc‐uri>/media PUT <upload‐uri> vApp Configuration Operations GET <download‐uri> POST <vapp‐parent‐element‐uri> DELETE <resourceEntity‐uri> DELETE <vapp‐element‐uri> PUT <vapp‐element‐uri> Task Management GET <tasks‐list‐uri> Inventory Listing GET <task‐uri> GET <vapp‐uri> POST <task‐uri>/action/cancel GET <vdc‐uri> GET <vAppTemplate‐uri> Service Provider Automation GET <media‐uri> Create/Delete/Update Org GET <network‐uri> Create/Delete/Update vDC for an Org Create/Delete/Update an Org Network Catalog Management Create/Delete/Update Org Catalogs GET <catalog‐uri> Create/Delete/Update Users, Groups, Roles POST <catalog‐uri>/catalogItems
- 35. Q&A