System Topics - Create Or Update

Služba:

Event Grid

Verze rozhraní API:

2025-02-15

Vytvořte systémové téma.
Asynchronně vytvoří nové systémové téma se zadanými parametry.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků v rámci předplatného uživatele.
subscriptionId	path	True	string	Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.
systemTopicName	path	True	string	Název systémového tématu.
api-version	query	True	string	Verze rozhraní API, která se má použít s požadavkem klienta.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Umístění prostředku
identity		IdentityInfo	Informace o identitě prostředku
properties.source		string	Zdroj pro systémové téma.
properties.topicType		string	TopicType pro systémové téma.
tags		object	Značky prostředku

Odpovědi

Name	Typ	Description
200 OK	SystemTopic	OK
201 Created	SystemTopic	Vytvořil
Other Status Codes		Chybové odpovědi: *** 400 Chybný požadavek. Vnitřní chyba serveru 500.

Příklady

SystemTopics_CreateOrUpdate

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

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

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
IdentityInfo	Informace o identitě prostředku.
IdentityType	Typ použité spravované identity. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere jakoukoli identitu.
ResourceProvisioningState	Stav zřizování připojení privátního koncového bodu
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
SystemTopic	Téma systému EventGrid.
UserIdentityProperties	Informace o identitě uživatele

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

IdentityInfo

Objekt

Informace o identitě prostředku.

Name	Typ	Description
principalId	string	ID objektu zabezpečení identity prostředku.
tenantId	string	ID tenanta prostředku.
type	IdentityType	Typ použité spravované identity. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere jakoukoli identitu.
userAssignedIdentities	<string,  UserIdentityProperties>	Seznam identit uživatelů přidružených k prostředku. Odkazy na klíč slovníku identit uživatele budou ID prostředků ARM ve formátu: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Tato vlastnost se v současné době nepoužívá a vyhrazena pro budoucí využití.

IdentityType

Výčet

Typ použité spravované identity. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere jakoukoli identitu.

Hodnota	Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

ResourceProvisioningState

Výčet

Stav zřizování připojení privátního koncového bodu

Hodnota	Description
Creating
Updating
Deleting
Succeeded
Canceled
Failed

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

SystemTopic

Objekt

Téma systému EventGrid.

Name	Typ	Description
id	string	Plně kvalifikovaný identifikátor prostředku.
identity	IdentityInfo	Informace o identitě prostředku
location	string	Umístění prostředku
name	string	Název prostředku
properties.metricResourceId	string	ID prostředku metriky pro systémové téma
properties.provisioningState	ResourceProvisioningState	Stav zřizování systémového tématu.
properties.source	string	Zdroj pro systémové téma.
properties.topicType	string	TopicType pro systémové téma.
systemData	systemData	Systémová metadata týkající se prostředku Event Gridu.
tags	object	Značky prostředku
type	string	Typ prostředku

UserIdentityProperties

Objekt

Informace o identitě uživatele

Name	Typ	Description
clientId	string	ID klienta identity přiřazené uživatelem.
principalId	string	ID objektu zabezpečení identity přiřazené uživatelem.