Microsoft.EventGrid トピック 2020-04-01-preview

Bicep リソース定義

トピック リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.EventGrid/topics リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.EventGrid/topics@2020-04-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  properties: {
    inboundIpRules: [
      {
        action: 'Allow'
        ipMask: 'string'
      }
    ]
    inputSchema: 'string'
    inputSchemaMapping: {
      inputSchemaMappingType: 'string'
      // For remaining properties, see InputSchemaMapping objects
    }
    privateEndpointConnections: [
      {
        properties: {
          groupIds: [
            'string'
          ]
          privateEndpoint: {
            id: 'string'
          }
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
          provisioningState: 'string'
        }
      }
    ]
    publicNetworkAccess: 'string'
  }
}

InputSchemaMapping オブジェクト

inputSchemaMappingType プロパティを設定して、オブジェクトの種類を指定します。

Json の場合は、次の値を使用します。

  inputSchemaMappingType: 'Json'
  properties: {
    dataVersion: {
      defaultValue: 'string'
      sourceField: 'string'
    }
    eventTime: {
      sourceField: 'string'
    }
    eventType: {
      defaultValue: 'string'
      sourceField: 'string'
    }
    id: {
      sourceField: 'string'
    }
    subject: {
      defaultValue: 'string'
      sourceField: 'string'
    }
    topic: {
      sourceField: 'string'
    }
  }

プロパティ値

topics

名前 説明
name リソース名 string (必須)

文字制限: 3 から 50

有効な文字:
英数字とハイフン。
location リソースの場所。 string (必須)
tags リソースのタグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku トピックの Sku 価格レベル。 ResourceSku
identity リソースの ID 情報。 IdentityInfo
properties トピックのプロパティ。 TopicProperties

IdentityInfo

名前 説明
principalId リソース ID のプリンシパル ID。 string
tenantId リソースのテナント ID。 string
type 使用されるマネージド ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' では、任意の ID が削除されます。 'None'
'SystemAssigned'
'SystemAssigned、UserAssigned'
'UserAssigned'
userAssignedIdentities リソースに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ キー参照は、次の形式の ARM リソース ID になります。
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'
このプロパティは現在使用されておらず、今後の使用のために予約されています。
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

名前 説明
{カスタマイズされたプロパティ} UserIdentityProperties

UserIdentityProperties

名前 説明
clientId ユーザー割り当て ID のクライアント ID。 string
principalId ユーザー割り当て ID のプリンシパル ID。 string

TopicProperties

名前 説明
inboundIpRules これは、すべての IP ではなく、特定の IP からのトラフィックを制限するために使用できます。 注: これらは、PublicNetworkAccess が有効になっている場合にのみ考慮されます。 InboundIpRule[]
inputSchema これにより、トピックに発行された受信イベントに対して Event Grid で想定される形式が決まります。 'CloudEventSchemaV1_0'
'CustomEventSchema'
'EventGridSchema'
inputSchemaMapping これにより、カスタム イベント スキーマを使用した発行が可能になります。 InputSchemaMapping を指定して、ソース スキーマのさまざまなプロパティを EventGridEvent スキーマのさまざまな必須プロパティにマップできます。 InputSchemaMapping
privateEndpointConnections PrivateEndpointConnection[]
publicNetworkAccess これにより、トラフィックがパブリック ネットワーク経由で許可されるかどうかが決まります。 既定では有効になっています。
{seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /} を構成することで、特定の IP をさらに制限できます
'Disabled'
'Enabled'

InboundIpRule

名前 説明
action IpMask の一致または一致に基づいて実行するアクション。 'Allow'
ipMask CIDR 表記の IP アドレス (例: 10.0.0.0/8)。 string

InputSchemaMapping

名前 説明
inputSchemaMappingType オブジェクトの種類を設定する Json (必須)

JsonInputSchemaMapping

名前 説明
inputSchemaMappingType カスタム マッピングの種類 'Json' (必須)
properties 入力スキーマ マッピングの JSON プロパティ JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

