Skip to content

Commit fce9470

Browse files
committed
Delivery Properties
1 parent 5558f64 commit fce9470

File tree

5 files changed

+42
-4
lines changed

5 files changed

+42
-4
lines changed

articles/event-grid/event-schema-event-hubs.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,17 @@ The data object has the following properties:
122122
| `firstEnqueueTime` | string | The first time from the queue. |
123123
| `lastEnqueueTime` | string | The last time from the queue. |
124124

125+
## Delivery properties
126+
Event subscriptions allow you to set up HTTP headers that are included in delivered events. This capability allows you to set custom headers that are required by a destination. You can set custom headers on the events that are delivered to Azure Event Hubs.
127+
128+
If you need to publish events to a specific partition within an event hub, set the `ParitionKey` property on your event subscription to specify the partition key that identifies the target event hub partition.
129+
130+
| Header name | Header type |
131+
| :-- | :-- |
132+
|`PartitionKey` | Static |
133+
134+
For more information, see [Custom delivery properties](delivery-properties.md).
135+
125136
## Tutorials and how-tos
126137

127138
|Title |Description |

articles/event-grid/handler-event-hubs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Event hub as an event handler for Azure Event Grid events
33
description: Describes how you can use event hubs as event handlers for Azure Event Grid events.
44
ms.topic: conceptual
5-
ms.date: 09/28/2021
5+
ms.date: 09/30/2021
66
---
77

88
# Event hub as an event handler for Azure Event Grid events

articles/event-grid/handler-service-bus.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Service Bus queues and topics as event handlers for Azure Event Grid events
33
description: Describes how you can use Service Bus queues and topics as event handlers for Azure Event Grid events.
44
ms.topic: conceptual
5-
ms.date: 09/28/2021
5+
ms.date: 09/30/2021
66
---
77

88
# Service Bus queues and topics as event handlers for Azure Event Grid events
@@ -146,5 +146,28 @@ The internal system ID for the message will be maintained across redelivery of t
146146
}
147147
```
148148

149+
## Delivery properties
150+
Event subscriptions allow you to set up HTTP headers that are included in delivered events. This capability allows you to set custom headers that are required by a destination. You can set custom headers on the events that are delivered to Azure Service Bus queues and topics.
151+
152+
Azure Service Bus supports the use of following message properties when sending single messages.
153+
154+
| Header name | Header type |
155+
| :-- | :-- |
156+
| `MessageId` | Dynamic |
157+
| `PartitionKey` | Static or dynamic |
158+
| `SessionId` | Static or dynamic |
159+
| `CorrelationId` | Static or dynamic |
160+
| `Label` | Static or dynamic |
161+
| `ReplyTo` | Static or dynamic |
162+
| `ReplyToSessionId` | Static or dynamic |
163+
| `To` |Static or dynamic |
164+
| `ViaPartitionKey` | Static or dynamic |
165+
166+
> [!NOTE]
167+
> - The default value of `MessageId` is the internal ID of the Event Grid event. You can override it. For example, `data.field`.
168+
> - You can only set either `SessionId` or `MessageId`.
169+
170+
For more information, see [Custom delivery properties](delivery-properties.md).
171+
149172
## Next steps
150173
See the [Event handlers](event-handlers.md) article for a list of supported event handlers.

articles/event-grid/post-to-custom-topic.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,14 @@ ms.date: 08/19/2021
66
ms.custom: devx-track-azurepowershell
77
---
88

9-
# Post to Azure Event Grid custom topics using access keys
9+
# Publish events to Azure Event Grid custom topics using access keys
1010

1111
This article describes how to post an event to a custom topic using an access key. It shows the format of the post and event data. The [Service Level Agreement (SLA)](https://azure.microsoft.com/support/legal/sla/event-grid/v1_0/) only applies to posts that match the expected format.
1212

13+
14+
> [!NOTE]
15+
> Azure AD authentication provides a superior authentication support than that's offered by access key or Shared Access Signature (SAS) token authentication. With Azure AD authentication, the identity is validated against Azure AD identity provider. As a developer, you won't have to handle keys in your code if you use Azure AD authentication. you'll also benefit from all security features built into the Microsoft Identity platform, such as Conditional Access, that can help you improve your application's security stance. For more information, see [Authenticate publishing clients using Azure Active Directory](authenticate-with-active-directory.md).
16+
1317
## Endpoint
1418

1519
When sending the HTTP POST to a custom topic, use the URI format: `https://<topic-endpoint>?api-version=2018-01-01`.

articles/event-grid/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -252,7 +252,7 @@
252252
href: auth0-how-to.md
253253
- name: Get access keys for topics or domains
254254
href: get-access-keys.md
255-
- name: Post to custom topics using access keys
255+
- name: Publish events custom topics using access keys
256256
href: post-to-custom-topic.md
257257
- name: Receive events at HTTP endpoint
258258
href: receive-events.md

0 commit comments

Comments
 (0)