Tópicos do Microsoft.EventGrid 2020-10-15-preview

• última
• 2024-12-15-preview
• 2024-06-01-preview
• 2023-12-15-preview
• 2023-06-01-preview
• 2022-06-15
• 2021-12-01
• 2021-10-15-preview
• 2021-06-01-preview
• 2020-10-15-preview
• 2020-06-01
• 2020-04-01-preview
• 2020-01-01-preview
• 2019-06-01
• 2019-02-01-preview
• 2019-01-01
• 2018-09-15-preview
• 2018-05-01-preview
• 2018-01-01
• 2017-09-15-preview
• 2017-06-15-preview

Definição de recurso do Bicep

O tipo de recurso de tópicos pode ser implantado com operações direcionadas:

• Grupos de recursos - Consulte comandos de implantação do grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.EventGrid/topics, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.EventGrid/topics@2020-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: {
    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'
  }
}

Objetos InputSchemaMapping

Defina a propriedade inputSchemaMappingType para especificar o tipo de objeto.

Para Json, use:

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

Valores de propriedade

ExtendedLocation

Nome	Descrição	Valor
nome	Nome totalmente qualificado do local estendido.	corda
tipo	Tipo do local estendido.	corda

IdentityInfo

Nome	Descrição	Valor
principalId	A ID principal da identidade do recurso.	corda
tenantId	A ID do locatário do recurso.	corda
tipo	O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá qualquer identidade.	'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. No momento, essa propriedade não é usada e reservada para uso futuro.	IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome	Descrição	Valor

InboundIpRule

Nome	Descrição	Valor
ação	Ação a ser executada com base na correspondência ou nenhuma correspondência do IpMask.	'Permitir'
ipMask	Endereço IP na notação CIDR, por exemplo, 10.0.0.0/8.	corda

InputSchemaMapping

Nome	Descrição	Valor
inputSchemaMappingType	Defina como 'Json' para o tipo JsonInputSchemaMapping .	'Json' (obrigatório)

JsonField

Nome	Descrição	Valor
sourceField	Nome de um campo no esquema de evento de entrada que deve ser usado como a origem de um mapeamento.	corda

JsonFieldWithDefault

Nome	Descrição	Valor
defaultValue	O valor padrão a ser usado para mapeamento quando um SourceField não é fornecido ou se não há nenhuma propriedade com o nome especificado no conteúdo do evento JSON publicado.	corda
sourceField	Nome de um campo no esquema de evento de entrada que deve ser usado como a origem de um mapeamento.	corda

JsonInputSchemaMapping

Nome	Descrição	Valor
inputSchemaMappingType	Tipo do mapeamento personalizado	'Json' (obrigatório)
Propriedades	Propriedades JSON do mapeamento de esquema de entrada	JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Nome	Descrição	Valor
dataVersion	As informações de mapeamento da propriedade DataVersion do Evento da Grade de Eventos.	JsonFieldWithDefault
eventTime	As informações de mapeamento para a propriedade EventTime do Evento da Grade de Eventos.	JsonField
eventType	As informações de mapeamento da propriedade EventType do Evento da Grade de Eventos.	JsonFieldWithDefault
id	As informações de mapeamento para a propriedade ID do Evento da Grade de Eventos.	JsonField
Assunto	As informações de mapeamento da propriedade Subject do Evento da Grade de Eventos.	JsonFieldWithDefault
tópico	As informações de mapeamento da propriedade Topic do Evento da Grade de Eventos.	JsonField

Microsoft.EventGrid/topics

Nome	Descrição	Valor
extendedLocation	Local estendido do recurso.	ExtendedLocation
identidade	Informações de identidade para o recurso.	IdentityInfo
tipo	Tipo de recurso.	'Azure' 'AzureArc'
localização	Local do recurso.	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades do tópico.	TopicProperties
Sku	O tipo de preço do Sku para o tópico.	do ResourceSku
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos

ResourceSku

Nome	Descrição	Valor
nome	O nome do SKU do recurso. Os valores possíveis são: Básico ou Premium.	'Básico' 'Premium'

TopicProperties

