다음을 통해 공유


Microsoft.EventGrid topics 2020-10-15-preview

Bicep 리소스 정의

topics 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.EventGrid/topics 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.EventGrid/topics@2020-10-15-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  kind: 'string'
  extendedLocation: {
    name: 'string'
    type: '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
    }
    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 Description
name 리소스 이름 string(필수)

문자 제한: 3-50

유효한 문자:
영숫자 및 하이픈
위치 리소스의 위치입니다. string(필수)
tags 리소스의 태그입니다. 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
sku 토픽의 Sku 가격 책정 계층입니다. ResourceSku
kind 리소스 종류입니다. 'Azure'
'AzureArc'
extendedLocation 리소스의 확장된 위치입니다. ExtendedLocation
identity 리소스에 대한 ID 정보입니다. IdentityInfo
properties 항목의 속성입니다. TopicProperties

ExtendedLocation

Name Description
name 확장된 위치의 정규화된 이름입니다. 문자열
type 확장된 위치의 형식입니다. string

IdentityInfo

Name Description
principalId 리소스 ID의 보안 주체 ID입니다. 문자열
tenantId 리소스의 테넌트 ID입니다. 문자열
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

Name Description
{customized property} UserIdentityProperties

UserIdentityProperties

Name Description
clientId 사용자 할당 ID의 클라이언트 ID입니다. 문자열
principalId 사용자 할당 ID의 보안 주체 ID입니다. string

TopicProperties

Name Description
inboundIpRules 모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하는 경우에만 고려됩니다. InboundIpRule[]
inputSchema 그러면 Event Grid가 토픽에 게시된 들어오는 이벤트에 대해 예상해야 하는 형식이 결정됩니다. 'CloudEventSchemaV1_0'
'CustomEventSchema'
'EventGridSchema'
inputSchemaMapping 이렇게 하면 사용자 지정 이벤트 스키마를 사용하여 게시할 수 있습니다. 원본 스키마의 다양한 속성을 EventGridEvent 스키마의 다양한 필수 속성에 매핑하도록 InputSchemaMapping을 지정할 수 있습니다. InputSchemaMapping
publicNetworkAccess 이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다.
{seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /}를 구성하여 특정 IP로 더 제한할 수 있습니다.
'Disabled'
'Enabled'

InboundIpRule

Name Description
action IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다. '허용'
ipMask CIDR 표기법의 IP 주소(예: 10.0.0.0/8). 문자열

InputSchemaMapping

Name Description
inputSchemaMappingType 개체 유형 설정 Json (필수)

JsonInputSchemaMapping

Name Description
inputSchemaMappingType 사용자 지정 매핑 유형 'Json'(필수)
properties 입력 스키마 매핑의 JSON 속성 JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Name Description
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
토픽 Event Grid 이벤트의 Topic 속성에 대한 매핑 정보입니다. JsonField

JsonFieldWithDefault

Name Description
defaultValue SourceField가 제공되지 않거나 게시된 JSON 이벤트 페이로드에 지정된 이름의 속성이 없는 경우 매핑에 사용할 기본값입니다. string
sourceField 매핑의 원본으로 사용할 입력 이벤트 스키마의 필드 이름입니다. 문자열

JsonField

Name Description
sourceField 매핑의 원본으로 사용할 입력 이벤트 스키마의 필드 이름입니다. 문자열

ResourceSku

Name Description
name 리소스의 Sku 이름입니다. 가능한 값은 기본 또는 프리미엄입니다. 'Basic'
'프리미엄'

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.

템플릿 Description
Azure Event Grid 사용자 지정 토픽 및 구독 만들기

Azure에 배포
Azure Event Grid 사용자 지정 토픽 및 웹후크 구독을 만듭니다. 원래 John Downs가 작성한 템플릿입니다.
CloudEvents를 사용하여 사용자 지정 Azure Event Grid 토픽/구독

Azure에 배포
사용자 지정 Azure Event Grid 토픽, CloudEvents 스키마가 있는 웹후크 구독 및 이벤트 처리기로 논리 앱을 만듭니다. 원래 저스틴 유에 의해 작성 된 템플릿.
Event Grid 사용자 지정 토픽 및 이벤트 허브 처리기 만들기

Azure에 배포
이벤트를 처리하는 Azure Event Grid 사용자 지정 토픽 및 이벤트 허브를 만듭니다.
Azure Event Grid 사용자 지정 토픽 및 큐 구독 만들기

