Microsoft.EventGrid eventSubscriptions

아티클
12/16/2024

Bicep 리소스 정의

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

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

리소스 형식

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

resource symbolicname 'Microsoft.EventGrid/eventSubscriptions@2024-12-15-preview' = {
  scope: resourceSymbolicName or scope
  name: 'string'
  properties: {
    deadLetterDestination: {
      endpointType: 'string'
      // For remaining properties, see DeadLetterDestination objects
    }
    deadLetterWithResourceIdentity: {
      deadLetterDestination: {
        endpointType: 'string'
        // For remaining properties, see DeadLetterDestination objects
      }
      identity: {
        federatedIdentityCredentialInfo: {
          federatedClientId: 'string'
        }
        type: 'string'
        userAssignedIdentity: 'string'
      }
    }
    deliveryWithResourceIdentity: {
      destination: {
        endpointType: 'string'
        // For remaining properties, see EventSubscriptionDestination objects
      }
      identity: {
        federatedIdentityCredentialInfo: {
          federatedClientId: 'string'
        }
        type: 'string'
        userAssignedIdentity: 'string'
      }
    }
    destination: {
      endpointType: 'string'
      // For remaining properties, see EventSubscriptionDestination objects
    }
    eventDeliverySchema: 'string'
    expirationTimeUtc: 'string'
    filter: {
      advancedFilters: [
        {
          key: 'string'
          operatorType: 'string'
          // For remaining properties, see AdvancedFilter objects
        }
      ]
      enableAdvancedFilteringOnArrays: bool
      includedEventTypes: [
        'string'
      ]
      isSubjectCaseSensitive: bool
      subjectBeginsWith: 'string'
      subjectEndsWith: 'string'
    }
    labels: [
      'string'
    ]
    retryPolicy: {
      eventTimeToLiveInMinutes: int
      maxDeliveryAttempts: int
    }
  }
}

DeadLetterDestination 개체

endpointType 속성을 설정하여 개체 유형을 지정합니다.

StorageBlob경우 다음을 사용합니다.

{
  endpointType: 'StorageBlob'
  properties: {
    blobContainerName: 'string'
    resourceId: 'string'
  }
}

DeliveryAttributeMapping 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

동적경우 다음을 사용합니다.

{
  properties: {
    sourceField: 'string'
  }
  type: 'Dynamic'
}

정적경우 다음을 사용합니다.

{
  properties: {
    isSecret: bool
    value: 'string'
  }
  type: 'Static'
}

AdvancedFilter 개체

operatorType 속성을 설정하여 개체 유형을 지정합니다.

BoolEquals경우 다음을 사용합니다.

{
  operatorType: 'BoolEquals'
  value: bool
}

IsNotNull경우 다음을 사용합니다.

{
  operatorType: 'IsNotNull'
}

isNullOrUn 정의경우 다음을 사용합니다.

{
  operatorType: 'IsNullOrUndefined'
}

NumberGreaterThan경우 다음을 사용합니다.

{
  operatorType: 'NumberGreaterThan'
  value: int
}

NumberGreaterThanOrEquals경우 다음을 사용합니다.

{
  operatorType: 'NumberGreaterThanOrEquals'
  value: int
}

NumberIn경우 다음을 사용합니다.

{
  operatorType: 'NumberIn'
  values: [
    int
  ]
}

numberInRange경우 다음을 사용합니다.

{
  operatorType: 'NumberInRange'
  values: [
    [
      int
    ]
  ]
}

numberLessThan경우 다음을 사용합니다.

{
  operatorType: 'NumberLessThan'
  value: int
}

numberLessThanOrEquals경우 다음을 사용합니다.

{
  operatorType: 'NumberLessThanOrEquals'
  value: int
}

NumberNotIn경우 다음을 사용합니다.

{
  operatorType: 'NumberNotIn'
  values: [
    int
  ]
}

NumberNotInRange경우 다음을 사용합니다.

{
  operatorType: 'NumberNotInRange'
  values: [
    [
      int
    ]
  ]
}

