Condividi tramite


Argomenti di Microsoft.EventGrid 2022-06-15

Definizione di risorsa Bicep

Il tipo di risorsa degli argomenti può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.EventGrid/topics, aggiungere il modello Bicep seguente.

resource symbolicname 'Microsoft.EventGrid/topics@2022-06-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  properties: {
    dataResidencyBoundary: 'string'
    disableLocalAuth: bool
    inboundIpRules: [
      {
        action: 'Allow'
        ipMask: 'string'
      }
    ]
    inputSchema: 'string'
    inputSchemaMapping: {
      inputSchemaMappingType: 'string'
      // For remaining properties, see InputSchemaMapping objects
    }
    publicNetworkAccess: 'string'
  }
}

Oggetti InputSchemaMapping

Impostare la proprietà inputSchemaMappingType per specificare il tipo di oggetto.

Per Json, usare:

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

Valori delle proprietà

topics

Nome Descrizione valore
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 3-50

Caratteri validi:
Caratteri alfanumerici e trattini.
posizione Posizione della risorsa. stringa (obbligatoria)
tags Tag della risorsa. Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
identity Informazioni sull'identità per la risorsa. IdentityInfo
properties Proprietà dell'argomento. TopicProperties

IdentityInfo

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. string
TenantId ID tenant della risorsa. string
type Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno id risorsa ARM nel formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Questa proprietà attualmente non viene usata e riservata per l'utilizzo futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome Descrizione Valore
{proprietà personalizzata} UserIdentityProperties

UserIdentityProperties

Nome Descrizione Valore
clientId ID client dell'identità assegnata dall'utente. string
principalId ID principale dell'identità assegnata dall'utente. string

TopicProperties

Nome Descrizione Valore
dataResidencyBoundary Data Residency Limite della risorsa. 'WithinGeopair'
'WithinRegion'
disableLocalAuth Questo valore booleano viene usato per abilitare o disabilitare l'autenticazione locale. Il valore predefinito è false. Quando la proprietà è impostata su true, verrà usato solo il token AAD per l'autenticazione se l'utente è autorizzato a pubblicare nell'argomento. bool
inboundIpRules Questa operazione può essere usata per limitare il traffico da indirizzi IP specifici anziché da tutti gli INDIRIZZI IP. Nota: questi vengono considerati solo se PublicNetworkAccess è abilitato. InboundIpRule[]
inputSchema Questo determina il formato previsto da Griglia di eventi per gli eventi in ingresso pubblicati nell'argomento. 'CloudEventSchemaV1_0'
'CustomEventSchema'
'EventGridSchema'
inputSchemaMapping In questo modo è possibile pubblicare usando schemi eventi personalizzati. È possibile specificare InputSchemaMapping per eseguire il mapping di varie proprietà di uno schema di origine a varie proprietà necessarie dello schema EventGridEvent. InputSchemaMapping
publicNetworkAccess Ciò determina se il traffico è consentito tramite rete pubblica. Per impostazione predefinita, è abilitata.
È possibile limitare ulteriormente gli INDIRIZZI IP specifici configurando {seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /}
'Disabilitato'
'Enabled'

InboundIpRule

Nome Descrizione Valore
azione Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask. 'Allow'
ipMask Indirizzo IP nella notazione CIDR, ad esempio 10.0.0.0.0/8. string

InputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Impostare il tipo di oggetto Json (obbligatorio)

JsonInputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Tipo del mapping personalizzato 'Json' (obbligatorio)
properties Proprietà JSON del mapping dello schema di input JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Nome Descrizione Valore
dataVersion Informazioni di mapping per la proprietà DataVersion dell'evento Griglia di eventi. JsonFieldWithDefault
eventTime Informazioni di mapping per la proprietà EventTime dell'evento Griglia di eventi. JsonField
eventType Informazioni di mapping per la proprietà EventType dell'evento Griglia di eventi. JsonFieldWithDefault
id Informazioni di mapping per la proprietà Id dell'evento Griglia di eventi. JsonField
subject Informazioni di mapping per la proprietà Subject dell'evento Griglia di eventi. JsonFieldWithDefault
argomento Informazioni di mapping per la proprietà Topic dell'evento Griglia di eventi. JsonField