Azure에 배포
Azure Event Grid 사용자 지정 토픽 및 Service Bus 큐 구독을 만듭니다. 원래 마르쿠스 마이어가 작성한 템플릿입니다.
Azure Event Grid 사용자 지정 토픽 구독 만들기

Azure에 배포
Azure Event Grid 사용자 지정 토픽 및 Service Bus 토픽 구독을 만듭니다. 원래 마르쿠스 마이어가 작성한 템플릿입니다.

ARM 템플릿 리소스 정의

topics 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.EventGrid/topics 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.EventGrid/topics",
  "apiVersion": "2020-10-15-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "kind": "string",
  "extendedLocation": {
    "name": "string",
    "type": "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
    },
    "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 Description
형식 리소스 종류 'Microsoft.EventGrid/topics'
apiVersion 리소스 api 버전 '2020-10-15-preview'
name 리소스 이름 string(필수)

문자 제한: 3-50

유효한 문자:
영숫자 및 하이픈
위치 리소스의 위치입니다. string(필수)
tags 리소스의 태그입니다. 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
sku 토픽의 Sku 가격 책정 계층입니다. ResourceSku
kind 리소스 종류입니다. 'Azure'
'AzureArc'
extendedLocation 리소스의 확장된 위치입니다. ExtendedLocation
identity 리소스에 대한 ID 정보입니다. IdentityInfo
properties 항목의 속성입니다. TopicProperties

ExtendedLocation

Name Description
name 확장된 위치의 정규화된 이름입니다. 문자열
type 확장된 위치의 형식입니다. 문자열

IdentityInfo

Name Description
principalId 리소스 ID의 보안 주체 ID입니다. string
tenantId 리소스의 테넌트 ID입니다. 문자열
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

Name Description
{customized property} UserIdentityProperties

UserIdentityProperties

Name Description
clientId 사용자 할당 ID의 클라이언트 ID입니다. 문자열
principalId 사용자 할당 ID의 보안 주체 ID입니다. string

TopicProperties

Name Description
inboundIpRules 모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하는 경우에만 고려됩니다. InboundIpRule[]
inputSchema 그러면 Event Grid가 토픽에 게시된 들어오는 이벤트에 대해 예상해야 하는 형식이 결정됩니다. 'CloudEventSchemaV1_0'
'CustomEventSchema'
'EventGridSchema'
inputSchemaMapping 이렇게 하면 사용자 지정 이벤트 스키마를 사용하여 게시할 수 있습니다. 원본 스키마의 다양한 속성을 EventGridEvent 스키마의 다양한 필수 속성에 매핑하도록 InputSchemaMapping을 지정할 수 있습니다. InputSchemaMapping
publicNetworkAccess 이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다.
{seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /}를 구성하여 특정 IP로 더 제한할 수 있습니다.
'Disabled'
'Enabled'

InboundIpRule

Name Description
action IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다. '허용'
ipMask CIDR 표기법의 IP 주소(예: 10.0.0.0/8). 문자열

InputSchemaMapping

Name Description
inputSchemaMappingType 개체 유형 설정 Json (필수)

JsonInputSchemaMapping

Name Description
inputSchemaMappingType 사용자 지정 매핑 유형 'Json'(필수)
properties 입력 스키마 매핑의 JSON 속성 JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Name Description
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
토픽 Event Grid 이벤트의 Topic 속성에 대한 매핑 정보입니다. JsonField

JsonFieldWithDefault

Name Description
defaultValue SourceField가 제공되지 않거나 게시된 JSON 이벤트 페이로드에 지정된 이름의 속성이 없는 경우 매핑에 사용할 기본값입니다. string
sourceField 매핑의 원본으로 사용할 입력 이벤트 스키마의 필드 이름입니다. 문자열

JsonField

Name Description
sourceField 매핑의 원본으로 사용할 입력 이벤트 스키마의 필드 이름입니다. 문자열

ResourceSku

Name Description
name 리소스의 Sku 이름입니다. 가능한 값은 기본 또는 프리미엄입니다. '기본'
'프리미엄'

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플릿 Description
Azure Event Grid 사용자 지정 토픽 및 구독 만들기

Azure에 배포
Azure Event Grid 사용자 지정 토픽 및 웹후크 구독을 만듭니다. 원래 John Downs가 작성한 템플릿입니다.
CloudEvents를 사용하여 사용자 지정 Azure Event Grid 토픽/구독

Azure에 배포
사용자 지정 Azure Event Grid 토픽, CloudEvents 스키마가 있는 웹후크 구독 및 논리 앱을 이벤트 처리기로 만듭니다. 원래 저스틴 유에 의해 작성 된 템플릿.
Event Grid 사용자 지정 토픽 및 이벤트 허브 처리기 만들기

