銷售: 1-800-867-1380
本文章是由機器翻譯。 將指標移到文章內的文字上方即可查看原文。 其他資訊。
譯文
原文

列出佇列

 

這項作業會列出指定儲存體帳戶中的所有佇列。

List Queues 要求可能建構如下。 建議使用 HTTPS。 取代 myaccount 的儲存體帳戶名稱:

方法

要求 URI

HTTP 版本

GET

https://myaccount.queue.core.windows.net?comp=list

HTTP/1.1

對模擬儲存體服務的要求時,指定將模擬器主機名稱和佇列服務的連接埠與 127.0.0.1:10001, ,後面接著模擬儲存體帳戶名稱:

方法

要求 URI

HTTP 版本

GET

http://127.0.0.1:10001/devstoreaccount1?comp=list

HTTP/1.1

您可以在要求的 URI 中指定下列其他參數。

參數

說明

prefix

篩選結果,只傳回名稱開頭為指定前置詞的佇列。

marker

識別下一個清單作業所要傳回之清單部分的字串值。 此作業會傳回 NextMarker 回應主體如果傳回的清單中的項目並不完整。 您接著可以在要求佇列清單下一個部分的後續呼叫中,使用此值做為查詢參數。

此標記值對於用戶端為不透明。

maxresults

指定要傳回的最大佇列數目。 如果 maxresults 未指定,伺服器會傳回最多 5000 個項目。

include=metadata

選擇項。 包含此參數可指定將容器的中繼資料當做回應主體的一部分傳回。

請注意,您必須根據 2009-09-19 版的佇列服務規定的命名限制,藉以儲存使用此參數要求的中繼資料。 從這個版本開始,所有中繼資料名稱必須遵守命名慣例 C# 識別碼

timeout

選擇項。 timeout 參數以秒為單位。 如需詳細資訊,請參閱 設定佇列服務作業的逾時值

下表描述必要的和選用的要求標頭。

要求標頭

說明

Authorization

必要項。 指定驗證配置、帳戶名稱及簽章。 如需詳細資訊,請參閱 Azure 儲存體服務的驗證

Datex-ms-date

必要項。 指定要求的國際標準時間 (UTC)。 如需詳細資訊,請參閱 Azure 儲存體服務的驗證

x-ms-version

選擇項。 指定用於這個要求的作業版本。 如需詳細資訊,請參閱 為 Windows Azure 中的 Blob、佇列和表格服務進行版本設定

x-ms-client-request-id

選擇項。 提供啟用儲存體分析記錄時,由用戶端產生的不透明值,而且在分析記錄中記錄 1 KB 的字元限制。 要將用戶端活動與伺服器收到的要求產生關聯時,極力建議您使用這個標頭。 如需詳細資訊,請參閱 關於儲存體分析記錄Azure 記錄:使用記錄檔追蹤儲存體需求

如需範例要求,請參閱以下的<範例要求和回應>一節。

回應包括 HTTP 狀態碼、一組回應標頭,以及含有佇列清單的回應主體。

成功的作業會傳回狀態碼 200 (OK)。

如需狀態碼的相關資訊,請參閱 狀態和錯誤碼

這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。 所有標準標頭符合 HTTP/1.1 通訊協定規格

回應標頭

說明

x-ms-request-id

此標頭可唯一識別提出的要求,而且可用來進行要求的疑難排解。 如需詳細資訊,請參閱 對應用程式開發介面作業進行疑難排解

x-ms-version

指出用於執行要求的佇列服務版本。 對 2009-09-19 (含) 以上版本提出要求會傳回此標頭。

Date

服務產生的 UTC 日期/時間值,可指出啟動回應的時間。

回應主體的格式如下。 請注意 Prefix, ,Marker, ,和 MaxResults 項目只會出現在 URI 中指定。 NextMarker 項目具有值只有當清單結果不完整。

