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

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

Kérés

Metódus Kérés URI-ja HTTP-verzió
PUT 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 meg. Több entitás is osztozhat ugyanazon előtagszegmenseken.

Kérelemfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce Description
Engedélyezés Egy közös hozzáférésű jogosultságkód (SAS) jogkivonatot ad meg "Kezelés" jogosultságokkal. Részletekért lásd: Service Bus-hitelesítés közös hozzáférésű jogosultságkódokkal .
Content-Type Beállítás : application/atom+xml;type=entry; charset=utf-8.
If-Match Állítsa ezt 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érelem törzse

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} a legfelső szintű entitások üzenetsorát vagy témakörét, illetve a szülőentitásokhoz kapcsolódó előfizetést vagy szabályt ismertette.

Az üzenetsorokat például egy QueueDescription elem írja le. Az üzenetsor létrehozásához vagy frissítéséhez szükséges XML-hasznos adat ezért a következő formában jelenhet meg, 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ásokkal és azok elérési utakhoz való viszonyával kapcsolatos további részletekért tekintse meg az Áttekintést .

Reagálás

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

Válaszkódok

Megjegyzés

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

Code Description
201 Entitás frissítve.
400 Érvénytelen kérelemtörzs.
401 Engedélyezési hiba.
403 Kvóta túllépve; entitás nincs frissítve.
500 Belső hiba történt.

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

Válaszfejlécek

Nincsenek.

Válasz törzse

A függvény visszaadja az entitás leírását. Egyes leírástulajdonságok alapértelmezett értékeket tartalmazhatnak, ha hiányoznak a PUT kérelemből.