Freigeben über


Microsoft.EventGrid-Themen 2023-06-01-preview

Bicep-Ressourcendefinition

Der Ressourcentyp topics kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

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

Bereitstellen in Azure
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

Bereitstellen in Azure
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

Bereitstellen in Azure
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

Bereitstellen in Azure
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

Bereitstellen in Azure
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:

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

Bereitstellen in Azure
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

Bereitstellen in Azure
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

Bereitstellen in Azure
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

Bereitstellen in Azure
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

Bereitstellen in Azure
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"