Kuyruk Oluştur

Önemli

Bu API 11.01.2021 itibarıylakullanımdan kaldırılmıştır ve artık kullanılmamalıdır.

Yeni bir kuyruk oluşturur. Oluşturulduktan sonra kuyruk kaynak bildirimi sabittir. Bu işlem bir kez etkili. Aynı ada sahip bir kuyruk başarıyla oluşturulduktan sonra oluşturma çağrısının yinelenmesi 409 Çakışması hata iletisiyle sonuçlanır.

İstek

Yöntem	İstek URI'si	HTTP sürümü
PUT	https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Queues/{Queue Path}	HTTP/1.1

İstek Üst Bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Description
İçerik Türü	application/xml;type=entry; charset=utf-8
x-ms-version	2012-03-01

İstek ayrıca bir istemci sertifikası gerektirir. Bu sertifika, söz konusu abonelik için karşıya yüklediğiniz sertifikayla eşleşmelidir.

İstek Gövdesi

Aşağıdaki tabloda istek gövdesinin temel öğeleri açıklanmaktadır:

Özellik Adı	Tür	Gerekli	Açıklama
MaxQueueSizeInMegaBytes	İşaretsiz Tamsayı	Gerekli	Bu parametre, en büyük kuyruk boyutunu megabayt cinsinden belirtir. Kuyruğun bu değeri aşmasına neden olan bir iletiyi kuyruğa alma girişimleri başarısız olur. Bu değere yalnızca kullanıcı içeriği sayılır. Kuyruk oluşturma zamanında ve çalışma zamanında ayarlanabilir: - Aralık: 1–5*1024. - Varsayılan: 1*1024.
QueueSizeinBytes	İşaretsiz Tamsayı	Salt okunur. Oluşturma sırasında gerekli değildir.	Bu parametre, kuyruktaki iletilerin şu anda kuyruğun kotasında kapsadığı gerçek baytları yansıtır. Aralık: 0 –MaxTopicSizeinMegaBytes
QueueDepth	İşaretsiz Tamsayı	Salt okunur. Oluşturma sırasında gerekli değildir.	Bu parametre şu anda kuyrukta olan iletilerin sayısını gösterir.
DefaultMessageTimeToLive	XML Datetime	İsteğe bağlı, varsayılan değer 14 gündür.	Teslim edilemeyen iletilerin etkinleştirilip etkinleştirilmediğine bağlı olarak, bir ileti belirtilen süreden daha uzun bir süre kuyrukta depolanmışsa, ileti otomatik olarak teslim edilemeyen ileti kuyruğuna taşınır veya silinir. TTL, kuyrukta ayarlanan TTL değerinden küçükse, iletide belirtilen TTL değeri bu değerin üzerine yazılır. Kuyruk oluşturulduktan sonra bu değer sabittir: - Aralık: 1 saniye – 14 gün. - Varsayılan: 14 gün.
LockDuration	XML Datetime	İsteğe bağlı, varsayılan değer 30 saniyedir.	Bu ayar, bir iletinin alıcı tarafından işlenmek üzere kilitlenmesi gereken saniye sayısını belirler. Bu sürenin sonunda iletinin kilidi açılır ve bir sonraki alıcı tarafından kullanılabilir. Yalnızca kuyruk oluşturma zamanında ayarlanabilir: - Aralık: 0-5 dk. 0 iletinin kilitli olmadığı anlamına gelir. - Varsayılan: 30 saniye.
GerekliSession	Boole	İsteğe Bağlı	Yalnızca kuyruk oluşturma zamanında ayarlanabilir. olarak ayarlanırsa true, kuyruk oturum algılar ve yalnızca desteklenir SessionReceiver . Oturum kullanan kuyruklar REST aracılığıyla desteklenmez. - Varsayılan: False.
RequiresDuplicateDetection	Boole	İsteğe Bağlı	Yalnızca kuyruk oluşturma zamanında ayarlanabilir. - Dayanıklı kuyruk için varsayılan: false.
EnableDeadLetteringOnMessageExpiration	Boole	İsteğe Bağlı	Yalnızca kuyruk oluşturma zamanında ayarlanabilir. - Varsayılan: false. Bu alan, Service Bus'ın süresi dolan TTL içeren bir iletiyi nasıl işlediğini belirler. True ise ve bir iletinin süresi dolarsa, Service Bus iletiyi kuyruktan kuyruğun teslim edilemeyen harf alt sırasına taşır. Yanlışsa, ileti kuyruktan kalıcı olarak silinir.
DuplicateDetectionHistoryTimeWindow	Zaman Aralığı	İsteğe bağlı.	Service Bus'ın ileti yinelemesini algıladığı zaman aralığını belirten özellik. - Aralık: 1 saniye-7 gün. - Varsayılan: 10 dakika.
Durum	Dize	Salt okunur. Oluşturma sırasında gerekli değildir.	Aşağıdaki değerlerden biri olabilir: Etkin Oluşturma Siliniyor ReceiveDisabled SendDisabled Devre dışı Yeni -den adlandırma Geri yükleme Bilinmiyor

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Yanıt Kodları

Not

Özel veya kodlanmış karakterler içeren bir adla kuyruk oluşturursanız (örneğin, "test mi? "test%3FName%3Dvalue%26") olarak kodlanan Name=value&", (400) Geçersiz istek özel durumu oluşturulur.

Kod	Description
201	Kuyruk oluşturuldu.
400	Geçersiz istek gövdesi.
401	Yetkilendirme hatası.
403	Kota aşıldı; kuyruk oluşturulmamış.
409	Belirtilen kuyruk zaten var (veya belirtilen yol zaten dolu).
500	İç hata.

Durum kodları hakkında bilgi için bkz. Durum ve Hata Kodları.

Yanıt Üst Bilgileri

Yok.

Yanıt Gövdesi

Kuyruk açıklaması döndürülür. PUT isteğinde eksikse, bazı açıklama özellikleri varsayılan değerler içerebilir.