Konu 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 konu oluşturur. Oluşturulduktan sonra bu konunun kaynak bildirimi değişmez. 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.

Şunlara dikkat edin:

  • Konu hemen silinmez. Silinmek üzere işaretlenir ve kaynak yönetimi aracısı bu silme isteğini 5 dakika içinde alır. Ancak kullanıcı arabirimi, alınan HTTP koduna göre bu işlemi hemen yansıtmalıdır.

  • Konu adı aslında URI yoludur. Aşağıdaki normal ifade, olası % kodlaması kaldırıldıktan sonra URI yolundaki her kesimi doğrular.

  • Konu adı aşağıdaki RegEx ile uyumlu olmalıdır.

    public static readonly Regex SafeMessagingEntityNameExpression = new Regex(@"^[\w-\.\$]*/?$", RegexOptions.Compiled | RegexOptions.ECMAScript);

    Bunun anlamı:

    • Varlık segmentleri yalnızca harf, sayı, nokta (.), kısa çizgi (-) ve alt çizgi (_) içerebilir.

    • Birden çok segmente izin verilir (örneğin, kuyruk adı = "a/b/c" ise, üç segment içerir).

    • Kuyruk adının ön eki veya son eki olarak eğik çizgiye (/) izin verilmez.

    • Karakter sayısı üst sınırı 50'dir.

İstek

Yöntem İstek URI'si HTTP sürümü
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Topics/{Topic 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
MaxTopicSizeInMegaBytes İşaretsiz Tamsayı Gereklidir. Bu parametre, konu boyutu üst sınırını megabayt cinsinden belirtir. Konunun bu değeri aşmasına neden olan bir iletiyi sıralama girişimi başarısız olur. Bu değere yalnızca kullanıcı içeriği sayılır. Konu oluşturma zamanında ve çalışma zamanında ayarlanabilir:

- Aralık: 1–5*1024.

- Varsayılan: 1*1024.
TopicSizeinBytes İşaretsiz Tamsayı Salt okunur. Oluşturma zamanında gerekli değildir. Bu parametre, konu başlığındaki iletilerin konu kotasına göre kapsadığı gerçek bayt sayısını yansıtır.

Aralık: 0 – MaxTopicSizeinMegaBytes
DefaultMessageTimeToLive XML Datetime İsteğe bağlı. Teslim edilemeyen iletinin etkinleştirilip etkinleştirilmediğine bağlı olarak, bir ileti belirtilen süreden daha uzun bir süre boyunca konu başlığında depolanmışsa, ileti otomatik olarak teslim edilemeyen ileti kuyruğuna taşınır veya silinir. TTL, konu başlığında ayarlanan TTL değerinden küçükse, iletide belirtilen TTL değeri bu değerin üzerine yazılır. Konu oluşturulduktan sonra bu değer sabittir:

- Aralık: 1 saniye – 14 gün.

- Varsayılan: 14 gün.
RequiresDuplicateDetection Boole İsteğe bağlı. Yalnızca konu oluşturma zamanında ayarlanabilir.

- Dayanıklı konu için varsayılan: False.
EnableDeadLetteringOnMessageExpiration Boole İsteğe bağlı. Yalnızca konu 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. Etkinse ve bir iletinin süresi dolarsa, Service Bus konu başlığındaki iletiyi bu konunun geçersiz harf alt sıralarına taşır. Devre dışı bırakılırsa, ileti konu başlığından 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.
NumberOfSubscriptions Tamsayı Salt okunur. Oluşturma zamanında gerekli değildir. Konu aboneliği sayısı.
Durum Dize Salt okunur. Aşağıdaki değerlerden biri:

- Oluşturma: oluşturma aşamasındayken.
- Etkin: oluşturma işleminden sonra veya kullanıcı son askıya alındıktan sonra etkinleştirdiğinde varsayılan olarak.
- Askıya alındı: kullanıcı varlığı askıya alınacak şekilde güncelleştirdiğinde.

Yanıt

Yanıt bir HTTP durum kodu ve yanıt üst bilgileri kümesi içerir.

Yanıt Kodları

Not

Özel veya kodlanmış karakterler içeren bir adla bir konu oluşturursanız (örneğin, test?Name=value&ile kodlanır test%3FName%3Dvalue%26), bir (401) Yetkisiz özel durum oluşturulur.

Kod Description
201 Konu başarıyla oluşturuldu.
400 Geçersiz istek gövdesi.
401 Yetkilendirme hatası.
403 Kota aşıldı; kuyruğu güncelleştirilmedi.
500 İç hata.

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

Yanıt Üst Bilgileri

Yanıt Üst Bilgisi Description
İçerik Türü application/xml;type=entry; charset=utf-8

Yanıt Gövdesi

Put isteğinde bazı açıklama özellikleri eksikse varsayılan değerler içerebileceğinden konu açıklaması döndürülür.

  • Last updated on