Partilhar via


System Topics - Create Or Update

Crie um tópico do sistema.
Cria de forma assíncrona um novo tópico do sistema com os parâmetros especificados.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/systemTopics/{systemTopicName}?api-version=2025-02-15

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos dentro da assinatura do usuário.

subscriptionId
path True

string

Credenciais de assinatura que identificam exclusivamente uma assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.

systemTopicName
path True

string

Nome do tópico do sistema.

api-version
query True

string

Versão da API a ser usada com a solicitação do cliente.

Corpo do Pedido

Name Necessário Tipo Description
location True

string

Localização do recurso.

identity

IdentityInfo

Informações de identidade para o recurso.

properties.source

string

Fonte para o tópico do sistema.

properties.topicType

string

TopicType para o tópico do sistema.

tags

object

Tags do recurso.

Respostas

Name Tipo Description
200 OK

SystemTopic

OK

201 Created

SystemTopic

Criado

Other Status Codes

Respostas de erro: ***

  • 400 mau pedido.

  • 500 Erro interno do servidor.

Exemplos

SystemTopics_CreateOrUpdate

Pedido de amostra

PUT https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/systemTopics/exampleSystemTopic1?api-version=2025-02-15

{
  "properties": {
    "source": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/azureeventgridrunnerrgcentraluseuap/providers/microsoft.storage/storageaccounts/pubstgrunnerb71cd29e",
    "topicType": "microsoft.storage.storageaccounts"
  },
  "location": "westus2",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  }
}

Resposta da amostra

{
  "properties": {
    "provisioningState": "Succeeded",
    "source": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/azureeventgridrunnerrgcentraluseuap/providers/microsoft.storage/storageaccounts/pubstgrunnerb71cd29e",
    "topicType": "microsoft.storage.storageaccounts",
    "metricResourceId": "183c0fb1-17ff-47b6-ac77-5a47420ab01e"
  },
  "location": "centraluseuap",
  "tags": null,
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/systemTopics/exampleSystemTopic2",
  "name": "exampleSystemTopic2",
  "type": "Microsoft.EventGrid/systemTopics"
}
{
  "properties": {
    "provisioningState": "Succeeded",
    "source": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/azureeventgridrunnerrgcentraluseuap/providers/microsoft.storage/storageaccounts/pubstgrunnerb71cd29e",
    "topicType": "microsoft.storage.storageaccounts",
    "metricResourceId": "183c0fb1-17ff-47b6-ac77-5a47420ab01e"
  },
  "location": "centraluseuap",
  "tags": null,
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/systemTopics/exampleSystemTopic2",
  "name": "exampleSystemTopic2",
  "type": "Microsoft.EventGrid/systemTopics"
}

Definições

Name Description
createdByType

O tipo de identidade que criou o recurso.

IdentityInfo

As informações de identidade do recurso.

IdentityType

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.

ResourceProvisioningState

Estado de provisionamento da Private Endpoint Connection.

systemData

Metadados referentes à criação e última modificação do recurso.

SystemTopic

Tópico do sistema EventGrid.

UserIdentityProperties

As informações sobre a identidade do usuário.

createdByType

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

IdentityInfo

As informações de identidade do recurso.

Name Tipo Description
principalId

string

A ID principal da identidade do recurso.

tenantId

string

A ID do locatário do recurso.

type

IdentityType

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.

userAssignedIdentities

<string,  UserIdentityProperties>

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.

IdentityType

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.

Valor Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

ResourceProvisioningState

Estado de provisionamento da Private Endpoint Connection.

Valor Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

systemData

Metadados referentes à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

SystemTopic

Tópico do sistema EventGrid.

Name Tipo Description
id

string

Identificador totalmente qualificado do recurso.

identity

IdentityInfo

Informações de identidade para o recurso.

location

string

Localização do recurso.

name

string

Nome do recurso.

properties.metricResourceId

string

ID do recurso métrico para o tópico do sistema.

properties.provisioningState

ResourceProvisioningState

Estado de provisionamento do tópico do sistema.

properties.source

string

Fonte para o tópico do sistema.

properties.topicType

string

TopicType para o tópico do sistema.

systemData

systemData

Os metadados do sistema relacionados ao recurso Grade de Eventos.

tags

object

Tags do recurso.

type

string

Tipo de recurso.

UserIdentityProperties

As informações sobre a identidade do usuário.

Name Tipo Description
clientId

string

O ID do cliente da identidade atribuída ao usuário.

principalId

string

O id principal da identidade atribuída ao usuário.