AmqpMessageHeader 類別

Message 標頭。 Message 標頭。 這只適用于已接收的訊息，而不會在傳送的訊息上設定。 在任何給定訊息上設定的屬性將取決於服務，而並非所有訊息都有所有屬性。 如需訊息標頭的詳細資訊， http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-header 請參閱 AMQP 規格。

繼承

azure.servicebus.amqp._amqp_message.DictMixin

AmqpMessageHeader

建構函式

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)

僅限關鍵字的參數

名稱	Description
delivery_count	Optional[int] 先前嘗試傳遞此訊息的失敗次數。 如果這個值不是零，可以視為傳遞可能重複的指示。 第一次傳遞時，值為零。 它會根據針對每個結果所定義的規則，在傳送者端決定結果時遞增。
time_to_live	Optional[int] 訊息視為「即時」的毫秒持續時間。 如果已設定，則會根據抵達媒介的時間來計算訊息到期時間。 超過到期時間的訊息將會捨棄 (或寄不出的信件) 。 當訊息由以 ttl 接收的媒介傳輸時，傳輸的訊息標頭應該包含 ttl，其計算為目前時間與先前計算訊息到期時間之間的差異，也就是縮減的 ttl，如此一來，訊息最終會在傳遞迴圈中終止時終止。
durable	Optional[bool] 即使中繼意外終止並重新啟動，長期訊息也不得遺失。 無法滿足此保證的目標「不可」接受永久標頭設定為 True的訊息：如果來源允許拒絕的結果，則訊息應該以前置條件失敗錯誤來拒絕，否則接收者必須卸離相同錯誤的連結。
first_acquirer	Optional[bool] 如果此值為 True，則任何其他連結尚未取得此訊息。 如果此值為 False，則此訊息可能先前已由另一個連結或連結取得。
priority	Optional[int] 此欄位包含相對訊息優先順序。 較高的數位表示優先順序較高的訊息。 優先順序較高的訊息可能會在優先順序較低的訊息之前傳遞。

變數

名稱	Description
delivery_count	Optional[int] 先前嘗試傳遞此訊息的失敗次數。 如果這個值不是零，可以視為傳遞可能重複的指示。 第一次傳遞時，值為零。 它會根據針對每個結果所定義的規則，在傳送者端決定結果時遞增。
time_to_live	Optional[int] 訊息視為「即時」的毫秒持續時間。 如果已設定，則會根據抵達媒介的時間來計算訊息到期時間。 超過到期時間的訊息將會捨棄 (或寄不出的信件) 。 當訊息由以 ttl 接收的媒介傳輸時，傳輸的訊息標頭應該包含 ttl，其計算為目前時間與先前計算訊息到期時間之間的差異，也就是縮減的 ttl，如此一來，訊息最終會在傳遞迴圈中終止時終止。
durable	Optional[bool] 即使中繼意外終止並重新啟動，長期訊息也不得遺失。 無法滿足此保證的目標「不可」接受永久標頭設定為 True的訊息：如果來源允許拒絕的結果，則訊息應該以前置條件失敗錯誤來拒絕，否則接收者必須卸離相同錯誤的連結。
first_acquirer	Optional[bool] 如果此值為 True，則任何其他連結尚未取得此訊息。 如果此值為 False，則此訊息可能先前已由另一個連結或連結取得。
priority	Optional[int] 此欄位包含相對訊息優先順序。 較高的數位表示優先順序較高的訊息。 優先順序較高的訊息可能會在優先順序較低的訊息之前傳遞。

方法

get
has_key
items
keys
update
values

get

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

參數

名稱	Description
key 必要
default	預設值: None

has_key

has_key(k: str) -> bool

參數

名稱	Description
k 必要

items

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

keys

keys() -> List[str]

update

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

values

values() -> List[Any]