vCloud API Programming Guide vCloud Director 1.5

vCloud API Programming Guide vCloud Director 1.5 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs. EN-000579-00 vCloud API Programming Guide You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com Copyright © 2009–2011 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. Contents vCloud API Programming Guide 7 1 About the VMware vCloud API 9 Object Taxonomy 10 Objects, References, and Representations 11 Links and Link Relations 12 Client Workflow Overview 15 Using the vCloud API with vCloud Director 18 About the vCloud API Examples 22 2 Hello vCloud: A Simplified RESTful Workflow 23 Logging In 24 Find a Catalog and a vDC 26 Retrieve the Contents of a Catalog 27 Retrieve a Catalog Item 28 Retrieve Deployment Information From the vDC 30 Deploy the vApp 31 Get Information About a vApp 34 Displaying the Virtual Machine Console 37 Delete the vApp 38 Log Out 39 3 Exploring a Cloud 41 Summary of vCloud API Browsing Requests 41 Retrieve the Login URL and List of Supported API Versions 42 Create a Login Session 44 Retrieve a List of Organizations Accessible to You 46 Retrieve an Administrative View of a Cloud 47 Retrieve a List of vSphere Platform Operations and Objects for a Cloud 49 4 Provisioning an Organization with vApps, Templates, and Media 53 Summary of vCloud API Provisioning Requests 54 Upload an OVF Package to Create a vApp Template 55 Download a vApp Template as OVF 64 Upload a Media Image 67 Copying and Moving with the vCloud API 69 Capturing and Importing vApps 70 Cataloging vApp Templates and Media Images 70 View or Change the Owner of an Object 73 VMware, Inc. 3 vCloud API Programming Guide 5 Deploying and Operating vApps 75 Summary of vCloud API vApp and Virtual Machine Operations Requests 77 Create a vApp From a Template 78 Compose a vApp From Existing Virtual Machines 80 Recompose a vApp to Add or Remove Virtual Machines 83 Operate a vApp 85 Configuring vApps and Virtual Machines 86 6 Creating, Provisioning, and Managing Organizations 109 Summary of Administrative Requests 109 Administrator Credentials and Privileges 111 Organization Administration 112 Network Administration 118 vDC Administration 139 Catalog Administration 145 User and Group Administration 148 Working With Roles and Rights 153 Controlling Access to vApps and Catalogs 157 7 Using vCloud API Extensions to Provision and Manage a Cloud 161 Summary of vSphere Platform Extension Requests 161 Retrieve or Update System Settings 165 Attach a vCenter Server 166 Finding Available vCenter Resources 167 Create a Provider vDC 173 Create an External Network 180 Create a Network Pool 183 Import a Virtual Machine from vCenter 189 Relocate a Virtual Machine to a Different Datastore 192 8 Working With Object Metadata 195 Retrieve or Update a Metadata Element 196 Retrieve or Update a Metadata Value 199 9 Using the Query Service 201 Typed Queries 201 Packaged Queries 207 Query Parameters 211 10 Configuring and Using Blocking Tasks and Notifications 215 Configure Notifications and AMQP Settings 216 Retrieve or Update Blocking Task Settings 225 Monitor Blocking Tasks 228 Take Action on a Blocking Task 229 Extend The Timeout Expiration of an Active Task 232 11 XML Representations in the vCloud API 233 XML Namespace Identifiers 234 4 VMware, Inc. Contents Common vCloud API Attributes 235 Retrieve an Object as an Entity 237 Index 239 VMware, Inc. 5 ... - tailieumienphi.vn