5.5

Example: Example Message File Content
The following lines are appropriate in the en_US message file for a service that meets the following
conditions:
n
Its Namespace is registered as org.example.vcd.backup.
n
It defined a Task whose operationName attribute can have a value of backupInProgress.
n
It defined an Event whose type attribute can have a value of backupComplete.
org.example.vcd.backup=vCloud Backup Service
backupInProgress=Backup in progress for ${resourceName} ({resourceType}) with id: {resourceId}
backupInProgress_PROGRESS=Backup in progress for ${resourceName} ({resourceType}) with id:
{resourceId}
backupComplete=Backup complete for entity {resourceName} ({resourceType}) with id: {resourceId}
FAILED.backupComplete=Backup failed for entity {resourceName} ({resourceType}) with id:
{resourceId}
If the localization bundle for this service contained a file named fr_FR that included the following line, the
Task posted in “Example: Add a Task to an Organization's Tasks List,” on page 340 returns this localized
value for the operationName attribute when the client locale is set to fr_FR. The passthrough value for
operation is not localized.
backupInProgress_PROGRESS=Sauvegarde en cours pour entity {resourceName} ({resourceType}) avec
id: {resourceId}
Request:
GET https://vcloud.example.com/api/task/604
Response:
200 OK
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task
...
operation="Backup in progress for virtual machine with id 7b91b053-2b..."
operationName="Sauvegarde en cours pour entity Finance (application/vnd.vmware.vcloud.org
+xml) avec id 26 "
... >
REST APIs for Extension Services
A simple extension service does not need a REST API. You can define a service-specific REST API
entrypoint and one or more schema definition files.
An extension service that does not require request or response bodies other than those that the vCloud API
defines, Task, for example, can simply define the URL patterns that constitute its API filters and the service
links that implement its operations.
A service that defines its own request or response bodies must also specify a URL to which clients can direct
requests. The service must specify locations of the files, such as XML schema definition (XSD) files, to which
its clients require access.
Chapter 11 vCloud Director Extension Services
VMware, Inc. 353