Condividi tramite


Argomenti di Microsoft.EventGrid 2021-10-15-preview

Definizione di risorsa Bicep

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

  • 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 risorsa

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

resource symbolicname 'Microsoft.EventGrid/topics@2021-10-15-preview' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    dataResidencyBoundary: 'string'
    disableLocalAuth: bool
    inboundIpRules: [
      {
        action: 'string'
        ipMask: 'string'
      }
    ]
    inputSchema: 'string'
    inputSchemaMapping: {
      inputSchemaMappingType: 'string'
      // For remaining properties, see InputSchemaMapping objects
    }
    publicNetworkAccess: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: '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à

ExtendedLocation

Nome Descrizione Valore
nome Nome completo della posizione estesa. corda
digitare Tipo della posizione estesa. corda

IdentityInfo

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. corda
tenantId ID tenant della risorsa. corda
digitare 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 di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno gli 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.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome Descrizione Valore

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. corda

InputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Impostare su "Json" per il tipo JsonInputSchemaMapping. 'Json' (obbligatorio)

JsonField

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

JsonFieldWithDefault

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

JsonInputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Tipo del mapping personalizzato 'Json' (obbligatorio)
proprietà 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
Oggetto 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

Microsoft.EventGrid/topics

Nome Descrizione Valore
extendedLocation Posizione estesa della risorsa. ExtendedLocation
identità Informazioni sull'identità per la risorsa. IdentityInfo
gentile Tipo di risorsa. 'Azure'
'AzureArc'
ubicazione Posizione della risorsa. stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà dell'argomento. TopicProperties
Sku Piano tariffario sku per l'argomento. resourceSku
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

ResourceSku

Nome Descrizione Valore
nome Nome sku della risorsa. I valori possibili sono: Basic o Premium. 'Basic'
'Premium'

Proprietà argomenti

Nome Descrizione Valore
dataResidencyBoundary Limite di residenza dei dati 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 Può essere usato 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 di eventi personalizzati. È possibile specificare un inputSchemaMapping per eseguire il mapping di varie proprietà di uno schema di origine a varie proprietà necessarie dello schema EventGridEvent. InputSchemaMapping
publicNetworkAccess Determina se il traffico è consentito in 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'

TrackedResourceTags

Nome Descrizione Valore

UserIdentityProperties

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

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File Descrizione
Creare un argomento personalizzato e una sottoscrizione della coda di Griglia di eventi di Azure Crea un argomento personalizzato di Griglia di eventi di Azure e una sottoscrizione della coda del bus di servizio. Modello originariamente creato da Markus Meyer.
Creare un argomento personalizzato e una sottoscrizione di Griglia di eventi di Azure Crea un argomento personalizzato di Griglia di eventi di Azure e una sottoscrizione webhook. Modello originariamente creato da John Downs.

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 del gruppo di risorse

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

Formato risorsa

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

