Microsoft.EventGrid/topics 2020-06-01 - Bicep, ARM template & Terraform AzAPI reference

Definizione di risorsa Bicep

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

Gruppi di risorse - Vedere i comandi di distribuzione del gruppo 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 modello Bicep seguente.

resource symbolicname 'Microsoft.EventGrid/topics@2020-06-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    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
properties	Proprietà dell'argomento.	TopicProperties

TopicProperties

Nome	Descrizione	Valore
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 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

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	Crea un Griglia di eventi di Azure argomento personalizzato e una sottoscrizione webhook. Modello originariamente creato da John Downs.
Argomento/sottoscrizione di Griglia di eventi di Azure personalizzati con CloudEvents	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	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	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	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 di risorsa del modello di Resource Manager

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

Gruppi di risorse - Vedere i comandi di distribuzione dei 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 JSON seguente al modello.

{
  "type": "Microsoft.EventGrid/topics",
  "apiVersion": "2020-06-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "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 della risorsa	'2020-06-01'
name	Nome della risorsa	stringa (obbligatorio) Limite di caratteri: 3-50 Caratteri validi: Caratteri alfanumerici e trattini.
posizione	Posizione della risorsa.	stringa (obbligatorio)
tags	Tag della risorsa.	Dizionario di nomi e valori di tag. Vedere Tag nei modelli
properties	Proprietà dell'argomento.	Proprietà argomento

Proprietà argomento

Nome	Descrizione	Valore
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' 'Enabled'

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

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	Crea un Griglia di eventi di Azure argomento personalizzato e una sottoscrizione webhook. Modello originariamente creato da John Downs.
Argomento/sottoscrizione di Griglia di eventi di Azure personalizzati con CloudEvents	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	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	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	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 Terraform (provider AzAPI)

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

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 modello terraform seguente.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/topics@2020-06-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      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@2020-06-01"
name	Nome della risorsa	stringa (obbligatoria) Limite di caratteri: 3-50 Caratteri validi: Caratteri alfanumerici e trattini.
posizione	Posizione della risorsa.	stringa (obbligatoria)
parent_id	Per distribuire in un gruppo di risorse, usare l'ID del gruppo di risorse.	stringa (obbligatoria)
tags	Tag della risorsa.	Dizionario dei nomi e dei valori dei tag.
properties	Proprietà dell'argomento.	TopicProperties

TopicProperties

Nome	Descrizione	Valore
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" "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.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 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

Condividi tramite

Argomenti di Microsoft.EventGrid 2020-06-01

Definizione di risorsa Bicep

Formato di risorsa

Oggetti InputSchemaMapping

Valori delle proprietà

topics

TopicProperties

InboundIpRule

InputSchemaMapping

JsonInputSchemaMapping

JsonInputSchemaMappingProperties

JsonFieldWithDefault

JsonField

Modelli di avvio rapido

Definizione di risorsa del modello di Resource Manager

Formato di risorsa

Oggetti InputSchemaMapping

Valori delle proprietà

topics

Proprietà argomento

InboundIpRule

InputSchemaMapping

JsonInputSchemaMapping

JsonInputSchemaMappingProperties

JsonFieldWithDefault

JsonField

Modelli di avvio rapido

Definizione della risorsa Terraform (provider AzAPI)

Formato di risorsa

Oggetti InputSchemaMapping

Valori delle proprietà

topics

TopicProperties

InboundIpRule

InputSchemaMapping

JsonInputSchemaMapping

JsonInputSchemaMappingProperties

JsonFieldWithDefault

JsonField

Commenti e suggerimenti

Risorse aggiuntive