StringBeginsWith경우 다음을 사용합니다.

{
  operatorType: 'StringBeginsWith'
  values: [
    'string'
  ]
}

StringContains경우 다음을 사용합니다.

{
  operatorType: 'StringContains'
  values: [
    'string'
  ]
}

StringEndsWith경우 다음을 사용합니다.

{
  operatorType: 'StringEndsWith'
  values: [
    'string'
  ]
}

StringIn경우 다음을 사용합니다.

{
  operatorType: 'StringIn'
  values: [
    'string'
  ]
}

StringNotBeginsWith경우 다음을 사용합니다.

{
  operatorType: 'StringNotBeginsWith'
  values: [
    'string'
  ]
}

StringNotContains경우 다음을 사용합니다.

{
  operatorType: 'StringNotContains'
  values: [
    'string'
  ]
}

StringNotEndsWith다음을 사용합니다.

{
  operatorType: 'StringNotEndsWith'
  values: [
    'string'
  ]
}

StringNotIn경우 다음을 사용합니다.

{
  operatorType: 'StringNotIn'
  values: [
    'string'
  ]
}

EventSubscriptionDestination 개체

endpointType 속성을 설정하여 개체 유형을 지정합니다.

azureFunction경우 다음을 사용합니다.

{
  endpointType: 'AzureFunction'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    maxEventsPerBatch: int
    preferredBatchSizeInKilobytes: int
    resourceId: 'string'
  }
}

eventHub경우 다음을 사용합니다.

{
  endpointType: 'EventHub'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId: 'string'
  }
}

HybridConnection경우 다음을 사용합니다.

{
  endpointType: 'HybridConnection'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId: 'string'
  }
}

MonitorAlert경우 다음을 사용합니다.

{
  endpointType: 'MonitorAlert'
  properties: {
    actionGroups: [
      'string'
    ]
    description: 'string'
    severity: 'string'
  }
}

NamespaceTopic경우 다음을 사용합니다.

{
  endpointType: 'NamespaceTopic'
  properties: {
    resourceId: 'string'
  }
}

PartnerDestination경우 다음을 사용합니다.

{
  endpointType: 'PartnerDestination'
  properties: {
    resourceId: 'string'
  }
}

serviceBusQueue경우 다음을 사용합니다.

{
  endpointType: 'ServiceBusQueue'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId: 'string'
  }
}

serviceBusTopic경우 다음을 사용합니다.

{
  endpointType: 'ServiceBusTopic'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId: 'string'
  }
}

storageQueue경우 다음을 사용합니다.

{
  endpointType: 'StorageQueue'
  properties: {
    queueMessageTimeToLiveInSeconds: int
    queueName: 'string'
    resourceId: 'string'
  }
}

WebHook경우 다음을 사용합니다.

{
  endpointType: 'WebHook'
  properties: {
    azureActiveDirectoryApplicationIdOrUri: 'string'
    azureActiveDirectoryTenantId: 'string'
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    endpointUrl: 'string'
    maxEventsPerBatch: int
    minimumTlsVersionAllowed: 'string'
    preferredBatchSizeInKilobytes: int
  }
}

속성 값

AdvancedFilter

