定址佇列服務資源

  • 發行項

佇列服務可透過 REST 應用程式開發介面公開下列資源：

  • 帳戶。 儲存體帳戶是儲存體系統中唯一識別的實體。 帳戶是佇列服務的父命名空間。 所有佇列都與帳戶相關聯。

  • 佇列。 佇列中保存的訊息可讓用戶端應用程式或服務擷取。

  • 訊息。 訊息是 UTF-8 編碼的文字，可以是 XML 項目的值。 訊息的大小可以是 64 KiB。

資源 URI 語法

每個資源都有對應的基底 URI，它會參考資源本身。

對於儲存體帳戶，佇列作業的基底 URI 僅包含帳戶的名稱：

https://myaccount.queue.core.windows.net

對於佇列而言，基底 URI 包含帳戶名稱和佇列名稱：

https://myaccount.queue.core.windows.net/myqueue

對於佇列中的訊息而言，基底 URI 包含帳戶名稱、佇列名稱，以及該佇列中的訊息集：

https://myaccount.queue.core.windows.net/myqueue/messages

參照訊息識別碼可更新或刪除個別訊息。 請注意，此語法僅適用于 更新訊息 和 刪除訊息 作業，而且需要 popreceipt 參數進行驗證：

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

每個資源可能也有元件，可以在基底 URI 上顯示為查詢字串的一部分。 查詢字串的語法為 ?comp=<component_name>。 目前，下列資源元件可用於佇列資源，當做 URI 的參數。

元件 支援的資源 Description
list 帳戶 列舉此資源之下的實體。 在帳戶上傳回佇列的清單。
metadata 佇列 設定或傳回佇列屬性，包括使用者定義的中繼資料。

請注意，您必須以 URL 編碼查詢參數的所有值，再傳送至 Azure 儲存體服務。

支援的 HTTP 作業

每一項資源會支援以 HTTP 動詞命令 (GET、PUT、HEAD 和 DELETE) 為基礎的作業。 各項作業的動詞命令、語法和支援的 HTTP 版本會顯示在各項作業的參考頁面上。 如需作業參考頁面的完整清單，請參閱 佇列服務 REST API。

另請參閱

命名佇列和中繼資料
佇列上的作業
訊息上的作業
佇列服務 REST API \(英文\)