İletilere Göz Atma
İşlem kuyruğun Peek Messages
önünden bir veya daha fazla ileti alır, ancak iletinin görünürlüğünü değiştirmez.
İstek
İsteği aşağıdaki gibi oluşturabilirsiniz Peek Messages
. HTTPS kullanmanızı öneririz.
myaccount değerini depolama hesabınızın adıyla, myqueue değerini ise kuyruğunuzun adıyla değiştirin:
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
GET |
https://myaccount.queue.core.windows.net/myqueue/messages?peekonly=true |
HTTP/1.1 |
Öykünülmüş depolama hizmeti isteği
Öykünülen depolama hizmetine karşı istekte bulunulduğunda öykünücü ana bilgisayar adını ve Kuyruk hizmeti bağlantı noktasını olarak 127.0.0.1:10001
ve ardından öykünülen depolama hesabı adını belirtin:
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
GET |
http://127.0.0.1:10001/devstoreaccount1/myqueue/messages?peekonly=true |
HTTP/1.1 |
Daha fazla bilgi için bkz . Yerel Azure Depolama geliştirmesi için Azurite öykünücüsü kullanma.
URI parametreleri
İstek URI'sinde aşağıdaki parametreler belirtilebilir.
Parametre | Açıklama |
---|---|
numofmessages |
İsteğe bağlı. En fazla 32 olmak üzere kuyruktan göz atacak iletilerin sayısını belirten sıfır olmayan bir tamsayı değeri. Varsayılan olarak, bu işlemle kuyruktan tek bir iletiye göz atılır. |
timeout |
İsteğe bağlı.
timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz . Kuyruk hizmeti işlemleri için zaman aşımlarını ayarlama. |
İstek üst bilgileri
Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:
İstek üst bilgisi | Açıklama |
---|---|
Authorization |
Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
Date veya x-ms-date |
Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
x-ms-version |
İsteğe bağlı. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. |
x-ms-client-request-id |
İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. Azure Kuyruk Depolama'yı izleme. |
İstek gövdesi
Yok.
Yanıt
Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve XML yanıt gövdesi içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.
Durum kodları hakkında daha fazla bilgi için bkz . Durum ve hata kodları.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ayrıca ek standart HTTP üst bilgileri içerir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.
Yanıt üst bilgisi | Description |
---|---|
x-ms-request-id |
Yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme. |
x-ms-version |
İsteği yürütmek için kullanılan Kuyruk hizmeti sürümü. Sürüm 2009-09-19 ve üzeri için yapılan istekler için döndürüldü. |
Date |
Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. |
x-ms-client-request-id |
İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir.
x-ms-client-request-id Üst bilgi istekte yoksa yanıtta bulunmaz. |
Yanıt gövdesi
İşlemin yanıt XML'i Peek Messages
aşağıdaki biçimde döndürülür.
MessageID
öğesi, kuyruktaki iletiyi tanımlayan bir GUID değeridir. Bu değer, Kuyruk hizmeti tarafından iletiye atanır ve istemci için opaktır.
InsertionTime
ve ExpirationTime
öğeleri UTC değerleri olarak temsil edilir ve RFC 1123'te açıklandığı gibi biçimlendirilir.
öğesi, DequeueCount
ileti ilk kez sıralandığında 1 değerine sahiptir. Bu değer, ileti daha sonra her sıralandığında artırılır.
Not
DequeueCount
öğesi yanıt gövdesinde döndürülür ancak kuyruk Kuyruk hizmeti sürüm 2009-09-19 ile oluşturulduysa döndürülür.
<QueueMessagesList>
<QueueMessage>
<MessageId>string-message-id</MessageId>
<InsertionTime>insertion-time</InsertionTime>
<ExpirationTime>expiration-time</ExpirationTime>
<DequeueCount>integer</DequeueCount>
<MessageText>message-body</MessageText>
</QueueMessage>
</QueueMessagesList>
Not
Bu yanıt, veya TimeNextVisible
öğelerini içermediği için İleti Al işleminin yanıtından PopReceipt
farklıdır.
Örnek yanıt
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
Content-Type: application/xml
Date: Fri, 16 Sep 2011 22:51:18 GMT
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
Response Body:
<?xml version="1.0" encoding="utf-8"?>
<QueueMessagesList>
<QueueMessage>
<MessageId>06eba214-8107-4412-a7f6-710a9baff647</MessageId>
<InsertionTime>Fri, 09 Oct 2009 18:59:54 GMT</InsertionTime>
<ExpirationTime>Fri, 16 Sep 2009 18:59:54 GMT</ExpirationTime>
<DequeueCount>1</DequeueCount>
<MessageText>PHRlc3Q+dGhpcyBpcyBhIHRlc3QgbWVzc2FnZTwvdGVzdD4=</MessageText>
</QueueMessage>
</QueueMessagesList>
Yetkilendirme
Bu işlem hesap sahibi ve paylaşılan erişim imzası olan ve bu işlemi gerçekleştirme izni olan herkes tarafından gerçekleştirilebilir.
Açıklamalar
olarak ayarlanmış true
kuyruktan peekonly
bir ileti alındığında iletinin görünürlüğü değişmez. İstemci İletileri Al işlemini kullanarak iletiyi alana kadar ileti kuyruğun diğer tüketicileri tarafından kullanılabilir durumda kalır. İletiyi isteyen istemci yanıtla birlikte bir pop alındı bilgisi almaz ve bu nedenle iletiyi silemez.
Yalnızca görünür olan iletiler işlemle Peek Messages
alınabilir. Alınabilecek ileti sayısı üst sınırının 32 olduğunu unutmayın.
çağrısıyla Get Messages
DequeueCount
bir ileti ilk kez alındığında, özelliği 1 olarak ayarlanır. Silinmez ve daha sonra yeniden alınırsa, DequeueCount
özellik artırılır. İstemci, bir iletinin kaç kez alındığını belirlemek için bu değeri kullanabilir.
Not
çağrısı Peek Messages
değerini DequeueCount
artırmaz, ancak istemcinin okuması için bu değeri döndürür.
numofmessages parametresi aralık dışındaysa, hizmet aşağıdaki örnekte gösterildiği gibi ek hata bilgileriyle birlikte 400 (Hatalı İstek) durum kodunu döndürür:
HTTP/1.1 400 One of the query parameters specified in the request URI is outside the permissible range.
Connection: Keep-Alive
Content-Length: 455
Via: 1.1 TK5-PRXY-22
Date: Wed, 02 May 2012 19:37:23 GMT
Content-Type: application/xml
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 6a03526c-ca2c-4358-a63a-b5d096988533
x-ms-version: 2011-08-18
<?xml version="1.0" encoding="utf-8"?>
<Error>
<Code>OutOfRangeQueryParameterValue</Code>
<Message>One of the query parameters specified in the request URI is outside the permissible range.
RequestId:6a03526c-ca2c-4358-a63a-b5d096988533
Time:2012-05-02T19:37:24.2438463Z
</Message>
<QueryParameterName>numofmessages</QueryParameterName>
<QueryParameterValue>0</QueryParameterValue>
<MinimumAllowed>1</MinimumAllowed>
<MaximumAllowed>32</MaximumAllowed>
</Error>
Ayrıca bkz.
Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları
Kuyruk hizmeti hata kodları