이름	묘사	값
열쇠	필터링할 이벤트의 필드/속성입니다.	문자열
operatorType	BoolEqualsAdvancedFilter형식에 대해 'BoolEquals'로 설정합니다. IsNotNullAdvancedFilter형식에 대해 'IsNotNull'로 설정합니다. IsNullOrUndefinedAdvancedFilter형식에 대해 'IsNullOrUndefined'로 설정합니다. numberGreaterThanAdvancedFilter형식에 대해 'NumberGreaterThan'으로 설정합니다. numberGreaterThanOrEqualsAdvancedFilter형식에 대해 'NumberGreaterThanOrEquals'로 설정합니다. NumberInAdvancedFilter형식에 대해 'NumberIn'으로 설정합니다. NumberInRangeAdvancedFilter형식에 대해 'NumberInRange'로 설정합니다. numberLessThanAdvancedFilter형식에 대해 'NumberLessThan'으로 설정합니다. NumberLessThanOrEqualsAdvancedFilter형식에 대해 'NumberLessThanOrEquals'로 설정합니다. NumberNotInAdvancedFilter형식에 대해 'NumberNotIn'으로 설정합니다. NumberNotInRangeAdvancedFilter형식에 대해 'NumberNotInRange'로 설정합니다. StringBeginsWithAdvancedFilter형식에 대해 'StringBeginsWith'로 설정합니다. StringContainsAdvancedFilter형식에 대해 'StringContains'로 설정합니다. StringEndsWithAdvancedFilter형식에 대해 'StringEndsWith'로 설정합니다. StringInAdvancedFilter형식에 대해 'StringIn'으로 설정합니다. StringNotBeginsWithAdvancedFilter형식에 대해 'StringNotBeginsWith'로 설정합니다. StringNotContainsAdvancedFilter형식에 대해 'StringNotContains'로 설정합니다. StringNotEndsWithAdvancedFilter형식에 대해 'StringNotEndsWith'로 설정합니다. StringNotInAdvancedFilter형식에 대해 'StringNotIn'으로 설정합니다.	'BoolEquals' 'IsNotNull' 'IsNullOrUndefined' 'NumberGreaterThan' 'NumberGreaterThanOrEquals' 'NumberIn' 'NumberInRange' 'NumberLessThan' 'NumberLessThanOrEquals' 'NumberNotIn' 'NumberNotInRange' 'StringBeginsWith' 'StringContains' 'StringEndsWith' 'StringIn' 'StringNotBeginsWith' 'StringNotContains' 'StringNotEndsWith' 'StringNotIn'(필수)

AzureFunctionEventSubscriptionDestination

이름	묘사	값
endpointType	이벤트 구독 대상에 대한 엔드포인트의 유형입니다.	'AzureFunction'(필수)
속성	이벤트 구독 대상의 Azure 함수 속성입니다.	AzureFunctionEventSubscriptionDestinationProperties

AzureFunctionEventSubscriptionDestinationProperties

이름	묘사	값
deliveryAttributeMappings	배달 특성 세부 정보입니다.	DeliveryAttributeMapping[]
maxEventsPerBatch	일괄 처리당 최대 이벤트 수입니다.	int
preferredBatchSizeInKilobytes	기본 배치 크기(킬로바이트)입니다.	int
resourceId	이벤트 구독의 Azure Function 대상 엔드포인트를 나타내는 Azure 리소스 ID입니다.	문자열

BoolEqualsAdvancedFilter

이름	묘사	값
operatorType	필터링에 사용되는 연산자 형식(예: NumberIn, StringContains, BoolEquals 등)입니다.	'BoolEquals'(필수)
값	부울 필터 값입니다.	bool

DeadLetterDestination

이름	묘사	값
endpointType	StorageBlobDeadLetterDestination형식에 대해 'StorageBlob'으로 설정합니다.	'StorageBlob'(필수)

DeadLetterWithResourceIdentity

이름	묘사	값
deadLetterDestination	이벤트 구독에 대해 이벤트를 배달해야 하는 대상에 대한 정보입니다. 부모 리소스(즉, 토픽 또는 도메인)에서 관리 ID 설정을 사용하여 배달 못 한 편지에 사용되는 인증 토큰을 가져옵니다.	DeadLetterDestination
신원	배달 못한 편지 이벤트가 발생할 때 사용할 ID입니다.	EventSubscriptionIdentity

DeliveryAttributeMapping

이름	묘사	값
이름	배달 특성 또는 헤더의 이름입니다.	문자열
형	DynamicDeliveryAttributeMapping형식에 대해 '동적'으로 설정합니다. staticDeliveryAttributeMapping형식에 대해 'Static'으로 설정합니다.	'동적' 'Static'(필수)

DeliveryWithResourceIdentity