Nome	Descrição	Valor
inboundIpRules	Isso pode ser usado para restringir o tráfego de IPs específicos em vez de todos os IPs. Observação: elas serão consideradas somente se PublicNetworkAccess estiver habilitado.	InboundIpRule []
inputSchema	Isso determina o formato que a Grade de Eventos deve esperar para eventos de entrada publicados no tópico.	'CloudEventSchemaV1_0' 'CustomEventSchema' 'EventGridSchema'
inputSchemaMapping	Isso permite a publicação usando esquemas de eventos personalizados. Um InputSchemaMapping pode ser especificado para mapear várias propriedades de um esquema de origem para várias propriedades necessárias do esquema EventGridEvent.	InputSchemaMapping
publicNetworkAccess	Isso determina se o tráfego é permitido pela rede pública. Por padrão, ele está habilitado. Você pode restringir ainda mais a IPs específicos configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />	'Desabilitado' 'Habilitado'

TrackedResourceTags

Nome	Descrição	Valor

UserIdentityProperties

Nome	Descrição	Valor
clientId	A ID do cliente da identidade atribuída pelo usuário.	corda
principalId	A ID principal da identidade atribuída pelo usuário.	corda

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep	Descrição
criar o tópico personalizado da Grade de Eventos do Azure e a assinatura da fila	Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de fila do barramento de serviço. Modelo originalmente criado por Markus Meyer.
Criar tópico personalizado e de assinatura da Grade de Eventos do Azure	Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de webhook. Modelo originalmente criado por John Downs.

Definição de recurso de modelo do ARM

O tipo de recurso de tópicos pode ser implantado com operações direcionadas:

• Grupos de recursos - Consulte comandos de implantação do grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.EventGrid/topics, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.EventGrid/topics",
  "apiVersion": "2020-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": {
    "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"
  }
}

Objetos InputSchemaMapping

Defina a propriedade inputSchemaMappingType para especificar o tipo de objeto.

Para Json, use:

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

Valores de propriedade

ExtendedLocation

Nome	Descrição	Valor
nome	Nome totalmente qualificado do local estendido.	corda
tipo	Tipo do local estendido.	corda

IdentityInfo

Nome	Descrição	Valor
principalId	A ID principal da identidade do recurso.	corda
tenantId	A ID do locatário do recurso.	corda
tipo	O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá qualquer identidade.	'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. No momento, essa propriedade não é usada e reservada para uso futuro.	IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome	Descrição	Valor

InboundIpRule

Nome	Descrição	Valor
ação	Ação a ser executada com base na correspondência ou nenhuma correspondência do IpMask.	'Permitir'
ipMask	Endereço IP na notação CIDR, por exemplo, 10.0.0.0/8.	corda

InputSchemaMapping

Nome	Descrição	Valor
inputSchemaMappingType	Defina como 'Json' para o tipo JsonInputSchemaMapping .	'Json' (obrigatório)

JsonField

Nome	Descrição	Valor
sourceField	Nome de um campo no esquema de evento de entrada que deve ser usado como a origem de um mapeamento.	corda

JsonFieldWithDefault

Nome	Descrição	Valor
defaultValue	O valor padrão a ser usado para mapeamento quando um SourceField não é fornecido ou se não há nenhuma propriedade com o nome especificado no conteúdo do evento JSON publicado.	corda
sourceField	Nome de um campo no esquema de evento de entrada que deve ser usado como a origem de um mapeamento.	corda

JsonInputSchemaMapping

Nome	Descrição	Valor
inputSchemaMappingType	Tipo do mapeamento personalizado	'Json' (obrigatório)
Propriedades	Propriedades JSON do mapeamento de esquema de entrada	JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Nome	Descrição	Valor
dataVersion	As informações de mapeamento da propriedade DataVersion do Evento da Grade de Eventos.	JsonFieldWithDefault
eventTime	As informações de mapeamento para a propriedade EventTime do Evento da Grade de Eventos.	JsonField
eventType	As informações de mapeamento da propriedade EventType do Evento da Grade de Eventos.	JsonFieldWithDefault
id	As informações de mapeamento para a propriedade ID do Evento da Grade de Eventos.	JsonField
Assunto	As informações de mapeamento da propriedade Subject do Evento da Grade de Eventos.	JsonFieldWithDefault
tópico	As informações de mapeamento da propriedade Topic do Evento da Grade de Eventos.	JsonField

