Megosztás a következőn keresztül:


Microsoft.EventGrid témakörök 2021-12-01

Bicep-erőforrásdefiníció

A témakörök erőforrástípusa üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.EventGrid/topics erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.

resource symbolicname 'Microsoft.EventGrid/topics@2021-12-01' = {
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    disableLocalAuth: bool
    inboundIpRules: [
      {
        action: 'string'
        ipMask: 'string'
      }
    ]
    inputSchema: 'string'
    inputSchemaMapping: {
      inputSchemaMappingType: 'string'
      // For remaining properties, see InputSchemaMapping objects
    }
    publicNetworkAccess: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

InputSchemaMapping objektumok

Állítsa be az inputSchemaMappingType tulajdonságot az objektum típusának megadásához.

A Jsonesetében használja a következőt:

{
  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'
    }
  }
}

Tulajdonságértékek

IdentityInfo

Név Leírás Érték
principalId Az erőforrás-identitás egyszerű azonosítója. húr
tenantId Az erőforrás bérlőazonosítója. húr
típus A használt felügyelt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolít minden identitást. "Nincs"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek az űrlapon:
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
Ez a tulajdonság jelenleg nincs használatban, és a jövőbeni használatra van fenntartva.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Név Leírás Érték

InboundIpRule

Név Leírás Érték
akció Az IpMask egyezése vagy nem egyezése alapján végrehajtandó művelet. "Engedélyezés"
ipMask IP-cím CIDR-jelölésben, pl. 10.0.0.0/8. húr

InputSchemaMapping

Név Leírás Érték
inputSchemaMappingType A JsonInputSchemaMapping típushoz állítsa be a "Json" értéket. "Json" (kötelező)

JsonField

Név Leírás Érték
sourceField A leképezés forrásaként használni kívánt bemeneti eseményséma egyik mezőjének neve. húr

JsonFieldWithDefault

Név Leírás Érték
defaultValue A leképezéshez használt alapértelmezett érték, ha nincs megadva SourceField, vagy ha a közzétett JSON-esemény hasznos adatai között nincs megadott nevű tulajdonság. húr
sourceField A leképezés forrásaként használni kívánt bemeneti eseményséma egyik mezőjének neve. húr

JsonInputSchemaMapping

Név Leírás Érték
inputSchemaMappingType Az egyéni leképezés típusa "Json" (kötelező)
kellékek A bemeneti séma leképezésének JSON-tulajdonságai JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Név Leírás Érték
dataVersion Az Event Grid-esemény DataVersion tulajdonságának leképezési információi. JsonFieldWithDefault
eventTime Az Event Grid-esemény EventTime tulajdonságának leképezési adatai. JsonField
eventType Az Event Grid-esemény EventType tulajdonságának leképezési adatai. JsonFieldWithDefault
azonosító Az Event Grid-esemény Azonosító tulajdonságának leképezési adatai. JsonField
tárgy Az Event Grid-esemény Tulajdonos tulajdonságának leképezési információi. JsonFieldWithDefault
téma Az Event Grid-esemény Témakör tulajdonságának leképezési információi. JsonField

Microsoft.EventGrid/topics

Név Leírás Érték
azonosság Az erőforrás identitásadatai. IdentityInfo
hely Az erőforrás helye. sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
kellékek A témakör tulajdonságai. TopicProperties
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése

TopicProperties

Név Leírás Érték
disableLocalAuth Ez a logikai érték a helyi hitelesítés engedélyezésére vagy letiltására szolgál. Az alapértelmezett érték hamis. Ha a tulajdonság értéke igaz, a rendszer csak az AAD-jogkivonatot használja a hitelesítéshez, ha a felhasználó közzéteheti a témakört. Bool
inboundIpRules Ez az összes IP-cím helyett az adott IP-címekről érkező forgalom korlátozására használható. Megjegyzés: Ezek csak akkor tekinthetők meg, ha a PublicNetworkAccess engedélyezve van. InboundIpRule[]
inputSchema Ez határozza meg, hogy az Event Grid milyen formátumot várjon a témakörben közzétett bejövő eseményekhez. "CloudEventSchemaV1_0"
'CustomEventSchema'
"EventGridSchema"
inputSchemaMapping Ez lehetővé teszi a közzétételt egyéni eseménysémák használatával. Az InputSchemaMapping paraméterrel leképezhetők a forrásséma különböző tulajdonságai az EventGridEvent séma különböző szükséges tulajdonságaira. InputSchemaMapping
publicNetworkAccess Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van.
Az adott IP-címekre további korlátozást <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />
"Letiltva"
"Engedélyezve"

