Aktualizovat téma

Důležité

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

Aktualizace téma. Aktualizovaný popisovač se odešle v textu požadavku. Rozhraní API aktualizuje položky témat v položkách FE/BE.

Žá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
x-ms-version 2012-03-01
If-Match *

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

Text požadavku

Následující tabulka popisuje klíčové prvky textu požadavku. Toto jsou jediné vlastnosti, které můžete aktualizovat. Text musí obsahovat úplný popis tématu, i když měníte jenom jednu vlastnost. Doporučený postup je následující:

  1. Získejte popis tématu.

  2. Aktualizujte požadované prvky.

  3. Předejte aktualizovaný popis.

Název vlastnosti Typ Description
DefaultMessageTimeToLive XML Datetime Na základě toho, jestli je povolené nedoručované zprávy, se zpráva v tématu uloží déle, 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 neměnná po vytvoření tématu:

- Rozsah: 1 sekunda – 14 dní.

- Výchozí: 14 dní.
DuplicateDetectionHistoryTimeWindow Časové rozpětí Vlastnost, která určuje časové rozmezí, během kterého služba Service Bus detekuje duplicitu zpráv.

- Rozsah: 1 sekunda – 7 dní.

- Výchozí: 10 minut.
EnableFilteringMessagesBeforePublishing Logická hodnota Vlastnost, která určuje, zda se má použít filtrování před publikováním zprávy. Další informace najdete v tématu EnableFilteringMessagesBeforePublishing.

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ý se zakóduje do "test%3FName%3Dvalue%26"), je generována (401) Neautorizovaná výjimka.

Kód Description
200 Popis tématu se úspěšně aktualizoval.
401 Chyba autorizace.
404 Entita v tomto oboru názvů neexistuje.
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

Pokud je tato operace úspěšná, v textu odpovědi se vrátí aktualizovaný popisovač tématu.

  • Last updated on