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

介紹

除了幫助頁面，所有URIs只會服務(wù)application/json類型的資源，并且需要HTTP基礎(chǔ)認(rèn)證(使用標(biāo)準(zhǔn)RabbitMQ用戶數(shù)據(jù)庫). 默認(rèn)用戶是guest/guest.

大多數(shù)URIs需要虛擬主機(jī)名稱作為其路徑的一部分, 因為名稱是虛擬主機(jī)的唯一標(biāo)識符對象. 默認(rèn)虛擬主機(jī)稱為"/", 它需要編碼為"%2f".

PUT一個資源會對其進(jìn)行創(chuàng)建. 你上傳的JSON對象必須有某個鍵keys (下面文檔有描述)，其它的鍵會被忽略. 缺失鍵會引發(fā)錯誤.

在AMQP中，由于綁定沒有名稱或IDs，因此我們基于其所有屬性人工合成了一個. 

由于一般情況下很難預(yù)測這個名字, 你可以通過POST一個工廠URI來創(chuàng)建綁定.查看下面的例子.

注意事項

• arguments 字段會被忽略.你不創(chuàng)建一個隊列,交換器或使用參數(shù)進(jìn)行綁定. 帶有參數(shù)的隊列，交換器或綁定也不會顯示這些參數(shù)．
• 權(quán)限偶爾才需要強(qiáng)制執(zhí)行.如果一個用戶能用HTTP API進(jìn)行認(rèn)證，那么它們可以做任何事情.
• 從GET請求中返回的對象中包含許多與監(jiān)控相關(guān)的信息. 它們是無證實的，并且將來可能要發(fā)生變化.

示例

下面有幾個快速例子,它們使用了Unix命令行工具curl:

• 獲取虛擬主機(jī)列表:

  $ 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  
  ["/"]

• 創(chuàng)建一個新虛擬主機(jī):

  $ 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

  注意: 你必須將mime類型指定為application/json.

  Note: 在上傳的JSON對象中，對象名稱是不需要的，因為它已經(jīng)包含在了URI中. 由于一個虛擬主機(jī)除了名稱外沒有其它屬性，這意味著你完全不需要指定一個body.

• 在默認(rèn)虛擬主機(jī)中創(chuàng)建一個新的交換器:

  $ 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

  注意: 在PUT或DELETE的響應(yīng)中， 除非失敗了，否則我們絕不會返回一個body.

• 再刪除它:

  $ 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

參考

{"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":".*"}