System Topics - Create Or Update

Serviço:

Event Grid

Versão da API:

2025-02-15

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

HTTP

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

Código de estado:

200

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

Código de estado:

201

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

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

IdentityInfo

Object

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

Enumeração

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

Enumeração

Estado de provisionamento da Private Endpoint Connection.

Valor	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

systemData

Object

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

Name	Tipo	Description
createdAt	string (date-time)	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 (date-time)	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

Object

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

Object

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.