Microsoft.EventGrid-Themen 2023-06-01-preview
- Neueste
- 2023-12-15-preview
- 2023-06-01-preview
- 2022-06-15
- 2021-12-01
- 2021-10-15-preview
- 2021-06-01-preview
- 2020-10-15-preview
- 2020-06-01
- 2020-04-01-preview
- 2020-01-01-preview
- 2019-06-01
- 2019-02-01-preview
- 2019-01-01
- 2018-09-15-preview
- 2018-05-01-preview
- 2018-01-01
- 2017-09-15-preview
- 2017-06-15-preview
Bicep-Ressourcendefinition
Der Ressourcentyp topics kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.EventGrid/topics-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.
resource symbolicname 'Microsoft.EventGrid/topics@2023-06-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
name: 'string'
}
kind: 'string'
extendedLocation: {
name: 'string'
type: 'string'
}
identity: {
principalId: 'string'
tenantId: 'string'
type: 'string'
userAssignedIdentities: {
{customized property}: {
clientId: 'string'
principalId: 'string'
}
}
}
properties: {
dataResidencyBoundary: 'string'
disableLocalAuth: bool
eventTypeInfo: {
inlineEventTypes: {
{customized property}: {
dataSchemaUrl: 'string'
description: 'string'
displayName: 'string'
documentationUrl: 'string'
}
}
kind: 'Inline'
}
inboundIpRules: [
{
action: 'Allow'
ipMask: 'string'
}
]
inputSchema: 'string'
inputSchemaMapping: {
inputSchemaMappingType: 'string'
// For remaining properties, see InputSchemaMapping objects
}
minimumTlsVersionAllowed: 'string'
publicNetworkAccess: 'string'
}
}
InputSchemaMapping-Objekte
Legen Sie die inputSchemaMappingType-Eigenschaft fest, um den Typ des Objekts anzugeben.
Verwenden Sie für Json Folgendes:
inputSchemaMappingType: 'Json'
properties: {
dataVersion: {
defaultValue: 'string'
sourceField: 'string'
}
eventTime: {
sourceField: 'string'
}
eventType: {
defaultValue: 'string'
sourceField: 'string'
}
id: {
sourceField: 'string'
}
subject: {
defaultValue: 'string'
sourceField: 'string'
}
topic: {
sourceField: 'string'
}
}
Eigenschaftswerte
topics
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 3-50 Gültige Zeichen: Alphanumerische Zeichen und Bindestriche. |
| location | Speicherort der Ressource. | Zeichenfolge (erforderlich) |
| tags | Tags der Ressource. | Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen. |
| sku | Der SKU-Tarif für das Thema. | ResourceSku |
| kind | Art der Ressource. | "Azure" "AzureArc" |
| extendedLocation | Erweiterter Speicherort der Ressource. | ExtendedLocation |
| Identität | Identitätsinformationen für die Ressource. | IdentityInfo |
| properties | Eigenschaften des Themas. | TopicProperties |
ExtendedLocation
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| name | Vollqualifizierter Name des erweiterten Speicherorts. | Zeichenfolge |
| type | Typ des erweiterten Standorts. | Zeichenfolge |
IdentityInfo
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| principalId | Die Prinzipal-ID der Ressourcenidentität. | Zeichenfolge |
| tenantId | Die Mandanten-ID der Ressource. | Zeichenfolge |
| type | Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" umfasst sowohl eine implizit erstellte Identität als auch eine Reihe von benutzerseitig zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten. | "Keine" "SystemAssigned" 'SystemAssigned, UserAssigned' "UserAssigned" |
| userAssignedIdentities | Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Verweise auf das Benutzeridentitätswörterbuch sind ARM-Ressourcen-IDs im Format: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Diese Eigenschaft wird derzeit nicht verwendet und für die zukünftige Verwendung reserviert. |
IdentityInfoUserAssignedIdentities |
IdentityInfoUserAssignedIdentities
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| {angepasste Eigenschaft} | UserIdentityProperties |
UserIdentityProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| clientId | Die Client-ID der benutzerseitig zugewiesenen Identität. | Zeichenfolge |
| principalId | Die Prinzipal-ID der benutzerseitig zugewiesenen Identität. | Zeichenfolge |
TopicProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| dataResidencyBoundary | Data Residency Begrenzung der Ressource. | "WithinGeopair" "InnerhalbRegion" |
| disableLocalAuth | Dieser boolesche Wert wird verwendet, um die lokale Authentifizierung zu aktivieren oder zu deaktivieren. Der Standardwert ist false. Wenn die Eigenschaft auf true festgelegt ist, wird nur das AAD-Token für die Authentifizierung verwendet, wenn der Benutzer die Veröffentlichung im Thema zulassen kann. | bool |
| eventTypeInfo | Ereignistypinformationen für das Benutzerthema. Diese Informationen werden vom Herausgeber bereitgestellt und können vom Abonnent, um verschiedene Arten von Ereignissen anzuzeigen, die veröffentlicht werden. |
EventTypeInfo |
| inboundIpRules | Dies kann verwendet werden, um den Datenverkehr von bestimmten IP-Adressen anstelle aller IP-Adressen einzuschränken. Hinweis: Diese werden nur berücksichtigt, wenn PublicNetworkAccess aktiviert ist. | InboundIpRule[] |
| inputSchema | Dadurch wird das Format bestimmt, das Event Grid für eingehende Ereignisse erwarten sollte, die im Thema veröffentlicht werden. | "CloudEventSchemaV1_0" 'CustomEventSchema' 'EventGridSchema' |
| inputSchemaMapping | Dies ermöglicht die Veröffentlichung mithilfe benutzerdefinierter Ereignisschemas. Ein InputSchemaMapping kann angegeben werden, um verschiedene Eigenschaften eines Quellschemas verschiedenen erforderlichen Eigenschaften des EventGridEvent-Schemas zuzuordnen. | InputSchemaMapping |
| minimumTlsVersionAllowed | Minimale TLS-Version des Herausgebers, die in diesem Thema veröffentlicht werden darf | 1.0 '1.1' '1.2' |
| publicNetworkAccess | Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist es aktiviert. Sie können weitere Einschränkungen auf bestimmte IP-Adressen durchführen, indem Sie {seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /} konfigurieren. |
"Deaktiviert" "Aktiviert" |
EventTypeInfo
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| inlineEventTypes | Eine Auflistung von Inlineereignistypen für die Ressource. Die Schlüssel des Inlineereignistyps sind vom Typ Zeichenfolge, die den Namen des Ereignisses darstellt. Ein Beispiel für einen gültigen Inlineereignisnamen ist "Contoso.OrderCreated". Die Werte des Inlineereignistyps sind vom Typ InlineEventProperties und enthalten zusätzliche Informationen für jeden Inlineereignistyp. |
EventTypeInfoInlineEventTypes |
| kind | Die Art des verwendeten Ereignistyps. | "Inline" |
EventTypeInfoInlineEventTypes
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| {angepasste Eigenschaft} | InlineEventProperties |
InlineEventProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| dataSchemaUrl | Das dataSchemaUrl für das Inlineereignis. | Zeichenfolge |
| description | Die Beschreibung für das Inlineereignis. | Zeichenfolge |
| displayName | Der displayName für das Inlineereignis. | Zeichenfolge |
| documentationUrl | Die documentationUrl für das Inlineereignis. | Zeichenfolge |
InboundIpRule
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| action | Aktion, die basierend auf der Übereinstimmung oder keine Übereinstimmung der IpMask ausgeführt werden soll. | "Zulassen" |
| ipMask | IP-Adresse in CIDR-Notation, z. B. 10.0.0.0/8. | Zeichenfolge |
InputSchemaMapping
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| inputSchemaMappingType | Festlegen des Objekttyps | JSON ( erforderlich) |
JsonInputSchemaMapping
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| inputSchemaMappingType | Typ der benutzerdefinierten Zuordnung | "Json" (erforderlich) |
| properties | JSON-Eigenschaften der Eingabeschemazuordnung | JsonInputSchemaMappingProperties |
JsonInputSchemaMappingProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| dataVersion | Die Zuordnungsinformationen für die DataVersion-Eigenschaft des Event Grid-Ereignisses. | JsonFieldWithDefault |
| eventTime | Die Zuordnungsinformationen für die EventTime-Eigenschaft des Event Grid-Ereignisses. | JsonField |
| eventType | Die Zuordnungsinformationen für die EventType-Eigenschaft des Event Grid-Ereignisses. | JsonFieldWithDefault |
| id | Die Zuordnungsinformationen für die Id-Eigenschaft des Event Grid-Ereignisses. | JsonField |
| subject | Die Zuordnungsinformationen für die Subject-Eigenschaft des Event Grid-Ereignisses. | JsonFieldWithDefault |
| topic | Die Zuordnungsinformationen für die Topic-Eigenschaft des Event Grid-Ereignisses. | JsonField |
JsonFieldWithDefault
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| defaultValue | Der Standardwert, der für die Zuordnung verwendet werden soll, wenn kein SourceField-Objekt angegeben wird oder wenn keine Eigenschaft mit dem angegebenen Namen in der veröffentlichten JSON-Ereignisnutzlast vorhanden ist. | Zeichenfolge |
| sourceField | Name eines Felds im Eingabeereignisschema, das als Quelle einer Zuordnung verwendet werden soll. | Zeichenfolge |
JsonField
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| sourceField | Name eines Felds im Eingabeereignisschema, das als Quelle einer Zuordnung verwendet werden soll. | Zeichenfolge |
ResourceSku
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| name | Der SKU-Name der Ressource. Die möglichen Werte sind: Basic oder Premium. | "Basic" "Premium" |
Schnellstartvorlagen
Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.
| Vorlage | BESCHREIBUNG |
|---|---|
Erstellen Azure Event Grid benutzerdefinierten Themas und Abonnements |
Erstellt ein Azure Event Grid benutzerdefiniertes Thema und ein Webhookabonnement. Vorlage, die ursprünglich von John Downs erstellt wurde. |
| Benutzerdefiniertes Azure Event Grid Thema/Abonnement mit CloudEvents |
Erstellt ein benutzerdefiniertes Azure Event Grid Thema, ein Webhookabonnement mit CloudEvents-Schema und eine Logik-App als Ereignishandler. Vorlage, die ursprünglich von Justin Yoo erstellt wurde. |
| Erstellen eines benutzerdefinierten Event Grid-Themas und eines Event Hub-Handlers |
Erstellt ein Azure Event Grid benutzerdefinierten Thema und Event Hub, um die Ereignisse zu behandeln. |
| Erstellen eines Azure Event Grid benutzerdefinierten Themas und eines Warteschlangenabonnements |
Erstellt ein Azure Event Grid benutzerdefiniertes Thema und ein Service Bus-Warteschlangenabonnement. Vorlage ursprünglich von Markus Meyer erstellt. |
| Erstellen eines Azure Event Grid benutzerdefinierten Themenabonnements |
Erstellt ein Azure Event Grid benutzerdefiniertes Thema und ein Service Bus-Themenabonnement. Vorlage ursprünglich von Markus Meyer erstellt. |
Ressourcendefinition mit einer ARM-Vorlage
Der Ressourcentyp "topics" kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:
- Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.EventGrid/topics-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.EventGrid/topics",
"apiVersion": "2023-06-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"name": "string"
},
"kind": "string",
"extendedLocation": {
"name": "string",
"type": "string"
},
"identity": {
"principalId": "string",
"tenantId": "string",
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
"clientId": "string",
"principalId": "string"
}
}
},
"properties": {
"dataResidencyBoundary": "string",
"disableLocalAuth": "bool",
"eventTypeInfo": {
"inlineEventTypes": {
"{customized property}": {
"dataSchemaUrl": "string",
"description": "string",
"displayName": "string",
"documentationUrl": "string"
}
},
"kind": "Inline"
},
"inboundIpRules": [
{
"action": "Allow",
"ipMask": "string"
}
],
"inputSchema": "string",
"inputSchemaMapping": {
"inputSchemaMappingType": "string"
// For remaining properties, see InputSchemaMapping objects
},
"minimumTlsVersionAllowed": "string",
"publicNetworkAccess": "string"
}
}
InputSchemaMapping-Objekte
Legen Sie die inputSchemaMappingType-Eigenschaft fest, um den Typ des Objekts anzugeben.
Verwenden Sie für Json Folgendes:
"inputSchemaMappingType": "Json",
"properties": {
"dataVersion": {
"defaultValue": "string",
"sourceField": "string"
},
"eventTime": {
"sourceField": "string"
},
"eventType": {
"defaultValue": "string",
"sourceField": "string"
},
"id": {
"sourceField": "string"
},
"subject": {
"defaultValue": "string",
"sourceField": "string"
},
"topic": {
"sourceField": "string"
}
}
Eigenschaftswerte
topics
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| type | Ressourcentyp | "Microsoft.EventGrid/topics" |
| apiVersion | Die Ressourcen-API-Version | '2023-06-01-preview' |
| name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 3-50 Gültige Zeichen: Alphanumerische Zeichen und Bindestriche. |
| location | Speicherort der Ressource. | Zeichenfolge (erforderlich) |
| tags | Tags der Ressource. | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| sku | Der Sku-Tarif für das Thema. | ResourceSku |
| kind | Art der Ressource. | "Azure" "AzureArc" |
| extendedLocation | Erweiterter Speicherort der Ressource. | ExtendedLocation |
| Identität | Identitätsinformationen für die Ressource. | IdentityInfo |
| properties | Eigenschaften des Themas. | TopicProperties |
ExtendedLocation
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| name | Vollqualifizierter Name des erweiterten Speicherorts. | Zeichenfolge |
| type | Typ des erweiterten Speicherorts. | Zeichenfolge |
IdentityInfo
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| principalId | Die Prinzipal-ID der Ressourcenidentität. | Zeichenfolge |
| tenantId | Die Mandanten-ID der Ressource. | Zeichenfolge |
| type | Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe benutzerseitig zugewiesener Identitäten. Der Typ "None" entfernt jede Identität. | "Keine" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
| userAssignedIdentities | Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Schlüsselverweise des Benutzeridentitätswörterbuchs sind ARM-Ressourcen-IDs in der Form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Diese Eigenschaft wird derzeit nicht verwendet und für die zukünftige Verwendung reserviert. |
IdentityInfoUserAssignedIdentities |
IdentityInfoUserAssignedIdentities
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| {angepasste Eigenschaft} | UserIdentityProperties |
UserIdentityProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| clientId | Die Client-ID der benutzerseitig zugewiesenen Identität. | Zeichenfolge |
| principalId | Die Prinzipal-ID der benutzerseitig zugewiesenen Identität. | Zeichenfolge |
TopicProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| dataResidencyBoundary | Data Residency Begrenzung der Ressource. | "WithinGeopair" "InnerhalbRegion" |
| disableLocalAuth | Dieser boolesche Wert wird verwendet, um die lokale Authentifizierung zu aktivieren oder zu deaktivieren. Der Standardwert ist false. Wenn die Eigenschaft auf true festgelegt ist, wird nur das AAD-Token für die Authentifizierung verwendet, wenn der Benutzer die Veröffentlichung im Thema zulassen kann. | bool |
| eventTypeInfo | Ereignistypinformationen für das Benutzerthema. Diese Informationen werden vom Herausgeber bereitgestellt und können vom Abonnent, um verschiedene Arten von Ereignissen anzuzeigen, die veröffentlicht werden. |
EventTypeInfo |
| inboundIpRules | Dies kann verwendet werden, um den Datenverkehr von bestimmten IP-Adressen anstelle aller IP-Adressen einzuschränken. Hinweis: Diese werden nur berücksichtigt, wenn PublicNetworkAccess aktiviert ist. | InboundIpRule[] |
| inputSchema | Dadurch wird das Format bestimmt, das Event Grid für eingehende Ereignisse erwarten sollte, die im Thema veröffentlicht werden. | "CloudEventSchemaV1_0" 'CustomEventSchema' 'EventGridSchema' |
| inputSchemaMapping | Dies ermöglicht die Veröffentlichung mithilfe benutzerdefinierter Ereignisschemas. Ein InputSchemaMapping kann angegeben werden, um verschiedene Eigenschaften eines Quellschemas verschiedenen erforderlichen Eigenschaften des EventGridEvent-Schemas zuzuordnen. | InputSchemaMapping |
| minimumTlsVersionAllowed | Minimale TLS-Version des Herausgebers, die in diesem Thema veröffentlicht werden darf | 1.0 '1.1' '1.2' |
| publicNetworkAccess | Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist es aktiviert. Sie können weitere Einschränkungen auf bestimmte IP-Adressen durchführen, indem Sie {seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /} konfigurieren. |
"Deaktiviert" "Aktiviert" |
EventTypeInfo
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| inlineEventTypes | Eine Auflistung von Inlineereignistypen für die Ressource. Die Schlüssel des Inlineereignistyps sind vom Typ Zeichenfolge, die den Namen des Ereignisses darstellt. Ein Beispiel für einen gültigen Inlineereignisnamen ist "Contoso.OrderCreated". Die Werte des Inlineereignistyps sind vom Typ InlineEventProperties und enthalten zusätzliche Informationen für jeden Inlineereignistyp. |
EventTypeInfoInlineEventTypes |
| kind | Die Art des verwendeten Ereignistyps. | "Inline" |
EventTypeInfoInlineEventTypes
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| {angepasste Eigenschaft} | InlineEventProperties |
InlineEventProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| dataSchemaUrl | Das dataSchemaUrl für das Inlineereignis. | Zeichenfolge |
| description | Die Beschreibung für das Inlineereignis. | Zeichenfolge |
| displayName | Der displayName für das Inlineereignis. | Zeichenfolge |
| documentationUrl | Die documentationUrl für das Inlineereignis. | Zeichenfolge |
InboundIpRule
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| action | Aktion, die basierend auf der Übereinstimmung oder keine Übereinstimmung der IpMask ausgeführt werden soll. | "Zulassen" |
| ipMask | IP-Adresse in CIDR-Notation, z. B. 10.0.0.0/8. | Zeichenfolge |
InputSchemaMapping
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| inputSchemaMappingType | Festlegen des Objekttyps | JSON ( erforderlich) |
JsonInputSchemaMapping
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| inputSchemaMappingType | Typ der benutzerdefinierten Zuordnung | "Json" (erforderlich) |
| properties | JSON-Eigenschaften der Eingabeschemazuordnung | JsonInputSchemaMappingProperties |
JsonInputSchemaMappingProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| dataVersion | Die Zuordnungsinformationen für die DataVersion-Eigenschaft des Event Grid-Ereignisses. | JsonFieldWithDefault |
| eventTime | Die Zuordnungsinformationen für die EventTime-Eigenschaft des Event Grid-Ereignisses. | JsonField |
| eventType | Die Zuordnungsinformationen für die EventType-Eigenschaft des Event Grid-Ereignisses. | JsonFieldWithDefault |
| id | Die Zuordnungsinformationen für die Id-Eigenschaft des Event Grid-Ereignisses. | JsonField |
| subject | Die Zuordnungsinformationen für die Subject-Eigenschaft des Event Grid-Ereignisses. | JsonFieldWithDefault |
| topic | Die Zuordnungsinformationen für die Topic-Eigenschaft des Event Grid-Ereignisses. | JsonField |
JsonFieldWithDefault
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| defaultValue | Der Standardwert, der für die Zuordnung verwendet werden soll, wenn kein SourceField-Objekt angegeben wird oder wenn keine Eigenschaft mit dem angegebenen Namen in der veröffentlichten JSON-Ereignisnutzlast vorhanden ist. | Zeichenfolge |
| sourceField | Name eines Felds im Eingabeereignisschema, das als Quelle einer Zuordnung verwendet werden soll. | Zeichenfolge |
JsonField
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| sourceField | Name eines Felds im Eingabeereignisschema, das als Quelle einer Zuordnung verwendet werden soll. | Zeichenfolge |
ResourceSku
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| name | Der SKU-Name der Ressource. Die möglichen Werte sind: Basic oder Premium. | "Basic" "Premium" |
Schnellstartvorlagen
Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.
| Vorlage | BESCHREIBUNG |
|---|---|
| Erstellen Azure Event Grid benutzerdefinierten Themas und Abonnements |
Erstellt ein Azure Event Grid benutzerdefiniertes Thema und ein Webhookabonnement. Vorlage, die ursprünglich von John Downs erstellt wurde. |
| Benutzerdefiniertes Azure Event Grid Thema/Abonnement mit CloudEvents |
Erstellt ein benutzerdefiniertes Azure Event Grid Thema, ein Webhookabonnement mit CloudEvents-Schema und eine Logik-App als Ereignishandler. Vorlage, die ursprünglich von Justin Yoo erstellt wurde. |
| Erstellen eines benutzerdefinierten Event Grid-Themas und eines Event Hub-Handlers |
Erstellt ein Azure Event Grid benutzerdefinierten Thema und Event Hub, um die Ereignisse zu behandeln. |
| Erstellen eines Azure Event Grid benutzerdefinierten Themas und eines Warteschlangenabonnements |
Erstellt ein Azure Event Grid benutzerdefiniertes Thema und ein Service Bus-Warteschlangenabonnement. Vorlage ursprünglich von Markus Meyer erstellt. |
| Erstellen eines Azure Event Grid benutzerdefinierten Themenabonnements |
Erstellt ein Azure Event Grid benutzerdefiniertes Thema und ein Service Bus-Themenabonnement. Vorlage ursprünglich von Markus Meyer erstellt. |
Terraform (AzAPI-Anbieter) Ressourcendefinition
Der Ressourcentyp "topics" kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.EventGrid/topics-Ressource zu erstellen, fügen Sie Der Vorlage die folgende Terraform-Ressource hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.EventGrid/topics@2023-06-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
dataResidencyBoundary = "string"
disableLocalAuth = bool
eventTypeInfo = {
inlineEventTypes = {
{customized property} = {
dataSchemaUrl = "string"
description = "string"
displayName = "string"
documentationUrl = "string"
}
}
kind = "Inline"
}
inboundIpRules = [
{
action = "Allow"
ipMask = "string"
}
]
inputSchema = "string"
inputSchemaMapping = {
inputSchemaMappingType = "string"
// For remaining properties, see InputSchemaMapping objects
}
minimumTlsVersionAllowed = "string"
publicNetworkAccess = "string"
}
sku = {
name = "string"
}
kind = "string"
extendedLocation = {
name = "string"
type = "string"
}
})
}
InputSchemaMapping-Objekte
Legen Sie die inputSchemaMappingType-Eigenschaft fest, um den Typ des Objekts anzugeben.
Verwenden Sie für Json Folgendes:
inputSchemaMappingType = "Json"
properties = {
dataVersion = {
defaultValue = "string"
sourceField = "string"
}
eventTime = {
sourceField = "string"
}
eventType = {
defaultValue = "string"
sourceField = "string"
}
id = {
sourceField = "string"
}
subject = {
defaultValue = "string"
sourceField = "string"
}
topic = {
sourceField = "string"
}
}
Eigenschaftswerte
topics
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| type | Ressourcentyp | "Microsoft.EventGrid/topics@2023-06-01-preview" |
| name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 3-50 Gültige Zeichen: Alphanumerische Zeichen und Bindestriche. |
| location | Speicherort der Ressource. | Zeichenfolge (erforderlich) |
| parent_id | Verwenden Sie zum Bereitstellen in einer Ressourcengruppe die ID dieser Ressourcengruppe. | Zeichenfolge (erforderlich) |
| tags | Tags der Ressource. | Wörterbuch der Tagnamen und -werte. |
| sku | Der Sku-Tarif für das Thema. | ResourceSku |
| kind | Art der Ressource. | "Azure" "AzureArc" |
| extendedLocation | Erweiterter Speicherort der Ressource. | ExtendedLocation |
| Identität | Identitätsinformationen für die Ressource. | IdentityInfo |
| properties | Eigenschaften des Themas. | TopicProperties |
ExtendedLocation
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| name | Vollqualifizierter Name des erweiterten Speicherorts. | Zeichenfolge |
| type | Typ des erweiterten Speicherorts. | Zeichenfolge |
IdentityInfo
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| type | Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe benutzerseitig zugewiesener Identitäten. Der Typ "None" entfernt jede Identität. | "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
| identity_ids | Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Schlüsselverweise des Benutzeridentitätswörterbuchs sind ARM-Ressourcen-IDs in der Form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Diese Eigenschaft wird derzeit nicht verwendet und für die zukünftige Verwendung reserviert. |
Array von Benutzeridentitäts-IDs. |
IdentityInfoUserAssignedIdentities
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| {angepasste Eigenschaft} | UserIdentityProperties |
UserIdentityProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| clientId | Die Client-ID der benutzerseitig zugewiesenen Identität. | Zeichenfolge |
| principalId | Die Prinzipal-ID der benutzerseitig zugewiesenen Identität. | Zeichenfolge |
TopicProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| dataResidencyBoundary | Data Residency Begrenzung der Ressource. | "WithinGeopair" "WithinRegion" |
| disableLocalAuth | Dieser boolesche Wert wird verwendet, um die lokale Authentifizierung zu aktivieren oder zu deaktivieren. Der Standardwert ist false. Wenn die Eigenschaft auf true festgelegt ist, wird nur das AAD-Token für die Authentifizierung verwendet, wenn der Benutzer die Veröffentlichung im Thema zulassen kann. | bool |
| eventTypeInfo | Ereignistypinformationen für das Benutzerthema. Diese Informationen werden vom Herausgeber bereitgestellt und können vom Abonnent, um verschiedene Arten von Ereignissen anzuzeigen, die veröffentlicht werden. |
EventTypeInfo |
| inboundIpRules | Dies kann verwendet werden, um den Datenverkehr von bestimmten IP-Adressen anstelle aller IP-Adressen einzuschränken. Hinweis: Diese werden nur berücksichtigt, wenn PublicNetworkAccess aktiviert ist. | InboundIpRule[] |
| inputSchema | Dadurch wird das Format bestimmt, das Event Grid für eingehende Ereignisse erwarten sollte, die im Thema veröffentlicht werden. | "CloudEventSchemaV1_0" "CustomEventSchema" "EventGridSchema" |
| inputSchemaMapping | Dies ermöglicht die Veröffentlichung mithilfe benutzerdefinierter Ereignisschemas. Ein InputSchemaMapping kann angegeben werden, um verschiedene Eigenschaften eines Quellschemas verschiedenen erforderlichen Eigenschaften des EventGridEvent-Schemas zuzuordnen. | InputSchemaMapping |
| minimumTlsVersionAllowed | Minimale TLS-Version des Herausgebers, die in diesem Thema veröffentlicht werden darf | "1.0" "1.1" "1.2" |
| publicNetworkAccess | Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist es aktiviert. Sie können weitere Einschränkungen auf bestimmte IP-Adressen durchführen, indem Sie {seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /} konfigurieren. |
"Deaktiviert" "Aktiviert" |
EventTypeInfo
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| inlineEventTypes | Eine Auflistung von Inlineereignistypen für die Ressource. Die Schlüssel des Inlineereignistyps sind vom Typ Zeichenfolge, die den Namen des Ereignisses darstellt. Ein Beispiel für einen gültigen Inlineereignisnamen ist "Contoso.OrderCreated". Die Werte des Inlineereignistyps sind vom Typ InlineEventProperties und enthalten zusätzliche Informationen für jeden Inlineereignistyp. |
EventTypeInfoInlineEventTypes |
| kind | Die Art des verwendeten Ereignistyps. | "Inline" |
EventTypeInfoInlineEventTypes
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| {angepasste Eigenschaft} | InlineEventProperties |
InlineEventProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| dataSchemaUrl | Das dataSchemaUrl für das Inlineereignis. | Zeichenfolge |
| description | Die Beschreibung für das Inlineereignis. | Zeichenfolge |
| displayName | Der displayName für das Inlineereignis. | Zeichenfolge |
| documentationUrl | Die documentationUrl für das Inlineereignis. | Zeichenfolge |
InboundIpRule
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| action | Aktion, die basierend auf der Übereinstimmung oder keine Übereinstimmung der IpMask ausgeführt werden soll. | "Zulassen" |
| ipMask | IP-Adresse in CIDR-Notation, z. B. 10.0.0.0/8. | Zeichenfolge |
InputSchemaMapping
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| inputSchemaMappingType | Festlegen des Objekttyps | JSON ( erforderlich) |
JsonInputSchemaMapping
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| inputSchemaMappingType | Typ der benutzerdefinierten Zuordnung | "Json" (erforderlich) |
| properties | JSON-Eigenschaften der Eingabeschemazuordnung | JsonInputSchemaMappingProperties |
JsonInputSchemaMappingProperties
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| dataVersion | Die Zuordnungsinformationen für die DataVersion-Eigenschaft des Event Grid-Ereignisses. | JsonFieldWithDefault |
| eventTime | Die Zuordnungsinformationen für die EventTime-Eigenschaft des Event Grid-Ereignisses. | JsonField |
| eventType | Die Zuordnungsinformationen für die EventType-Eigenschaft des Event Grid-Ereignisses. | JsonFieldWithDefault |
| id | Die Zuordnungsinformationen für die Id-Eigenschaft des Event Grid-Ereignisses. | JsonField |
| subject | Die Zuordnungsinformationen für die Subject-Eigenschaft des Event Grid-Ereignisses. | JsonFieldWithDefault |
| topic | Die Zuordnungsinformationen für die Topic-Eigenschaft des Event Grid-Ereignisses. | JsonField |
JsonFieldWithDefault
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| defaultValue | Der Standardwert, der für die Zuordnung verwendet werden soll, wenn kein SourceField-Objekt angegeben wird oder wenn keine Eigenschaft mit dem angegebenen Namen in der veröffentlichten JSON-Ereignisnutzlast vorhanden ist. | Zeichenfolge |
| sourceField | Name eines Felds im Eingabeereignisschema, das als Quelle einer Zuordnung verwendet werden soll. | Zeichenfolge |
JsonField
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| sourceField | Name eines Felds im Eingabeereignisschema, das als Quelle einer Zuordnung verwendet werden soll. | Zeichenfolge |
ResourceSku
| Name | BESCHREIBUNG | Wert |
|---|---|---|
| name | Der SKU-Name der Ressource. Die möglichen Werte sind: Basic oder Premium. | „Basic“ "Premium" |