5.5

An XML Notification contains an entityResolver URL and EntityLink elements that provide more
information about the entity, org, and user components of the routing key. Attributes of those elements
show the name, type, and id of each component. After you authenticate to the cloud as a system
administrator, you can retrieve any of the entities represented in an EntityLink by making a GET request to
a URL you create by appending the value of an id attribute to the entityResolver URL. See “Retrieve an
Object as an Entity,” on page 362.
Here is the same message delivered as a JSON object.
{
"eventId" : "a1440dd8-60ae-46c7-b216-44693bc00c90",
"type" : "com/vmware/vcloud/event/blockingtask/create",
"timestamp" : "2011-06-18T14:33:27.787+03:00",
"operationSuccess" : true,
"user" : "urn:vcloud:user:44",
"org" : "urn:vcloud:org:70",
"entity" : "urn:vcloud:blockingTask:25"
"task" : "urn:vcloud:task:34",
"taskOwner" : "urn:vcloud:vapp:26"
}
This request retrieves the blocking task that generated this notification.
GET https://vcloud.example.com/api/entity/urn:vcloud:blockingtask:25
The response to this request is identical to the one shown in the response portion of “Example: Handling a
Blocking Task,” on page 326.
Notification Types
The value of the type attribute of a vCloud Director notification is a string of the form
com/vmware/vcloud/event/object-type/event-type. Notification types can be grouped based on the object
type affected by the event.
User, Group, Role, and Session Events
Table 10‑2. User, Group, Role, and Session Events
Type (com/vmware/vcloud/event/) Description
session/login A login session was created.
user/import A user was imported from LDAP.
user/remove An imported user was removed from the organization.
user/modify One or more properties of a user were modified.
user/lockout An account was locked based on the organization's
password policy settings.
user/unlock A locked account was unlocked.
user/lock_expired The lock on an account has expired.
user/create A local user was created in an organization.
user/delete A local user was removed from the organization.
group/import A group was imported from LDAP.
group/remove A group was removed from an organization.
role/create A new role was created.
vCloud API Programming Guide
314 VMware, Inc.