System Topics - Create Or Update

Servicio:

Event Grid

Versión de la API:

2025-02-15

Cree un tema del sistema.
Crea de forma asincrónica un nuevo tema del sistema con los parámetros especificados.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos dentro de la suscripción del usuario.
subscriptionId	path	True	string	Credenciales de suscripción que identifican de forma única una suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.
systemTopicName	path	True	string	Nombre del tema del sistema.
api-version	query	True	string	Versión de la API que se va a usar con la solicitud de cliente.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación del recurso.
identity		IdentityInfo	Información de identidad del recurso.
properties.source		string	Origen del tema del sistema.
properties.topicType		string	TopicType para el tema del sistema.
tags		object	Etiquetas del recurso.

Respuestas

Nombre	Tipo	Description
200 OK	SystemTopic	De acuerdo
201 Created	SystemTopic	Creado
Other Status Codes		Respuestas de error: *** 400 Solicitud incorrecta. Error interno del servidor 500.

Ejemplos

SystemTopics_CreateOrUpdate

Solicitud de ejemplo

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

Respuesta de muestra

status code:

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

status code:

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

Definiciones

Nombre	Description
createdByType	Tipo de identidad que creó el recurso.
IdentityInfo	Información de identidad del recurso.
IdentityType	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad.
ResourceProvisioningState	Estado de aprovisionamiento de la conexión de punto de conexión privado.
systemData	Metadatos relativos a la creación y última modificación del recurso.
SystemTopic	Tema del sistema EventGrid.
UserIdentityProperties	Información sobre la identidad del usuario.

createdByType

Enumeration

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

IdentityInfo

Object

Información de identidad del recurso.

Nombre	Tipo	Description
principalId	string	Identificador de entidad de seguridad de la identidad del recurso.
tenantId	string	Identificador de inquilino del recurso.
type	IdentityType	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad.
userAssignedIdentities	<string,  UserIdentityProperties>	Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Esta propiedad no se usa actualmente y está reservada para uso futuro.

IdentityType

Enumeration

Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad.

Valor	Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

ResourceProvisioningState

Enumeration

Estado de aprovisionamiento de la conexión de punto de conexión privado.

Valor	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

SystemTopic

Object

Tema del sistema EventGrid.

Nombre	Tipo	Description
id	string	Identificador completo del recurso.
identity	IdentityInfo	Información de identidad del recurso.
location	string	Ubicación del recurso.
name	string	Nombre del recurso.
properties.metricResourceId	string	Identificador de recurso de métrica para el tema del sistema.
properties.provisioningState	ResourceProvisioningState	Estado de aprovisionamiento del tema del sistema.
properties.source	string	Origen del tema del sistema.
properties.topicType	string	TopicType para el tema del sistema.
systemData	systemData	Metadatos del sistema relacionados con el recurso de Event Grid.
tags	object	Etiquetas del recurso.
type	string	Tipo del recurso.

UserIdentityProperties

Object

Información sobre la identidad del usuario.

Nombre	Tipo	Description
clientId	string	Identificador de cliente de la identidad asignada por el usuario.
principalId	string	Identificador principal de la identidad asignada por el usuario.