pub struct AddPermissionFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to AddPermission
.
Adds a permission to a queue for a specific principal. This allows sharing access to the queue.
When you create a queue, you have full control access rights for the queue. Only you, the owner of the queue, can grant or deny permissions to the queue. For more information about these permissions, see Allow Developers to Write Messages to a Shared Queue in the Amazon SQS Developer Guide.
-
AddPermission
generates a policy for you. You can useSetQueueAttributes
-
An Amazon SQS policy can have a maximum of seven actions per statement.
-
To remove the ability to change queue permissions, you must deny permission to the
AddPermission
,RemovePermission
, andSetQueueAttributes
actions in your IAM policy. -
Amazon SQS
AddPermission
does not support adding a non-account principal.
Cross-account permissions don't apply to this action. For more information, see Grant cross-account permissions to a role and a username in the Amazon SQS Developer Guide.
Implementations§
source§impl AddPermissionFluentBuilder
impl AddPermissionFluentBuilder
sourcepub fn as_input(&self) -> &AddPermissionInputBuilder
pub fn as_input(&self) -> &AddPermissionInputBuilder
Access the AddPermission as a reference.
sourcepub async fn send(
self
) -> Result<AddPermissionOutput, SdkError<AddPermissionError, HttpResponse>>
pub async fn send( self ) -> Result<AddPermissionOutput, SdkError<AddPermissionError, 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<AddPermissionOutput, AddPermissionError, Self>
pub fn customize( self ) -> CustomizableOperation<AddPermissionOutput, AddPermissionError, 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 to which permissions are added.
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 to which permissions are added.
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 to which permissions are added.
Queue URLs and names are case-sensitive.
sourcepub fn label(self, input: impl Into<String>) -> Self
pub fn label(self, input: impl Into<String>) -> Self
The unique identification of the permission you're setting (for example, AliceSendMessage
). Maximum 80 characters. Allowed characters include alphanumeric characters, hyphens (-
), and underscores (_
).
sourcepub fn set_label(self, input: Option<String>) -> Self
pub fn set_label(self, input: Option<String>) -> Self
The unique identification of the permission you're setting (for example, AliceSendMessage
). Maximum 80 characters. Allowed characters include alphanumeric characters, hyphens (-
), and underscores (_
).
sourcepub fn get_label(&self) -> &Option<String>
pub fn get_label(&self) -> &Option<String>
The unique identification of the permission you're setting (for example, AliceSendMessage
). Maximum 80 characters. Allowed characters include alphanumeric characters, hyphens (-
), and underscores (_
).
sourcepub fn aws_account_ids(self, input: impl Into<String>) -> Self
pub fn aws_account_ids(self, input: impl Into<String>) -> Self
Appends an item to AWSAccountIds
.
To override the contents of this collection use set_aws_account_ids
.
The Amazon Web Services account numbers of the principals who are to receive permission. For information about locating the Amazon Web Services account identification, see Your Amazon Web Services Identifiers in the Amazon SQS Developer Guide.
sourcepub fn set_aws_account_ids(self, input: Option<Vec<String>>) -> Self
pub fn set_aws_account_ids(self, input: Option<Vec<String>>) -> Self
The Amazon Web Services account numbers of the principals who are to receive permission. For information about locating the Amazon Web Services account identification, see Your Amazon Web Services Identifiers in the Amazon SQS Developer Guide.
sourcepub fn get_aws_account_ids(&self) -> &Option<Vec<String>>
pub fn get_aws_account_ids(&self) -> &Option<Vec<String>>
The Amazon Web Services account numbers of the principals who are to receive permission. For information about locating the Amazon Web Services account identification, see Your Amazon Web Services Identifiers in the Amazon SQS Developer Guide.
sourcepub fn actions(self, input: impl Into<String>) -> Self
pub fn actions(self, input: impl Into<String>) -> Self
Appends an item to Actions
.
To override the contents of this collection use set_actions
.
The action the client wants to allow for the specified principal. Valid values: the name of any action or *
.
For more information about these actions, see Overview of Managing Access Permissions to Your Amazon Simple Queue Service Resource in the Amazon SQS Developer Guide.
Specifying SendMessage
, DeleteMessage
, or ChangeMessageVisibility
for ActionName.n
also grants permissions for the corresponding batch versions of those actions: SendMessageBatch
, DeleteMessageBatch
, and ChangeMessageVisibilityBatch
.
sourcepub fn set_actions(self, input: Option<Vec<String>>) -> Self
pub fn set_actions(self, input: Option<Vec<String>>) -> Self
The action the client wants to allow for the specified principal. Valid values: the name of any action or *
.
For more information about these actions, see Overview of Managing Access Permissions to Your Amazon Simple Queue Service Resource in the Amazon SQS Developer Guide.
Specifying SendMessage
, DeleteMessage
, or ChangeMessageVisibility
for ActionName.n
also grants permissions for the corresponding batch versions of those actions: SendMessageBatch
, DeleteMessageBatch
, and ChangeMessageVisibilityBatch
.
sourcepub fn get_actions(&self) -> &Option<Vec<String>>
pub fn get_actions(&self) -> &Option<Vec<String>>
The action the client wants to allow for the specified principal. Valid values: the name of any action or *
.
For more information about these actions, see Overview of Managing Access Permissions to Your Amazon Simple Queue Service Resource in the Amazon SQS Developer Guide.
Specifying SendMessage
, DeleteMessage
, or ChangeMessageVisibility
for ActionName.n
also grants permissions for the corresponding batch versions of those actions: SendMessageBatch
, DeleteMessageBatch
, and ChangeMessageVisibilityBatch
.
Trait Implementations§
source§impl Clone for AddPermissionFluentBuilder
impl Clone for AddPermissionFluentBuilder
source§fn clone(&self) -> AddPermissionFluentBuilder
fn clone(&self) -> AddPermissionFluentBuilder
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more