background image

VMware, Inc.

13

2

This

 

chapter

 

describes

 

how

 

to

 

prepare

 

for

 

using

 

the

 

vCloud

 

SDK

 

for

 

PHP,

 

and

 

how

 

to

 

download

 

the

 

SDK

 

and

 

use

 

it.

This

 

chapter

 

includes

 

the

 

following

 

topics:

“Prerequisites”

 

on

 

page 13

“Download

 

and

 

Install

 

the

 

vCloud

 

SDK

 

for

 

PHP”

 

on

 

page 14

Prerequisites

The

 

vCloud

 

SDK

 

for

 

PHP

 

requires

 

the

 

following

 

software

 

to

 

be

 

installed

 

on

 

the

 

computer

 

where

 

you

 

install

 

the

 

SDK:

PHP

 

5.3.1

 

or

 

later.

The

 

PEAR

 

HTTP_Request2

 

package,

 

version

 

0.5.1,

 

available

 

from

 

(

http://pear.php.net/package/HTTP_Request2/download

.

This

 

document

 

and

 

the

 

SDK

 

reference

 

documentation

 

assume

 

that

 

you

 

are

 

familiar

 

with

 

the

 

PHP

 

programming

 

language

 

and

 

have

 

access

 

to

 

an

 

installation

 

of

 

VMware

 

vCloud

 

Director.

 

In

 

addition,

 

you

 

should

 

consider

 

the

 

following:

Although

 

the

 

vCloud

 

SDK

 

for

 

PHP

 

reference

 

documentation

 

provides

 

information

 

about

 

the

 

vCloud

 

API

 

XML

 

schemas,

 

which

 

define

 

the

 

objects

 

and

 

operations

 

that

 

the

 

SDK

 

supports,

 

familiarity

 

with

 

the

 

details

 

of

 

the

 

underlying

 

objects

 

and

 

operations,

 

as

 

described

 

in

 

the

 

vCloud

 

API

 

Programming

 

Guide

,

 

can

 

help

 

you

 

understand

 

the

 

structure

 

of

 

vCloud

 

API

 

objects,

 

and

 

how

 

the

 

methods

 

in

 

this

 

SDK

 

operate

 

on

 

those

 

objects.

Before

 

you

 

can

 

run

 

the

 

examples,

 

you

 

must

 

use

 

the

 

vCloud

 

Director

 

web

 

console

 

or

 

the

 

vCloud

 

API

 

to

 

create

 

an

 

organization,

 

catalog,

 

and

 

vDC

 

that

 

the

 

examples

 

can

 

use.

 

The

 

organization

 

must

 

have

 

a

 

user

 

account

 

with

 

rights

 

to

 

run

 

the

 

examples.

 

The

 

predefined

 

CatalogAuthor

 

role

 

should

 

provide

 

all

 

the

 

necessary

 

rights.

 

For

 

more

 

information

 

about

 

roles

 

and

 

rights,

 

see

 

the

 

VMware

 

Cloud

 

Director

 

Administrator

ʹ

s

 

Guide.

Several

 

of

 

the

 

example

 

programs

 

require

 

you

 

to

 

have

 

an

 

OVF

 

package

 

available

 

on

 

the

 

client

 

host.

 

This

 

package

 

must

 

be

 

uncompressed,

 

and

 

can

 

specify

 

one

 

or

 

more

 

vmdk

 

files.

 

For

 

more

 

information

 

about

 

OVF,

 

see

 

the

 

vCloud

 

API

 

Programming

 

Guide.

Setting Up for PHP Development

2

Summary of Contents for vCloud SDK 1.0

Page 1: ...SDK 1 0 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 documen...

Page 2: ...ts about this documentation submit your feedback to docfeedback vmware com Copyright 2010 VMware Inc All rights reserved This product is protected by U S and international copyright and intellectual p...

Page 3: ...ct 10 Creating an SDK Object 10 Using a Different HTTP Library 12 Using the HTML Reference Material 12 2 Setting Up for PHP Development 13 Prerequisites 13 Download and Install the vCloud SDK for PHP...

Page 4: ...vCloud SDK for PHP Developer s Guide 4 VMware Inc...

Page 5: ...ud Director This guide assumes you are familiar with the PHP programming language Representational State Transfer REST and RESTful programming conventions the Open Virtualization Format Specification...

Page 6: ...ware com support services VMware Professional Services VMware Education Services courses offer extensive hands on labs case study examples and course materials designed to be used as on the job refere...

Page 7: ...bout running the example applications included in the SDK This chapter includes the following topics vCloud Object Taxonomy on page 7 vCloud SDK for PHP Design on page 9 vCloud Object Taxonomy The vCl...

Page 8: ...s floppy disks and CD ROMs An organization administrator specifies how resources from a provider vDC are distributed to the vDCs in an organization vCloud Catalogs Catalogs contain references to virtu...

Page 9: ...fined in vCloud API vCloud administrative API and vCloud vSphere platform API extensions Classes in this package are generated from the vCloud API XML schema files Each class maps to a complex type de...

Page 10: ...e Creating an SDK Object You can create an SDK object when you need to invoke a lifecycle operation such as create or modify on a vCloud API object Most class constructors for SDK objects require two...

Page 11: ...minOrg getAdminVdcsRefs Catalog Org getCatalogRefs CatalogItem Catalog getCatalogItemRefs CatalogItem AdminCatalog getCatalogItemRefs Extension None See Creating Top Level Objects on page 12 Extension...

Page 12: ...are_VCloud_SDK_Http_Client_Interface interface and then can call the VMware_VCloud_SDK_Service getService method specifying that client service VMware_VCloud_SDK_Service getService myHTTPClient Using...

Page 13: ...ut the vCloud API XML schemas which define the objects and operations that the SDK supports familiarity with the details of the underlying objects and operations as described in the vCloud API Program...

Page 14: ...e with the download or click No to exit without downloading 5 Choose a download option then click the link for the distribution format you want The vCloud SDK for PHP is distributed as a compressed ar...

Page 15: ...help To run the helloVCloud php example use the following command php helloVCloud php s server u user vcloudOrganization p password c config o orgName d vdcName g catalogName i item a vAppName The fol...

Page 16: ...ample creates All options but s u and p must be separated from their arguments by an equals sign For example php helloVCloud php s vcloud example com u user exampleOrg p Pa55w0rd o exampleOrg d exampl...

Page 17: ...mples use for logging in names for objects such as catalogs and vDCs that the examples create and other values that you are required to specify when creating a vCloud API object You must edit this fil...

Page 18: ...sed by all example code updateVmMemory php Edits the memory required by a virtual machine and reduces the existing value by half uploadVAppTemplate php Uploads an OVF package to create a vApp template...

Page 19: ...kage used in examples 13 P packages in this SDK 9 PEAR HTTP_Request2 package 13 PHP versions supported 13 S sample programs privileges required to run 18 runtime environment for 17 sample programs pri...

Page 20: ...vCloud SDK for PHP Developer s Guide 20 VMware Inc...

Reviews: