AmqpMessageHeader Klasse

  • Referenz

Der Nachrichtenheader. Der Nachrichtenheader. Dies wird nur für empfangene Nachrichten verwendet und nicht für gesendete Nachrichten festgelegt. Die für eine bestimmte Nachricht festgelegten Eigenschaften hängen vom Dienst ab, und nicht alle Nachrichten verfügen über alle Eigenschaften. Weitere Informationen zum Nachrichtenheader finden Sie in der AMQP-Spezifikation http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-header .

Vererbung
azure.servicebus.amqp._amqp_message.DictMixin
AmqpMessageHeader

Konstruktor

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)

Nur Schlüsselwortparameter

Name Beschreibung
delivery_count
Optional[int]

Die Anzahl der fehlgeschlagenen vorherigen Versuche, diese Nachricht zu übermitteln. Wenn dieser Wert ungleich 0 ist, kann er als Hinweis darauf genommen werden, dass es sich bei der Übermittlung um ein Duplikat handelt. Bei der ersten Übermittlung ist der Wert 0. Es wird erhöht, wenn ein Ergebnis beim Absender gemäß den für jedes Ergebnis definierten Regeln abgerechnet wird.
time_to_live
Optional[int]

Dauer in Millisekunden, für die die Nachricht als "live" betrachtet werden soll. Wenn dies festgelegt ist, wird eine Ablaufzeit der Nachricht basierend auf dem Zeitpunkt der Ankunft bei einem Vermittler berechnet. Nachrichten, die länger als ihre Ablaufzeit leben, werden verworfen (oder unzustellbar). Wenn eine Nachricht von einem Vermittler übertragen wird, der mit einem ttl empfangen wurde, SOLLTE der Header der übertragenen Nachricht einen ttl enthalten, der als Unterschied zwischen der aktuellen Zeit und der zuvor berechneten Ablaufzeit der Nachricht berechnet wird, d. h. der reduzierten ttl, sodass Nachrichten letztendlich sterben, wenn sie in einer Übermittlungsschleife enden.
durable
Optional[bool]

Dauerhafte Nachrichten dürfen nicht verloren gehen, auch wenn ein Vermittler unerwartet beendet und neu gestartet wird. Ein Ziel, das diese Garantie nicht erfüllen kann, DARF KEINE Nachrichten akzeptieren, bei denen der dauerhafte Header auf True festgelegt ist: Wenn die Quelle das abgelehnte Ergebnis zulässt, sollte die Nachricht mit dem Vorbedingungsfehler abgelehnt werden, andernfalls MUSS der Link vom Empfänger mit demselben Fehler getrennt werden.
first_acquirer
Optional[bool]

Wenn dieser Wert True ist, wurde diese Nachricht von keinem anderen Link abgerufen. Wenn dieser Wert False ist, kann diese Meldung möglicherweise zuvor von einem anderen Link oder links abgerufen werden.
priority
Optional[int]

Dieses Feld enthält die relative Nachrichtenpriorität. Höhere Zahlen weisen auf Nachrichten mit höherer Priorität hin. Nachrichten mit höheren Prioritäten können vor denen mit niedrigeren Prioritäten übermittelt werden.

Variablen

Name Beschreibung
delivery_count
Optional[int]

Die Anzahl der fehlgeschlagenen vorherigen Versuche, diese Nachricht zu übermitteln. Wenn dieser Wert ungleich 0 ist, kann er als Hinweis darauf genommen werden, dass es sich bei der Übermittlung um ein Duplikat handelt. Bei der ersten Übermittlung ist der Wert 0. Es wird erhöht, wenn ein Ergebnis beim Absender gemäß den für jedes Ergebnis definierten Regeln abgerechnet wird.
time_to_live
Optional[int]

Dauer in Millisekunden, für die die Nachricht als "live" betrachtet werden soll. Wenn dies festgelegt ist, wird eine Ablaufzeit der Nachricht basierend auf dem Zeitpunkt der Ankunft bei einem Vermittler berechnet. Nachrichten, die länger als ihre Ablaufzeit leben, werden verworfen (oder unzustellbar). Wenn eine Nachricht von einem Vermittler übertragen wird, der mit einem ttl empfangen wurde, SOLLTE der Header der übertragenen Nachricht einen ttl enthalten, der als Unterschied zwischen der aktuellen Zeit und der zuvor berechneten Ablaufzeit der Nachricht berechnet wird, d. h. der reduzierten ttl, sodass Nachrichten letztendlich sterben, wenn sie in einer Übermittlungsschleife enden.
durable
Optional[bool]

Dauerhafte Nachrichten dürfen nicht verloren gehen, auch wenn ein Vermittler unerwartet beendet und neu gestartet wird. Ein Ziel, das diese Garantie nicht erfüllen kann, DARF KEINE Nachrichten akzeptieren, bei denen der dauerhafte Header auf True festgelegt ist: Wenn die Quelle das abgelehnte Ergebnis zulässt, sollte die Nachricht mit dem Vorbedingungsfehler abgelehnt werden, andernfalls MUSS der Link vom Empfänger mit demselben Fehler getrennt werden.
first_acquirer
Optional[bool]

Wenn dieser Wert True ist, wurde diese Nachricht von keinem anderen Link abgerufen. Wenn dieser Wert False ist, kann diese Meldung möglicherweise zuvor von einem anderen Link oder links abgerufen werden.
priority
Optional[int]

Dieses Feld enthält die relative Nachrichtenpriorität. Höhere Zahlen weisen auf Nachrichten mit höherer Priorität hin. Nachrichten mit höheren Prioritäten können vor denen mit niedrigeren Prioritäten übermittelt werden.

Methoden

get
has_key
items
keys
update
values

get 

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

Parameter

Name Beschreibung
key
Erforderlich
default
Standardwert: None

has_key 

has_key(k: str) -> bool

Parameter

Name Beschreibung
k
Erforderlich

items 

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

keys 

keys() -> List[str]

update 

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

values 

values() -> List[Any]