Microsoft.EventGrid/topics

Nome	Descrição	Valor
apiVersion	A versão da API	'2020-10-15-preview'
extendedLocation	Local estendido do recurso.	ExtendedLocation
identidade	Informações de identidade para o recurso.	IdentityInfo
tipo	Tipo de recurso.	'Azure' 'AzureArc'
localização	Local do recurso.	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades do tópico.	TopicProperties
Sku	O tipo de preço do Sku para o tópico.	do ResourceSku
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo	O tipo de recurso	'Microsoft.EventGrid/topics'

ResourceSku

Nome	Descrição	Valor
nome	O nome do SKU do recurso. Os valores possíveis são: Básico ou Premium.	'Básico' 'Premium'

TopicProperties

Nome	Descrição	Valor
inboundIpRules	Isso pode ser usado para restringir o tráfego de IPs específicos em vez de todos os IPs. Observação: elas serão consideradas somente se PublicNetworkAccess estiver habilitado.	InboundIpRule []
inputSchema	Isso determina o formato que a Grade de Eventos deve esperar para eventos de entrada publicados no tópico.	'CloudEventSchemaV1_0' 'CustomEventSchema' 'EventGridSchema'
inputSchemaMapping	Isso permite a publicação usando esquemas de eventos personalizados. Um InputSchemaMapping pode ser especificado para mapear várias propriedades de um esquema de origem para várias propriedades necessárias do esquema EventGridEvent.	InputSchemaMapping
publicNetworkAccess	Isso determina se o tráfego é permitido pela rede pública. Por padrão, ele está habilitado. Você pode restringir ainda mais a IPs específicos configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />	'Desabilitado' 'Habilitado'

TrackedResourceTags

Nome	Descrição	Valor

UserIdentityProperties

Nome	Descrição	Valor
clientId	A ID do cliente da identidade atribuída pelo usuário.	corda
principalId	A ID principal da identidade atribuída pelo usuário.	corda

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo	Descrição
criar o tópico personalizado da Grade de Eventos do Azure e a assinatura da fila	Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de fila do barramento de serviço. Modelo originalmente criado por Markus Meyer.
Criar tópico personalizado e de assinatura da Grade de Eventos do Azure	Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de webhook. Modelo originalmente criado por John Downs.
criar assinatura de tópico personalizado da Grade de Eventos do Azure	Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de tópico do barramento de serviço. Modelo originalmente criado por Markus Meyer.
criar o tópico personalizado da Grade de Eventos e o manipulador do hub de eventos	Cria um tópico personalizado da Grade de Eventos do Azure e um hub de eventos para lidar com os eventos.
tópico/assinatura personalizado da Grade de Eventos do Azure com o CloudEvents	Cria um tópico personalizado da Grade de Eventos do Azure, uma assinatura de webhook com esquema CloudEvents e um Aplicativo Lógico como manipulador de eventos. Modelo originalmente criado por Justin Yoo.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de tópicos pode ser implantado com operações direcionadas:

• grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.EventGrid/topics, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/topics@2020-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 = {
      inboundIpRules = [
        {
          action = "string"
          ipMask = "string"
        }
      ]
      inputSchema = "string"
      inputSchemaMapping = {
        inputSchemaMappingType = "string"
        // For remaining properties, see InputSchemaMapping objects
      }
      publicNetworkAccess = "string"
    }
  })
}

Objetos InputSchemaMapping

Defina a propriedade inputSchemaMappingType para especificar o tipo de objeto.

Para Json, use:

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

Valores de propriedade

ExtendedLocation

Nome	Descrição	Valor
nome	Nome totalmente qualificado do local estendido.	corda
tipo	Tipo do local estendido.	corda

IdentityInfo

