VMware, Inc.
89
Chapter 5 Datacenter Operations
Control Access to vApps
Access
control
links
for
vApps
are
included
in
the
vApp
body.
Example 5
‐
36
,
an
excerpt
from
Example 2
‐
8
on
page 27
,
shows
these
links.
Example 5-36.
Access Control Links for a vApp
<vApp ... >
...
<Link rel="down" href="http://vcloud.example.com/api/v1.0/vApp/vapp-7/controlAccess/"/>
<Link rel="controlAccess"
href="http://vcloud.example.com/api/v1.0/vApp/vapp-7/action/controlAccess/"/>
...
</vApp>
An
organization
administrator
can
use
these
links
in
the
same
kinds
of
requests
shown
in
“Control
Access
to
Catalogs”
on
page 56.
Retrieve a Task
Whenever
the
result
of
a
request
cannot
be
returned
immediately,
the
server
creates
a
Task
object
and
includes
it
in
the
response,
as
a
member
of
the
Tasks
container
in
the
response
body.
Each
Task
has
an
href
value,
which
is
a
URL
that
the
client
can
use
to
retrieve
the
Task
element
alone,
without
the
rest
of
the
response
in
which
it
was
contained.
All
information
about
the
task
is
included
in
the
Task
element
when
it
is
returned
in
the
response’s
Tasks
container,
so
a
client
does
not
need
to
make
an
additional
request
to
the
Task
URL
unless
it
wants
to
follow
the
progress
of
a
task
that
was
incomplete.
Example 5
‐
37
retrieves
that
task
that
was
returned
in
the
response
in
Example 2
‐
6
on
page 25
.
Example 5-37.
Retrieve a Task
Request:
GET http://vcloud.example.com/api/v1.0/task/1awvdrn82atz7yzsdey
Response:
200 OK
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task status="running" startTime="2010-06-25T08:00:55.402-07:00" operation="Creating Virtual
Application Linux FTP server(7)" expiryTime="2010-09-23T08:00:55.402-07:00"
type="application/vnd.vmware.vcloud.task+xml"
href="http://vcloud.example.com/api/v1.0/task/1awvdrn82atz7yzsdey">
<Owner type="application/vnd.vmware.vcloud.vApp+xml" name="LinuxFtpServer"
href="http://vcloud.example.com/vApp/vapp-7"/>
</Task>
Tasks
expire
after
a
configurable
interval.
The
default
interval
is
24
hours.
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...
