Témakör létrehozása

Fontos

Ez az API 2021. 11. 01-étőlelavult, és már nem használható.

Létrehoz egy új témakört. A létrehozás után a témakör erőforrás-jegyzékfájlja nem módosítható. Ez a művelet idempotens. Ha megismétli a létrehozási hívást egy azonos nevű üzenetsor sikeres létrehozása után, "409-ütközés" hibaüzenet jelenik meg.

Vegye figyelembe a következőket:

  • A témakör nem törlődik azonnal. Törlésre van megjelölve, és az erőforrás-kezelő ügynök 5 percen belül lekéri ezt a törlési kérést. A felhasználói felületnek azonban azonnal tükröznie kell ezt a műveletet a kapott HTTP-kódnak megfelelően.

  • A témakör neve valójában az URI elérési útja. Az alábbi reguláris kifejezés ellenőrzi az URI-útvonal egyes szegmenseit a lehetséges % kódolás eltávolítása után.

  • A témakör nevének meg kell felelnie a következő RegEx-nek.

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

    Ez a következőt jelenti:

    • Az entitásszegmensek csak betűket, számokat, pontokat (.), kötőjeleket (-) és aláhúzásjeleket (_) tartalmazhatnak.

    • Több szegmens is engedélyezett (például ha az üzenetsor neve = "a/b/c", akkor három szegmenst tartalmaz).

    • A perjel (/) nem használható az üzenetsor nevének előtagjaként vagy utótagjaként.

    • A karakterek maximális száma 50.

Kérés

Metódus Kérés URI-ja HTTP-verzió
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Topics/{Topic Path} HTTP/1.1

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
Content-Type application/xml;type=entry;charset=utf-8
x-ms-version 2012-03-01

Vegye figyelembe, hogy a kérelemhez ügyféltanúsítvány is szükséges. Ennek a tanúsítványnak meg kell egyeznie az adott előfizetéshez feltöltött tanúsítvánnyal.

Kérelem törzse

Az alábbi táblázat a kérelem törzsének fő elemeit ismerteti:

Tulajdonság neve Típus Kötelező Leírás
MaxTopicSizeInMegaBytes Aláíratlan egész szám Kötelező. Ez a paraméter megabájtban adja meg a témakör maximális méretét. Ha olyan üzenetet kísérel meg létrehozni, amely miatt a témakör túllépi ezt az értéket, sikertelen lesz. Csak a felhasználói tartalmak számítanak bele ebbe az értékbe. Beállítás a témakör létrehozásakor és futásidőben:

- Tartomány: 1–5*1024.

- Alapértelmezett: 1*1024.
TopicSizeinBytes Aláíratlan egész szám Csak olvasható. Létrehozáskor nem szükséges. Ez a paraméter a témakör üzenetei által jelenleg elfoglalt bájtok számát tükrözi a témakörkvóta alapján.

Tartomány: 0 – MaxTopicSizeinMegaBytes
DefaultMessageTimeToLive XML Datetime Választható. Attól függően, hogy engedélyezve van-e a kézbesítetlen levelek írása, a rendszer automatikusan áthelyezi vagy törli az üzenetet, ha egy üzenet a megadott időnél hosszabb ideje van tárolva a témakörben. Ezt az értéket felülírja az üzenetben megadott TTL, ha az üzenet TTL-értéke kisebb, mint a témakörben beállított élettartam. Ez az érték nem módosítható a témakör létrehozása után:

- Tartomány: 1 másodperc - 14 nap.

- Alapértelmezett: 14 nap.
RequiresDuplicateDetection Logikai Választható. Csak a témakör létrehozásakor állítható be.

– Tartós témakör alapértelmezett értéke: Hamis.
EnableDeadLetteringOnMessageExpiration Logikai Választható. Csak a témakör létrehozásakor állítható be.

- Alapértelmezett: Hamis.

Ez a mező határozza meg, hogy Service Bus hogyan kezeli a lejárt élettartamú üzeneteket. Ha engedélyezve van, és egy üzenet lejár, Service Bus áthelyezi az üzenetet a témakör kézbesíthetetlen levelek aldokumentumába. Ha le van tiltva, az üzenet véglegesen törlődik a témakörből.
DuplicateDetectionHistoryTimeWindow Időtartam Választható. Egy tulajdonság, amely meghatározza azt az időtartamot, amely alatt a Service Bus észleli az üzenetek duplikálását.

- Tartomány: 1 másodperc - 7 nap.

- Alapértelmezett: 10 perc.
NumberOfSubscriptions Egész szám Csak olvasható. Létrehozáskor nem szükséges. Témakör-előfizetések száma.
Állapot Sztring Csak olvasható. Az alábbi értékek egyike:

- Létrehozás: ha még a létrehozási fázisban van.
- Aktív: alapértelmezés szerint a létrehozás után, vagy ha a felhasználó a legutóbbi felfüggesztés után aktiválja.
- Felfüggesztve: amikor a felhasználó frissíti a felfüggesztendő entitást.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot és a válaszfejlécek készletét.

Válaszkódok

Megjegyzés

Ha speciális vagy kódolt karaktereket tartalmazó (például kódolttest%3FName%3Dvalue%26) nevű témakört hoz létre, test?Name=value&a rendszer (401) Nem engedélyezett kivételt hoz létre.

Code Leírás
201 A témakör létrehozása sikerült.
400 Érvénytelen kérelemtörzs.
401 Engedélyezési hiba.
403 Kvóta túllépve; az üzenetsor nem frissült.
500 Belső hiba történt.

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

Válaszfejlécek

Válaszfejléc Description
Content-Type application/xml;type=entry;charset=utf-8

Válasz törzse

A rendszer visszaadja a témakör leírását, mert ha egyes leírástulajdonságok hiányoznak a PUT kérelemből, előfordulhat, hogy alapértelmezett értékeket tartalmaznak.