Azure에 배포
이벤트를 처리할 Azure Event Grid 사용자 지정 토픽 및 이벤트 허브를 만듭니다.
Azure Event Grid 사용자 지정 토픽 및 큐 구독 만들기

Azure에 배포
Azure Event Grid 사용자 지정 토픽 및 Service Bus 큐 구독을 만듭니다. 원래 마르쿠스 마이어에 의해 작성 된 템플릿.
Azure Event Grid 사용자 지정 토픽 구독 만들기

Azure에 배포
Azure Event Grid 사용자 지정 토픽 및 Service Bus 토픽 구독을 만듭니다. 원래 마르쿠스 마이어에 의해 작성 된 템플릿.

Terraform(AzAPI 공급자) 리소스 정의

topics 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.EventGrid/topics 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/topics@2020-10-15-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
      }
      publicNetworkAccess = "string"
    }
    sku = {
      name = "string"
    }
    kind = "string"
    extendedLocation = {
      name = "string"
      type = "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 Description
형식 리소스 종류 "Microsoft.EventGrid/topics@2020-10-15-preview"
name 리소스 이름 string(필수)

문자 제한: 3-50

유효한 문자:
영숫자 및 하이픈
위치 리소스의 위치입니다. string(필수)
parent_id 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. string(필수)
tags 리소스의 태그입니다. 태그 이름 및 값의 사전입니다.
sku 토픽의 Sku 가격 책정 계층입니다. ResourceSku
kind 리소스 종류입니다. "Azure"
"AzureArc"
extendedLocation 리소스의 확장된 위치입니다. ExtendedLocation
identity 리소스에 대한 ID 정보입니다. IdentityInfo
properties 항목의 속성입니다. TopicProperties

ExtendedLocation

Name Description
name 확장된 위치의 정규화된 이름입니다. 문자열
type 확장된 위치의 형식입니다. 문자열

IdentityInfo

Name Description
형식 사용되는 관리 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

Name Description
{사용자 지정 속성} UserIdentityProperties

UserIdentityProperties

Name Description
clientId 사용자 할당 ID의 클라이언트 ID입니다. 문자열
principalId 사용자 할당 ID의 보안 주체 ID입니다. 문자열

TopicProperties

Name Description
inboundIpRules 모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하도록 설정한 경우에만 고려됩니다. InboundIpRule[]
inputSchema 이는 Event Grid가 토픽에 게시된 들어오는 이벤트에 대해 예상해야 하는 형식을 결정합니다. "CloudEventSchemaV1_0"
"CustomEventSchema"
"EventGridSchema"
inputSchemaMapping 이렇게 하면 사용자 지정 이벤트 스키마를 사용하여 게시할 수 있습니다. Source 스키마의 다양한 속성을 EventGridEvent 스키마의 다양한 필수 속성에 매핑하도록 InputSchemaMapping을 지정할 수 있습니다. InputSchemaMapping
publicNetworkAccess 이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다.
{seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" /}를 구성하여 특정 IP로 더 제한할 수 있습니다.
"사용 안 함"
"사용"

InboundIpRule

Name Description
action IpMask의 일치 또는 일치 항목에 따라 수행할 작업입니다. "허용"
ipMask CIDR 표기법의 IP 주소(예: 10.0.0.0/8). string

InputSchemaMapping

Name Description
inputSchemaMappingType 개체 형식 설정 Json (필수)

JsonInputSchemaMapping

Name Description
inputSchemaMappingType 사용자 지정 매핑 유형 "Json"(필수)
properties 입력 스키마 매핑의 JSON 속성 JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Name Description
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
토픽 Event Grid 이벤트의 Topic 속성에 대한 매핑 정보입니다. JsonField

JsonFieldWithDefault

Name Description
defaultValue SourceField가 제공되지 않거나 게시된 JSON 이벤트 페이로드에 지정된 이름의 속성이 없는 경우 매핑에 사용할 기본값입니다. string
sourceField 매핑의 원본으로 사용할 입력 이벤트 스키마의 필드 이름입니다. 문자열

JsonField

Name Description
sourceField 매핑의 원본으로 사용할 입력 이벤트 스키마의 필드 이름입니다. 문자열

ResourceSku

Name Description
name 리소스의 Sku 이름입니다. 가능한 값은 기본 또는 프리미엄입니다. "Basic"
"프리미엄"