VMware VCLOUD SDK 1.0 - FOR PHP DEVELOPERS GUIDE Guia do Utilizador

vCloud SDK for PHP Developer's GuidevCloud Director 5.1This document supports the version of each product listed andsupports all subsequent versi

Objects, References, and RepresentationsThe vCloud API represents objects as XML documents in which object properties are encoded as elements andattri

Attribute values in a Link element supply the following information:relDefines the relationship of the link to the object that contains it. A relation

Table 1-1. Link Relationships and HTTP Request Types (Continued)rel Attribute Value Action or Relationship Description Implied HTTP Verbdown:aclRules

Table 1-1. Link Relationships and HTTP Request Types (Continued)rel Attribute Value Action or Relationship Description Implied HTTP VerbinstallVmware

Table 1-1. Link Relationships and HTTP Request Types (Continued)rel Attribute Value Action or Relationship Description Implied HTTP Verbrights:cleanu

If a URL of such an object is known to a client, the client can use an HTTP GET request to retrieve therepresentation of the object. In the vCloud API

vCloud API REST RequestsTo retrieve object representations, clients make HTTP requests to object references. The server supplies thesereferences as hr

Table 1-3. HTTP Status Codes that the vCloud API Returns (Continued)Status Code Status Description400 Bad Request The request body is malformed, inco

vCloud SDK for PHP Developer's Guide18 VMware, Inc.

Setting Up for PHP Development 2To use the vCloud SDK for PHP, you need PHP 5.3.2 or later and the PEAR HTTP_Request2 package or asimilar HTTP client

vCloud SDK for PHP Developer's Guide2 VMware, Inc.You can find the most up-to-date technical documentation on the VMware Web site at:http://www

5 On the Download page, choose a download option and click the file format to download.Option DescriptionvcloudPHP_5.1.0.build.tar.gzA compressed arch

Working with the vCloud SDK for PHP 3The vCloud SDK for PHP provides a PHP class library and a set of example applications. The classes andfunctions i

Table 3-2. VMware_VCloud_SDK PackagesPackage Name Package ContentsVMware_VCloud_SDK Classes that implement operationsdefined in the vCloud user API a

Table 3-3. Summary of SDK Objects, Containers, and Methods (Continued)SDK Object Container MethodExtension None See “Create a Root Object,” onpage 25

Table 3-3. Summary of SDK Objects, Containers, and Methods (Continued)SDK Object Container MethodExtension_ResourceClass Extension_Service getResourc

Create a Data ObjectTo create a data object, you can either invoke an empty constructor and then call the setters for the object orinvoke the construc

2 Call the VMware_VCloud_SDK_Service::getService() method that specifies the client that you created.For example,$service = VMware_VCloud_SDK_Service:

About the Example Programs 4The vCloud SDK for PHP includes example programs that demonstrate how to use the SDK to develop clientapplications. The ex

Table 4-1. Summary of Example Programs and Required Permissions (Continued)Example Name Description Required Permissionscreateprovidervdc.phpCreates

2 Run php hellovcloud.php, as show in “Example: Running HellovCloud,” on page 29.Example: Running HellovCloudYou must supply runtime options on the co

ContentsvCloud SDK for PHP Developer's Guide 5 1About the VMware vCloud API 7Object Taxonomy 8Objects, References, and Representations 10Links an

Logging In and Getting an Organization ListMost vCloud API requests must be authenticated by a login request that supplies user credentials in the for

Procedure1 (Optional) Edit the config.php file to provide common parameter values.When you run any example program, you can override its use of these

vCloud SDK for PHP Developer's Guide32 VMware, Inc.

IndexCcontainers, SDK 22Ddata object, to create 25EEntity, object representation in 10example programsHello vCloud 28to run 30using 27HHellovClo

vCloud SDK for PHP Developer's Guide34 VMware, Inc.

vCloud SDK for PHP Developer's Guide4 VMware, Inc.

vCloud SDK for PHP Developer's GuideThe vCloud SDK for PHP Developer's Guide provides information about the PHP SDK for version 5.1 of thevC

vCloud SDK for PHP Developer's Guide6 VMware, Inc.

About the VMware vCloud API 1The VMware vCloud API provides support for developers who are building interactive clients ofVMware vCloud Director using

Object TaxonomyThe vCloud API defines a set of objects common to cloud computing environments. An understanding of theseobjects, their properties, and

Organization vDCsAn organization virtual datacenter (organization vDC) is a deploymentenvironment for virtual systems owned by the containing organiza