TrackedResourceTags

Név Leírás Érték

UserIdentityProperties

Név Leírás Érték
clientId A felhasználó által hozzárendelt identitás ügyfélazonosítója. húr
principalId A felhasználó által hozzárendelt identitás egyszerű azonosítója. húr

Használati példák

Azure-ból ellenőrzött modulok

Az alábbi Azure Verified Modules használható az erőforrástípus üzembe helyezéséhez.

Modul Leírás
Event Grid-témakör AVM-erőforrásmodul az Event Grid-témakörhöz

Azure gyorsútmutató-minták

Az alábbi Azure rövid útmutatósablonok bicep-mintákat tartalmaznak az erőforrástípus üzembe helyezéséhez.

Bicep-fájl Leírás
Egyéni Azure Event Grid-témakör és üzenetsor-előfizetés létrehozása Létrehoz egy egyéni Azure Event Grid-témakört és egy service bus-üzenetsor-előfizetést. A sablont eredetileg Markus Meyer készítette.
Egyéni Azure Event Grid-témakör és előfizetési létrehozása Létrehoz egy egyéni Azure Event Grid-témakört és egy webhook-előfizetést. A sablont eredetileg John Downs készítette.

ARM-sablon erőforrásdefiníciója

A témakörök erőforrástípusa üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.EventGrid/topics erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.

{
  "type": "Microsoft.EventGrid/topics",
  "apiVersion": "2021-12-01",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "disableLocalAuth": "bool",
    "inboundIpRules": [
      {
        "action": "string",
        "ipMask": "string"
      }
    ],
    "inputSchema": "string",
    "inputSchemaMapping": {
      "inputSchemaMappingType": "string"
      // For remaining properties, see InputSchemaMapping objects
    },
    "publicNetworkAccess": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

InputSchemaMapping objektumok

Állítsa be az inputSchemaMappingType tulajdonságot az objektum típusának megadásához.

A Jsonesetében használja a következőt:

{
  "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"
    }
  }
}

Tulajdonságértékek

IdentityInfo

Név Leírás Érték
principalId Az erőforrás-identitás egyszerű azonosítója. húr
tenantId Az erőforrás bérlőazonosítója. húr
típus A használt felügyelt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolít minden identitást. "Nincs"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek az űrlapon:
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
Ez a tulajdonság jelenleg nincs használatban, és a jövőbeni használatra van fenntartva.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Név Leírás Érték

InboundIpRule

Név Leírás Érték
akció Az IpMask egyezése vagy nem egyezése alapján végrehajtandó művelet. "Engedélyezés"
ipMask IP-cím CIDR-jelölésben, pl. 10.0.0.0/8. húr

InputSchemaMapping

Név Leírás Érték
inputSchemaMappingType A JsonInputSchemaMapping típushoz állítsa be a "Json" értéket. "Json" (kötelező)

JsonField

Név Leírás Érték
sourceField A leképezés forrásaként használni kívánt bemeneti eseményséma egyik mezőjének neve. húr

JsonFieldWithDefault

Név Leírás Érték
defaultValue A leképezéshez használt alapértelmezett érték, ha nincs megadva SourceField, vagy ha a közzétett JSON-esemény hasznos adatai között nincs megadott nevű tulajdonság. húr
sourceField A leképezés forrásaként használni kívánt bemeneti eseményséma egyik mezőjének neve. húr

JsonInputSchemaMapping

Név Leírás Érték
inputSchemaMappingType Az egyéni leképezés típusa "Json" (kötelező)
kellékek A bemeneti séma leképezésének JSON-tulajdonságai JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Név Leírás Érték
dataVersion Az Event Grid-esemény DataVersion tulajdonságának leképezési információi. JsonFieldWithDefault
eventTime Az Event Grid-esemény EventTime tulajdonságának leképezési adatai. JsonField
eventType Az Event Grid-esemény EventType tulajdonságának leképezési adatai. JsonFieldWithDefault
azonosító Az Event Grid-esemény Azonosító tulajdonságának leképezési adatai. JsonField
tárgy Az Event Grid-esemény Tulajdonos tulajdonságának leképezési információi. JsonFieldWithDefault
téma Az Event Grid-esemény Témakör tulajdonságának leképezési információi. JsonField