名前 説明
dataVersion Event Grid イベントの DataVersion プロパティのマッピング情報。 JsonFieldWithDefault
eventTime Event Grid イベントの EventTime プロパティのマッピング情報。 JsonField
eventType Event Grid イベントの EventType プロパティのマッピング情報。 JsonFieldWithDefault
id Event Grid イベントの Id プロパティのマッピング情報。 JsonField
subject Event Grid イベントの Subject プロパティのマッピング情報。 JsonFieldWithDefault
topic Event Grid イベントの Topic プロパティのマッピング情報。 JsonField

JsonFieldWithDefault

名前 説明
defaultValue SourceField が指定されていない場合、または発行された JSON イベント ペイロードに指定された名前のプロパティがない場合に、マッピングに使用される既定値。 string
sourceField マッピングのソースとして使用される入力イベント スキーマ内のフィールドの名前。 string

JsonField

名前 説明
sourceField マッピングのソースとして使用される入力イベント スキーマ内のフィールドの名前。 string

PrivateEndpointConnection

名前 説明
properties PrivateEndpointConnection のプロパティ。 PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

名前 説明
groupIds プライベート リンク サービス リソースの GroupIds。 string[]
privateEndpoint この接続のプライベート エンドポイント リソース。 PrivateEndpoint
privateLinkServiceConnectionState 接続の状態の詳細。 ConnectionState
provisioningState プライベート エンドポイント接続のプロビジョニング状態。 'Canceled'
'Creating'
'削除中'
'Failed'
'Succeeded'
'更新中'

PrivateEndpoint

名前 説明
id プライベート エンドポイントの ARM 識別子。 string

ConnectionState

名前 説明
actionsRequired 必要なアクション (存在する場合)。 string
description 接続状態の説明。 string
status 接続の状態。 '承認済み'
'Disconnected'
'保留中'
'Rejected'

ResourceSku

名前 説明
name リソースの Sku 名。 使用できる値は、Basic または Premium です。 'Basic'
'Premium'

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
カスタム トピックとサブスクリプションAzure Event Grid作成する

Azure にデプロイする
Azure Event Gridカスタム トピックと Webhook サブスクリプションを作成します。 最初に John Downs によって作成されたテンプレート。
CloudEvents を使用したカスタム Azure Event Grid トピック/サブスクリプション

Azure にデプロイする
カスタム Azure Event Grid トピック、CloudEvents スキーマを持つ Webhook サブスクリプション、およびイベント ハンドラーとしてのロジック アプリを作成します。 テンプレートは、もともと Justin Yoo によって作成されました。
Event Grid カスタム トピックとイベント ハブ ハンドラーを作成する

Azure にデプロイする
イベントを処理Azure Event Gridカスタム トピックとイベント ハブを作成します。
カスタム トピックとキュー サブスクリプションAzure Event Grid作成する

Azure にデプロイする
Azure Event Gridカスタム トピックと Service Bus キュー サブスクリプションを作成します。 テンプレートは、もともと Markus Meyer によって作成されました。
カスタム トピック サブスクリプションAzure Event Grid作成する

Azure にデプロイする
Azure Event Gridカスタム トピックと Service Bus トピック サブスクリプションを作成します。 テンプレートは、もともと Markus Meyer によって作成されました。

ARM テンプレート リソース定義

トピック リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.EventGrid/topics リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.EventGrid/topics",
  "apiVersion": "2020-04-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "properties": {
    "inboundIpRules": [
      {
        "action": "Allow",
        "ipMask": "string"
      }
    ],
    "inputSchema": "string",
    "inputSchemaMapping": {
      "inputSchemaMappingType": "string"
      // For remaining properties, see InputSchemaMapping objects
    },
    "privateEndpointConnections": [
      {
        "properties": {
          "groupIds": [ "string" ],
          "privateEndpoint": {
            "id": "string"
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          },
          "provisioningState": "string"
        }
      }
    ],
    "publicNetworkAccess": "string"
  }
}

InputSchemaMapping オブジェクト

inputSchemaMappingType プロパティを設定して、オブジェクトの種類を指定します。

