5.1

Table Of Contents
type="application/vnd.vmware.admin.amqpSettings+xml"
href="https://vcloud.example.com/api/admin/extension/settings/amqp"
... >
<vcloud:Link
rel="test"
type="application/vnd.vmware.admin.amqpSettingsTest+xml"
href="https://vcloud.example.com/api/admin/extension/settings/amqp/action/test"/>
<AmqpHost />
<AmqpPort>5672</AmqpPort>
<AmqpUsername>guest</AmqpUsername>
<AmqpPassword />
<AmqpExchange>amq.direct</AmqpExchange>
<AmqpVHost>/</AmqpVHost>
<AmqpUseSSL>true</AmqpUseSSL>
</AmqpSettings>
Test AMQP Settings
The settings/amqp/action/test link of the AmqpSettings element allows you to test AMQP settings before
configuring them for the cloud.
Prerequisites
n
Verify that you are logged in to the vCloud API as a system administrator.
n
Verify that you know the AMQP broker password.
n
Retrieve the SystemSettings element. See “Retrieve or Update System Settings,” on page 197.
Procedure
1 Examine the SystemSettings element to locate the link that you can use to retrieve the system's
AmqpSettings element.
This link has a rel attribute value of down and a type attribute value of
application/vnd.vmware.admin.amqpSettings+xml as shown here:
<Link href="https://vcloud.example.com/api/admin/extension/settings/amqp"
rel="down"
type="application/vnd.vmware.admin.amqpSettings+xml"/>
2 Retrieve the AmqpSettings element and locate the settings/amqp/action/test link it contains.
The response portion of “Example: Update AMQP Settings,” on page 265 includes this link.
3 Create a new AmqpSettings element that contains the values you want to test.
You can use the existing AmqpSettings element as a template. Whether you want to test the existing values
or create new ones, you must include the AMQP broker password in the AmqpPassword element. This
element is always returned empty when you retrieve the system's AmqpSettings.
4 Test the AMQP settings.
POST the AmqpSettings element to the settings/amqp/action/test link described in Step 2.
Example: Test AMQP Settings
This example tests the settings shown in the request portion of “Example: Update AMQP Settings,” on
page 265
vCloud API Programming Guide
266 VMware, Inc.