Partilhar via


AmqpMessageHeader Classe

O cabeçalho Mensagem. O cabeçalho Mensagem. Esta ação só é utilizada na mensagem recebida e não é definida nas mensagens que estão a ser enviadas. As propriedades definidas em qualquer mensagem determinada dependerão do Serviço e nem todas as mensagens terão todas as propriedades. Veja a especificação AMQP: http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-header para obter mais informações sobre o cabeçalho da mensagem.

Herança
azure.servicebus.amqp._amqp_message.DictMixin
AmqpMessageHeader

Construtor

AmqpMessageHeader(*, delivery_count: int | None = None, time_to_live: int | None = None, durable: bool | None = None, first_acquirer: bool | None = None, priority: int | None = None, **kwargs: Any)

Parâmetros Só de Palavra-Chave

Name Description
delivery_count

O número de tentativas anteriores sem êxito para entregar esta mensagem. Se este valor não for zero, pode ser considerado como uma indicação de que a entrega pode ser duplicada. Na primeira entrega, o valor é zero. É incrementado após um resultado ser resolvido no remetente, de acordo com as regras definidas para cada resultado.

time_to_live

Duração em milissegundos para a qual a mensagem deve ser considerada "live". Se estiver definido, será calculada uma hora de expiração da mensagem com base na hora de chegada a um intermediário. As mensagens que residam durante mais tempo do que o tempo de expiração serão eliminadas (ou não entregues). Quando uma mensagem é transmitida por um intermediário que foi recebido com um ttl, o cabeçalho da mensagem transmitida DEVE conter um ttl que é calculado como a diferença entre a hora atual e o tempo de expiração da mensagem anteriormente calculada, ou seja, o ttl reduzido, para que as mensagens eventualmente morram se acabarem num ciclo de entrega.

durable

As mensagens duráveis NÃO DEVEM ser perdidas mesmo que um intermediário seja terminado e reiniciado inesperadamente. Um destino que não seja capaz de cumprir esta garantia NÃO PODE aceitar mensagens em que o cabeçalho durável está definido como Verdadeiro: se a origem permitir o resultado rejeitado, a mensagem DEVE ser rejeitada com o erro de falha de pré-condição, caso contrário, a ligação TEM de ser desanexada pelo recetor com o mesmo erro.

first_acquirer

Se este valor for Verdadeiro, esta mensagem não foi adquirida por nenhuma outra ligação. Se este valor for Falso, esta mensagem poderá ter sido adquirida anteriormente por outra ligação ou ligações.

priority

Este campo contém a prioridade da mensagem relativa. Números mais altos indicam mensagens de prioridade mais alta. As mensagens com prioridades mais elevadas podem ser entregues antes das que têm prioridades mais baixas.

Variáveis

Name Description
delivery_count

O número de tentativas anteriores sem êxito para entregar esta mensagem. Se este valor não for zero, pode ser considerado como uma indicação de que a entrega pode ser duplicada. Na primeira entrega, o valor é zero. É incrementado após um resultado ser resolvido no remetente, de acordo com as regras definidas para cada resultado.

time_to_live

Duração em milissegundos para a qual a mensagem deve ser considerada "live". Se estiver definido, será calculada uma hora de expiração da mensagem com base na hora de chegada a um intermediário. As mensagens que residam durante mais tempo do que o tempo de expiração serão eliminadas (ou não entregues). Quando uma mensagem é transmitida por um intermediário que foi recebido com um ttl, o cabeçalho da mensagem transmitida DEVE conter um ttl que é calculado como a diferença entre a hora atual e o tempo de expiração da mensagem anteriormente calculada, ou seja, o ttl reduzido, para que as mensagens eventualmente morram se acabarem num ciclo de entrega.

durable

As mensagens duráveis NÃO DEVEM ser perdidas mesmo que um intermediário seja terminado e reiniciado inesperadamente. Um destino que não seja capaz de cumprir esta garantia NÃO PODE aceitar mensagens em que o cabeçalho durável está definido como Verdadeiro: se a origem permitir o resultado rejeitado, a mensagem DEVE ser rejeitada com o erro de falha de pré-condição, caso contrário, a ligação TEM de ser desanexada pelo recetor com o mesmo erro.

first_acquirer

Se este valor for Verdadeiro, esta mensagem não foi adquirida por nenhuma outra ligação. Se este valor for Falso, esta mensagem poderá ter sido adquirida anteriormente por outra ligação ou ligações.

priority

Este campo contém a prioridade da mensagem relativa. Números mais altos indicam mensagens de prioridade mais alta. As mensagens com prioridades mais elevadas podem ser entregues antes das que têm prioridades mais baixas.

Métodos

get
has_key
items
keys
update
values

get

get(key: str, default: Any | None = None) -> Any

Parâmetros

Name Description
key
Necessário
default
Default value: None

has_key

has_key(k: str) -> bool

Parâmetros

Name Description
k
Necessário

items

items() -> List[Tuple[str, Any]]

keys

keys() -> List[str]

update

update(*args: Any, **kwargs: Any) -> None

values

values() -> List[Any]