paws.application.integration (version 0.5.0)

sqs: Amazon Simple Queue Service

Description

Welcome to the Amazon SQS API Reference.

Amazon SQS is a reliable, highly-scalable hosted queue for storing messages as they travel between applications or microservices. Amazon SQS moves data between distributed application components and helps you decouple these components.

For information on the permissions you need to use this API, see Identity and access management in the Amazon SQS Developer Guide.

You can use Amazon Web Services SDKs to access Amazon SQS using your favorite programming language. The SDKs perform tasks such as the following automatically:

  • Cryptographically sign your service requests

  • Retry requests

  • Handle error responses

Additional information

Usage

sqs(config = list(), credentials = list(), endpoint = NULL, region = NULL)

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

  • endpoint: The complete URL to use for the constructed client.

  • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Service syntax

svc <- sqs(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

add_permissionAdds a permission to a queue for a specific principal
cancel_message_move_taskCancels a specified message movement task
change_message_visibilityChanges the visibility timeout of a specified message in a queue to a new value
change_message_visibility_batchChanges the visibility timeout of multiple messages
create_queueCreates a new standard or FIFO queue
delete_messageDeletes the specified message from the specified queue
delete_message_batchDeletes up to ten messages from the specified queue
delete_queueDeletes the queue specified by the QueueUrl, regardless of the queue's contents
get_queue_attributesGets attributes for the specified queue
get_queue_urlReturns the URL of an existing Amazon SQS queue
list_dead_letter_source_queuesReturns a list of your queues that have the RedrivePolicy queue attribute configured with a dead-letter queue
list_message_move_tasksGets the most recent message movement tasks (up to 10) under a specific source queue
list_queuesReturns a list of your queues in the current region
list_queue_tagsList all cost allocation tags added to the specified Amazon SQS queue
purge_queueDeletes available messages in a queue (including in-flight messages) specified by the QueueURL parameter
receive_messageRetrieves one or more messages (up to 10), from the specified queue
remove_permissionRevokes any permissions in the queue policy that matches the specified Label parameter
send_messageDelivers a message to the specified queue
send_message_batchYou can use SendMessageBatch to send up to 10 messages to the specified queue by assigning either identical or different values to each message (or by not assigning values at all)
set_queue_attributesSets the value of one or more queue attributes
start_message_move_taskStarts an asynchronous task to move messages from a specified source queue to a specified destination queue
tag_queueAdd cost allocation tags to the specified Amazon SQS queue
untag_queueRemove cost allocation tags from the specified Amazon SQS queue

Examples

Run this code
if (FALSE) {
svc <- sqs()
svc$add_permission(
  Foo = 123
)
}

Run the code above in your browser using DataLab