background image

vCloud SDK for Java Developer’s Guide

8

VMware, Inc.

Figure 1-1.  

vCloud Object Taxonomy

vCloud Organizations

A

 

vCloud

 

contains

 

one

 

or

 

more

 

organizations.

 

A

 

vCloud

 

organization

 

is

 

a

 

unit

 

of

 

administration

 

for

 

a

 

collection

 

of

 

users,

 

groups,

 

and

 

computing

 

resources.

 

Users

 

authenticate

 

at

 

the

 

organization

 

level,

 

supplying

 

credentials

 

established

 

by

 

an

 

organization

 

administrator

 

when

 

the

 

user

 

was

 

created

 

or

 

imported.

vCloud Users and Groups

An

 

organization

 

can

 

contain

 

an

 

arbitrary

 

number

 

of

 

users

 

and

 

groups.

 

Users

 

can

 

be

 

created

 

by

 

the

 

organization

 

administrator

 

or

 

imported

 

from

 

a

 

directory

 

service

 

such

 

as

 

LDAP.

 

Groups

 

must

 

be

 

imported

 

from

 

the

 

directory

 

service.

 

Permissions

 

within

 

an

 

organization

 

are

 

controlled

 

through

 

the

 

assignment

 

of

 

rights

 

and

 

roles

 

to

 

users

 

and

 

groups.

vCloud Networks

An

 

organization

 

can

 

be

 

provisioned

 

with

 

one

 

or

 

more

 

networks.

 

These

 

organization

 

networks

 

can

 

be

 

configured

 

to

 

provide

 

services

 

such

 

as

 

DHCP,

 

NAT,

 

and

 

firewalls.

vCloud Virtual Datacenters

A

 

vCloud

 

virtual

 

datacenter

 

(vDC)

 

is

 

an

 

allocation

 

mechanism

 

for

 

resources

 

such

 

as

 

networks,

 

storage,

 

CPU,

 

and

 

memory.

 

In

 

a

 

vDC,

 

computing

 

resources

 

are

 

fully

 

virtualized,

 

and

 

can

 

be

 

allocated

 

based

 

on

 

demand,

 

service

 

level

 

requirements,

 

or

 

a

 

combination

 

of

 

the

 

two.

There

 

are

 

two

 

kinds

 

of

 

vDCs:

Provider

 

vDCs

.

 

These

 

vDCs

 

contain

 

all

 

the

 

resources

 

available

 

from

 

the

 

vCloud

 

service

 

provider.

 

Provider

 

vDCs

 

are

 

created

 

and

 

managed

 

by

 

vCloud

 

system

 

administrators.

 

Organization

 

vDCs

.

 

These

 

vDCs

 

provide

 

an

 

environment

 

where

 

virtual

 

systems

 

can

 

be

 

stored,

 

deployed,

 

and

 

operated.

 

They

 

also

 

provide

 

storage

 

for

 

virtual

 

media,

 

such

 

as

 

floppy

 

disks

 

and

 

CD

 

ROMs.

An

 

organization

 

administrator

 

specifies

 

how

 

resources

 

from

 

a

 

provider

 

vDC

 

are

 

distributed

 

to

 

the

 

vDCs

 

in

 

an

 

organization.

Catalog 2

Catalogitem

em
em
em

Catalog 1

Catalog 3

vDC2

Catalogitem
Catalogitem
Catalogitem
Catalogitem

users

Media

vApp

template

Media

vApp

TasksList

Organization

vDC1

Media

vApp

template

Media

vApp

Network

Network

Catalogitem

em
em
em

groups

Summary of Contents for VCLOUD SDK FOR JAVA 1.0 - DEVELOPER S GUIDE

Page 1: ...Java 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 docume...

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: ...Development 11 Prerequisites 11 Download the vCloud SDK for Java Package 11 Import the SDK Into Your Java IDE 12 About SSL Access 12 3 Hello vCloud A Structured Java Workflow Example 13 Running the H...

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

Page 5: ...d API applications including interactive clients of VMware Cloud Director This guide assumes you are familiar with the Java programming language Representational State Transfer REST and RESTful progra...

Page 6: ...mware 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 refer...

Page 7: ...7 vCloud Object Taxonomy on page 7 vCloud SDK for Java Design The vCloud SDK for Java provides object specific methods for creating updating retrieving and deleting objects defined by the vCloud API...

Page 8: ...igured to provide services such as DHCP NAT and firewalls vCloud Virtual Datacenters A vCloud virtual datacenter vDC is an allocation mechanism for resources such as networks storage CPU and memory In...

Page 9: ...SO or floppy Virtual systems are stored as templates using an open standard format OVF 1 0 These templates can be retrieved from catalogs and transformed into virtual systems called vApps through a pr...

Page 10: ...vCloud SDK for Java Developer s Guide 10 VMware Inc...

Page 11: ...ccount with rights to run the samples The predefined role CatalogAuthor should provide all the necessary rights For more information about roles and rights see the VMware Cloud Director Administrator...

Page 12: ...mples 1 0 sources jar 3 Import the contents of the vcloud java sdk all folder into your Java IDE About SSL Access In the default configuration VMware Cloud Director requires vCloud API clients to use...

Page 13: ...to the vCloud Uploading an OVF package to create a vApp template Adding the vApp template to a catalog Instantiating the vApp template to create a vApp Operating the vApp The file HellovCloud txt in t...

Page 14: ...te to the cloud The vCloud API returns a list of the organizations to which the user has access and the login method in HellovCloud java prints this list In the typical case this list has a single mem...

Page 15: ...equests for it and examines the response for additional upload URLs When the response contains any upload URLs beyond the one returned in Step 2 template is complete 5 The client uses HTTP PUT request...

Page 16: ...AppTemplate URL of the vDC and returns a Vapp helper object that contains among other things a reference to the vApp Example 3 4 Instantiating the vApp Template public static Vapp newvAppFromTemplate...

Page 17: ...tVappTemplParamsType setSource vAppTemplateReference instVappTemplParamsType setInstantiationParams instantiationParamsType make the request and get an href to the vApp in return Vapp vapp vdc instant...

Page 18: ...vCloud SDK for Java Developer s Guide 18 VMware Inc...

Page 19: ...oud sdk Defines the classes that implement the user API Objects accessed by these classes are typically readable by all users and can be modified by users with appropriate rights com vmware vcloud sdk...

Page 20: ...anization Table 4 3 Administrative API Samples Sample Name Description CatalogCRUD java Create retrieve update or delete a catalog OrganizationCRUD java Create retrieve update or delete an organizatio...

Page 21: ...oad 13 OVF package to upload 15 P packages overview of 19 S samples HellovCloud sample 13 overview of 19 rights required to run 11 txt file output 11 T Tasks about 9 technical support resources 5 U us...

Page 22: ...vCloud SDK for Java Developer s Guide 22 VMware Inc...

Reviews: