Partilhar via


Propriedades de entrega para assinaturas de tópicos de namespace

As assinaturas de eventos permitem configurar cabeçalhos HTTP que serão incluídos nos eventos entregues. Esse recurso permite que você defina cabeçalhos personalizados que o destino exige. Você pode configurar até 10 cabeçalhos ao criar uma assinatura de evento. Cada valor de cabeçalho não deve ser maior que 4.096 (4K) bytes.

Você pode definir cabeçalhos personalizados nos eventos que são entregues aos seguintes destinos: Hubs de Eventos do Azure.

Ao criar uma assinatura de evento no portal do Azure, você pode usar a guia Propriedades de Entrega para definir cabeçalhos HTTP personalizados. Esta página permite definir valores de cabeçalho fixos e dinâmicos.

Definindo valores de cabeçalho estático

Para definir cabeçalhos com um valor fixo, forneça o nome do cabeçalho e seu valor nos campos correspondentes:

Screenshot that shows the Delivery Properties tab of the Create Event Subscription page with an example static header.

Você pode querer verificar É secreto?, quando você estiver fornecendo dados confidenciais. A visibilidade de dados confidenciais no portal do Azure depende da permissão RBAC (controle de acesso baseado em função) do usuário.

Definição de valores de cabeçalho dinâmicos

Você pode definir o valor de um cabeçalho com base em uma propriedade em um evento de entrada. Use a sintaxe JsonPath para se referir ao valor da propriedade de um evento de entrada a ser usado como o valor de um cabeçalho em solicitações de saída. Somente valores JSON de string, number e boolean são suportados. Por exemplo, para definir o valor de um cabeçalho chamado channel usando o valor do sistema de propriedades de evento de entrada nos dados do evento, configure sua assinatura de evento da seguinte maneira:

Screenshot that shows the Delivery Properties tab of the Create Event Subscription page with an example dynamic header.

Exemplos

Esta seção fornece alguns exemplos de uso de propriedades de entrega.

Exemplo de Hubs de Eventos

Se você precisar publicar eventos em uma partição específica dentro de um hub de eventos, defina a propriedade em sua assinatura de evento para especificar a chave de partição que identifica a PartitionKey partição do hub de eventos de destino.

Nome do cabeçalho Tipo de cabeçalho
PartitionKey Estático ou dinâmico

Você também pode especificar propriedades personalizadas ao enviar mensagens para um hub de eventos. Não use o prefixo para o aeg- nome da propriedade, pois ele é usado pelas propriedades do sistema nos cabeçalhos das mensagens. Para obter uma lista de propriedades de cabeçalho de mensagem, consulte Hubs de eventos como um manipulador de eventos.

Próximos passos

Para obter mais informações sobre a entrega de eventos, consulte o seguinte artigo: