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.