Export (0) Print
Expand All

Entities Discovery

Updated: December 20, 2011

Discovers entities.

The Entities Discovery request may be constructed as follows.

 

Method Request URI HTTP Version

GET

https://{serviceNamespace}.servicebus.Windows.net[:{port}]/{path}

HTTP/1.1

The following table describes required and optional request headers.

 

Request Header Description

Authorization

Specifies a WRAPv0.9.7.2 token containing a SimpleWebToken acquired from ACS. Set to WRAP access_token=”{swt}”.

The response includes an HTTP status code and a set of response headers.

 

Code Description

200

OK.

401

Unauthorized. The request is not authorized.

noteNote
In order for the HTTP GET request be interpreted as “Discovery” operation, the name addressed by the URL must not be occupied. If the name is occupied, the HTTP GET request is interpreted as a “Get” operation.

For information about status codes, see Status and Error Codes.

The response for this operation includes the following headers. The response may also include additional standard HTTP headers. All standard headers conform to the HTTP/1.1 protocol specification.

 

Response Header Description

Content-type

Content-Type: application/atom+xml; type=entry

Upon success, an Atom feed listing immediate children of current node is returned. For example:

<?xml version="1.0" encoding="utf-8" ?>
<feed xmlns='http://www.w3.org/2005/Atom'>
  <entry>
    <id>https://{serviceNamespace}.servicebus.Windows.net/{path}</id>
    <published>{createdTime}</published>
    <updated>{lastUpdatedTime}</updated>
    <link rel='self'>https://{serviceNamespace}.servicebus.Windows.net/{path}</link>
    <content type='application/xml'>
      ...
    </content>
  </entry>
</feed>

Show:
© 2014 Microsoft