Json の場合は、次の値を使用します。

  "inputSchemaMappingType": "Json",
  "properties": {
    "dataVersion": {
      "defaultValue": "string",
      "sourceField": "string"
    },
    "eventTime": {
      "sourceField": "string"
    },
    "eventType": {
      "defaultValue": "string",
      "sourceField": "string"
    },
    "id": {
      "sourceField": "string"
    },
    "subject": {
      "defaultValue": "string",
      "sourceField": "string"
    },
    "topic": {
      "sourceField": "string"
    }
  }

プロパティ値

topics

名前 説明
type リソースの種類 'Microsoft.EventGrid/topics'
apiVersion リソース API のバージョン '2020-04-01-preview'
name リソース名 string (必須)

文字制限: 3 から 50

有効な文字:
英数字とハイフン。
location リソースの場所。 string (必須)
tags リソースのタグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku トピックの Sku 価格レベル。 ResourceSku
identity リソースの ID 情報。 IdentityInfo
properties トピックのプロパティ。 TopicProperties

IdentityInfo

名前 説明
principalId リソース ID のプリンシパル ID。 string
tenantId リソースのテナント ID。 string
type 使用されるマネージド ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' では、任意の ID が削除されます。 'None'
'SystemAssigned'
'SystemAssigned、UserAssigned'
'UserAssigned'
userAssignedIdentities リソースに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ キー参照は、次の形式の ARM リソース ID になります。
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'
このプロパティは現在使用されておらず、今後の使用のために予約されています。
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

名前 説明
{カスタマイズされたプロパティ} UserIdentityProperties

UserIdentityProperties

名前 説明
clientId ユーザー割り当て ID のクライアント ID。 string
principalId ユーザー割り当て ID のプリンシパル ID。 string

TopicProperties

名前 説明
inboundIpRules これは、すべての IP ではなく、特定の IP からのトラフィックを制限するために使用できます。 注: これらは、PublicNetworkAccess が有効になっている場合にのみ考慮されます。 InboundIpRule[]
inputSchema これにより、トピックに発行された受信イベントに対して Event Grid で想定される形式が決まります。 'CloudEventSchemaV1_0'
'CustomEventSchema'
'EventGridSchema'
inputSchemaMapping これにより、カスタム イベント スキーマを使用した発行が可能になります。 InputSchemaMapping を指定して、ソース スキーマのさまざまなプロパティを EventGridEvent スキーマのさまざまな必須プロパティにマップできます。 InputSchemaMapping
privateEndpointConnections PrivateEndpointConnection[]
publicNetworkAccess これにより、パブリック ネットワーク経由でトラフィックが許可されるかどうかが決まります。 既定では有効になっています。
{seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /} を構成することで、特定の IP をさらに制限できます。
'Disabled'
'Enabled'

InboundIpRule

名前 説明
action IpMask の一致または一致に基づいて実行するアクション。 'Allow'
ipMask CIDR 表記の IP アドレス (例: 10.0.0.0/8)。 string

InputSchemaMapping

名前 説明
inputSchemaMappingType オブジェクトの種類を設定する Json (必須)

JsonInputSchemaMapping

名前 説明
inputSchemaMappingType カスタム マッピングの種類 'Json' (必須)
properties 入力スキーマ マッピングの JSON プロパティ JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

名前 説明
dataVersion Event Grid イベントの DataVersion プロパティのマッピング情報。 JsonFieldWithDefault
eventTime Event Grid イベントの EventTime プロパティのマッピング情報。 JsonField
eventType Event Grid イベントの EventType プロパティのマッピング情報。 JsonFieldWithDefault
id Event Grid イベントの Id プロパティのマッピング情報。 JsonField
subject Event Grid イベントの Subject プロパティのマッピング情報。 JsonFieldWithDefault
topic Event Grid イベントの Topic プロパティのマッピング情報。 JsonField

JsonFieldWithDefault

名前 説明
defaultValue SourceField が指定されていない場合、または発行された JSON イベント ペイロードに指定された名前のプロパティがない場合に、マッピングに使用される既定値。 string
sourceField マッピングのソースとして使用される入力イベント スキーマ内のフィールドの名前。 string

JsonField

名前 説明
sourceField マッピングのソースとして使用される入力イベント スキーマ内のフィールドの名前。 string

PrivateEndpointConnection

名前 説明
properties PrivateEndpointConnection のプロパティ。 PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

