pub struct DeleteMessageFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to DeleteMessage
.
Deletes the specified message from the specified queue. To select the message to delete, use the ReceiptHandle
of the message (not the MessageId
which you receive when you send the message). Amazon SQS can delete a message from a queue even if a visibility timeout setting causes the message to be locked by another consumer. Amazon SQS automatically deletes messages left in a queue longer than the retention period configured for the queue.
The ReceiptHandle
is associated with a specific instance of receiving a message. If you receive a message more than once, the ReceiptHandle
is different each time you receive a message. When you use the DeleteMessage
action, you must provide the most recently received ReceiptHandle
for the message (otherwise, the request succeeds, but the message will not be deleted).
For standard queues, it is possible to receive a message even after you delete it. This might happen on rare occasions if one of the servers which stores a copy of the message is unavailable when you send the request to delete the message. The copy remains on the server and might be returned to you during a subsequent receive request. You should ensure that your application is idempotent, so that receiving a message more than once does not cause issues.
Implementations§
source§impl DeleteMessageFluentBuilder
impl DeleteMessageFluentBuilder
sourcepub fn as_input(&self) -> &DeleteMessageInputBuilder
pub fn as_input(&self) -> &DeleteMessageInputBuilder
Access the DeleteMessage as a reference.
sourcepub async fn send(
self
) -> Result<DeleteMessageOutput, SdkError<DeleteMessageError, HttpResponse>>
pub async fn send( self ) -> Result<DeleteMessageOutput, SdkError<DeleteMessageError, HttpResponse>>
Sends the request and returns the response.
If an error occurs, an SdkError
will be returned with additional details that
can be matched against.
By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.
sourcepub fn customize(
self
) -> CustomizableOperation<DeleteMessageOutput, DeleteMessageError, Self>
pub fn customize( self ) -> CustomizableOperation<DeleteMessageOutput, DeleteMessageError, Self>
Consumes this builder, creating a customizable operation that can be modified before being sent.
sourcepub fn queue_url(self, input: impl Into<String>) -> Self
pub fn queue_url(self, input: impl Into<String>) -> Self
The URL of the Amazon SQS queue from which messages are deleted.
Queue URLs and names are case-sensitive.
sourcepub fn set_queue_url(self, input: Option<String>) -> Self
pub fn set_queue_url(self, input: Option<String>) -> Self
The URL of the Amazon SQS queue from which messages are deleted.
Queue URLs and names are case-sensitive.
sourcepub fn get_queue_url(&self) -> &Option<String>
pub fn get_queue_url(&self) -> &Option<String>
The URL of the Amazon SQS queue from which messages are deleted.
Queue URLs and names are case-sensitive.
sourcepub fn receipt_handle(self, input: impl Into<String>) -> Self
pub fn receipt_handle(self, input: impl Into<String>) -> Self
The receipt handle associated with the message to delete.
sourcepub fn set_receipt_handle(self, input: Option<String>) -> Self
pub fn set_receipt_handle(self, input: Option<String>) -> Self
The receipt handle associated with the message to delete.
sourcepub fn get_receipt_handle(&self) -> &Option<String>
pub fn get_receipt_handle(&self) -> &Option<String>
The receipt handle associated with the message to delete.
Trait Implementations§
source§impl Clone for DeleteMessageFluentBuilder
impl Clone for DeleteMessageFluentBuilder
source§fn clone(&self) -> DeleteMessageFluentBuilder
fn clone(&self) -> DeleteMessageFluentBuilder
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreAuto Trait Implementations§
impl Freeze for DeleteMessageFluentBuilder
impl !RefUnwindSafe for DeleteMessageFluentBuilder
impl Send for DeleteMessageFluentBuilder
impl Sync for DeleteMessageFluentBuilder
impl Unpin for DeleteMessageFluentBuilder
impl !UnwindSafe for DeleteMessageFluentBuilder
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more