이름	묘사	값
목적지	이벤트 구독에 대해 이벤트를 배달해야 하는 대상에 대한 정보입니다. 부모 리소스(즉, 토픽 또는 도메인)에서 관리 ID 설정을 사용하여 배달 중에 사용되는 인증 토큰을 획득합니다.	eventSubscriptionDestination
신원	이벤트를 배달할 때 사용할 ID입니다.	EventSubscriptionIdentity

DynamicDeliveryAttributeMapping

이름	묘사	값
속성	동적 배달 특성 매핑의 속성입니다.	DynamicDeliveryAttributeMappingProperties
형	배달 특성 또는 헤더 이름의 형식입니다.	'Dynamic'(필수)

DynamicDeliveryAttributeMappingProperties

이름	묘사	값
sourceField	특성 값이 포함된 이벤트의 JSON 경로입니다.	문자열

EventHubEventSubscriptionDestination

이름	묘사	값
endpointType	이벤트 구독 대상에 대한 엔드포인트의 유형입니다.	'EventHub'(필수)
속성	이벤트 구독 대상의 이벤트 허브 속성입니다.	EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

이름	묘사	값
deliveryAttributeMappings	배달 특성 세부 정보입니다.	DeliveryAttributeMapping[]
resourceId	이벤트 구독의 Event Hub 대상 엔드포인트를 나타내는 Azure 리소스 ID입니다.	문자열

EventSubscriptionDestination

이름	묘사	값
endpointType	AzureFunctionEventSubscriptionDestination형식에 대해 'AzureFunction'으로 설정합니다. EventHubEventSubscriptionDestination형식에 대해 'EventHub'로 설정합니다. HybridConnectionEventSubscriptionDestination형식에 대해 'HybridConnection'으로 설정합니다. MonitorAlertEventSubscriptionDestination형식에 대해 'MonitorAlert'로 설정합니다. NamespaceTopicEventSubscriptionDestination형식에 대해 'NamespaceTopic'으로 설정합니다. PartnerEventSubscriptionDestination형식에 대해 'PartnerDestination'으로 설정합니다. ServiceBusQueueEventSubscriptionDestination형식에 대해 'ServiceBusQueue'로 설정합니다. ServiceBusTopicEventSubscriptionDestination형식에 대해 'ServiceBusTopic'으로 설정합니다. StorageQueueEventSubscriptionDestination형식에 대해 'StorageQueue'로 설정합니다. WebHookEventSubscriptionDestination형식에 대해 'WebHook'으로 설정합니다.	'AzureFunction' 'EventHub' 'HybridConnection' 'MonitorAlert' 'NamespaceTopic' 'PartnerDestination' 'ServiceBusQueue' 'ServiceBusTopic' 'StorageQueue' 'WebHook'(필수)

EventSubscriptionFilter

이름	묘사	값
advancedFilters	이벤트 구독을 필터링하는 데 사용되는 고급 필터의 배열입니다.	AdvancedFilter[]
enableAdvancedFilteringOnArrays	단수 값을 예상하는 대신 고급 필터를 값 배열에 대해 평가할 수 있습니다.	bool
includedEventTypes	이벤트 구독의 일부여야 하는 적용 가능한 이벤트 유형 목록입니다. 모든 기본 이벤트 유형을 구독하려면 IncludedEventTypes를 null로 설정합니다.	string[]
isSubjectCaseSensitive	필터의 SubjectBeginsWith 및 SubjectEndsWith 속성을 지정합니다. 는 대/소문자를 구분하는 방식으로 비교해야 합니다.	bool
subjectBeginsWith	리소스 경로 접두사를 기반으로 이벤트 구독에 대한 이벤트를 필터링하는 선택적 문자열입니다. 이 형식은 이벤트의 게시자에 따라 달라집니다. 와일드카드 문자는 이 경로에서 지원되지 않습니다.	문자열
subjectEndsWith	리소스 경로 접미사를 기반으로 이벤트 구독에 대한 이벤트를 필터링하는 선택적 문자열입니다. 와일드카드 문자는 이 경로에서 지원되지 않습니다.	문자열