JsonFieldWithDefault

Nome Descrizione Valore
defaultValue Valore predefinito da utilizzare per il mapping quando un oggetto SourceField non viene fornito o se non è presente alcuna proprietà con il nome specificato nel payload dell'evento JSON pubblicato. string
sourceField Nome di un campo nello schema dell'evento di input da usare come origine di un mapping. string

JsonField

Nome Descrizione Valore
sourceField Nome di un campo nello schema dell'evento di input da usare come origine di un mapping. string

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Creare Griglia di eventi di Azure argomento e sottoscrizione personalizzati

Distribuisci in Azure
Crea un argomento personalizzato Griglia di eventi di Azure e una sottoscrizione webhook. Modello originariamente creato da John Downs.
Argomento/sottoscrizione di Griglia di eventi di Azure personalizzato con CloudEvents

Distribuisci in Azure
Crea un argomento Griglia di eventi di Azure personalizzato, una sottoscrizione webhook con schema CloudEvents e un'app per la logica come gestore eventi. Modello originariamente creato da Justin Yoo.
Creare un argomento personalizzato di Griglia di eventi e un gestore dell'hub eventi

Distribuisci in Azure
Crea un Griglia di eventi di Azure argomento personalizzato e hub eventi per gestire gli eventi.
Creare Griglia di eventi di Azure sottoscrizione personalizzata e argomento della coda

Distribuisci in Azure
Crea un argomento personalizzato Griglia di eventi di Azure e una sottoscrizione della coda del bus di servizio. Modello originariamente creato da Markus Meyer.
Creare Griglia di eventi di Azure sottoscrizione di argomenti personalizzati

Distribuisci in Azure
Crea un argomento personalizzato Griglia di eventi di Azure e una sottoscrizione dell'argomento del bus di servizio. Modello originariamente creato da Markus Meyer.

Definizione della risorsa modello di Resource Manager

Il tipo di risorsa degli argomenti può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.EventGrid/topics, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.EventGrid/topics",
  "apiVersion": "2022-06-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "properties": {
    "dataResidencyBoundary": "string",
    "disableLocalAuth": "bool",
    "inboundIpRules": [
      {
        "action": "Allow",
        "ipMask": "string"
      }
    ],
    "inputSchema": "string",
    "inputSchemaMapping": {
      "inputSchemaMappingType": "string"
      // For remaining properties, see InputSchemaMapping objects
    },
    "publicNetworkAccess": "string"
  }
}

Oggetti InputSchemaMapping

Impostare la proprietà inputSchemaMappingType per specificare il tipo di oggetto.

Per Json, usare:

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

Valori delle proprietà

topics

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.EventGrid/topics'
apiVersion Versione dell'API risorsa '2022-06-15'
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 3-50

Caratteri validi:
Caratteri alfanumerici e trattini.
posizione Posizione della risorsa. stringa (obbligatoria)
tags Tag della risorsa. Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
identity Informazioni sull'identità per la risorsa. IdentityInfo
properties Proprietà dell'argomento. TopicProperties

IdentityInfo

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. string
TenantId ID tenant della risorsa. string
type Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno id risorsa ARM nel formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Questa proprietà attualmente non viene usata e riservata per l'utilizzo futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome Descrizione Valore
{proprietà personalizzata} UserIdentityProperties

UserIdentityProperties

Nome Descrizione Valore
clientId ID client dell'identità assegnata dall'utente. string
principalId ID principale dell'identità assegnata dall'utente. string

TopicProperties

