Varlık Oluşturma veya Güncelleştirme

Makale
08/04/2023

Mesajlaşma varlığını oluşturur veya güncelleştirir.

İstek

Yöntem	İstek URI'si	HTTP Sürümü
PUT	https://{serviceNamespace}.servicebus.windows.net/{Entity Path}	HTTP/1.1

Varlık yolu, segmentlerin '/' ile ayrılmış olduğu çok segmentli bir ad olabilir. Yolun tamamı varlıkların adını oluşturur. Birden çok varlık aynı ön ek kesimlerini paylaşabilir.

İstek Üst Bilgileri

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

İstek Başlığı	Description
Yetkilendirme	"Yönet" haklarına sahip bir Paylaşılan Erişim İmzası (SAS) belirteci belirtir. Ayrıntılar için bkz. Paylaşılan Erişim İmzaları ile Service Bus kimlik doğrulaması .
İçerik Türü	application/atom+xml;type=entry olarak ayarlayın; charset=utf-8.
If-Match	Varlığı güncelleştirmek için bu üst bilgiyi "*" olarak ayarlayın. Güncelleştirilmiş varlıkta istenen tüm özellik değerlerini sağlamanız gerekir. Sağlanmayan tüm değerler hizmet varsayılan değerlerine ayarlanır. Bu üst bilgi eksikse, güncelleştirme çağrısı bu varlığın zaten var olduğunu belirten bir hata döndürür.

İstek Gövdesi

İsteğin gövdesi, oluşturulacak varlığın açıklamasını ekleyen geçerli bir Atom XML girişi içermelidir

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {description}  
  </content>  
</entry>

Burada {description} üst düzey varlıklar için bir Kuyruk veya Konu başlığı ya da üst varlıklarına göre bir abonelik veya kural tanımladı.

Örneğin bir kuyruk bir QueueDescription öğeyle açıklanmıştır. Bu nedenle, bir kuyruk oluşturmak veya güncelleştirmek için XML yükü aşağıdaki biçimde olabilir ve atlanmış tüm özellikler varsayılan değerlerini varsayar:

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <content type="application/xml">  
    <QueueDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
       <LockDuration>T1M</LockDuration>
    </QueueDescription>
  </content>  
</entry>

Varlıklar ve bunların yollarla ilişkisi hakkında daha fazla bilgi için bkz. Genel Bakış .

Yanıt

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

Yanıt Kodları

Not

Bir varlığı özel veya kodlanmış karakterler içeren bir adla güncelleştirirseniz (örneğin, "test mi? "test%3FName%3Dvalue%26") olarak kodlanan Name=value&"), bir (401) yetkisiz özel durum oluşturulur.

Kod	Description
201	Varlık güncelleştirildi.
400	Geçersiz istek gövdesi.
401	Yetkilendirme hatası.
403	Kota aşıldı; varlık güncelleştirilmedi.
500	İç hata.

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

Yanıt Üst Bilgileri

Yok.

Yanıt Gövdesi

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

Aracılığıyla paylaş