Microsoft.EventGrid/topics

Név Leírás Érték
apiVersion Az API verziója '2021-12-01'
azonosság Az erőforrás identitásadatai. IdentityInfo
hely Az erőforrás helye. sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
kellékek A témakör tulajdonságai. TopicProperties
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése
típus Az erőforrás típusa "Microsoft.EventGrid/topics"

TopicProperties

Név Leírás Érték
disableLocalAuth Ez a logikai érték a helyi hitelesítés engedélyezésére vagy letiltására szolgál. Az alapértelmezett érték hamis. Ha a tulajdonság értéke igaz, a rendszer csak az AAD-jogkivonatot használja a hitelesítéshez, ha a felhasználó közzéteheti a témakört. Bool
inboundIpRules Ez az összes IP-cím helyett az adott IP-címekről érkező forgalom korlátozására használható. Megjegyzés: Ezek csak akkor tekinthetők meg, ha a PublicNetworkAccess engedélyezve van. InboundIpRule[]
inputSchema Ez határozza meg, hogy az Event Grid milyen formátumot várjon a témakörben közzétett bejövő eseményekhez. "CloudEventSchemaV1_0"
'CustomEventSchema'
"EventGridSchema"
inputSchemaMapping Ez lehetővé teszi a közzétételt egyéni eseménysémák használatával. Az InputSchemaMapping paraméterrel leképezhetők a forrásséma különböző tulajdonságai az EventGridEvent séma különböző szükséges tulajdonságaira. InputSchemaMapping
publicNetworkAccess Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van.
Az adott IP-címekre további korlátozást <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />
"Letiltva"
"Engedélyezve"

TrackedResourceTags

Név Leírás Érték

UserIdentityProperties

Név Leírás Érték
clientId A felhasználó által hozzárendelt identitás ügyfélazonosítója. húr
principalId A felhasználó által hozzárendelt identitás egyszerű azonosítója. húr

Használati példák

Azure gyorsútmutató-sablonok

Az alábbi Azure rövid útmutatósablonok üzembe helyezni ezt az erőforrástípust.

Sablon Leírás
Egyéni Azure Event Grid-témakör és üzenetsor-előfizetés létrehozása

Üzembe helyezés az Azure
Létrehoz egy egyéni Azure Event Grid-témakört és egy service bus-üzenetsor-előfizetést. A sablont eredetileg Markus Meyer készítette.
Egyéni Azure Event Grid-témakör és előfizetési létrehozása

Üzembe helyezés az Azure
Létrehoz egy egyéni Azure Event Grid-témakört és egy webhook-előfizetést. A sablont eredetileg John Downs készítette.
Egyéni Azure Event Grid-előfizetés létrehozása

Üzembe helyezés az Azure
Egyéni Azure Event Grid-témakört és service bus-előfizetést hoz létre. A sablont eredetileg Markus Meyer készítette.
Event Grid egyéni témakörének és eseményközpont-kezelőjének létrehozása

Üzembe helyezés az Azure
Létrehoz egy egyéni Azure Event Grid-témakört és eseményközpontot az események kezeléséhez.
Egyéni Azure Event Grid-témakör/előfizetés a CloudEvents

Üzembe helyezés az Azure
Létrehoz egy egyéni Azure Event Grid-témakört, egy CloudEvents-sémával rendelkező webhook-előfizetést és egy logikai alkalmazást eseménykezelőként. A sablont eredetileg Justin Yoo készítette.

Terraform (AzAPI-szolgáltató) erőforrásdefiníciója

A témakörök erőforrástípusa üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

  • erőforráscsoportok

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.EventGrid/topics erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/topics@2021-12-01"
  name = "string"
  identity = {
    principalId = "string"
    tenantId = "string"
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      disableLocalAuth = bool
      inboundIpRules = [
        {
          action = "string"
          ipMask = "string"
        }
      ]
      inputSchema = "string"
      inputSchemaMapping = {
        inputSchemaMappingType = "string"
        // For remaining properties, see InputSchemaMapping objects
      }
      publicNetworkAccess = "string"
    }
  })
}

InputSchemaMapping objektumok