名前 説明
groupIds プライベート リンク サービス リソースの GroupIds。 string[]
privateEndpoint この接続のプライベート エンドポイント リソース。 PrivateEndpoint
privateLinkServiceConnectionState 接続の状態の詳細。 ConnectionState
provisioningState プライベート エンドポイント接続のプロビジョニング状態。 'Canceled'
'Creating'
'削除中'
'Failed'
'Succeeded'
'更新中'

PrivateEndpoint

名前 説明
id プライベート エンドポイントの ARM 識別子。 string

ConnectionState

名前 説明
actionsRequired 必要なアクション (存在する場合)。 string
description 接続状態の説明。 string
status 接続の状態。 '承認済み'
'Disconnected'
'保留中'
'Rejected'

ResourceSku

名前 説明
name リソースの Sku 名。 使用できる値は、Basic または Premium です。 'Basic'
'Premium'

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
カスタム トピックとサブスクリプションAzure Event Grid作成する

Azure にデプロイする
Azure Event Gridカスタム トピックと Webhook サブスクリプションを作成します。 最初に John Downs によって作成されたテンプレート。
CloudEvents を使用したカスタム Azure Event Grid トピック/サブスクリプション

Azure にデプロイする
カスタム Azure Event Grid トピック、CloudEvents スキーマを持つ Webhook サブスクリプション、およびイベント ハンドラーとしてのロジック アプリを作成します。 テンプレートは、もともと Justin Yoo によって作成されました。
Event Grid カスタム トピックとイベント ハブ ハンドラーを作成する

Azure にデプロイする
イベントを処理Azure Event Gridカスタム トピックとイベント ハブを作成します。
カスタム トピックとキュー サブスクリプションAzure Event Grid作成する

Azure にデプロイする
Azure Event Gridカスタム トピックと Service Bus キュー サブスクリプションを作成します。 テンプレートは、もともと Markus Meyer によって作成されました。
カスタム トピック サブスクリプションAzure Event Grid作成する

Azure にデプロイする
Azure Event Gridカスタム トピックと Service Bus トピック サブスクリプションを作成します。 テンプレートは、もともと Markus Meyer によって作成されました。

Terraform (AzAPI プロバイダー) リソース定義

トピック リソースの種類は、次を対象とする操作でデプロイできます。

  • リソース グループ

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.EventGrid/topics リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/topics@2020-04-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      inboundIpRules = [
        {
          action = "Allow"
          ipMask = "string"
        }
      ]
      inputSchema = "string"
      inputSchemaMapping = {
        inputSchemaMappingType = "string"
        // For remaining properties, see InputSchemaMapping objects
      }
      privateEndpointConnections = [
        {
          properties = {
            groupIds = [
              "string"
            ]
            privateEndpoint = {
              id = "string"
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
            provisioningState = "string"
          }
        }
      ]
      publicNetworkAccess = "string"
    }
    sku = {
      name = "string"
    }
  })
}

InputSchemaMapping オブジェクト

inputSchemaMappingType プロパティを設定して、オブジェクトの種類を指定します。

Json の場合は、次の値を使用します。

  inputSchemaMappingType = "Json"
  properties = {
    dataVersion = {
      defaultValue = "string"
      sourceField = "string"
    }
    eventTime = {
      sourceField = "string"
    }
    eventType = {
      defaultValue = "string"
      sourceField = "string"
    }
    id = {
      sourceField = "string"
    }
    subject = {
      defaultValue = "string"
      sourceField = "string"
    }
    topic = {
      sourceField = "string"
    }
  }

プロパティ値

topics

名前 説明
type リソースの種類 "Microsoft.EventGrid/topics@2020-04-01-preview"
name リソース名 string (必須)

文字制限: 3 から 50

有効な文字:
英数字とハイフン。
location リソースの場所。 string (必須)
parent_id リソース グループにデプロイするには、そのリソース グループの ID を使用します。 string (必須)
tags リソースのタグ。 タグの名前と値のディクショナリ。
sku トピックの Sku 価格レベル。 ResourceSku
identity リソースの ID 情報。 IdentityInfo
properties トピックのプロパティ。 TopicProperties

IdentityInfo

