Kuyrukları Listele

Makale
06/27/2023

Bu işlem, belirli bir depolama hesabındaki tüm kuyrukları listeler.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz List Queues . HTTPS önerilir. myaccount değerini depolama hesabınızın adıyla değiştirin.

Yöntem	İstek URI'si	HTTP sürümü
`GET`	`https://myaccount.queue.core.windows.net?comp=list`	HTTP/1.1

Öykünmüş depolama hizmeti URI'si

Öykünülen depolama hizmetine yönelik bir istekte bulunurken öykünücü ana bilgisayar adını ve Azure Kuyruk Depolama 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?comp=list`	HTTP/1.1

URI Parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz.

Parametre	Açıklama
`prefix`	Sonuçları yalnızca belirtilen ön ekle başlayan adlara sahip kuyrukları döndürecek şekilde filtreler.
`marker`	Listenin bir sonraki liste işlemiyle döndürülecek bölümünü tanımlayan dize değeri. Döndürülen liste tamamlanmadıysa, işlem yanıt gövdesi içinde bir `NextMarker` öğe döndürür. Ardından, kuyruk listesinin sonraki bölümünü istemek için sonraki bir çağrıda sorgu parametresi olarak bu değeri kullanabilirsiniz. İşaretçi değeri istemci için opaktır.
`maxresults`	Döndürülecek en fazla kuyruk sayısını belirtir. Belirtilmezse `maxresults` , sunucu en fazla 5.000 öğe döndürür.
`include=metadata`	İsteğe bağlı. Kapsayıcının meta verilerinin yanıt gövdesinin bir parçası olarak döndürüleceğini belirtmek için bu parametreyi ekleyin. Bu parametreyle istenen meta verilerin Kuyruk Depolama'nın 2009-09-19 sürümü tarafından uygulanan adlandırma kısıtlamalarına uygun olarak depolanması gerektiğini unutmayın. Bu sürümden başlayarak, tüm meta veri adları C# tanımlayıcıları için adlandırma kurallarına uymalıdır.
`timeout`	İsteğe bağlı. `timeout` parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz . Kuyruk Depolama işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadı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.

Örnek istek

Bu makalenin devamında yer alan "Örnek istek ve yanıt" bölümüne bakın.

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve kuyruk listesini içeren bir 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 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 ek, standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi	Description
`x-ms-request-id`	Bu üst bilgi, yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme.
`x-ms-version`	İsteği çalıştırmak için kullanılan Kuyruk Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürülür.
`Date`	Yanıtın başlatıldığı saati gösteren utc tarih/saat değeri. Hizmet bu değeri oluşturur.
`x-ms-client-request-id`	İstekler ve karşılık gelen yanıtlarla ilgili sorunları gidermek için bu üst bilgiyi kullanabilirsiniz. Bu üst bilginin değeri, istekte varsa üst bilginin değerine `x-ms-client-request-id` eşittir. Değer en fazla 1024 görünür ASCII karakterdir. `x-ms-client-request-id` Üst bilgi istekte yoksa, yanıtta bu üst bilgi bulunmaz.

Yanıt gövdesi

Yanıt gövdesinin biçimi aşağıdaki gibidir. , Markerve MaxResults öğelerinin Prefixyalnızca URI'de belirttiğinizde mevcut olduğunu unutmayın. öğesinin NextMarker yalnızca liste sonuçları tamamlanmazsa bir değeri vardır.

Sürüm 2013-08-15 ve üzeri için, AccountName öğesinin EnumerationResults özniteliği olarak ServiceEndpointyeniden adlandırıldı. Buna ek olarak, Url altındaki Queue öğesi kaldırıldı.

<?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 öğesi yalnızca parametresi URI'de belirtilmişse include=metadata bulunur. öğesinde Metadata , her ad-değer çiftinin değeri, çiftin adına karşılık gelen bir öğe içinde listelenir.

Meta veri ad-değer çifti 2009-09-19 sürümü tarafından uygulanan adlandırma kısıtlamalarını ihlal ederse, yanıt gövdesi aşağıdaki XML parçasında gösterildiği gibi bir x-ms-invalid-name öğe içindeki sorunlu adı gösterir:

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

Örnek yanıt

Bu makalenin devamında yer alan "Örnek istek ve yanıt" bölümüne bakın.

Yetkilendirme

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

parametresi için maxresults bir değer belirtirseniz ve döndürülecek kuyruk sayısı bu değeri aşıyorsa veya için maxresultsvarsayılan değeri aşıyorsa, yanıt gövdesi bir NextMarker öğe içerir. Bu öğe, sonraki bir istekte döndürülecek bir sonraki kuyruğu gösterir. Sonraki öğe kümesini döndürmek için değerini sonraki istek için URI'de işaretçi parametresi olarak belirtin NextMarker .

değerinin NextMarker opak olarak kabul edilmesi gerektiğini unutmayın.

Kuyruklar yanıt gövdesinde alfabetik sırada listelenir.

Örnek istek ve yanıt

Bir hesap için kuyruk listesini isteyen örnek bir URI aşağıda verilmiştir. İlk işlem için döndürülecek en yüksek sonuçları üç olarak ayarlar.

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

İstek şu üst bilgilerle gönderilir:

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

Durum kodu ve yanıt üst bilgileri aşağıdaki gibi döndürülür:

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

Bu isteğin yanıt XML'i aşağıdaki gibidir. öğesinin NextMarker kuyruk kümesini izlediğini ve döndürülecek sonraki kuyruğun adını içerdiğini unutmayın.

<?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>

Sonraki liste işlemi, aşağıdaki gibi istek URI'sinde işaretçiyi belirtir. İşaretçi tarafından belirtilen kuyrukla başlayarak sonraki sonuç kümesi döndürülür. Sonraki isteğin URI'sini aşağıda bulabilirsiniz:

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

Bu işlemin yanıt gövdesi aşağıdaki gibidir:

<?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>

Ayrıca bkz.

Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları
Kuyruk Depolama hata kodları

Share via