Állítsa be az inputSchemaMappingType tulajdonságot az objektum típusának megadásához.

A Jsonesetében használja a következőt:

{
  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"
    }
  }
}

Tulajdonságértékek

IdentityInfo

Név Leírás Érték
principalId Az erőforrás-identitás egyszerű azonosítója. húr
tenantId Az erőforrás bérlőazonosítója. húr
típus A használt felügyelt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolít minden identitást. "Nincs"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek az űrlapon:
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
Ez a tulajdonság jelenleg nincs használatban, és a jövőbeni használatra van fenntartva.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Név Leírás Érték

InboundIpRule

Név Leírás Érték
akció Az IpMask egyezése vagy nem egyezése alapján végrehajtandó művelet. "Engedélyezés"
ipMask IP-cím CIDR-jelölésben, pl. 10.0.0.0/8. húr

InputSchemaMapping

Név Leírás Érték
inputSchemaMappingType A JsonInputSchemaMapping típushoz állítsa be a "Json" értéket. "Json" (kötelező)

JsonField

Név Leírás Érték
sourceField A leképezés forrásaként használni kívánt bemeneti eseményséma egyik mezőjének neve. húr

JsonFieldWithDefault

Név Leírás Érték
defaultValue A leképezéshez használt alapértelmezett érték, ha nincs megadva SourceField, vagy ha a közzétett JSON-esemény hasznos adatai között nincs megadott nevű tulajdonság. húr
sourceField A leképezés forrásaként használni kívánt bemeneti eseményséma egyik mezőjének neve. húr

JsonInputSchemaMapping

Név Leírás Érték
inputSchemaMappingType Az egyéni leképezés típusa "Json" (kötelező)
kellékek A bemeneti séma leképezésének JSON-tulajdonságai JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Név Leírás Érték
dataVersion Az Event Grid-esemény DataVersion tulajdonságának leképezési információi. JsonFieldWithDefault
eventTime Az Event Grid-esemény EventTime tulajdonságának leképezési adatai. JsonField
eventType Az Event Grid-esemény EventType tulajdonságának leképezési adatai. JsonFieldWithDefault
azonosító Az Event Grid-esemény Azonosító tulajdonságának leképezési adatai. JsonField
tárgy Az Event Grid-esemény Tulajdonos tulajdonságának leképezési információi. JsonFieldWithDefault
téma Az Event Grid-esemény Témakör tulajdonságának leképezési információi. JsonField

Microsoft.EventGrid/topics

Név Leírás Érték
azonosság Az erőforrás identitásadatai. IdentityInfo
hely Az erőforrás helye. sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
kellékek A témakör tulajdonságai. TopicProperties
Címkék Erőforráscímkék Címkenevek és -értékek szótára.
típus Az erőforrás típusa "Microsoft.EventGrid/topics@2021-12-01"

TopicProperties

Név Leírás Érték
disableLocalAuth Ez a logikai érték a helyi hitelesítés engedélyezésére vagy letiltására szolgál. Az alapértelmezett érték hamis. Ha a tulajdonság értéke igaz, a rendszer csak az AAD-jogkivonatot használja a hitelesítéshez, ha a felhasználó közzéteheti a témakört. Bool
inboundIpRules Ez az összes IP-cím helyett az adott IP-címekről érkező forgalom korlátozására használható. Megjegyzés: Ezek csak akkor tekinthetők meg, ha a PublicNetworkAccess engedélyezve van. InboundIpRule[]
inputSchema Ez határozza meg, hogy az Event Grid milyen formátumot várjon a témakörben közzétett bejövő eseményekhez. "CloudEventSchemaV1_0"
'CustomEventSchema'
"EventGridSchema"
inputSchemaMapping Ez lehetővé teszi a közzétételt egyéni eseménysémák használatával. Az InputSchemaMapping paraméterrel leképezhetők a forrásséma különböző tulajdonságai az EventGridEvent séma különböző szükséges tulajdonságaira. InputSchemaMapping
publicNetworkAccess Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van.
Az adott IP-címekre további korlátozást <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />
"Letiltva"
"Engedélyezve"

TrackedResourceTags

Név Leírás Érték

UserIdentityProperties

Név Leírás Érték
clientId A felhasználó által hozzárendelt identitás ügyfélazonosítója. húr
principalId A felhasználó által hozzárendelt identitás egyszerű azonosítója. húr