EventSubscriptionIdentity

이름	묘사	값
federatedIdentityCredentialInfo	리소스 배달에 사용되는 페더레이션 ID 자격 증명(FIC)의 세부 정보입니다.	FederatedIdentityCredentialInfo
형	사용되는 관리 ID의 형식입니다. 'SystemAssigned' 또는 'UserAssigned'일 수 있습니다.	'SystemAssigned' 'UserAssigned'
userAssignedIdentity	리소스와 연결된 사용자 ID입니다.	문자열

EventSubscriptionProperties

이름	묘사	값
deadLetterDestination	이벤트 구독의 배달 못한 편지 대상입니다. 대상에 배달할 수 없는 모든 이벤트는 배달 못한 편지 대상으로 전송됩니다. Azure Event Grid의 ID를 사용하여 배달/배달 못 한 편지 중에 사용되는 인증 토큰을 획득합니다.	DeadLetterDestination
deadLetterWithResourceIdentity	이벤트 구독의 배달 못한 편지 대상입니다. 대상에 배달할 수 없는 모든 이벤트는 배달 못한 편지 대상으로 전송됩니다. 부모 리소스(즉, 토픽 또는 도메인)에서 관리 ID 설정을 사용하여 배달/배달 못 한 편지 중에 사용되는 인증 토큰을 획득합니다.	DeadLetterWithResourceIdentity
deliveryWithResourceIdentity	이벤트 구독에 대해 이벤트를 배달해야 하는 대상에 대한 정보입니다. 부모 리소스(즉, 토픽 또는 도메인)에서 관리 ID 설정을 사용하여 배달/배달 못 한 편지 중에 사용되는 인증 토큰을 획득합니다.	DeliveryWithResourceIdentity
목적지	이벤트 구독에 대해 이벤트를 배달해야 하는 대상에 대한 정보입니다. Azure Event Grid의 ID를 사용하여 배달/배달 못 한 편지 중에 사용되는 인증 토큰을 획득합니다.	eventSubscriptionDestination
eventDeliverySchema	이벤트 구독에 대한 이벤트 배달 스키마입니다.	'CloudEventSchemaV1_0' 'CustomInputSchema' 'EventGridSchema'
expirationTimeUtc	이벤트 구독의 만료 시간입니다.	문자열
필터	이벤트 구독에 대한 필터에 대한 정보입니다.	eventSubscriptionFilter
레이블	사용자 정의 레이블 목록입니다.	string[]
retryPolicy	이벤트에 대한 재시도 정책입니다. 최대 배달 시도 횟수 및 이벤트 라이브 시간을 구성하는 데 사용할 수 있습니다.	RetryPolicy

FederatedIdentityCredentialInfo

이름	묘사	값
federatedClientId	FIC(페더레이션 ID 자격 증명)가 연결된 다중 테넌트 AAD 애플리케이션입니다.	문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`(필수)

HybridConnectionEventSubscriptionDestination

이름	묘사	값
endpointType	이벤트 구독 대상에 대한 엔드포인트의 유형입니다.	'HybridConnection'(필수)
속성	이벤트 구독 대상의 하이브리드 연결 속성입니다.	HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

이름	묘사	값
deliveryAttributeMappings	배달 특성 세부 정보입니다.	DeliveryAttributeMapping[]
resourceId	이벤트 구독의 대상인 하이브리드 연결의 Azure 리소스 ID입니다.	문자열

IsNotNullAdvancedFilter

이름	묘사	값
operatorType	필터링에 사용되는 연산자 형식(예: NumberIn, StringContains, BoolEquals 등)입니다.	'IsNotNull'(필수)

IsNullOrUndefinedAdvancedFilter

이름	묘사	값
operatorType	필터링에 사용되는 연산자 형식(예: NumberIn, StringContains, BoolEquals 등)입니다.	'IsNullOrUndefined'(필수)