為 2013年-08-15 版及更新的 AccountName 屬性 EnumerationResults 項目重新命名為 ServiceEndpoint 此外, Url 項目底下 Queue 已經移除。

<?xml version="1.0" encoding="utf-8"?> <EnumerationResults ServiceEndpoint="https://myaccount.queue.core.windows.net/"> <Prefix>string-value</Prefix> <Marker>string-value</Marker> <MaxResults>int-value</MaxResults> <Queues> <Queue> <Name>string-value</Name> <Metadata> <metadata-name>value</metadata-name> <Metadata> </Queue> <NextMarker /> </EnumerationResults>

Metadata 元素存在於才 include=metadata 參數在 URI 中指定。Metadata 組名稱對應項目中列出項目,每個名稱 / 值組的值。

回應主體如果中繼資料名稱 / 值組違反 2009年-09-19 版本所強制執行命名限制,指出此問題名稱內 x-ms-invalid-name 項目,如下列 XML 片段所示:


… <Metadata> <MyMetadata1>first value</MyMetadata1> <MyMetadata2>second value</MyMetadata2> <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name> <Metadata> …

如需範例回應,請參閱以下的<範例要求和回應>一節。

只有帳戶擁有者可呼叫這項作業。

如果您指定的值 maxresults 參數和傳回的佇列數目超過此值,或超過的預設值為 maxresults, ,回應主體會包含 NextMarker 指出後續要求傳回的下一個佇列的項目。 若要傳回下一組項目,指定的值 NextMarker 做為後續的要求 URI 中的標記參數。

請注意,值 NextMarker 應視為不透明。

佇列會依字母順序列於回應主體中。

下列為範例 URI 要求帳戶的佇列清單,並將初始作業所要傳回的最大結果數目設為 3。

GET https://myaccount.queue.core.windows.net?comp=list&maxresults=3&include=metadata HTTP/1.1

所傳送的要求包含下列標頭:

x-ms-version: 2013-08-15 x-ms-date: Wed, 23 Oct 2013 00:55:16 GMT Authorization: SharedKey myaccount:Q7tar7qqM2LD/Wey7OQNPP3hMNap9wjg+g9AlAYeFls=

傳回的狀態碼和回應標頭如下:

HTTP/1.1 200 OK Transfer-Encoding: chunked Content-Type: application/xml Date: Wed, 23 Oct 2013 00:56:38 GMT x-ms-version: 2013-08-15 Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

此要求的回應 XML 如下。 請注意 NextMarker 項目跟隨在一組佇列並包含所要傳回的下一個佇列的名稱。

<?xml version="1.0" encoding="utf-8"?> <EnumerationResults ServiceEndpoint="https://myaccount.queue.core.windows.net/"> <Prefix>q</Prefix> <MaxResults>3</MaxResults> <Queues> <Queue> <Name>q1</Name> <Metadata> <Color>red</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> <Queue> <Name>q2</Name> <Metadata> <Color>blue</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> <Queue> <Name>q3</Name> <Metadata> <Color>yellow</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> </Queues> <NextMarker>q4</NextMarker> </EnumerationResults>

後續清單作業在要求 URI 中指定標記 (如下所示)。 下一組結果在回傳時,會以標記所指定的佇列起始。 以下是後續要求的 URI:

https://myaccount.queue.core.windows.net?comp=list&maxresults=3&include=metadata&prefix=q&marker=q4

此項作業的回應主體如下:

<?xml version="1.0" encoding="utf-8"?> <EnumerationResults ServiceEndpoint="https://myaccount.queue.core.windows.net/"> <Prefix>q</Prefix> <Marker>q4</Marker> <MaxResults>3</MaxResults> <Queues> <Queue> <Name>q4</Name> <Metadata> <Color>green</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> <Queue> <Name>q5</Name> <Metadata> <Color>violet</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> </Queues> <NextMarker /> </EnumerationResults>
本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
顯示:
© 2016 Microsoft