public sealed class DeadLetterPolicy : IMessage<DeadLetterPolicy>, IEquatable<DeadLetterPolicy>, IDeepCloneable<DeadLetterPolicy>, IBufferMessage, IMessage
Dead lettering is done on a best effort basis. The same message might be
dead lettered multiple times.
If validation on any of the fields fails at subscription creation/updation,
the create/update subscription request will fail.
The name of the topic to which dead letter messages should be published.
Format is projects/{project}/topics/{topic}.The Cloud Pub/Sub service
account associated with the enclosing subscription's parent project (i.e.,
service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
permission to Publish() to this topic.
The operation will fail if the topic does not exist.
Users should ensure that there is a subscription attached to this topic
since messages published to a topic with no subscriptions are lost.
Property Value
Type
Description
System.String
MaxDeliveryAttempts
public int MaxDeliveryAttempts { get; set; }
The maximum number of delivery attempts for any message. The value must be
between 5 and 100.
The number of delivery attempts is defined as 1 + (the sum of number of
NACKs and number of times the acknowledgement deadline has been exceeded
for the message).
A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that
client libraries may automatically extend ack_deadlines.
This field will be honored on a best effort basis.
If this parameter is 0, a default value of 5 is used.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe webpage documents various versions of the \u003ccode\u003eDeadLetterPolicy\u003c/code\u003e class within the \u003ccode\u003eGoogle.Cloud.PubSub.V1\u003c/code\u003e namespace for .NET, with version 3.23.0 being the latest and many older versions available, all the way back to version 2.3.0.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDeadLetterPolicy\u003c/code\u003e is designed for handling messages that cannot be successfully processed and supports configurations like \u003ccode\u003eDeadLetterTopic\u003c/code\u003e for rerouting and \u003ccode\u003eMaxDeliveryAttempts\u003c/code\u003e to cap the number of delivery retries before a message is considered dead lettered.\u003c/p\u003e\n"],["\u003cp\u003eDead lettering is performed on a best-effort basis, and the same message can be dead lettered multiple times, with the system failing to create/update a subscription if the validation of fields fails.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eDeadLetterPolicy\u003c/code\u003e class inherits from \u003ccode\u003eSystem.Object\u003c/code\u003e and implements \u003ccode\u003eGoogle.Protobuf.IMessage\u003c/code\u003e, \u003ccode\u003eSystem.IEquatable\u003c/code\u003e, \u003ccode\u003eGoogle.Protobuf.IDeepCloneable\u003c/code\u003e, and \u003ccode\u003eGoogle.Protobuf.IBufferMessage\u003c/code\u003e, among other interfaces.\u003c/p\u003e\n"],["\u003cp\u003eThe class allows for creating a \u003ccode\u003eDeadLetterPolicy\u003c/code\u003e object either without any parameters or by using another \u003ccode\u003eDeadLetterPolicy\u003c/code\u003e object, as well as publishing to the topic the dead letters.\u003c/p\u003e\n"]]],[],null,[]]
