Entitás létrehozása vagy frissítése

Üzenetkezelési entitást hoz létre vagy frissít.

Kérelem

Metódus	URI-kérés	HTTP-verzió
Helyezze	https://{serviceNamespace}.servicebus.windows.net/{Entity Path}	HTTP/1.1

Az entitás elérési útja lehet többszegmenses név, a szegmenseket pedig "/" választja el egymástól. Az elérési út teljes egésze az entitások nevét adja. Több entitás is megoszthatja ugyanazokat az előtagszegmenseket.

Kérelemfejlécek

Az alábbi táblázat a szükséges és választható kérelemfejléceket ismerteti.

Kérelem fejléce	Leírás
Engedélyezés	"Kezelés" jogosultságokkal rendelkező közös hozzáférésű jogosultsági (SAS) jogkivonatot ad meg. Részletekért lásd Service Bus-hitelesítés közös hozzáférésű jogosultságkódokkal.
Tartalom típusa	Beállítás alkalmazás/atom+xml;type=entry; charset=utf-8.
If-Match	Állítsa a fejlécet "*" értékre az entitás frissítéséhez. Meg kell adnia a frissített entitáshoz szükséges összes tulajdonságértéket. A nem megadott értékek a szolgáltatás alapértelmezett értékeire vannak beállítva. Ha ez a fejléc hiányzik, a frissítési hívás hibát ad vissza, amely azt jelzi, hogy ez az entitás már létezik.

Kérelemtörzs

A kérelem törzsének tartalmaznia kell egy érvényes Atom XML-bejegyzést, amely beágyazza a létrehozandó entitás leírását

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

A(z) {description} egy üzenetsort vagy témakört írt le a legfelső szintű entitásokhoz, vagy egy előfizetést vagy szabályt a szülőentitásokhoz képest.

Az üzenetsorokat például egy QueueDescription elem ismerteti. Az üzenetsor létrehozásához vagy frissítéséhez szükséges XML-hasznos adatok ezért a következő űrlapot ölthetik, amelyben az összes kihagyott tulajdonság feltételezi az alapértelmezett értékeket:

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

Az entitásokról és az elérési utakhoz való viszonyukról az áttekintési talál.

Válasz

A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.

Válaszkódok

Megjegyzés

Ha speciális vagy kódolt karaktereket tartalmazó névvel frissít egy entitást (például "teszt? A Name=value&"), amely a következőre lesz kódolva: "test%3FName%3Dvalue%26"), egy (401) jogosulatlan kivétel jön létre.

Kód	Leírás
201	Az entitás frissítve van.
400	Érvénytelen kérelemtörzs.
401	Engedélyezési hiba.
403	Kvóta túllépve; az entitás nem frissült.
500	Belső hiba.

Az állapotkódokkal kapcsolatos információkért lásd állapot- és hibakódokat.

Válaszfejlécek

Nincs.

Válasz törzse

Az entitás leírása lesz visszaadva. Egyes leírástulajdonságok alapértelmezett értékeket tartalmazhatnak, ha hiányoznak a PUT kérelemből.