Nome	Descrição	Valor
principalId	A ID principal da identidade do recurso.	corda
tenantId	A ID do locatário do recurso.	corda
tipo	O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá qualquer identidade.	'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. No momento, essa propriedade não é usada e reservada para uso futuro.	IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome	Descrição	Valor

InboundIpRule

Nome	Descrição	Valor
ação	Ação a ser executada com base na correspondência ou nenhuma correspondência do IpMask.	'Permitir'
ipMask	Endereço IP na notação CIDR, por exemplo, 10.0.0.0/8.	corda

InputSchemaMapping

Nome	Descrição	Valor
inputSchemaMappingType	Defina como 'Json' para o tipo JsonInputSchemaMapping .	'Json' (obrigatório)

JsonField

Nome	Descrição	Valor
sourceField	Nome de um campo no esquema de evento de entrada que deve ser usado como a origem de um mapeamento.	corda

JsonFieldWithDefault

Nome	Descrição	Valor
defaultValue	O valor padrão a ser usado para mapeamento quando um SourceField não é fornecido ou se não há nenhuma propriedade com o nome especificado no conteúdo do evento JSON publicado.	corda
sourceField	Nome de um campo no esquema de evento de entrada que deve ser usado como a origem de um mapeamento.	corda

JsonInputSchemaMapping

Nome	Descrição	Valor
inputSchemaMappingType	Tipo do mapeamento personalizado	'Json' (obrigatório)
Propriedades	Propriedades JSON do mapeamento de esquema de entrada	JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Nome	Descrição	Valor
dataVersion	As informações de mapeamento da propriedade DataVersion do Evento da Grade de Eventos.	JsonFieldWithDefault
eventTime	As informações de mapeamento para a propriedade EventTime do Evento da Grade de Eventos.	JsonField
eventType	As informações de mapeamento da propriedade EventType do Evento da Grade de Eventos.	JsonFieldWithDefault
id	As informações de mapeamento para a propriedade ID do Evento da Grade de Eventos.	JsonField
Assunto	As informações de mapeamento da propriedade Subject do Evento da Grade de Eventos.	JsonFieldWithDefault
tópico	As informações de mapeamento da propriedade Topic do Evento da Grade de Eventos.	JsonField

Microsoft.EventGrid/topics

Nome	Descrição	Valor
extendedLocation	Local estendido do recurso.	ExtendedLocation
identidade	Informações de identidade para o recurso.	IdentityInfo
tipo	Tipo de recurso.	'Azure' 'AzureArc'
localização	Local do recurso.	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades do tópico.	TopicProperties
Sku	O tipo de preço do Sku para o tópico.	do ResourceSku
Tags	Marcas de recurso	Dicionário de nomes e valores de marca.
tipo	O tipo de recurso	"Microsoft.EventGrid/topics@2020-10-15-preview"

ResourceSku

Nome	Descrição	Valor
nome	O nome do SKU do recurso. Os valores possíveis são: Básico ou Premium.	'Básico' 'Premium'

TopicProperties

Nome	Descrição	Valor
inboundIpRules	Isso pode ser usado para restringir o tráfego de IPs específicos em vez de todos os IPs. Observação: elas serão consideradas somente se PublicNetworkAccess estiver habilitado.	InboundIpRule []
inputSchema	Isso determina o formato que a Grade de Eventos deve esperar para eventos de entrada publicados no tópico.	'CloudEventSchemaV1_0' 'CustomEventSchema' 'EventGridSchema'
inputSchemaMapping	Isso permite a publicação usando esquemas de eventos personalizados. Um InputSchemaMapping pode ser especificado para mapear várias propriedades de um esquema de origem para várias propriedades necessárias do esquema EventGridEvent.	InputSchemaMapping
publicNetworkAccess	Isso determina se o tráfego é permitido pela rede pública. Por padrão, ele está habilitado. Você pode restringir ainda mais a IPs específicos configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />	'Desabilitado' 'Habilitado'

TrackedResourceTags

Nome	Descrição	Valor

UserIdentityProperties

Nome	Descrição	Valor
clientId	A ID do cliente da identidade atribuída pelo usuário.	corda
principalId	A ID principal da identidade atribuída pelo usuário.	corda