Sdílet prostřednictvím


New-AzEventGridNamespaceTopicEventSubscription

Asynchronně vytvoří nebo aktualizuje odběr událostí tématu oboru názvů se zadanými parametry. Stávající odběry událostí se aktualizují pomocí tohoto rozhraní API.

Syntaxe

New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -NamespaceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -TopicName <String>
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -TopicInputObject <IEventGridIdentity>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -EventSubscriptionName <String>
   -TopicName <String>
   -NamespaceInputObject <IEventGridIdentity>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridNamespaceTopicEventSubscription
   -InputObject <IEventGridIdentity>
   [-DeliveryConfigurationDeliveryMode <String>]
   [-EventDeliverySchema <String>]
   [-FilterConfigurationFilter <IFilter[]>]
   [-FilterConfigurationIncludedEventType <String[]>]
   [-IdentityType <String>]
   [-QueueEventTimeToLive <TimeSpan>]
   [-QueueMaxDeliveryCount <Int32>]
   [-QueueReceiveLockDurationInSecond <Int32>]
   [-UserAssignedIdentity <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Asynchronně vytvoří nebo aktualizuje odběr událostí tématu oboru názvů se zadanými parametry. Stávající odběry událostí se aktualizují pomocí tohoto rozhraní API.

Příklady

Příklad 1: Asynchronní vytvoření odběru události tématu oboru názvů se zadanými parametry

$TimeSpan = New-TimeSpan -Hours 1 -Minutes 25
New-AzEventGridNamespaceTopicEventSubscription -EventSubscriptionName azps-eventsubname -NamespaceName azps-eventgridnamespace -ResourceGroupName azps_test_group_eventgrid -TopicName azps-topic -DeliveryConfigurationDeliveryMode Queue -QueueReceiveLockDurationInSecond 60 -QueueMaxDeliveryCount 4 -QueueEventTimeToLive $TimeSpan -EventDeliverySchema CloudEventSchemaV1_0

Name              ResourceGroupName
----              -----------------
azps-eventsubname azps_test_group_eventgrid

Asynchronní vytvoření odběru události tématu oboru názvů se zadanými parametry Stávající odběry událostí se aktualizují pomocí tohoto rozhraní API.

Parametry

-AsJob

Spuštění příkazu jako úlohy

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.

Typ:PSObject
Aliasy:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DeliveryConfigurationDeliveryMode

Režim doručení odběru události

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EventDeliverySchema

Schéma doručování událostí pro odběr událostí.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EventSubscriptionName

Název odběru události, který se má vytvořit. Názvy odběrů událostí musí mít délku 3 až 100 znaků a musí používat pouze alfanumerická písmena.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FilterConfigurationFilter

Pole filtrů, které se používají k filtrování odběrů událostí.

Typ:IFilter[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FilterConfigurationIncludedEventType

Seznam použitelných typů událostí, které musí být součástí odběru událostí. Pokud se chcete přihlásit k odběru všech výchozích typů událostí, nastavte IncludedEventTypes na hodnotu null.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IdentityType

Typ použité spravované identity. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere jakoukoli identitu.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Parametr identity

Typ:IEventGridIdentity
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-JsonFilePath

Cesta k souboru JSON zadanému pro operaci Vytvoření

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JsonString

Řetězec JSON zadaný pro operaci Vytvoření

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NamespaceInputObject

Parametr identity

Typ:IEventGridIdentity
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NamespaceName

Název oboru názvů.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NoWait

Asynchronní spuštění příkazu

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-QueueEventTimeToLive

Doba trvání trvání ve formátu ISO 8601, která určuje, jak dlouho jsou zprávy k dispozici odběru od doby publikování zprávy. Tato hodnota doby trvání se vyjadřuje pomocí následujícího formátu: "P(n)Y(n)M(n)DT(n)H(n)M(n)S", kde: - (n) se nahradí hodnotou každého časového prvku, který následuje za (n).

  • P je designátor doby trvání (nebo období) a vždy je umístěn na začátku doby trvání.
  • Y je návrh roku a řídí se hodnotou pro počet roků.
  • M je návrh měsíce a řídí se hodnotou pro počet měsíců.
  • W je návrh týdne a řídí se hodnotou počtu týdnů.
  • D je den designátoru a řídí se hodnotou počtu dní.
  • T je návrh času a předchází komponentám času.
  • H je hodinový návrh a řídí se hodnotou pro počet hodin.
  • M je minutový designátor a řídí se hodnotou počtu minut.
  • S je druhý designátor a řídí se hodnotou pro počet sekund. Tuto hodnotu doby trvání nelze nastavit větší než hodnota EventRetentionInDays tématu. Jedná se o volitelné pole, ve kterém je minimální hodnota 1 minuta a její maximum je určeno hodnotou EventRetentionInDays tématu. Tady jsou příklady platných hodnot: - "P0DT23H12M" nebo "PT23H12M": po dobu trvání 23 hodin a 12 minut.
  • "P1D" nebo "P1DT0H0M0S": po dobu trvání 1 dne.
Typ:TimeSpan
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-QueueMaxDeliveryCount

Maximální počet doručení událostí.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-QueueReceiveLockDurationInSecond

Maximální doba v sekundách, kdy je zpráva v přijatém stavu (klientem) a čeká na přijetí, uvolnění nebo odmítnutí. Pokud tento čas uplynul po přijetí zprávy klientem a nepřešel na přijato (nezpracováno), vydáno nebo odmítnuto, je zpráva k dispozici pro opětovné nasazení. Toto je volitelné pole, ve kterém je výchozí hodnota 60 sekund, minimum je 60 sekund a maximum je 300 sekund.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Název skupiny prostředků v rámci předplatného uživatele.

Typ:String
Aliasy:ResourceGroup
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SubscriptionId

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.

Typ:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TopicInputObject

Parametr identity

Typ:IEventGridIdentity
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TopicName

Název tématu oboru názvů

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserAssignedIdentity

Identita uživatele přidružená k prostředku.

Typ:String
Aliasy:IdentityId
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

IEventGridIdentity

Výstupy

ISubscription