Nome Descrizione Valore
dataResidencyBoundary Data Residency Limite della risorsa. 'WithinGeopair'
'WithinRegion'
disableLocalAuth Questo valore booleano viene usato per abilitare o disabilitare l'autenticazione locale. Il valore predefinito è false. Quando la proprietà è impostata su true, verrà usato solo il token AAD per l'autenticazione se l'utente è autorizzato a pubblicare nell'argomento. bool
inboundIpRules Questa operazione può essere usata per limitare il traffico da indirizzi IP specifici anziché da tutti gli INDIRIZZI IP. Nota: questi vengono considerati solo se PublicNetworkAccess è abilitato. InboundIpRule[]
inputSchema Questo determina il formato previsto da Griglia di eventi per gli eventi in ingresso pubblicati nell'argomento. 'CloudEventSchemaV1_0'
'CustomEventSchema'
'EventGridSchema'
inputSchemaMapping In questo modo è possibile pubblicare usando schemi eventi personalizzati. È possibile specificare InputSchemaMapping per eseguire il mapping di varie proprietà di uno schema di origine a varie proprietà necessarie dello schema EventGridEvent. InputSchemaMapping
publicNetworkAccess Ciò determina se il traffico è consentito tramite rete pubblica. Per impostazione predefinita, è abilitata.
È possibile limitare ulteriormente gli INDIRIZZI IP specifici configurando {seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /}
'Disabilitato'
'Enabled'

InboundIpRule

Nome Descrizione Valore
azione Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask. 'Allow'
ipMask Indirizzo IP nella notazione CIDR, ad esempio 10.0.0.0.0/8. string

InputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Impostare il tipo di oggetto Json (obbligatorio)

JsonInputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Tipo del mapping personalizzato 'Json' (obbligatorio)
properties Proprietà JSON del mapping dello schema di input JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Nome Descrizione Valore
dataVersion Informazioni di mapping per la proprietà DataVersion dell'evento Griglia di eventi. JsonFieldWithDefault
eventTime Informazioni di mapping per la proprietà EventTime dell'evento Griglia di eventi. JsonField
eventType Informazioni di mapping per la proprietà EventType dell'evento Griglia di eventi. JsonFieldWithDefault
id Informazioni di mapping per la proprietà Id dell'evento Griglia di eventi. JsonField
subject Informazioni di mapping per la proprietà Subject dell'evento Griglia di eventi. JsonFieldWithDefault
argomento Informazioni di mapping per la proprietà Topic dell'evento Griglia di eventi. JsonField

JsonFieldWithDefault

Nome Descrizione Valore
defaultValue Valore predefinito da utilizzare per il mapping quando un oggetto SourceField non viene fornito o se non è presente alcuna proprietà con il nome specificato nel payload dell'evento JSON pubblicato. string
sourceField Nome di un campo nello schema dell'evento di input da usare come origine di un mapping. string

JsonField

Nome Descrizione Valore
sourceField Nome di un campo nello schema dell'evento di input da usare come origine di un mapping. string

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Creare Griglia di eventi di Azure argomento e sottoscrizione personalizzati

Distribuisci in Azure
Crea un argomento personalizzato Griglia di eventi di Azure e una sottoscrizione webhook. Modello originariamente creato da John Downs.
Argomento/sottoscrizione di Griglia di eventi di Azure personalizzati con CloudEvents

Distribuisci in Azure
Crea un argomento Griglia di eventi di Azure personalizzato, una sottoscrizione webhook con schema CloudEvents e un'app per la logica come gestore eventi. Modello originariamente creato da Justin Yoo.
Creare un argomento personalizzato di Griglia di eventi e un gestore dell'hub eventi

Distribuisci in Azure
Crea un Griglia di eventi di Azure argomento personalizzato e un hub eventi per gestire gli eventi.
Creare Griglia di eventi di Azure sottoscrizione personalizzata di argomenti e code

Distribuisci in Azure
Crea un Griglia di eventi di Azure argomento personalizzato e una sottoscrizione della coda del bus di servizio. Modello originariamente creato da Markus Meyer.
Creare Griglia di eventi di Azure sottoscrizione di argomenti personalizzati

Distribuisci in Azure
Crea un Griglia di eventi di Azure argomento personalizzato e una sottoscrizione dell'argomento del bus di servizio. Modello originariamente creato da Markus Meyer.

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa degli argomenti può essere distribuito con operazioni destinate a:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.EventGrid/topics, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/topics@2022-06-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      dataResidencyBoundary = "string"
      disableLocalAuth = bool
      inboundIpRules = [
        {
          action = "Allow"
          ipMask = "string"
        }
      ]
      inputSchema = "string"
      inputSchemaMapping = {
        inputSchemaMappingType = "string"
        // For remaining properties, see InputSchemaMapping objects
      }
      publicNetworkAccess = "string"
    }
  })
}

