vCloud API Programming Guide
114
VMware, Inc.
Response:
201 Created
Content-Type: application/vnd.vmware.admin.user+xml
...
<Group name="Engineering" type="application/vnd.vmware.admin.group+xml"
href="http://vcloud.example.com/api/v1.0/admin/group/44" ...>
<Link rel="edit" type="application/vnd.vmware.admin.group+xml"
href="http://vcloud.example.com/api/v1.0/admin/group/44"/>
<Link rel="remove" href="http://vcloud.example.com/api/v1.0/admin/group/44"/>
<Description>Research and development</Description>
...
<UsersList/>
<Role type="application/vnd.vmware.admin.role+xml" name="vApp Wrangler"
href="http://vcloud.example.com/api/v1.0/admin/role/102"/>
</Group>
View Group Metadata
Each
group
in
an
organization
can
be
referenced
by
the
URL
contained
in
one
of
its
GroupReference
elements.
These
elements
are
contained
by
the
Groups
element
of
an
AdminOrg
body.
A
group’s
URL
also
appears
in
the
response
to
the
request
that
imports
the
group.
An
administrator
can
GET
a
group
URL
to
view
the
Group
body.
Modify Group Metadata
An
administrator
can
modify
a
Group
body
to
change
its
Description
or
Role
by
PUTting
a
modified
Group
body
to
the
edit
URL
for
the
group.
See
Example 6
‐
27
for
an
example
of
the
workflow
for
this
type
of
request.
Remove a Group
An
administrator
can
use
the
remove
link
in
a
Group
body
to
remove
a
group
from
a
vCloud.
Example 6
‐
30
removes
the
group
imported
in
Example 6
‐
29
.
Example 6-30.
Remove a Group
Request:
DELETE http://vcloud.example.com/api/v1.0/admin/group/44
Response:
204 No Content
Role Administration
A
role
associates
the
name
of
a
user
or
group
with
a
set
of
rights.
Role
names
must
be
unique
in
a
vCloud
instance.
Create a Role
A
system
administrator
can
create
a
role
by
aggregating
a
set
of
rights
in
a
Role
body,
and
then
POSTing
the
body
to
the
add
URL
for
roles.
Example 6
‐
31
creates
a
new
role
named
vAppWrangler
and
adds
it
to
the
vCloud
shown
in
Example 6
‐
2
.
The
response,
like
other
responses
to
requests
that
create
an
object,
includes
the
POSTed
content,
a
link
to
the
new
object,
and
links
of
type
edit
and
remove
that
an
administrator
can
use
to
manage
this
role.
Summary of Contents for VCLOUD API 1.0 - TECHNICAL NOTE
Page 10: ...vCloud API Programming Guide 10 VMware Inc...
Page 20: ...vCloud API Programming Guide 20 VMware Inc...
Page 32: ...vCloud API Programming Guide 32 VMware Inc...
Page 90: ...vCloud API Programming Guide 90 VMware Inc...
Page 150: ...vCloud API Programming Guide 150 VMware Inc...
Page 170: ...vCloud API Programming Guide 170 VMware Inc...
