共用方式為


System Topics - Create Or Update

建立系統主題。
以異步方式建立具有指定參數的新系統主題。

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

URI 參數

名稱 位於 必要 類型 Description
resourceGroupName
path True

string

用戶訂用帳戶內的資源組名。

subscriptionId
path True

string

可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。

systemTopicName
path True

string

系統主題的名稱。

api-version
query True

string

要與用戶端要求搭配使用的 API 版本。

要求本文

名稱 必要 類型 Description
location True

string

資源的位置。

identity

IdentityInfo

資源的身分識別資訊。

properties.source

string

系統主題的來源。

properties.topicType

string

系統主題的 TopicType。

tags

object

資源的標記。

回應

名稱 類型 Description
200 OK

SystemTopic

確定

201 Created

SystemTopic

建立時間

Other Status Codes

錯誤回應: ≦

  • 400 不正確的要求。

  • 500 內部伺服器錯誤。

範例

SystemTopics_CreateOrUpdate

範例要求

PUT https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/systemTopics/exampleSystemTopic1?api-version=2022-06-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"
  }
}

範例回覆

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

定義

名稱 Description
createdByType

建立資源的身分識別類型。

IdentityInfo

資源的身分識別資訊。

IdentityType

使用的受控識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 將會移除任何身分識別。

ResourceProvisioningState

私人端點聯機的布建狀態。

systemData

與建立和上次修改資源相關的元數據。

SystemTopic

EventGrid 系統主題。

UserIdentityProperties

使用者身分識別的相關信息。

createdByType

建立資源的身分識別類型。

名稱 類型 Description
Application

string

Key

string

ManagedIdentity

string

User

string

IdentityInfo

資源的身分識別資訊。

名稱 類型 Description
principalId

string

資源識別的主要標識碼。

tenantId

string

資源的租用戶標識碼。

type

IdentityType

使用的受控識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 將會移除任何身分識別。

userAssignedIdentities

<string,  UserIdentityProperties>

與資源相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 此屬性目前未使用,並保留供日後使用。

IdentityType

使用的受控識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 將會移除任何身分識別。

名稱 類型 Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

ResourceProvisioningState

私人端點聯機的布建狀態。

名稱 類型 Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string

資源建立的時間戳 (UTC) 。

createdBy

string

建立資源的身分識別。

createdByType

createdByType

建立資源的身分識別類型。

lastModifiedAt

string

上次修改的資源時間戳 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。

SystemTopic

EventGrid 系統主題。

名稱 類型 Description
id

string

資源的完整標識碼。

identity

IdentityInfo

資源的身分識別資訊。

location

string

資源的位置。

name

string

資源名稱。

properties.metricResourceId

string

系統主題的計量資源標識碼。

properties.provisioningState

ResourceProvisioningState

系統主題的布建狀態。

properties.source

string

系統主題的來源。

properties.topicType

string

系統主題的 TopicType。

systemData

systemData

與系統主題資源相關的系統元數據。

tags

object

資源的標記。

type

string

資源類型。

UserIdentityProperties

使用者身分識別的相關信息。

名稱 類型 Description
clientId

string

使用者指派身分識別的用戶端標識碼。

principalId

string

使用者指派身分識別的主體標識碼。