İletilere Göz Atma

Makale
08/05/2023

İş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:10001ve 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ış truekuyruktan 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 MessagesDequeueCount 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 DequeueCountartı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ı

Share via