RabbitMQ Management HTTP API--官方文档

标签：des   http   io   os   ar   for   sp   div   on   

Introduction

Apart from this help page, all URIs will serve only resources of type application/json, and will require HTTP basic authentication (using the standard RabbitMQ user database). The default user is guest/guest.

Many URIs require the name of a virtual host as part of the path, since names only uniquely identify objects within a virtual host. As the default virtual host is called "/", this will need to be encoded as "%2f".

PUTing a resource creates it. The JSON object you upload must have certain keys (documented below). Other keys are ignored. Missing keys consitute an error.

Since bindings do not have names or IDs in AMQP we synthesise one based on all its properties. Since predicting this name is hard in the general case, you can also create bindings by POSTing to a factory URI. See the example below.

Caveats

These caveats apply to the current development version of the management API. In future they will be fixed.

• arguments fields are ignored everywhere. You cannot create a queue, exchange or binding with arguments. Queues, exchanges or bindings with arguments won‘t show those arguments.
• Permissions are only enforced sporadically. If a user can authenticate with the HTTP API, they can do anything.
• There are many monitoring-related information items in the objects returned from GET requests. They are undocumented and subject to change.

Examples

A few quick examples, using the Unix command line tool curl:

• Get a list of vhosts:

  $ curl -i -u guest:guest http://localhost:55672/api/vhosts
  HTTP/1.1 200 OK
  Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic)
  Date: Tue, 31 Aug 2010 15:46:59 GMT
  Content-Type: application/json
  Content-Length: 5
  
  ["/"]

• Create a new vhost:

  $ curl -i -u guest:guest -H "content-type:application/json"   -XPUT http://localhost:55672/api/vhosts/foo
  HTTP/1.1 204 No Content
  Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic)
  Date: Fri, 27 Aug 2010 16:56:00 GMT
  Content-Type: application/json
  Content-Length: 0

  Note: you must specify application/json as the mime type.

  Note: the name of the object is not needed in the JSON object uploaded, since it is in the URI. As a virtual host has no properties apart from its name, this means you do not need to specify a body at all!

• Create a new exchange in the default virtual host:

  $ curl -i -u guest:guest -H "content-type:application/json"   -XPUT -d‘{"type":"direct","auto_delete":false,"durable":true,"arguments":[]}‘   http://localhost:55672/api/exchanges/%2f/my-new-exchange
  HTTP/1.1 204 No Content
  Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic)
  Date: Fri, 27 Aug 2010 17:04:29 GMT
  Content-Type: application/json
  Content-Length: 0

  Note: we never return a body in response to a PUT or DELETE, unless it fails.

• And delete it again:

  $ curl -i -u guest:guest -H "content-type:application/json"   -XDELETE http://localhost:55672/api/exchanges/%2f/my-new-exchange
  HTTP/1.1 204 No Content
  Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic)
  Date: Fri, 27 Aug 2010 17:05:30 GMT
  Content-Type: application/json
  Content-Length: 0

Reference

{"type":"direct","auto_delete":false,"durable":true,"arguments":[]}

{"auto_delete":false,"durable":true,"arguments":[]}

{"routing_key":"my_routing_key","arguments":[]}

{"password":"secret"}

{"scope":"client","configure":".*","write":".*","read":".*"}

原文地址：http://hg.rabbitmq.com/rabbitmq-management/raw-file/3646dee55e02/priv/www-api/help.html

RabbitMQ Management HTTP API--官方文档

标签：des   http   io   os   ar   for   sp   div   on   

原文地址：http://www.cnblogs.com/davidwang456/p/4062020.html