Témakör létrehozása
Fontos
Ez az API 2021. 11. 01-étőlelavult, és már nem használható.
Új témakört hoz létre. 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 a létrehozási hívás megismétlése 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-elérési út 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 |
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. Minden olyan kísérlet, amely olyan üzenetet kísérel meg létrehozni, amely miatt a témakör túllépi ezt az értéket, meghiúsul. 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 azt tükrözi, hogy a témakör üzenetei jelenleg hány bájtot foglalnak el a témakör kvótája 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 küldése, ha egy üzenet a megadott időnél hosszabb ideig van tárolva a témakörben, a rendszer automatikusan áthelyezi a kézbesítetlen levelek várólistájára, vagy törli őket. Ezt az értéket felülírja az üzenetben megadott TTL, ha a TTL kisebb, mint a témakörben beállított TTL. 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ítsa be a táblázatot. – Tartós témakör alapértelmezett értéke: Hamis. |
| EnableDeadLetteringOnMessageExpiration | Logikai | Választható. | Csak a témakör létrehozásakor állítsa be a táblázatot. - Alapértelmezett: Hamis. Ez a mező határozza meg, hogy a Service Bus hogyan kezeli a lejárt TTL-vel rendelkező üzeneteket. Ha engedélyezve van, és egy üzenet lejár, a Service Bus áthelyezi az üzenetet a témakörből a témakör kézbesíthetetlen betűs aldokumentumába. Ha le van tiltva, az üzenet véglegesen törlődik a témakörből. |
| DuplicateDetectionHistoryTimeWindow | Időtartomány | 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 amikor 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 egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Válaszkódok
Megjegyzés
Ha olyan témakört hoz létre, amelynek neve speciális vagy kódolt karaktereket tartalmaz (például test?Name=value&, amely a következőre test%3FName%3Dvalue%26van kódolva), a rendszer (401) Jogosulatlan kivételt hoz létre.
| Code | Description |
|---|---|
| 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 témakör leírása lesz visszaadva, mert ha néhány leírástulajdonság hiányzik a PUT kérelemből, azok alapértelmezett értékeket tartalmazhatnak.