System Topics - Create Or Update

Servizio:

Event Grid

Versione API:

2025-02-15

Creare un argomento di sistema.
Crea in modo asincrono un nuovo argomento di sistema con i parametri specificati.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione dell'utente.
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
systemTopicName	path	True	string	Nome dell'argomento di sistema.
api-version	query	True	string	Versione dell'API da usare con la richiesta client.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione della risorsa.
identity		IdentityInfo	Informazioni sull'identità per la risorsa.
properties.source		string	Origine per l'argomento di sistema.
properties.topicType		string	TopicType per l'argomento di sistema.
tags		object	Tag della risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	SystemTopic	OK
201 Created	SystemTopic	Creato
Other Status Codes		Risposte di errore: 400 Richiesta non valida. 500 Errore interno del server.

Esempio

SystemTopics_CreateOrUpdate

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
IdentityInfo	Informazioni sull'identità per la risorsa.
IdentityType	Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità.
ResourceProvisioningState	Stato di provisioning della connessione endpoint privato.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
SystemTopic	Argomento di sistema eventgrid.
UserIdentityProperties	Informazioni sull'identità utente.

createdByType

Enumeration

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

IdentityInfo

Object

Informazioni sull'identità per la risorsa.

Nome	Tipo	Descrizione
principalId	string	ID principale dell'identità della risorsa.
tenantId	string	ID tenant della risorsa.
type	IdentityType	Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità.
userAssignedIdentities	<string,  UserIdentityProperties>	Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Questa proprietà non è attualmente utilizzata e riservata per l'utilizzo futuro.

IdentityType

Enumeration

Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità.

Valore	Descrizione
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

ResourceProvisioningState

Enumeration

Stato di provisioning della connessione endpoint privato.

Valore	Descrizione
Canceled
Creating
Deleting
Failed
Succeeded
Updating

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

SystemTopic

Object

Argomento di sistema eventgrid.

Nome	Tipo	Descrizione
id	string	Identificatore completo della risorsa.
identity	IdentityInfo	Informazioni sull'identità per la risorsa.
location	string	Posizione della risorsa.
name	string	Nome della risorsa.
properties.metricResourceId	string	ID risorsa metrica per l'argomento di sistema.
properties.provisioningState	ResourceProvisioningState	Stato di provisioning dell'argomento di sistema.
properties.source	string	Origine per l'argomento di sistema.
properties.topicType	string	TopicType per l'argomento di sistema.
systemData	systemData	Metadati di sistema relativi alla risorsa griglia di eventi.
tags	object	Tag della risorsa.
type	string	Tipo della risorsa.

UserIdentityProperties

Object

Informazioni sull'identità utente.

Nome	Tipo	Descrizione
clientId	string	ID client dell'identità assegnata dall'utente.
principalId	string	ID principale dell'identità assegnata dall'utente.