배달 못한 편지 위치 설정 및 정책 다시 시도

이벤트 구독을 만들 때 이벤트 전송 설정을 사용자 지정할 수 있습니다. 이 문서에서는 배달 못한 편지 위치를 설정하고 재시도 설정을 사용자 지정하는 방법을 보여 줍니다. 이 기능에 대한 자세한 내용은 Event Grid 메시지 전송 및 재시도를 참조하세요.

배달 못한 편지 위치 설정

배달 못한 편지 위치를 설정하려면 엔드포인트로 전달할 수 없는 이벤트를 보유할 스토리지 계정이 필요합니다. 이 예제는 기존 스토리지 계정의 리소스 ID를 가져옵니다. 배달 못한 편지 엔드포인트의 스토리지 계정에 있는 컨테이너를 사용하는 이벤트 구독을 만듭니다.

Azure Portal

이벤트 구독을 만드는 동안 다음 이미지와 같이 추가 기능 탭에서 배달 못한 편지 기능을 사용하도록 설정할 수 있습니다. 이 기능을 사용하도록 설정한 후에는 배달 못한 편지 이벤트를 보관할 Blob 컨테이너와 Blob Storage가 있는 Azure 구독을 지정합니다.

필요에 따라 배달 못한 편지에 대해 시스템이 할당한 관리 ID 또는 사용자가 할당한 관리 ID를 사용하도록 설정할 수 있습니다. 관리 ID는 스토리지에 이벤트를 쓸 수 있는 RBAC(역할 기반 액세스 제어) 역할의 구성원이어야 합니다.

배달 못한 편지를 사용하도록 설정하고 기존 이벤트 구독에 대한 설정을 구성할 수도 있습니다. 이벤트 구독의 이벤트 구독 페이지에서 추가 기능 탭으로 전환하면 다음 이미지와 같이 배달 못한 편지 설정이 표시됩니다.

Azure CLI

containername=testcontainer

topicid=$(az eventgrid topic show --name demoTopic -g gridResourceGroup --query id --output tsv)
storageid=$(az storage account show --name demoStorage --resource-group gridResourceGroup --query id --output tsv)

az eventgrid event-subscription create \
  --source-resource-id $topicid \
  --name <event_subscription_name> \
  --endpoint <endpoint_URL> \
  --deadletter-endpoint $storageid/blobServices/default/containers/$containername

배달 못한 편지를 해제하려면 이벤트 구독을 만드는 명령을 다시 실행하지만 deadletter-endpoint에 대한 값을 제공하지는 않습니다. 이벤트 구독을 삭제할 필요가 없습니다.

PowerShell

$containername = "testcontainer"

$topicid = (Get-AzEventGridTopic -ResourceGroupName gridResourceGroup -Name demoTopic).Id
$storageid = (Get-AzStorageAccount -ResourceGroupName gridResourceGroup -Name demostorage).Id

New-AzEventGridSubscription `
  -ResourceId $topicid `
  -EventSubscriptionName <event_subscription_name> `
  -Endpoint <endpoint_URL> `
  -DeadLetterEndpoint "$storageid/blobServices/default/containers/$containername"

배달 못한 편지를 해제하려면 이벤트 구독을 만드는 명령을 다시 실행하지만 DeadLetterEndpoint에 대한 값을 제공하지는 않습니다. 이벤트 구독을 삭제할 필요가 없습니다.

재시도 정책 설정

Event Grid 구독을 만들 때 Event Grid에서 이벤트 전송을 시도할 기간의 값을 설정할 수 있습니다. 기본적으로 Event Grid는 24시간(1440분) 동안 또는 30회 시도합니다. Event Grid 구독에 대해 이러한 값 중 하나를 설정할 수 있습니다. 이벤트 TTL(Time to Live)의 값은 1과 1440 사이의 정수여야 합니다. 최대 재시도 값은 1과 30 사이의 정수여야 합니다.

재시도 일정을 구성할 수 없습니다.

Azure Portal

이벤트 구독을 만드는 동안 추가 기능 탭에서 재시도 정책 설정을 구성할 수 있습니다.

기존 이벤트 구독에 대해 재시도 정책 설정을 구성할 수도 있습니다. 이벤트 구독의 이벤트 구독 페이지에서 추가 기능 탭으로 전환하면 다음 이미지와 같이 재시도 정책 설정이 표시됩니다.

Azure CLI

이벤트 TTL(Time to Live)을 1440분 이외의 값으로 설정하려면 다음을 사용합니다.

az eventgrid event-subscription create \
  -g gridResourceGroup \
  --topic-name <topic_name> \
  --name <event_subscription_name> \
  --endpoint <endpoint_URL> \
  --event-ttl 720

최대 재시도 값을 30 이외의 값으로 설정하려면 다음을 사용합니다.

az eventgrid event-subscription create \
  -g gridResourceGroup \
  --topic-name <topic_name> \
  --name <event_subscription_name> \
  --endpoint <endpoint_URL> \
  --max-delivery-attempts 18

PowerShell

이벤트 TTL(Time to Live)을 1440분 이외의 값으로 설정하려면 다음을 사용합니다.

$topicid = (Get-AzEventGridTopic -ResourceGroupName gridResourceGroup -Name demoTopic).Id

New-AzEventGridSubscription `
  -ResourceId $topicid `
  -EventSubscriptionName <event_subscription_name> `
  -Endpoint <endpoint_URL> `
  -EventTtl 720

최대 재시도 값을 30 이외의 값으로 설정하려면 다음을 사용합니다.

$topicid = (Get-AzEventGridTopic -ResourceGroupName gridResourceGroup -Name demoTopic).Id

New-AzEventGridSubscription `
  -ResourceId $topicid `
  -EventSubscriptionName <event_subscription_name> `
  -Endpoint <endpoint_URL> `
  -MaxDeliveryAttempt 18

다음 단계

• 배달 못한 편지 이벤트를 처리하기 위해 Azure 함수 앱을 사용하는 샘플 애플리케이션은 .NET용 Azure Event Grid 배달 못한 편지 샘플을 참조하세요.
• 이벤트 배달 및 다시 시도에 대한 자세한 내용은 Event Grid 메시지 배달 및 다시 시도를 참조하세요.
• Event Grid에 대한 소개는 Event Grid 정보를 참조하세요.
• Event Grid를 빠르게 시작하려면 Azure Event Grid를 사용하여 사용자 지정 이벤트 만들기 및 라우팅을 참조하세요.