ServiceBusRuleManager.CreateRuleAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| CreateRuleAsync(CreateRuleOptions, CancellationToken) |
Přidá do aktuálního předplatného pravidlo pro filtrování zpráv, které se dostanou z tématu do odběru. |
| CreateRuleAsync(String, RuleFilter, CancellationToken) |
Přidá do aktuálního předplatného pravidlo pro filtrování zpráv, které se dostanou z tématu do odběru. |
CreateRuleAsync(CreateRuleOptions, CancellationToken)
Přidá do aktuálního předplatného pravidlo pro filtrování zpráv, které se dostanou z tématu do odběru.
public virtual System.Threading.Tasks.Task CreateRuleAsync (Azure.Messaging.ServiceBus.Administration.CreateRuleOptions options, System.Threading.CancellationToken cancellationToken = default);abstract member CreateRuleAsync : Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateRuleAsync : Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function CreateRuleAsync (options As CreateRuleOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- options
- CreateRuleOptions
Možnosti pro přidání pravidla
- cancellationToken
- CancellationToken
Volitelná CancellationToken instance, která signalizují požadavek na zrušení operace.
Návraty
Instance úlohy, která představuje asynchronní operaci přidání pravidla.
Výjimky
- V rámci předplatného existuje pravidlo se stejným názvem. V Reason tomto případě bude nastavena na MessagingEntityAlreadyExists hodnotu .
- Časový limit operace vypršel. V Reason tomto případě bude nastavena na ServiceTimeout hodnotu .
- Zadaná velikost entity není podporována nebo bylo dosaženo maximální povolené kvóty. Musíte zadat jednu z podporovaných hodnot velikosti, odstranit existující entity nebo zvětšit velikost kvóty. V tomto případě bude důvod selhání nastaven na QuotaExceeded hodnotu .
- Server je zaneprázdněn. Před opakováním operace byste měli počkat. V tomto případě bude důvod selhání nastaven na ServiceBusy hodnotu .
- Dojde k vnitřní chybě nebo neočekávané výjimce. V tomto případě bude důvod selhání nastaven na GeneralError hodnotu .
Poznámky
Do předplatného můžete přidat pravidla, která rozhodují o tom, které zprávy z tématu se mají k odběru dostat. Při vytváření předplatného se vždy přidá výchozí TrueRuleFilter pravidlo s názvem DefaultRuleName . Do stejného předplatného můžete přidat více pravidel s odlišnými názvy. Více filtrů se vzájemně kombinuje pomocí logické podmínky OR. Tj. Pokud je jakýkoliv filtr úspěšný, zpráva se předá do předplatného.
Platí pro
CreateRuleAsync(String, RuleFilter, CancellationToken)
Přidá do aktuálního předplatného pravidlo pro filtrování zpráv, které se dostanou z tématu do odběru.
public virtual System.Threading.Tasks.Task CreateRuleAsync (string ruleName, Azure.Messaging.ServiceBus.Administration.RuleFilter filter, System.Threading.CancellationToken cancellationToken = default);abstract member CreateRuleAsync : string * Azure.Messaging.ServiceBus.Administration.RuleFilter * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateRuleAsync : string * Azure.Messaging.ServiceBus.Administration.RuleFilter * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function CreateRuleAsync (ruleName As String, filter As RuleFilter, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- ruleName
- String
Název pravidla
- filter
- RuleFilter
Výraz filtru, se kterým se zprávy budou shodovat.
- cancellationToken
- CancellationToken
Volitelná CancellationToken instance, která signalizují požadavek na zrušení operace.
Návraty
Instance úlohy, která představuje asynchronní operaci přidání pravidla.
Výjimky
- V rámci předplatného existuje pravidlo se stejným názvem. V Reason tomto případě bude nastavena na MessagingEntityAlreadyExists hodnotu .
- Časový limit operace vypršel. V Reason tomto případě bude nastavena na ServiceTimeout hodnotu .
- Zadaná velikost entity není podporována nebo bylo dosaženo maximální povolené kvóty. Musíte zadat jednu z podporovaných hodnot velikosti, odstranit existující entity nebo zvětšit velikost kvóty. V tomto případě bude důvod selhání nastaven na QuotaExceeded hodnotu .
- Server je zaneprázdněn. Před opakováním operace byste měli počkat. V tomto případě bude důvod selhání nastaven na ServiceBusy hodnotu .
- Dojde k vnitřní chybě nebo neočekávané výjimce. V tomto případě bude důvod selhání nastaven na GeneralError hodnotu .
Poznámky
Do předplatného můžete přidat pravidla, která rozhodují o tom, které zprávy z tématu se mají k odběru dostat. Při vytváření předplatného se vždy přidá výchozí TrueRuleFilter pravidlo s názvem DefaultRuleName . Do stejného předplatného můžete přidat více pravidel s odlišnými názvy. Více filtrů se vzájemně kombinuje pomocí logické podmínky OR. Tj. Pokud je jakýkoliv filtr úspěšný, zpráva se předá do předplatného.