Vytvořit téma

Důležité

Toto rozhraní API je zastaralé a vyřazené k 1. 11. 2021 a už by se nemělo používat.

Vytvoří nové téma. Po vytvoření je manifest prostředků tohoto tématu neměnný. Tato operace je idempotentní. Opakování volání vytvoření po úspěšném vytvoření fronty se stejným názvem má za následek chybovou zprávu "409 conflict" (Konflikt 409).

Pamatujte na následující:

  • Téma se neodstraní okamžitě. Označí se k odstranění a agent správy prostředků tuto žádost o odstranění načte během 5 minut. V uživatelském rozhraní by se ale tato operace měla projevit okamžitě podle přijatého kódu HTTP.

  • Název tématu je ve skutečnosti cesta URI. Následující regulární výraz ověří každý segment v cestě URI po odebrání možného % kódování.

  • Název tématu by měl odpovídat následujícímu regulárnímu výrazu.

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

    To znamená následující:

    • Segmenty entit můžou obsahovat jenom písmena, číslice, tečky (.), spojovníky (-) a podtržítka (_).

    • Je povoleno více segmentů (například pokud název fronty = "a/b/c", obsahuje tři segmenty).

    • Lomítko (/) není povolené jako předpona nebo přípona názvu fronty.

    • Maximální počet znaků je 50.

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Topics/{Topic Path} HTTP/1.1

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Description
Typ obsahu application/xml;type=entry; charset=utf-8
x-ms-version 2012-03-01

Požadavek také vyžaduje klientský certifikát. Tento certifikát se musí shodovat s certifikátem, který jste nahráli pro dané konkrétní předplatné.

Text požadavku

Následující tabulka popisuje klíčové prvky textu požadavku:

Název vlastnosti Typ Vyžadováno Popis
MaxTopicSizeInMegaBytes Celé číslo bez znaménka Povinná hodnota. Tento parametr určuje maximální velikost tématu v megabajtech. Jakýkoli pokus o zařazení zprávy do fronty, který způsobí, že téma překročí tuto hodnotu, se nezdaří. Do této hodnoty se započítává jenom uživatelský obsah. Nastavitelné při vytváření tématu a za běhu:

- Rozsah: 1–5*1024.

- Výchozí hodnota: 1*1024.
TopicSizeinBytes Celé číslo bez znaménka Jen pro čtení. Při vytváření se nevyžaduje. Tento parametr odráží skutečný počet bajtů, které zprávy v tématu aktuálně zabírají vzhledem k kvótě tématu.

Rozsah: 0 – MaxTopicSizeinMegaBytes
DefaultMessageTimeToLive Datum a čas XML Nepovinný parametr. Na základě toho, jestli je povolené nedoručování zpráv, se zpráva v tématu ukládá po delší dobu, než je zadaná doba, automaticky se přesune do fronty nedoručených zpráv nebo se odstraní. Tato hodnota je přepsána hodnotou TTL zadanou ve zprávě, pokud je hodnota TTL zprávy menší než hodnota TTL nastavená v tématu. Tato hodnota je po vytvoření tématu neměnná:

- Rozsah: 1 sekunda – 14 dní.

- Výchozí hodnota: 14 dní.
RequiresDuplicateDetection Logická hodnota Nepovinný parametr. Nastavitelné pouze při vytváření tématu.

- Výchozí pro trvalé téma: False.
EnableDeadLetteringOnMessageExpiration Logická hodnota Nepovinný parametr. Nastavitelné pouze při vytváření tématu.

- Výchozí: False.

Toto pole určuje, jak Služba Service Bus zpracovává zprávu s hodnotou TTL s vypršenou platností. Pokud je povolená a platnost zprávy vyprší, Service Bus přesune zprávu z tématu do podpřísežné fronty pro toto téma. Pokud je tato možnost zakázaná, zpráva se trvale odstraní z tématu.
DuplicateDetectionHistoryTimeWindow Časový rozsah Nepovinný parametr. Vlastnost, která určuje časový rozsah, během kterého Služba Service Bus detekuje duplikaci zpráv.

- Rozsah: 1 sekunda – 7 dní.

- Výchozí hodnota: 10 minut.
NumberOfSubscriptions Integer Jen pro čtení. Při vytváření se nevyžaduje. Počet odběrů témat
Stav Řetězec Jen pro čtení. Jedna z následujících hodnot:

- Vytváření: ještě ve fázi vytváření.
- Aktivní: Ve výchozím nastavení po vytvoření nebo když ho uživatel aktivuje po posledním pozastavení.
- Pozastaveno: Když uživatel aktualizuje entitu tak, aby byla pozastavena.

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Kódy odpovědí

Poznámka

Pokud vytvoříte téma s názvem, který obsahuje speciální nebo zakódované znaky (například test?Name=value&, který je zakódovaný do test%3FName%3Dvalue%26), vygeneruje se (401) Výjimka Neautorizováno.

Kód Description
201 Téma se úspěšně vytvořilo.
400 Neplatný text požadavku.
401 Autorizace se nezdařila.
403 Překročení kvóty; fronta se neaktualizovala.
500 Vnitřní chyba.

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Hlavička odpovědi Description
Typ obsahu application/xml;type=entry; charset=utf-8

Text odpovědi

Vrátí se popis tématu, protože pokud v požadavku PUT chybí některé vlastnosti popisu, můžou obsahovat výchozí hodnoty.

  • Last updated on