Oggetti InputSchemaMapping

Impostare la proprietà inputSchemaMappingType per specificare il tipo di oggetto.

Per Json, usare:

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

Valori delle proprietà

topics

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.EventGrid/topics@2022-06-15"
name Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 3-50

Caratteri validi:
Caratteri alfanumerici e trattini.
posizione Posizione della risorsa. stringa (obbligatorio)
parent_id Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse. stringa (obbligatorio)
tags Tag della risorsa. Dizionario di nomi e valori di tag.
identity Informazioni sull'identità per la risorsa. IdentityInfo
properties Proprietà dell'argomento. Proprietà argomento

IdentityInfo

Nome Descrizione Valore
tipo Tipo di identità gestita usata. Il tipo "SystemAssigned, UserAssigned" include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà qualsiasi identità. "SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
identity_ids Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Questa proprietà non è attualmente utilizzata e riservata per l'utilizzo futuro.
Matrice di ID identità utente.

IdentityInfoUserAssignedIdentities

Nome Descrizione Valore
{proprietà personalizzata} UserIdentityProperties

UserIdentityProperties

Nome Descrizione Valore
clientId ID client dell'identità assegnata dall'utente. string
principalId ID principale dell'identità assegnata dall'utente. string

Proprietà argomento

Nome Descrizione Valore
dataResidencyBoundary Data Residency Limite della risorsa. "WithinGeopair"
"WithinRegion"
disableLocalAuth Questo valore booleano viene usato per abilitare o disabilitare l'autenticazione locale. Il valore predefinito è false. Quando la proprietà è impostata su true, verrà usato solo il token AAD per l'autenticazione se l'utente è autorizzato a pubblicare nell'argomento. bool
inboundIpRules Questa opzione può essere usata per limitare il traffico da indirizzi IP specifici anziché da tutti gli indirizzi IP. Nota: questi vengono considerati solo se PublicNetworkAccess è abilitato. InboundIpRule[]
inputSchema Questo determina il formato previsto da Griglia di eventi per gli eventi in ingresso pubblicati nell'argomento. "CloudEventSchemaV1_0"
"CustomEventSchema"
"EventGridSchema"
inputSchemaMapping Ciò consente la pubblicazione usando schemi di eventi personalizzati. È possibile specificare un oggetto InputSchemaMapping per eseguire il mapping di varie proprietà di uno schema di origine a varie proprietà obbligatorie dello schema EventGridEvent. InputSchemaMapping
publicNetworkAccess Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata.
È possibile limitare ulteriormente gli indirizzi IP specifici configurando {seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /}
"Disabilitato"
"Abilitato"

InboundIpRule

Nome Descrizione Valore
azione Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask. "Consenti"
ipMask Indirizzo IP nella notazione CIDR, ad esempio 10.0.0.0/8. string

InputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Impostare il tipo di oggetto Json (obbligatorio)

JsonInputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Tipo di mapping personalizzato "Json" (obbligatorio)
properties Proprietà JSON del mapping dello schema di input JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Nome Descrizione Valore
dataVersion Informazioni di mapping per la proprietà DataVersion dell'evento di Griglia di eventi. JsonFieldWithDefault
eventTime Informazioni di mapping per la proprietà EventTime dell'evento di Griglia di eventi. JsonField
eventType Informazioni di mapping per la proprietà EventType dell'evento di Griglia di eventi. JsonFieldWithDefault
id Informazioni di mapping per la proprietà Id dell'evento di Griglia di eventi. JsonField
subject Informazioni di mapping per la proprietà Subject dell'evento di Griglia di eventi. JsonFieldWithDefault
argomento Informazioni di mapping per la proprietà Topic dell'evento di Griglia di eventi. JsonField

JsonFieldWithDefault

Nome Descrizione Valore
defaultValue Valore predefinito da usare per il mapping quando un oggetto SourceField non viene specificato o se non è presente alcuna proprietà con il nome specificato nel payload dell'evento JSON pubblicato. string
sourceField Nome di un campo nello schema degli eventi di input da usare come origine di un mapping. string

JsonField

Nome Descrizione Valore
sourceField Nome di un campo nello schema degli eventi di input da usare come origine di un mapping. string