名前 説明
type 使用されるマネージド ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' では、任意の ID が削除されます。 "SystemAssigned"
"SystemAssigned、UserAssigned"
"UserAssigned"
identity_ids リソースに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ キー参照は、次の形式の ARM リソース ID になります。
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'
このプロパティは現在使用されておらず、今後の使用のために予約されています。
ユーザー ID ID の配列。

IdentityInfoUserAssignedIdentities

名前 説明
{カスタマイズされたプロパティ} UserIdentityProperties

UserIdentityProperties

名前 説明
clientId ユーザー割り当て ID のクライアント ID。 string
principalId ユーザー割り当て ID のプリンシパル ID。 string

TopicProperties

名前 説明
inboundIpRules これは、すべての IP ではなく、特定の IP からのトラフィックを制限するために使用できます。 注: これらは、PublicNetworkAccess が有効になっている場合にのみ考慮されます。 InboundIpRule[]
inputSchema これにより、トピックに発行された受信イベントに対して Event Grid で想定される形式が決まります。 "CloudEventSchemaV1_0"
"CustomEventSchema"
"EventGridSchema"
inputSchemaMapping これにより、カスタム イベント スキーマを使用した発行が可能になります。 InputSchemaMapping を指定して、ソース スキーマのさまざまなプロパティを EventGridEvent スキーマのさまざまな必須プロパティにマップできます。 InputSchemaMapping
privateEndpointConnections PrivateEndpointConnection[]
publicNetworkAccess これにより、パブリック ネットワーク経由でトラフィックが許可されるかどうかが決まります。 既定では有効になっています。
{seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /} を構成することで、特定の IP をさらに制限できます。
"無効"
"有効"

InboundIpRule

名前 説明
action IpMask の一致または一致に基づいて実行するアクション。 "許可"
ipMask CIDR 表記の IP アドレス (例: 10.0.0.0/8)。 string

InputSchemaMapping

名前 説明
inputSchemaMappingType オブジェクトの種類を設定する Json (必須)

JsonInputSchemaMapping

名前 説明
inputSchemaMappingType カスタム マッピングの種類 "Json" (必須)
properties 入力スキーマ マッピングの JSON プロパティ JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

名前 説明
dataVersion Event Grid イベントの DataVersion プロパティのマッピング情報。 JsonFieldWithDefault
eventTime Event Grid イベントの EventTime プロパティのマッピング情報。 JsonField
eventType Event Grid イベントの EventType プロパティのマッピング情報。 JsonFieldWithDefault
id Event Grid イベントの Id プロパティのマッピング情報。 JsonField
subject Event Grid イベントの Subject プロパティのマッピング情報。 JsonFieldWithDefault
topic Event Grid イベントの Topic プロパティのマッピング情報。 JsonField

JsonFieldWithDefault

名前 説明
defaultValue SourceField が指定されていない場合、または発行された JSON イベント ペイロードに指定された名前のプロパティがない場合に、マッピングに使用される既定値。 string
sourceField マッピングのソースとして使用される入力イベント スキーマ内のフィールドの名前。 string

JsonField

名前 説明
sourceField マッピングのソースとして使用される入力イベント スキーマ内のフィールドの名前。 string

PrivateEndpointConnection

名前 説明
properties PrivateEndpointConnection のプロパティ。 PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

名前 説明
groupIds プライベート リンク サービス リソースの GroupIds。 string[]
privateEndpoint この接続のプライベート エンドポイント リソース。 PrivateEndpoint
privateLinkServiceConnectionState 接続の状態の詳細。 ConnectionState
provisioningState プライベート エンドポイント接続のプロビジョニング状態。 "キャンセル済み"
"作成中"
"削除中"
"Failed"
"Succeeded"
"更新中"

PrivateEndpoint

名前 説明
id プライベート エンドポイントの ARM 識別子。 string

ConnectionState

名前 説明
actionsRequired 必要なアクション (存在する場合)。 string
description 接続状態の説明。 string
status 接続の状態。 "承認済み"
"Disconnected"
"保留中"
"Rejected"

ResourceSku

名前 説明
name リソースの Sku 名。 使用できる値は、Basic または Premium です。 "Basic"
"Premium"