{
  "type": "Microsoft.EventGrid/topics",
  "apiVersion": "2021-10-15-preview",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "dataResidencyBoundary": "string",
    "disableLocalAuth": "bool",
    "inboundIpRules": [
      {
        "action": "string",
        "ipMask": "string"
      }
    ],
    "inputSchema": "string",
    "inputSchemaMapping": {
      "inputSchemaMappingType": "string"
      // For remaining properties, see InputSchemaMapping objects
    },
    "publicNetworkAccess": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "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à

ExtendedLocation

Nome Descrizione Valore
nome Nome completo della posizione estesa. corda
digitare Tipo della posizione estesa. corda

IdentityInfo

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. corda
tenantId ID tenant della risorsa. corda
digitare 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 di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno gli 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.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome Descrizione Valore

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. corda

InputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Impostare su "Json" per il tipo JsonInputSchemaMapping. 'Json' (obbligatorio)

JsonField

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

JsonFieldWithDefault

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

JsonInputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Tipo del mapping personalizzato 'Json' (obbligatorio)
proprietà 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
Oggetto 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

Microsoft.EventGrid/topics

Nome Descrizione Valore
apiVersion Versione dell'API '2021-10-15-preview'
extendedLocation Posizione estesa della risorsa. ExtendedLocation
identità Informazioni sull'identità per la risorsa. IdentityInfo
gentile Tipo di risorsa. 'Azure'
'AzureArc'
ubicazione Posizione della risorsa. stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà dell'argomento. TopicProperties
Sku Piano tariffario sku per l'argomento. resourceSku
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.EventGrid/topics'

ResourceSku

Nome Descrizione Valore
nome Nome sku della risorsa. I valori possibili sono: Basic o Premium. 'Basic'
'Premium'

Proprietà argomenti

Nome Descrizione Valore
dataResidencyBoundary Limite di residenza dei dati 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 Può essere usato 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 di eventi personalizzati. È possibile specificare un inputSchemaMapping per eseguire il mapping di varie proprietà di uno schema di origine a varie proprietà necessarie dello schema EventGridEvent. InputSchemaMapping
publicNetworkAccess Determina se il traffico è consentito in 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'

TrackedResourceTags

Nome Descrizione Valore

UserIdentityProperties

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

Modelli di avvio rapido

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

Sagoma Descrizione
Creare un argomento personalizzato e una sottoscrizione della coda di Griglia di eventi di Azure

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

Distribuire in Azure
Crea un argomento personalizzato di Griglia di eventi di Azure e una sottoscrizione webhook. Modello originariamente creato da John Downs.
Creare una sottoscrizione di argomenti personalizzati di Griglia di eventi di Azure

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

Distribuire in Azure
Crea un argomento personalizzato e un hub eventi di Griglia di eventi di Azure per gestire gli eventi.
argomento/sottoscrizione di Griglia di eventi di Azure personalizzata con CloudEvents

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

Definizione di 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 risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/topics@2021-10-15-preview"
  name = "string"
  identity = {
    principalId = "string"
    tenantId = "string"
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  kind = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      dataResidencyBoundary = "string"
      disableLocalAuth = bool
      inboundIpRules = [
        {
          action = "string"
          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à

ExtendedLocation

Nome Descrizione Valore
nome Nome completo della posizione estesa. corda
digitare Tipo della posizione estesa. corda

IdentityInfo

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. corda
tenantId ID tenant della risorsa. corda
digitare 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 di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno gli 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.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome Descrizione Valore

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. corda

InputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Impostare su "Json" per il tipo JsonInputSchemaMapping. 'Json' (obbligatorio)

JsonField

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

JsonFieldWithDefault

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

JsonInputSchemaMapping

Nome Descrizione Valore
inputSchemaMappingType Tipo del mapping personalizzato 'Json' (obbligatorio)
proprietà 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
Oggetto 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

Microsoft.EventGrid/topics

Nome Descrizione Valore
extendedLocation Posizione estesa della risorsa. ExtendedLocation
identità Informazioni sull'identità per la risorsa. IdentityInfo
gentile Tipo di risorsa. 'Azure'
'AzureArc'
ubicazione Posizione della risorsa. stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà dell'argomento. TopicProperties
Sku Piano tariffario sku per l'argomento. resourceSku
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.EventGrid/topics@2021-10-15-preview"

ResourceSku

Nome Descrizione Valore
nome Nome sku della risorsa. I valori possibili sono: Basic o Premium. 'Basic'
'Premium'

Proprietà argomenti

Nome Descrizione Valore
dataResidencyBoundary Limite di residenza dei dati 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 Può essere usato 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 di eventi personalizzati. È possibile specificare un inputSchemaMapping per eseguire il mapping di varie proprietà di uno schema di origine a varie proprietà necessarie dello schema EventGridEvent. InputSchemaMapping
publicNetworkAccess Determina se il traffico è consentito in 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'

TrackedResourceTags

Nome Descrizione Valore

UserIdentityProperties

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