Partilhar via


Microsoft.EventGrid systemTopics

Definição de recursos do bíceps

O tipo de recurso systemTopics pode ser implantado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.EventGrid/systemTopics, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.EventGrid/systemTopics@2025-04-01-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    source: 'string'
    topicType: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.EventGrid/systemTopics

Designação Descrição Valor
identidade Informações de identidade para o recurso. IdentityInfo
localização Localização do recurso. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades Propriedades do tópico do sistema. SystemTopicProperties
âmbito Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

IdentityInfo

Designação Descrição Valor
principalId A ID principal da identidade do recurso. cadeia (de caracteres)
inquilinoId A ID do locatário do recurso. cadeia (de caracteres)
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 'Nenhum' removerá qualquer identidade. 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
identidades atribuídas pelo utilizador 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 ARM no formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Esta propriedade não é usada no momento e está reservada para uso futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Designação Descrição Valor

SystemTopicProperties

Designação Descrição Valor
origem Fonte para o tópico do sistema. cadeia (de caracteres)
Tipo de tópico TopicType para o tópico do sistema. cadeia (de caracteres)

TrackedResourceTags

Designação Descrição Valor

UserIdentityProperties

Designação Descrição Valor
ID do cliente O ID do cliente da identidade atribuída ao usuário. cadeia (de caracteres)
principalId O id principal da identidade atribuída ao usuário. cadeia (de caracteres)

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
de tópicos do sistema de grade de eventos Tópico do módulo de recursos AVM para sistema de grade de eventos

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Criar Armazenamento de Blobs e Subscrição de Grelha de Eventos para o Blob Cria uma conta de Armazenamento de Blob do Azure e, em seguida, cria uma assinatura de Grade de Eventos para esse Blob.
Implantar o banco de dados do Azure Data Explorer com conexão de Grade de Eventos Implante o banco de dados do Azure Data Explorer com conexão de Grade de Eventos.

Definição de recurso de modelo ARM

O tipo de recurso systemTopics pode ser implantado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.EventGrid/systemTopics, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.EventGrid/systemTopics",
  "apiVersion": "2025-04-01-preview",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "source": "string",
    "topicType": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.EventGrid/systemTopics

Designação Descrição Valor
Versão da API A versão api '2025-04-01-pré-visualização'
identidade Informações de identidade para o recurso. IdentityInfo
localização Localização do recurso. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades Propriedades do tópico do sistema. SystemTopicProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.EventGrid/systemTopics'

IdentityInfo

Designação Descrição Valor
principalId A ID principal da identidade do recurso. cadeia (de caracteres)
inquilinoId A ID do locatário do recurso. cadeia (de caracteres)
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 'Nenhum' removerá qualquer identidade. 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
identidades atribuídas pelo utilizador 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 ARM no formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Esta propriedade não é usada no momento e está reservada para uso futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Designação Descrição Valor

SystemTopicProperties

Designação Descrição Valor
origem Fonte para o tópico do sistema. cadeia (de caracteres)
Tipo de tópico TopicType para o tópico do sistema. cadeia (de caracteres)

TrackedResourceTags

Designação Descrição Valor

UserIdentityProperties

Designação Descrição Valor
ID do cliente O ID do cliente da identidade atribuída ao usuário. cadeia (de caracteres)
principalId O id principal da identidade atribuída ao usuário. cadeia (de caracteres)

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Modelo Descrição
Criar Armazenamento de Blobs e Subscrição de Grelha de Eventos para o Blob

Implantar no Azure
Cria uma conta de Armazenamento de Blob do Azure e, em seguida, cria uma assinatura de Grade de Eventos para esse Blob.
Implantar o banco de dados do Azure Data Explorer com conexão de Grade de Eventos

Implantar no Azure
Implante o banco de dados do Azure Data Explorer com conexão de Grade de Eventos.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso systemTopics pode ser implantado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.EventGrid/systemTopics, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/systemTopics@2025-04-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      source = "string"
      topicType = "string"
    }
  }
}

Valores de propriedade

Microsoft.EventGrid/systemTopics

Designação Descrição Valor
identidade Informações de identidade para o recurso. IdentityInfo
localização Localização do recurso. string (obrigatório)
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades Propriedades do tópico do sistema. SystemTopicProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.EventGrid/systemTopics@2025-04-01-preview"

IdentityInfo

Designação Descrição Valor
principalId A ID principal da identidade do recurso. cadeia (de caracteres)
inquilinoId A ID do locatário do recurso. cadeia (de caracteres)
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 'Nenhum' removerá qualquer identidade. 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
identidades atribuídas pelo utilizador 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 ARM no formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Esta propriedade não é usada no momento e está reservada para uso futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Designação Descrição Valor

SystemTopicProperties

Designação Descrição Valor
origem Fonte para o tópico do sistema. cadeia (de caracteres)
Tipo de tópico TopicType para o tópico do sistema. cadeia (de caracteres)

TrackedResourceTags

Designação Descrição Valor

UserIdentityProperties

Designação Descrição Valor
ID do cliente O ID do cliente da identidade atribuída ao usuário. cadeia (de caracteres)
principalId O id principal da identidade atribuída ao usuário. cadeia (de caracteres)

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do Tópico do Sistema de Grade de Eventos.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "systemTopic" {
  type      = "Microsoft.EventGrid/systemTopics@2021-12-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = "global"
  body = {
    properties = {
      source    = azapi_resource.resourceGroup.id
      topicType = "Microsoft.Resources.ResourceGroups"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}