2017-04-05 09:45:27 +02:00
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
2016-01-29 20:53:56 +01:00
package sqs
import (
2016-05-05 03:06:27 +02:00
"fmt"
2017-04-05 09:45:27 +02:00
"github.com/aws/aws-sdk-go/aws"
2016-01-29 20:53:56 +01:00
"github.com/aws/aws-sdk-go/aws/awsutil"
"github.com/aws/aws-sdk-go/aws/request"
2016-02-15 20:59:49 +01:00
"github.com/aws/aws-sdk-go/private/protocol"
"github.com/aws/aws-sdk-go/private/protocol/query"
2016-01-29 20:53:56 +01:00
)
const opAddPermission = "AddPermission"
2016-07-15 15:49:02 +02:00
// AddPermissionRequest generates a "aws/request.Request" representing the
// client's request for the AddPermission operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// See AddPermission for more information on using the AddPermission
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the AddPermissionRequest method.
// req, resp := client.AddPermissionRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/AddPermission
2016-01-29 20:53:56 +01:00
func ( c * SQS ) AddPermissionRequest ( input * AddPermissionInput ) ( req * request . Request , output * AddPermissionOutput ) {
op := & request . Operation {
Name : opAddPermission ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & AddPermissionInput { }
}
2017-01-23 22:22:31 +01:00
output = & AddPermissionOutput { }
2016-01-29 20:53:56 +01:00
req = c . newRequest ( op , input , output )
2018-12-14 02:30:43 +01:00
req . Handlers . Unmarshal . Swap ( query . UnmarshalHandler . Name , protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// AddPermission API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Adds a permission to a queue for a specific principal (http://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P).
2017-01-02 21:35:31 +01:00
// This allows sharing access to the queue.
2016-01-29 20:53:56 +01:00
//
// When you create a queue, you have full control access rights for the queue.
2017-01-02 21:35:31 +01:00
// Only you, the owner of the queue, can grant or deny permissions to the queue.
2018-10-17 02:12:35 +02:00
// For more information about these permissions, see Allow Developers to Write
// Messages to a Shared Queue (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// AddPermission writes an Amazon-SQS-generated policy. If you want to write
2016-01-29 20:53:56 +01:00
// your own policy, use SetQueueAttributes to upload your policy. For more information
2018-10-17 02:12:35 +02:00
// about writing your own policy, see Using Custom Policies with the Amazon
// SQS Access Policy Language (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-creating-custom-policies.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
//
2018-10-17 02:12:35 +02:00
// An Amazon SQS policy can have a maximum of 7 actions.
//
2017-01-02 21:35:31 +01:00
// Some actions take lists of parameters. These lists are specified using the
// param.n notation. Values of n are integers starting from 1. For example,
2016-04-02 17:17:21 +02:00
// a parameter list with two elements looks like this:
2016-10-17 23:21:08 +02:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.1=first
//
// &Attribute.2=second
2016-11-19 19:41:01 +01:00
//
2018-10-17 02:12:35 +02:00
// Cross-account permissions don't apply to this action. For more information,
// see see Grant Cross-Account Permissions to a Role and a User Name (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name)
// in the Amazon Simple Queue Service Developer Guide.
2016-11-19 19:41:01 +01:00
//
2016-10-17 23:21:08 +02:00
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation AddPermission for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeOverLimit "OverLimit"
2018-10-17 02:12:35 +02:00
// The specified action violates a limit. For example, ReceiveMessage returns
// this error if the maximum number of inflight messages is reached and AddPermission
// returns this error if the maximum number of permissions for the queue is
// reached.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/AddPermission
2016-01-29 20:53:56 +01:00
func ( c * SQS ) AddPermission ( input * AddPermissionInput ) ( * AddPermissionOutput , error ) {
req , out := c . AddPermissionRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// AddPermissionWithContext is the same as AddPermission with the addition of
// the ability to pass a context and additional request options.
//
// See AddPermission for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) AddPermissionWithContext ( ctx aws . Context , input * AddPermissionInput , opts ... request . Option ) ( * AddPermissionOutput , error ) {
req , out := c . AddPermissionRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opChangeMessageVisibility = "ChangeMessageVisibility"
2016-07-15 15:49:02 +02:00
// ChangeMessageVisibilityRequest generates a "aws/request.Request" representing the
// client's request for the ChangeMessageVisibility operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-09-05 15:21:07 +02:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// See ChangeMessageVisibility for more information on using the ChangeMessageVisibility
// API call, and error handling.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the ChangeMessageVisibilityRequest method.
// req, resp := client.ChangeMessageVisibilityRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ChangeMessageVisibility
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ChangeMessageVisibilityRequest ( input * ChangeMessageVisibilityInput ) ( req * request . Request , output * ChangeMessageVisibilityOutput ) {
op := & request . Operation {
Name : opChangeMessageVisibility ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & ChangeMessageVisibilityInput { }
}
2017-01-23 22:22:31 +01:00
output = & ChangeMessageVisibilityOutput { }
2016-01-29 20:53:56 +01:00
req = c . newRequest ( op , input , output )
2018-12-14 02:30:43 +01:00
req . Handlers . Unmarshal . Swap ( query . UnmarshalHandler . Name , protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// ChangeMessageVisibility API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Changes the visibility timeout of a specified message in a queue to a new
2018-10-17 02:12:35 +02:00
// value. The maximum allowed timeout value is 12 hours. For more information,
// see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2017-01-02 21:35:31 +01:00
//
2017-12-13 00:27:05 +01:00
// For example, you have a message with a visibility timeout of 5 minutes. After
2018-10-17 02:12:35 +02:00
// 3 minutes, you call ChangeMessageVisibility with a timeout of 10 minutes.
// You can continue to call ChangeMessageVisibility to extend the visibility
// timeout to a maximum of 12 hours. If you try to extend the visibility timeout
// beyond 12 hours, your request is rejected.
2016-01-29 20:53:56 +01:00
//
2016-12-15 15:48:01 +01:00
// A message is considered to be in flight after it's received from a queue
// by a consumer, but not yet deleted from the queue.
//
// For standard queues, there can be a maximum of 120,000 inflight messages
// per queue. If you reach this limit, Amazon SQS returns the OverLimit error
// message. To avoid reaching the limit, you should delete messages from the
// queue after they're processed. You can also increase the number of queues
// you use to process your messages.
//
// For FIFO queues, there can be a maximum of 20,000 inflight messages per queue.
// If you reach this limit, Amazon SQS returns no error messages.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// If you attempt to set the VisibilityTimeout to a value greater than the maximum
// time left, Amazon SQS returns an error. Amazon SQS doesn't automatically
// recalculate and increase the timeout to the maximum remaining time.
2016-07-15 15:49:02 +02:00
//
// Unlike with a queue, when you change the visibility timeout for a specific
2017-01-02 21:35:31 +01:00
// message the timeout value is applied immediately but isn't saved in memory
2016-07-15 15:49:02 +02:00
// for that message. If you don't delete a message after it is received, the
2017-01-02 21:35:31 +01:00
// visibility timeout for the message reverts to the original timeout value
// (not to the value you set using the ChangeMessageVisibility action) the next
// time the message is received.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation ChangeMessageVisibility for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeMessageNotInflight "AWS.SimpleQueueService.MessageNotInflight"
2018-10-17 02:12:35 +02:00
// The specified message isn't in flight.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeReceiptHandleIsInvalid "ReceiptHandleIsInvalid"
2018-10-17 02:12:35 +02:00
// The specified receipt handle isn't valid.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ChangeMessageVisibility
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ChangeMessageVisibility ( input * ChangeMessageVisibilityInput ) ( * ChangeMessageVisibilityOutput , error ) {
req , out := c . ChangeMessageVisibilityRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// ChangeMessageVisibilityWithContext is the same as ChangeMessageVisibility with the addition of
// the ability to pass a context and additional request options.
//
// See ChangeMessageVisibility for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) ChangeMessageVisibilityWithContext ( ctx aws . Context , input * ChangeMessageVisibilityInput , opts ... request . Option ) ( * ChangeMessageVisibilityOutput , error ) {
req , out := c . ChangeMessageVisibilityRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opChangeMessageVisibilityBatch = "ChangeMessageVisibilityBatch"
2016-07-15 15:49:02 +02:00
// ChangeMessageVisibilityBatchRequest generates a "aws/request.Request" representing the
// client's request for the ChangeMessageVisibilityBatch operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-09-05 15:21:07 +02:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// See ChangeMessageVisibilityBatch for more information on using the ChangeMessageVisibilityBatch
// API call, and error handling.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the ChangeMessageVisibilityBatchRequest method.
// req, resp := client.ChangeMessageVisibilityBatchRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ChangeMessageVisibilityBatch
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ChangeMessageVisibilityBatchRequest ( input * ChangeMessageVisibilityBatchInput ) ( req * request . Request , output * ChangeMessageVisibilityBatchOutput ) {
op := & request . Operation {
Name : opChangeMessageVisibilityBatch ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & ChangeMessageVisibilityBatchInput { }
}
output = & ChangeMessageVisibilityBatchOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// ChangeMessageVisibilityBatch API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Changes the visibility timeout of multiple messages. This is a batch version
// of ChangeMessageVisibility. The result of the action on each message is reported
// individually in the response. You can send up to 10 ChangeMessageVisibility
// requests with each ChangeMessageVisibilityBatch action.
//
2016-11-19 19:41:01 +01:00
// Because the batch request can result in a combination of successful and unsuccessful
// actions, you should check for batch errors even when the call returns an
// HTTP status code of 200.
2016-07-15 15:49:02 +02:00
//
2017-01-02 21:35:31 +01:00
// Some actions take lists of parameters. These lists are specified using the
// param.n notation. Values of n are integers starting from 1. For example,
2016-07-15 15:49:02 +02:00
// a parameter list with two elements looks like this:
2016-10-17 23:21:08 +02:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.1=first
2016-11-19 19:41:01 +01:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.2=second
2016-11-19 19:41:01 +01:00
//
2016-10-17 23:21:08 +02:00
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation ChangeMessageVisibilityBatch for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeTooManyEntriesInBatchRequest "AWS.SimpleQueueService.TooManyEntriesInBatchRequest"
2017-01-02 21:35:31 +01:00
// The batch request contains more entries than permissible.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeEmptyBatchRequest "AWS.SimpleQueueService.EmptyBatchRequest"
2017-01-02 21:35:31 +01:00
// The batch request doesn't contain any entries.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeBatchEntryIdsNotDistinct "AWS.SimpleQueueService.BatchEntryIdsNotDistinct"
2017-01-02 21:35:31 +01:00
// Two or more batch entries in the request have the same Id.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInvalidBatchEntryId "AWS.SimpleQueueService.InvalidBatchEntryId"
2016-11-19 19:41:01 +01:00
// The Id of a batch entry in a batch request doesn't abide by the specification.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ChangeMessageVisibilityBatch
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ChangeMessageVisibilityBatch ( input * ChangeMessageVisibilityBatchInput ) ( * ChangeMessageVisibilityBatchOutput , error ) {
req , out := c . ChangeMessageVisibilityBatchRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// ChangeMessageVisibilityBatchWithContext is the same as ChangeMessageVisibilityBatch with the addition of
// the ability to pass a context and additional request options.
//
// See ChangeMessageVisibilityBatch for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) ChangeMessageVisibilityBatchWithContext ( ctx aws . Context , input * ChangeMessageVisibilityBatchInput , opts ... request . Option ) ( * ChangeMessageVisibilityBatchOutput , error ) {
req , out := c . ChangeMessageVisibilityBatchRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opCreateQueue = "CreateQueue"
2016-07-15 15:49:02 +02:00
// CreateQueueRequest generates a "aws/request.Request" representing the
// client's request for the CreateQueue operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// See CreateQueue for more information on using the CreateQueue
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the CreateQueueRequest method.
// req, resp := client.CreateQueueRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/CreateQueue
2016-01-29 20:53:56 +01:00
func ( c * SQS ) CreateQueueRequest ( input * CreateQueueInput ) ( req * request . Request , output * CreateQueueOutput ) {
op := & request . Operation {
Name : opCreateQueue ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & CreateQueueInput { }
}
output = & CreateQueueOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// CreateQueue API operation for Amazon Simple Queue Service.
//
2017-05-11 13:24:29 +02:00
// Creates a new standard or FIFO queue. You can pass one or more attributes
// in the request. Keep the following caveats in mind:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * If you don't specify the FifoQueue attribute, Amazon SQS creates a standard
// queue.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// You can't change the queue type after you create it and you can't convert
// an existing standard queue into a FIFO queue. You must either create a
// new FIFO queue for your application or delete your existing standard queue
2018-10-17 02:12:35 +02:00
// and recreate it as a FIFO queue. For more information, see Moving From
2016-12-15 15:48:01 +01:00
// a Standard Queue to a FIFO Queue (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * If you don't provide a value for an attribute, the queue is created
// with the default value for the attribute.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * If you delete a queue, you must wait at least 60 seconds before creating
// a queue with the same name.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// To successfully create a new queue, you must provide a queue name that adheres
// to the limits related to queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html)
// and is unique within the scope of your queues.
//
// To get the queue URL, use the GetQueueUrl action. GetQueueUrl requires only
2017-01-02 21:35:31 +01:00
// the QueueName parameter. be aware of existing queue names:
2016-11-19 19:41:01 +01:00
//
// * If you provide the name of an existing queue along with the exact names
// and values of all the queue's attributes, CreateQueue returns the queue
// URL for the existing queue.
//
// * If the queue name, attribute names, or attribute values don't match
// an existing queue, CreateQueue returns an error.
//
2017-01-02 21:35:31 +01:00
// Some actions take lists of parameters. These lists are specified using the
// param.n notation. Values of n are integers starting from 1. For example,
// a parameter list with two elements looks like this:
2016-11-19 19:41:01 +01:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.1=first
2016-11-19 19:41:01 +01:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.2=second
//
// Cross-account permissions don't apply to this action. For more information,
// see see Grant Cross-Account Permissions to a Role and a User Name (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name)
// in the Amazon Simple Queue Service Developer Guide.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation CreateQueue for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeQueueDeletedRecently "AWS.SimpleQueueService.QueueDeletedRecently"
2016-10-17 23:21:08 +02:00
// You must wait 60 seconds after deleting a queue before you can create another
2018-10-17 02:12:35 +02:00
// queue with the same name.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeQueueNameExists "QueueAlreadyExists"
2018-10-17 02:12:35 +02:00
// A queue with this name already exists. Amazon SQS returns this error only
2016-10-17 23:21:08 +02:00
// if the request includes attributes whose values differ from those of the
// existing queue.
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/CreateQueue
2016-01-29 20:53:56 +01:00
func ( c * SQS ) CreateQueue ( input * CreateQueueInput ) ( * CreateQueueOutput , error ) {
req , out := c . CreateQueueRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// CreateQueueWithContext is the same as CreateQueue with the addition of
// the ability to pass a context and additional request options.
//
// See CreateQueue for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) CreateQueueWithContext ( ctx aws . Context , input * CreateQueueInput , opts ... request . Option ) ( * CreateQueueOutput , error ) {
req , out := c . CreateQueueRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opDeleteMessage = "DeleteMessage"
2016-07-15 15:49:02 +02:00
// DeleteMessageRequest generates a "aws/request.Request" representing the
// client's request for the DeleteMessage operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-09-05 15:21:07 +02:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// See DeleteMessage for more information on using the DeleteMessage
// API call, and error handling.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the DeleteMessageRequest method.
// req, resp := client.DeleteMessageRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/DeleteMessage
2016-01-29 20:53:56 +01:00
func ( c * SQS ) DeleteMessageRequest ( input * DeleteMessageInput ) ( req * request . Request , output * DeleteMessageOutput ) {
op := & request . Operation {
Name : opDeleteMessage ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & DeleteMessageInput { }
}
2017-01-23 22:22:31 +01:00
output = & DeleteMessageOutput { }
2016-01-29 20:53:56 +01:00
req = c . newRequest ( op , input , output )
2018-12-14 02:30:43 +01:00
req . Handlers . Unmarshal . Swap ( query . UnmarshalHandler . Name , protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// DeleteMessage API operation for Amazon Simple Queue Service.
//
2018-10-17 02:12:35 +02:00
// 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.
2016-01-29 20:53:56 +01:00
//
2018-10-17 02:12:35 +02:00
// 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 might not be deleted).
2017-01-02 21:35:31 +01:00
//
2017-05-11 13:24:29 +02:00
// For standard queues, it is possible to receive a message even after you delete
2018-10-17 02:12:35 +02:00
// 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.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation DeleteMessage for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeInvalidIdFormat "InvalidIdFormat"
2018-10-17 02:12:35 +02:00
// The specified receipt handle isn't valid for the current version.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeReceiptHandleIsInvalid "ReceiptHandleIsInvalid"
2018-10-17 02:12:35 +02:00
// The specified receipt handle isn't valid.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/DeleteMessage
2016-01-29 20:53:56 +01:00
func ( c * SQS ) DeleteMessage ( input * DeleteMessageInput ) ( * DeleteMessageOutput , error ) {
req , out := c . DeleteMessageRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// DeleteMessageWithContext is the same as DeleteMessage with the addition of
// the ability to pass a context and additional request options.
//
// See DeleteMessage for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) DeleteMessageWithContext ( ctx aws . Context , input * DeleteMessageInput , opts ... request . Option ) ( * DeleteMessageOutput , error ) {
req , out := c . DeleteMessageRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opDeleteMessageBatch = "DeleteMessageBatch"
2016-07-15 15:49:02 +02:00
// DeleteMessageBatchRequest generates a "aws/request.Request" representing the
// client's request for the DeleteMessageBatch operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// See DeleteMessageBatch for more information on using the DeleteMessageBatch
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the DeleteMessageBatchRequest method.
// req, resp := client.DeleteMessageBatchRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/DeleteMessageBatch
2016-01-29 20:53:56 +01:00
func ( c * SQS ) DeleteMessageBatchRequest ( input * DeleteMessageBatchInput ) ( req * request . Request , output * DeleteMessageBatchOutput ) {
op := & request . Operation {
Name : opDeleteMessageBatch ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & DeleteMessageBatchInput { }
}
output = & DeleteMessageBatchOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// DeleteMessageBatch API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Deletes up to ten messages from the specified queue. This is a batch version
2017-01-02 21:35:31 +01:00
// of DeleteMessage. The result of the action on each message is reported individually
// in the response.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Because the batch request can result in a combination of successful and unsuccessful
// actions, you should check for batch errors even when the call returns an
// HTTP status code of 200.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// Some actions take lists of parameters. These lists are specified using the
// param.n notation. Values of n are integers starting from 1. For example,
2016-04-02 17:17:21 +02:00
// a parameter list with two elements looks like this:
2016-10-17 23:21:08 +02:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.1=first
2016-11-19 19:41:01 +01:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.2=second
2016-11-19 19:41:01 +01:00
//
2016-10-17 23:21:08 +02:00
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation DeleteMessageBatch for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeTooManyEntriesInBatchRequest "AWS.SimpleQueueService.TooManyEntriesInBatchRequest"
2017-01-02 21:35:31 +01:00
// The batch request contains more entries than permissible.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeEmptyBatchRequest "AWS.SimpleQueueService.EmptyBatchRequest"
2017-01-02 21:35:31 +01:00
// The batch request doesn't contain any entries.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeBatchEntryIdsNotDistinct "AWS.SimpleQueueService.BatchEntryIdsNotDistinct"
2017-01-02 21:35:31 +01:00
// Two or more batch entries in the request have the same Id.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInvalidBatchEntryId "AWS.SimpleQueueService.InvalidBatchEntryId"
2016-11-19 19:41:01 +01:00
// The Id of a batch entry in a batch request doesn't abide by the specification.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/DeleteMessageBatch
2016-01-29 20:53:56 +01:00
func ( c * SQS ) DeleteMessageBatch ( input * DeleteMessageBatchInput ) ( * DeleteMessageBatchOutput , error ) {
req , out := c . DeleteMessageBatchRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// DeleteMessageBatchWithContext is the same as DeleteMessageBatch with the addition of
// the ability to pass a context and additional request options.
//
// See DeleteMessageBatch for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) DeleteMessageBatchWithContext ( ctx aws . Context , input * DeleteMessageBatchInput , opts ... request . Option ) ( * DeleteMessageBatchOutput , error ) {
req , out := c . DeleteMessageBatchRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opDeleteQueue = "DeleteQueue"
2016-07-15 15:49:02 +02:00
// DeleteQueueRequest generates a "aws/request.Request" representing the
// client's request for the DeleteQueue operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-09-05 15:21:07 +02:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// See DeleteQueue for more information on using the DeleteQueue
// API call, and error handling.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the DeleteQueueRequest method.
// req, resp := client.DeleteQueueRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/DeleteQueue
2016-01-29 20:53:56 +01:00
func ( c * SQS ) DeleteQueueRequest ( input * DeleteQueueInput ) ( req * request . Request , output * DeleteQueueOutput ) {
op := & request . Operation {
Name : opDeleteQueue ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & DeleteQueueInput { }
}
2017-01-23 22:22:31 +01:00
output = & DeleteQueueOutput { }
2016-01-29 20:53:56 +01:00
req = c . newRequest ( op , input , output )
2018-12-14 02:30:43 +01:00
req . Handlers . Unmarshal . Swap ( query . UnmarshalHandler . Name , protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// DeleteQueue API operation for Amazon Simple Queue Service.
//
2017-12-13 00:27:05 +01:00
// Deletes the queue specified by the QueueUrl, regardless of the queue's contents.
2017-01-02 21:35:31 +01:00
// If the specified queue doesn't exist, Amazon SQS returns a successful response.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// Be careful with the DeleteQueue action: When you delete a queue, any messages
// in the queue are no longer available.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// When you delete a queue, the deletion process takes up to 60 seconds. Requests
// you send involving that queue during the 60 seconds might succeed. For example,
2017-01-02 21:35:31 +01:00
// a SendMessage request might succeed, but after 60 seconds the queue and the
// message you sent no longer exist.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// When you delete a queue, you must wait at least 60 seconds before creating
// a queue with the same name.
2016-10-17 23:21:08 +02:00
//
2018-10-17 02:12:35 +02:00
// Cross-account permissions don't apply to this action. For more information,
// see see Grant Cross-Account Permissions to a Role and a User Name (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name)
// in the Amazon Simple Queue Service Developer Guide.
//
2016-10-17 23:21:08 +02:00
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation DeleteQueue for usage and error information.
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/DeleteQueue
2016-01-29 20:53:56 +01:00
func ( c * SQS ) DeleteQueue ( input * DeleteQueueInput ) ( * DeleteQueueOutput , error ) {
req , out := c . DeleteQueueRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// DeleteQueueWithContext is the same as DeleteQueue with the addition of
// the ability to pass a context and additional request options.
//
// See DeleteQueue for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) DeleteQueueWithContext ( ctx aws . Context , input * DeleteQueueInput , opts ... request . Option ) ( * DeleteQueueOutput , error ) {
req , out := c . DeleteQueueRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opGetQueueAttributes = "GetQueueAttributes"
2016-07-15 15:49:02 +02:00
// GetQueueAttributesRequest generates a "aws/request.Request" representing the
// client's request for the GetQueueAttributes operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// See GetQueueAttributes for more information on using the GetQueueAttributes
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the GetQueueAttributesRequest method.
// req, resp := client.GetQueueAttributesRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/GetQueueAttributes
2016-01-29 20:53:56 +01:00
func ( c * SQS ) GetQueueAttributesRequest ( input * GetQueueAttributesInput ) ( req * request . Request , output * GetQueueAttributesOutput ) {
op := & request . Operation {
Name : opGetQueueAttributes ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & GetQueueAttributesInput { }
}
output = & GetQueueAttributesOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// GetQueueAttributes API operation for Amazon Simple Queue Service.
//
2016-07-15 15:49:02 +02:00
// Gets attributes for the specified queue.
2016-01-29 20:53:56 +01:00
//
2017-05-11 13:24:29 +02:00
// To determine whether a queue is FIFO (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html),
// you can check whether QueueName ends with the .fifo suffix.
//
2017-01-02 21:35:31 +01:00
// Some actions take lists of parameters. These lists are specified using the
// param.n notation. Values of n are integers starting from 1. For example,
2016-07-15 15:49:02 +02:00
// a parameter list with two elements looks like this:
2016-10-17 23:21:08 +02:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.1=first
2016-11-19 19:41:01 +01:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.2=second
2016-11-19 19:41:01 +01:00
//
2016-10-17 23:21:08 +02:00
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation GetQueueAttributes for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeInvalidAttributeName "InvalidAttributeName"
2018-10-17 02:12:35 +02:00
// The specified attribute doesn't exist.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/GetQueueAttributes
2016-01-29 20:53:56 +01:00
func ( c * SQS ) GetQueueAttributes ( input * GetQueueAttributesInput ) ( * GetQueueAttributesOutput , error ) {
req , out := c . GetQueueAttributesRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// GetQueueAttributesWithContext is the same as GetQueueAttributes with the addition of
// the ability to pass a context and additional request options.
//
// See GetQueueAttributes for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) GetQueueAttributesWithContext ( ctx aws . Context , input * GetQueueAttributesInput , opts ... request . Option ) ( * GetQueueAttributesOutput , error ) {
req , out := c . GetQueueAttributesRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opGetQueueUrl = "GetQueueUrl"
2016-07-15 15:49:02 +02:00
// GetQueueUrlRequest generates a "aws/request.Request" representing the
// client's request for the GetQueueUrl operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-09-05 15:21:07 +02:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// See GetQueueUrl for more information on using the GetQueueUrl
// API call, and error handling.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the GetQueueUrlRequest method.
// req, resp := client.GetQueueUrlRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/GetQueueUrl
2016-01-29 20:53:56 +01:00
func ( c * SQS ) GetQueueUrlRequest ( input * GetQueueUrlInput ) ( req * request . Request , output * GetQueueUrlOutput ) {
op := & request . Operation {
Name : opGetQueueUrl ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & GetQueueUrlInput { }
}
output = & GetQueueUrlOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// GetQueueUrl API operation for Amazon Simple Queue Service.
//
2018-10-17 02:12:35 +02:00
// Returns the URL of an existing Amazon SQS queue.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// To access a queue that belongs to another AWS account, use the QueueOwnerAWSAccountId
2016-01-29 20:53:56 +01:00
// parameter to specify the account ID of the queue's owner. The queue's owner
// must grant you permission to access the queue. For more information about
2018-10-17 02:12:35 +02:00
// shared queue access, see AddPermission or see Allow Developers to Write Messages
// to a Shared Queue (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation GetQueueUrl for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeQueueDoesNotExist "AWS.SimpleQueueService.NonExistentQueue"
2018-10-17 02:12:35 +02:00
// The specified queue doesn't exist.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/GetQueueUrl
2016-01-29 20:53:56 +01:00
func ( c * SQS ) GetQueueUrl ( input * GetQueueUrlInput ) ( * GetQueueUrlOutput , error ) {
req , out := c . GetQueueUrlRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// GetQueueUrlWithContext is the same as GetQueueUrl with the addition of
// the ability to pass a context and additional request options.
//
// See GetQueueUrl for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) GetQueueUrlWithContext ( ctx aws . Context , input * GetQueueUrlInput , opts ... request . Option ) ( * GetQueueUrlOutput , error ) {
req , out := c . GetQueueUrlRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opListDeadLetterSourceQueues = "ListDeadLetterSourceQueues"
2016-07-15 15:49:02 +02:00
// ListDeadLetterSourceQueuesRequest generates a "aws/request.Request" representing the
// client's request for the ListDeadLetterSourceQueues operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// See ListDeadLetterSourceQueues for more information on using the ListDeadLetterSourceQueues
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the ListDeadLetterSourceQueuesRequest method.
// req, resp := client.ListDeadLetterSourceQueuesRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListDeadLetterSourceQueues
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ListDeadLetterSourceQueuesRequest ( input * ListDeadLetterSourceQueuesInput ) ( req * request . Request , output * ListDeadLetterSourceQueuesOutput ) {
op := & request . Operation {
Name : opListDeadLetterSourceQueues ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & ListDeadLetterSourceQueuesInput { }
}
output = & ListDeadLetterSourceQueuesOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// ListDeadLetterSourceQueues API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Returns a list of your queues that have the RedrivePolicy queue attribute
2017-12-13 00:27:05 +01:00
// configured with a dead-letter queue.
2016-01-29 20:53:56 +01:00
//
2017-12-13 00:27:05 +01:00
// For more information about using dead-letter queues, see Using Amazon SQS
// Dead-Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html)
// in the Amazon Simple Queue Service Developer Guide.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation ListDeadLetterSourceQueues for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeQueueDoesNotExist "AWS.SimpleQueueService.NonExistentQueue"
2018-10-17 02:12:35 +02:00
// The specified queue doesn't exist.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListDeadLetterSourceQueues
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ListDeadLetterSourceQueues ( input * ListDeadLetterSourceQueuesInput ) ( * ListDeadLetterSourceQueuesOutput , error ) {
req , out := c . ListDeadLetterSourceQueuesRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// ListDeadLetterSourceQueuesWithContext is the same as ListDeadLetterSourceQueues with the addition of
// the ability to pass a context and additional request options.
//
// See ListDeadLetterSourceQueues for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) ListDeadLetterSourceQueuesWithContext ( ctx aws . Context , input * ListDeadLetterSourceQueuesInput , opts ... request . Option ) ( * ListDeadLetterSourceQueuesOutput , error ) {
req , out := c . ListDeadLetterSourceQueuesRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
2017-12-13 00:27:05 +01:00
const opListQueueTags = "ListQueueTags"
// ListQueueTagsRequest generates a "aws/request.Request" representing the
// client's request for the ListQueueTags operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-12-13 00:27:05 +01:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See ListQueueTags for more information on using the ListQueueTags
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the ListQueueTagsRequest method.
// req, resp := client.ListQueueTagsRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListQueueTags
2017-12-13 00:27:05 +01:00
func ( c * SQS ) ListQueueTagsRequest ( input * ListQueueTagsInput ) ( req * request . Request , output * ListQueueTagsOutput ) {
op := & request . Operation {
Name : opListQueueTags ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & ListQueueTagsInput { }
}
output = & ListQueueTagsOutput { }
req = c . newRequest ( op , input , output )
return
}
// ListQueueTags API operation for Amazon Simple Queue Service.
//
// List all cost allocation tags added to the specified Amazon SQS queue. For
2018-10-17 02:12:35 +02:00
// an overview, see Tagging Your Amazon SQS Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
//
// When you use queue tags, keep the following guidelines in mind:
//
// * Adding more than 50 tags to a queue isn't recommended.
//
// * Tags don't have any semantic meaning. Amazon SQS interprets tags as
// character strings.
//
// * Tags are case-sensitive.
//
// * A new tag with a key identical to that of an existing tag overwrites
// the existing tag.
//
2018-10-17 02:12:35 +02:00
// * Tagging actions are limited to 5 TPS per AWS account. If your application
2017-12-13 00:27:05 +01:00
// requires a higher throughput, file a technical support request (https://console.aws.amazon.com/support/home#/case/create?issueType=technical).
//
2018-10-17 02:12:35 +02:00
// For a full list of tag restrictions, see Limits Related to Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues)
// in the Amazon Simple Queue Service Developer Guide.
//
// Cross-account permissions don't apply to this action. For more information,
// see see Grant Cross-Account Permissions to a Role and a User Name (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation ListQueueTags for usage and error information.
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListQueueTags
2017-12-13 00:27:05 +01:00
func ( c * SQS ) ListQueueTags ( input * ListQueueTagsInput ) ( * ListQueueTagsOutput , error ) {
req , out := c . ListQueueTagsRequest ( input )
return out , req . Send ( )
}
// ListQueueTagsWithContext is the same as ListQueueTags with the addition of
// the ability to pass a context and additional request options.
//
// See ListQueueTags for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) ListQueueTagsWithContext ( ctx aws . Context , input * ListQueueTagsInput , opts ... request . Option ) ( * ListQueueTagsOutput , error ) {
req , out := c . ListQueueTagsRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
}
2016-01-29 20:53:56 +01:00
const opListQueues = "ListQueues"
2016-07-15 15:49:02 +02:00
// ListQueuesRequest generates a "aws/request.Request" representing the
// client's request for the ListQueues operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-09-05 15:21:07 +02:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// See ListQueues for more information on using the ListQueues
// API call, and error handling.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the ListQueuesRequest method.
// req, resp := client.ListQueuesRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListQueues
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ListQueuesRequest ( input * ListQueuesInput ) ( req * request . Request , output * ListQueuesOutput ) {
op := & request . Operation {
Name : opListQueues ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & ListQueuesInput { }
}
output = & ListQueuesOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// ListQueues API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Returns a list of your queues. The maximum number of queues that can be returned
2017-01-02 21:35:31 +01:00
// is 1,000. If you specify a value for the optional QueueNamePrefix parameter,
// only queues with a name that begins with the specified value are returned.
2016-10-17 23:21:08 +02:00
//
2018-10-17 02:12:35 +02:00
// Cross-account permissions don't apply to this action. For more information,
// see see Grant Cross-Account Permissions to a Role and a User Name (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name)
// in the Amazon Simple Queue Service Developer Guide.
//
2016-10-17 23:21:08 +02:00
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation ListQueues for usage and error information.
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListQueues
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ListQueues ( input * ListQueuesInput ) ( * ListQueuesOutput , error ) {
req , out := c . ListQueuesRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// ListQueuesWithContext is the same as ListQueues with the addition of
// the ability to pass a context and additional request options.
//
// See ListQueues for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) ListQueuesWithContext ( ctx aws . Context , input * ListQueuesInput , opts ... request . Option ) ( * ListQueuesOutput , error ) {
req , out := c . ListQueuesRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opPurgeQueue = "PurgeQueue"
2016-07-15 15:49:02 +02:00
// PurgeQueueRequest generates a "aws/request.Request" representing the
// client's request for the PurgeQueue operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// See PurgeQueue for more information on using the PurgeQueue
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the PurgeQueueRequest method.
// req, resp := client.PurgeQueueRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/PurgeQueue
2016-01-29 20:53:56 +01:00
func ( c * SQS ) PurgeQueueRequest ( input * PurgeQueueInput ) ( req * request . Request , output * PurgeQueueOutput ) {
op := & request . Operation {
Name : opPurgeQueue ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & PurgeQueueInput { }
}
2017-01-23 22:22:31 +01:00
output = & PurgeQueueOutput { }
2016-01-29 20:53:56 +01:00
req = c . newRequest ( op , input , output )
2018-12-14 02:30:43 +01:00
req . Handlers . Unmarshal . Swap ( query . UnmarshalHandler . Name , protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// PurgeQueue API operation for Amazon Simple Queue Service.
//
2017-01-02 21:35:31 +01:00
// Deletes the messages in a queue specified by the QueueURL parameter.
2016-01-29 20:53:56 +01:00
//
2018-10-17 02:12:35 +02:00
// When you use the PurgeQueue action, you can't retrieve any messages deleted
2017-01-02 21:35:31 +01:00
// from a queue.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// The message deletion process takes up to 60 seconds. We recommend waiting
// for 60 seconds regardless of your queue's size.
//
// Messages sent to the queue before you call PurgeQueue might be received but
// are deleted within the next minute.
//
// Messages sent to the queue after you call PurgeQueue might be deleted while
// the queue is being purged.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation PurgeQueue for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeQueueDoesNotExist "AWS.SimpleQueueService.NonExistentQueue"
2018-10-17 02:12:35 +02:00
// The specified queue doesn't exist.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodePurgeQueueInProgress "AWS.SimpleQueueService.PurgeQueueInProgress"
2016-10-17 23:21:08 +02:00
// Indicates that the specified queue previously received a PurgeQueue request
2017-01-02 21:35:31 +01:00
// within the last 60 seconds (the time it can take to delete the messages in
// the queue).
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/PurgeQueue
2016-01-29 20:53:56 +01:00
func ( c * SQS ) PurgeQueue ( input * PurgeQueueInput ) ( * PurgeQueueOutput , error ) {
req , out := c . PurgeQueueRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// PurgeQueueWithContext is the same as PurgeQueue with the addition of
// the ability to pass a context and additional request options.
//
// See PurgeQueue for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) PurgeQueueWithContext ( ctx aws . Context , input * PurgeQueueInput , opts ... request . Option ) ( * PurgeQueueOutput , error ) {
req , out := c . PurgeQueueRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opReceiveMessage = "ReceiveMessage"
2016-07-15 15:49:02 +02:00
// ReceiveMessageRequest generates a "aws/request.Request" representing the
// client's request for the ReceiveMessage operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-09-05 15:21:07 +02:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// See ReceiveMessage for more information on using the ReceiveMessage
// API call, and error handling.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the ReceiveMessageRequest method.
// req, resp := client.ReceiveMessageRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ReceiveMessage
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ReceiveMessageRequest ( input * ReceiveMessageInput ) ( req * request . Request , output * ReceiveMessageOutput ) {
op := & request . Operation {
Name : opReceiveMessage ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & ReceiveMessageInput { }
}
output = & ReceiveMessageOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// ReceiveMessage API operation for Amazon Simple Queue Service.
//
2017-01-02 21:35:31 +01:00
// Retrieves one or more messages (up to 10), from the specified queue. Using
// the WaitTimeSeconds parameter enables long-poll support. For more information,
// see Amazon SQS Long Polling (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// Short poll is the default behavior where a weighted random set of machines
2017-01-02 21:35:31 +01:00
// is sampled on a ReceiveMessage call. Thus, only the messages on the sampled
// machines are returned. If the number of messages in the queue is small (fewer
// than 1,000), you most likely get fewer messages than you requested per ReceiveMessage
// call. If the number of messages in the queue is extremely small, you might
// not receive any messages in a particular ReceiveMessage response. If this
// happens, repeat the request.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// For each message returned, the response includes the following:
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// * The message body.
2016-01-29 20:53:56 +01:00
//
2017-05-11 13:24:29 +02:00
// * An MD5 digest of the message body. For information about MD5, see RFC1321
2016-11-19 19:41:01 +01:00
// (https://www.ietf.org/rfc/rfc1321.txt).
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// * The MessageId you received when you sent the message to the queue.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// * The receipt handle.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// * The message attributes.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// * An MD5 digest of the message attributes.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The receipt handle is the identifier you must provide when deleting the message.
2016-12-15 15:48:01 +01:00
// For more information, see Queue and Message Identifiers (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-message-identifiers.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// You can provide the VisibilityTimeout parameter in your request. The parameter
// is applied to the messages that Amazon SQS returns in the response. If you
2016-11-19 19:41:01 +01:00
// don't include the parameter, the overall visibility timeout for the queue
// is used for the returned messages. For more information, see Visibility Timeout
2016-12-15 15:48:01 +01:00
// (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// A message that isn't deleted or a message whose visibility isn't extended
2016-11-19 19:41:01 +01:00
// before the visibility timeout expires counts as a failed receive. Depending
2017-12-13 00:27:05 +01:00
// on the configuration of the queue, the message might be sent to the dead-letter
// queue.
2016-11-19 19:41:01 +01:00
//
2017-01-02 21:35:31 +01:00
// In the future, new attributes might be added. If you write code that calls
// this action, we recommend that you structure your code so that it can handle
// new attributes gracefully.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation ReceiveMessage for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeOverLimit "OverLimit"
2018-10-17 02:12:35 +02:00
// The specified action violates a limit. For example, ReceiveMessage returns
// this error if the maximum number of inflight messages is reached and AddPermission
// returns this error if the maximum number of permissions for the queue is
// reached.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ReceiveMessage
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ReceiveMessage ( input * ReceiveMessageInput ) ( * ReceiveMessageOutput , error ) {
req , out := c . ReceiveMessageRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// ReceiveMessageWithContext is the same as ReceiveMessage with the addition of
// the ability to pass a context and additional request options.
//
// See ReceiveMessage for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) ReceiveMessageWithContext ( ctx aws . Context , input * ReceiveMessageInput , opts ... request . Option ) ( * ReceiveMessageOutput , error ) {
req , out := c . ReceiveMessageRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opRemovePermission = "RemovePermission"
2016-07-15 15:49:02 +02:00
// RemovePermissionRequest generates a "aws/request.Request" representing the
// client's request for the RemovePermission operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// See RemovePermission for more information on using the RemovePermission
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the RemovePermissionRequest method.
// req, resp := client.RemovePermissionRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/RemovePermission
2016-01-29 20:53:56 +01:00
func ( c * SQS ) RemovePermissionRequest ( input * RemovePermissionInput ) ( req * request . Request , output * RemovePermissionOutput ) {
op := & request . Operation {
Name : opRemovePermission ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & RemovePermissionInput { }
}
2017-01-23 22:22:31 +01:00
output = & RemovePermissionOutput { }
2016-01-29 20:53:56 +01:00
req = c . newRequest ( op , input , output )
2018-12-14 02:30:43 +01:00
req . Handlers . Unmarshal . Swap ( query . UnmarshalHandler . Name , protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// RemovePermission API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Revokes any permissions in the queue policy that matches the specified Label
2018-10-17 02:12:35 +02:00
// parameter.
//
// Only the owner of a queue can remove permissions from it.
//
// Cross-account permissions don't apply to this action. For more information,
// see see Grant Cross-Account Permissions to a Role and a User Name (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name)
// in the Amazon Simple Queue Service Developer Guide.
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation RemovePermission for usage and error information.
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/RemovePermission
2016-01-29 20:53:56 +01:00
func ( c * SQS ) RemovePermission ( input * RemovePermissionInput ) ( * RemovePermissionOutput , error ) {
req , out := c . RemovePermissionRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// RemovePermissionWithContext is the same as RemovePermission with the addition of
// the ability to pass a context and additional request options.
//
// See RemovePermission for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) RemovePermissionWithContext ( ctx aws . Context , input * RemovePermissionInput , opts ... request . Option ) ( * RemovePermissionOutput , error ) {
req , out := c . RemovePermissionRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opSendMessage = "SendMessage"
2016-07-15 15:49:02 +02:00
// SendMessageRequest generates a "aws/request.Request" representing the
// client's request for the SendMessage operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-09-05 15:21:07 +02:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// See SendMessage for more information on using the SendMessage
// API call, and error handling.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the SendMessageRequest method.
// req, resp := client.SendMessageRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/SendMessage
2016-01-29 20:53:56 +01:00
func ( c * SQS ) SendMessageRequest ( input * SendMessageInput ) ( req * request . Request , output * SendMessageOutput ) {
op := & request . Operation {
Name : opSendMessage ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & SendMessageInput { }
}
output = & SendMessageOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// SendMessage API operation for Amazon Simple Queue Service.
//
2016-11-19 19:41:01 +01:00
// Delivers a message to the specified queue.
2016-01-29 20:53:56 +01:00
//
2017-05-11 13:24:29 +02:00
// A message can include only XML, JSON, and unformatted text. The following
// Unicode characters are allowed:
2017-01-02 21:35:31 +01:00
//
2017-05-11 13:24:29 +02:00
// #x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF
2017-01-02 21:35:31 +01:00
//
2017-05-11 13:24:29 +02:00
// Any characters not included in this list will be rejected. For more information,
// see the W3C specification for characters (http://www.w3.org/TR/REC-xml/#charsets).
2016-10-17 23:21:08 +02:00
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation SendMessage for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeInvalidMessageContents "InvalidMessageContents"
2016-10-17 23:21:08 +02:00
// The message contains characters outside the allowed set.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeUnsupportedOperation "AWS.SimpleQueueService.UnsupportedOperation"
2016-10-17 23:21:08 +02:00
// Error code 400. Unsupported operation.
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/SendMessage
2016-01-29 20:53:56 +01:00
func ( c * SQS ) SendMessage ( input * SendMessageInput ) ( * SendMessageOutput , error ) {
req , out := c . SendMessageRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// SendMessageWithContext is the same as SendMessage with the addition of
// the ability to pass a context and additional request options.
//
// See SendMessage for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) SendMessageWithContext ( ctx aws . Context , input * SendMessageInput , opts ... request . Option ) ( * SendMessageOutput , error ) {
req , out := c . SendMessageRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opSendMessageBatch = "SendMessageBatch"
2016-07-15 15:49:02 +02:00
// SendMessageBatchRequest generates a "aws/request.Request" representing the
// client's request for the SendMessageBatch operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// See SendMessageBatch for more information on using the SendMessageBatch
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the SendMessageBatchRequest method.
// req, resp := client.SendMessageBatchRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/SendMessageBatch
2016-01-29 20:53:56 +01:00
func ( c * SQS ) SendMessageBatchRequest ( input * SendMessageBatchInput ) ( req * request . Request , output * SendMessageBatchOutput ) {
op := & request . Operation {
Name : opSendMessageBatch ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & SendMessageBatchInput { }
}
output = & SendMessageBatchOutput { }
2017-01-23 22:22:31 +01:00
req = c . newRequest ( op , input , output )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// SendMessageBatch API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Delivers up to ten messages to the specified queue. This is a batch version
2016-11-19 19:41:01 +01:00
// of SendMessage. For a FIFO queue, multiple messages within a single batch
// are enqueued in the order they are sent.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The result of sending each message is reported individually in the response.
// Because the batch request can result in a combination of successful and unsuccessful
// actions, you should check for batch errors even when the call returns an
// HTTP status code of 200.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// The maximum allowed individual message size and the maximum total payload
// size (the sum of the individual lengths of all of the batched messages) are
// both 256 KB (262,144 bytes).
2016-01-29 20:53:56 +01:00
//
2017-05-11 13:24:29 +02:00
// A message can include only XML, JSON, and unformatted text. The following
// Unicode characters are allowed:
2017-01-02 21:35:31 +01:00
//
2017-05-11 13:24:29 +02:00
// #x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF
2017-01-02 21:35:31 +01:00
//
2017-05-11 13:24:29 +02:00
// Any characters not included in this list will be rejected. For more information,
// see the W3C specification for characters (http://www.w3.org/TR/REC-xml/#charsets).
2016-11-19 19:41:01 +01:00
//
// If you don't specify the DelaySeconds parameter for an entry, Amazon SQS
2017-01-02 21:35:31 +01:00
// uses the default value for the queue.
2016-07-15 15:49:02 +02:00
//
2017-01-02 21:35:31 +01:00
// Some actions take lists of parameters. These lists are specified using the
// param.n notation. Values of n are integers starting from 1. For example,
2016-07-15 15:49:02 +02:00
// a parameter list with two elements looks like this:
2016-10-17 23:21:08 +02:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.1=first
2016-11-19 19:41:01 +01:00
//
2018-10-17 02:12:35 +02:00
// &Attribute.2=second
2016-11-19 19:41:01 +01:00
//
2016-10-17 23:21:08 +02:00
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation SendMessageBatch for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeTooManyEntriesInBatchRequest "AWS.SimpleQueueService.TooManyEntriesInBatchRequest"
2017-01-02 21:35:31 +01:00
// The batch request contains more entries than permissible.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeEmptyBatchRequest "AWS.SimpleQueueService.EmptyBatchRequest"
2017-01-02 21:35:31 +01:00
// The batch request doesn't contain any entries.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeBatchEntryIdsNotDistinct "AWS.SimpleQueueService.BatchEntryIdsNotDistinct"
2017-01-02 21:35:31 +01:00
// Two or more batch entries in the request have the same Id.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeBatchRequestTooLong "AWS.SimpleQueueService.BatchRequestTooLong"
2016-10-17 23:21:08 +02:00
// The length of all the messages put together is more than the limit.
//
2017-02-08 14:02:41 +01:00
// * ErrCodeInvalidBatchEntryId "AWS.SimpleQueueService.InvalidBatchEntryId"
2016-11-19 19:41:01 +01:00
// The Id of a batch entry in a batch request doesn't abide by the specification.
2016-10-17 23:21:08 +02:00
//
2017-02-08 14:02:41 +01:00
// * ErrCodeUnsupportedOperation "AWS.SimpleQueueService.UnsupportedOperation"
2016-10-17 23:21:08 +02:00
// Error code 400. Unsupported operation.
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/SendMessageBatch
2016-01-29 20:53:56 +01:00
func ( c * SQS ) SendMessageBatch ( input * SendMessageBatchInput ) ( * SendMessageBatchOutput , error ) {
req , out := c . SendMessageBatchRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// SendMessageBatchWithContext is the same as SendMessageBatch with the addition of
// the ability to pass a context and additional request options.
//
// See SendMessageBatch for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) SendMessageBatchWithContext ( ctx aws . Context , input * SendMessageBatchInput , opts ... request . Option ) ( * SendMessageBatchOutput , error ) {
req , out := c . SendMessageBatchRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
const opSetQueueAttributes = "SetQueueAttributes"
2016-07-15 15:49:02 +02:00
// SetQueueAttributesRequest generates a "aws/request.Request" representing the
// client's request for the SetQueueAttributes operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-09-05 15:21:07 +02:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
2016-07-15 15:49:02 +02:00
//
2017-09-05 15:21:07 +02:00
// See SetQueueAttributes for more information on using the SetQueueAttributes
// API call, and error handling.
2016-10-17 23:21:08 +02:00
//
2017-09-05 15:21:07 +02:00
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
2016-07-15 15:49:02 +02:00
//
//
// // Example sending a request using the SetQueueAttributesRequest method.
// req, resp := client.SetQueueAttributesRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/SetQueueAttributes
2016-01-29 20:53:56 +01:00
func ( c * SQS ) SetQueueAttributesRequest ( input * SetQueueAttributesInput ) ( req * request . Request , output * SetQueueAttributesOutput ) {
op := & request . Operation {
Name : opSetQueueAttributes ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & SetQueueAttributesInput { }
}
2017-01-23 22:22:31 +01:00
output = & SetQueueAttributesOutput { }
2016-01-29 20:53:56 +01:00
req = c . newRequest ( op , input , output )
2018-12-14 02:30:43 +01:00
req . Handlers . Unmarshal . Swap ( query . UnmarshalHandler . Name , protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
return
}
2016-10-17 23:21:08 +02:00
// SetQueueAttributes API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Sets the value of one or more queue attributes. When you change a queue's
// attributes, the change can take up to 60 seconds for most of the attributes
2017-01-02 21:35:31 +01:00
// to propagate throughout the Amazon SQS system. Changes made to the MessageRetentionPeriod
2016-01-29 20:53:56 +01:00
// attribute can take up to 15 minutes.
//
2017-01-02 21:35:31 +01:00
// In the future, new attributes might be added. If you write code that calls
// this action, we recommend that you structure your code so that it can handle
// new attributes gracefully.
2016-10-17 23:21:08 +02:00
//
2018-10-17 02:12:35 +02:00
// Cross-account permissions don't apply to this action. For more information,
// see see Grant Cross-Account Permissions to a Role and a User Name (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name)
// in the Amazon Simple Queue Service Developer Guide.
//
2016-10-17 23:21:08 +02:00
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation SetQueueAttributes for usage and error information.
//
// Returned Error Codes:
2017-02-08 14:02:41 +01:00
// * ErrCodeInvalidAttributeName "InvalidAttributeName"
2018-10-17 02:12:35 +02:00
// The specified attribute doesn't exist.
2016-10-17 23:21:08 +02:00
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/SetQueueAttributes
2016-01-29 20:53:56 +01:00
func ( c * SQS ) SetQueueAttributes ( input * SetQueueAttributesInput ) ( * SetQueueAttributesOutput , error ) {
req , out := c . SetQueueAttributesRequest ( input )
2017-04-05 09:45:27 +02:00
return out , req . Send ( )
}
// SetQueueAttributesWithContext is the same as SetQueueAttributes with the addition of
// the ability to pass a context and additional request options.
//
// See SetQueueAttributes for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) SetQueueAttributesWithContext ( ctx aws . Context , input * SetQueueAttributesInput , opts ... request . Option ) ( * SetQueueAttributesOutput , error ) {
req , out := c . SetQueueAttributesRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
2016-01-29 20:53:56 +01:00
}
2017-12-13 00:27:05 +01:00
const opTagQueue = "TagQueue"
// TagQueueRequest generates a "aws/request.Request" representing the
// client's request for the TagQueue operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-12-13 00:27:05 +01:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See TagQueue for more information on using the TagQueue
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the TagQueueRequest method.
// req, resp := client.TagQueueRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/TagQueue
2017-12-13 00:27:05 +01:00
func ( c * SQS ) TagQueueRequest ( input * TagQueueInput ) ( req * request . Request , output * TagQueueOutput ) {
op := & request . Operation {
Name : opTagQueue ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & TagQueueInput { }
}
output = & TagQueueOutput { }
req = c . newRequest ( op , input , output )
2018-12-14 02:30:43 +01:00
req . Handlers . Unmarshal . Swap ( query . UnmarshalHandler . Name , protocol . UnmarshalDiscardBodyHandler )
2017-12-13 00:27:05 +01:00
return
}
// TagQueue API operation for Amazon Simple Queue Service.
//
// Add cost allocation tags to the specified Amazon SQS queue. For an overview,
2018-10-17 02:12:35 +02:00
// see Tagging Your Amazon SQS Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
//
// When you use queue tags, keep the following guidelines in mind:
//
// * Adding more than 50 tags to a queue isn't recommended.
//
// * Tags don't have any semantic meaning. Amazon SQS interprets tags as
// character strings.
//
// * Tags are case-sensitive.
//
// * A new tag with a key identical to that of an existing tag overwrites
// the existing tag.
//
2018-10-17 02:12:35 +02:00
// * Tagging actions are limited to 5 TPS per AWS account. If your application
2017-12-13 00:27:05 +01:00
// requires a higher throughput, file a technical support request (https://console.aws.amazon.com/support/home#/case/create?issueType=technical).
//
2018-10-17 02:12:35 +02:00
// For a full list of tag restrictions, see Limits Related to Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues)
// in the Amazon Simple Queue Service Developer Guide.
//
// Cross-account permissions don't apply to this action. For more information,
// see see Grant Cross-Account Permissions to a Role and a User Name (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation TagQueue for usage and error information.
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/TagQueue
2017-12-13 00:27:05 +01:00
func ( c * SQS ) TagQueue ( input * TagQueueInput ) ( * TagQueueOutput , error ) {
req , out := c . TagQueueRequest ( input )
return out , req . Send ( )
}
// TagQueueWithContext is the same as TagQueue with the addition of
// the ability to pass a context and additional request options.
//
// See TagQueue for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) TagQueueWithContext ( ctx aws . Context , input * TagQueueInput , opts ... request . Option ) ( * TagQueueOutput , error ) {
req , out := c . TagQueueRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
}
const opUntagQueue = "UntagQueue"
// UntagQueueRequest generates a "aws/request.Request" representing the
// client's request for the UntagQueue operation. The "output" return
2018-04-20 09:47:00 +02:00
// value will be populated with the request's response once the request completes
2018-10-25 06:09:59 +02:00
// successfully.
2017-12-13 00:27:05 +01:00
//
// Use "Send" method on the returned Request to send the API call to the service.
// the "output" return value is not valid until after Send returns without error.
//
// See UntagQueue for more information on using the UntagQueue
// API call, and error handling.
//
// This method is useful when you want to inject custom logic or configuration
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
//
//
// // Example sending a request using the UntagQueueRequest method.
// req, resp := client.UntagQueueRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/UntagQueue
2017-12-13 00:27:05 +01:00
func ( c * SQS ) UntagQueueRequest ( input * UntagQueueInput ) ( req * request . Request , output * UntagQueueOutput ) {
op := & request . Operation {
Name : opUntagQueue ,
HTTPMethod : "POST" ,
HTTPPath : "/" ,
}
if input == nil {
input = & UntagQueueInput { }
}
output = & UntagQueueOutput { }
req = c . newRequest ( op , input , output )
2018-12-14 02:30:43 +01:00
req . Handlers . Unmarshal . Swap ( query . UnmarshalHandler . Name , protocol . UnmarshalDiscardBodyHandler )
2017-12-13 00:27:05 +01:00
return
}
// UntagQueue API operation for Amazon Simple Queue Service.
//
// Remove cost allocation tags from the specified Amazon SQS queue. For an overview,
2018-10-17 02:12:35 +02:00
// see Tagging Your Amazon SQS Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
//
// When you use queue tags, keep the following guidelines in mind:
//
// * Adding more than 50 tags to a queue isn't recommended.
//
// * Tags don't have any semantic meaning. Amazon SQS interprets tags as
// character strings.
//
// * Tags are case-sensitive.
//
// * A new tag with a key identical to that of an existing tag overwrites
// the existing tag.
//
2018-10-17 02:12:35 +02:00
// * Tagging actions are limited to 5 TPS per AWS account. If your application
2017-12-13 00:27:05 +01:00
// requires a higher throughput, file a technical support request (https://console.aws.amazon.com/support/home#/case/create?issueType=technical).
//
2018-10-17 02:12:35 +02:00
// For a full list of tag restrictions, see Limits Related to Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues)
// in the Amazon Simple Queue Service Developer Guide.
//
// Cross-account permissions don't apply to this action. For more information,
// see see Grant Cross-Account Permissions to a Role and a User Name (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Simple Queue Service's
// API operation UntagQueue for usage and error information.
2018-01-25 12:09:58 +01:00
// See also, https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/UntagQueue
2017-12-13 00:27:05 +01:00
func ( c * SQS ) UntagQueue ( input * UntagQueueInput ) ( * UntagQueueOutput , error ) {
req , out := c . UntagQueueRequest ( input )
return out , req . Send ( )
}
// UntagQueueWithContext is the same as UntagQueue with the addition of
// the ability to pass a context and additional request options.
//
// See UntagQueue for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func ( c * SQS ) UntagQueueWithContext ( ctx aws . Context , input * UntagQueueInput , opts ... request . Option ) ( * UntagQueueOutput , error ) {
req , out := c . UntagQueueRequest ( input )
req . SetContext ( ctx )
req . ApplyOptions ( opts ... )
return out , req . Send ( )
}
2016-01-29 20:53:56 +01:00
type AddPermissionInput struct {
_ struct { } ` type:"structure" `
// The AWS account number of the principal (http://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P)
2017-01-02 21:35:31 +01:00
// who is given permission. The principal must have an AWS account, but does
// not need to be signed up for Amazon SQS. For information about locating the
2018-10-17 02:12:35 +02:00
// AWS account identification, see Your AWS Identifiers (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-making-api-requests.html#sqs-api-request-authentication)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-10-17 23:21:08 +02:00
//
// AWSAccountIds is a required field
2016-01-29 20:53:56 +01:00
AWSAccountIds [ ] * string ` locationNameList:"AWSAccountId" type:"list" flattened:"true" required:"true" `
2018-10-17 02:12:35 +02:00
// The action the client wants to allow for the specified principal. Valid values:
// the name of any action or *.
2017-01-02 21:35:31 +01:00
//
2018-10-17 02:12:35 +02:00
// For more information about these actions, see Overview of Managing Access
// Permissions to Your Amazon Simple Queue Service Resource (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-overview-of-managing-access.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// Specifying SendMessage, DeleteMessage, or ChangeMessageVisibility for ActionName.n
// also grants permissions for the corresponding batch versions of those actions:
// SendMessageBatch, DeleteMessageBatch, and ChangeMessageVisibilityBatch.
2016-10-17 23:21:08 +02:00
//
// Actions is a required field
2016-01-29 20:53:56 +01:00
Actions [ ] * string ` locationNameList:"ActionName" type:"list" flattened:"true" required:"true" `
2017-01-02 21:35:31 +01:00
// The unique identification of the permission you're setting (for example,
// AliceSendMessage). Maximum 80 characters. Allowed characters include alphanumeric
// characters, hyphens (-), and underscores (_).
2016-10-17 23:21:08 +02:00
//
// Label is a required field
2016-01-29 20:53:56 +01:00
Label * string ` type:"string" required:"true" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue to which permissions are added.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s AddPermissionInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s AddPermissionInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * AddPermissionInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "AddPermissionInput" }
if s . AWSAccountIds == nil {
invalidParams . Add ( request . NewErrParamRequired ( "AWSAccountIds" ) )
}
if s . Actions == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Actions" ) )
}
if s . Label == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Label" ) )
}
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAWSAccountIds sets the AWSAccountIds field's value.
func ( s * AddPermissionInput ) SetAWSAccountIds ( v [ ] * string ) * AddPermissionInput {
s . AWSAccountIds = v
return s
}
// SetActions sets the Actions field's value.
func ( s * AddPermissionInput ) SetActions ( v [ ] * string ) * AddPermissionInput {
s . Actions = v
return s
}
// SetLabel sets the Label field's value.
func ( s * AddPermissionInput ) SetLabel ( v string ) * AddPermissionInput {
s . Label = & v
return s
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * AddPermissionInput ) SetQueueUrl ( v string ) * AddPermissionInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
type AddPermissionOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s AddPermissionOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s AddPermissionOutput ) GoString ( ) string {
return s . String ( )
}
2018-10-17 02:12:35 +02:00
// Gives a detailed description of the result of an action on each entry in
// the request.
2016-01-29 20:53:56 +01:00
type BatchResultErrorEntry struct {
_ struct { } ` type:"structure" `
// An error code representing why the action failed on this entry.
2016-10-17 23:21:08 +02:00
//
// Code is a required field
2016-01-29 20:53:56 +01:00
Code * string ` type:"string" required:"true" `
2017-01-02 21:35:31 +01:00
// The Id of an entry in a batch request.
2016-10-17 23:21:08 +02:00
//
// Id is a required field
2016-01-29 20:53:56 +01:00
Id * string ` type:"string" required:"true" `
// A message explaining why the action failed on this entry.
Message * string ` type:"string" `
2018-10-17 02:12:35 +02:00
// Specifies whether the error happened due to the producer.
2016-10-17 23:21:08 +02:00
//
// SenderFault is a required field
2016-01-29 20:53:56 +01:00
SenderFault * bool ` type:"boolean" required:"true" `
}
// String returns the string representation
func ( s BatchResultErrorEntry ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s BatchResultErrorEntry ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetCode sets the Code field's value.
func ( s * BatchResultErrorEntry ) SetCode ( v string ) * BatchResultErrorEntry {
s . Code = & v
return s
}
// SetId sets the Id field's value.
func ( s * BatchResultErrorEntry ) SetId ( v string ) * BatchResultErrorEntry {
s . Id = & v
return s
}
// SetMessage sets the Message field's value.
func ( s * BatchResultErrorEntry ) SetMessage ( v string ) * BatchResultErrorEntry {
s . Message = & v
return s
}
// SetSenderFault sets the SenderFault field's value.
func ( s * BatchResultErrorEntry ) SetSenderFault ( v bool ) * BatchResultErrorEntry {
s . SenderFault = & v
return s
}
2016-01-29 20:53:56 +01:00
type ChangeMessageVisibilityBatchInput struct {
_ struct { } ` type:"structure" `
// A list of receipt handles of the messages for which the visibility timeout
// must be changed.
2016-10-17 23:21:08 +02:00
//
// Entries is a required field
2016-01-29 20:53:56 +01:00
Entries [ ] * ChangeMessageVisibilityBatchRequestEntry ` locationNameList:"ChangeMessageVisibilityBatchRequestEntry" type:"list" flattened:"true" required:"true" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue whose messages' visibility is changed.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s ChangeMessageVisibilityBatchInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ChangeMessageVisibilityBatchInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ChangeMessageVisibilityBatchInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ChangeMessageVisibilityBatchInput" }
if s . Entries == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Entries" ) )
}
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if s . Entries != nil {
for i , v := range s . Entries {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "Entries" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetEntries sets the Entries field's value.
func ( s * ChangeMessageVisibilityBatchInput ) SetEntries ( v [ ] * ChangeMessageVisibilityBatchRequestEntry ) * ChangeMessageVisibilityBatchInput {
s . Entries = v
return s
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * ChangeMessageVisibilityBatchInput ) SetQueueUrl ( v string ) * ChangeMessageVisibilityBatchInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
// For each message in the batch, the response contains a ChangeMessageVisibilityBatchResultEntry
// tag if the message succeeds or a BatchResultErrorEntry tag if the message
// fails.
type ChangeMessageVisibilityBatchOutput struct {
_ struct { } ` type:"structure" `
// A list of BatchResultErrorEntry items.
2016-10-17 23:21:08 +02:00
//
// Failed is a required field
2016-01-29 20:53:56 +01:00
Failed [ ] * BatchResultErrorEntry ` locationNameList:"BatchResultErrorEntry" type:"list" flattened:"true" required:"true" `
// A list of ChangeMessageVisibilityBatchResultEntry items.
2016-10-17 23:21:08 +02:00
//
// Successful is a required field
2016-01-29 20:53:56 +01:00
Successful [ ] * ChangeMessageVisibilityBatchResultEntry ` locationNameList:"ChangeMessageVisibilityBatchResultEntry" type:"list" flattened:"true" required:"true" `
}
// String returns the string representation
func ( s ChangeMessageVisibilityBatchOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ChangeMessageVisibilityBatchOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetFailed sets the Failed field's value.
func ( s * ChangeMessageVisibilityBatchOutput ) SetFailed ( v [ ] * BatchResultErrorEntry ) * ChangeMessageVisibilityBatchOutput {
s . Failed = v
return s
}
// SetSuccessful sets the Successful field's value.
func ( s * ChangeMessageVisibilityBatchOutput ) SetSuccessful ( v [ ] * ChangeMessageVisibilityBatchResultEntry ) * ChangeMessageVisibilityBatchOutput {
s . Successful = v
return s
}
2016-01-29 20:53:56 +01:00
// Encloses a receipt handle and an entry id for each message in ChangeMessageVisibilityBatch.
//
2017-01-02 21:35:31 +01:00
// All of the following list parameters must be prefixed with ChangeMessageVisibilityBatchRequestEntry.n,
// where n is an integer value starting with 1. For example, a parameter list
// for this action might look like this:
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// &ChangeMessageVisibilityBatchRequestEntry.1.Id=change_visibility_msg_2
2016-01-29 20:53:56 +01:00
//
2018-10-17 02:12:35 +02:00
// &ChangeMessageVisibilityBatchRequestEntry.1.ReceiptHandle=your_receipt_handle
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// &ChangeMessageVisibilityBatchRequestEntry.1.VisibilityTimeout=45
2016-01-29 20:53:56 +01:00
type ChangeMessageVisibilityBatchRequestEntry struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// An identifier for this particular receipt handle used to communicate the
// result.
//
// The Ids of a batch request need to be unique within a request
2016-10-17 23:21:08 +02:00
//
// Id is a required field
2016-01-29 20:53:56 +01:00
Id * string ` type:"string" required:"true" `
// A receipt handle.
2016-10-17 23:21:08 +02:00
//
// ReceiptHandle is a required field
2016-01-29 20:53:56 +01:00
ReceiptHandle * string ` type:"string" required:"true" `
// The new value (in seconds) for the message's visibility timeout.
VisibilityTimeout * int64 ` type:"integer" `
}
// String returns the string representation
func ( s ChangeMessageVisibilityBatchRequestEntry ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ChangeMessageVisibilityBatchRequestEntry ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ChangeMessageVisibilityBatchRequestEntry ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ChangeMessageVisibilityBatchRequestEntry" }
if s . Id == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Id" ) )
}
if s . ReceiptHandle == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ReceiptHandle" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetId sets the Id field's value.
func ( s * ChangeMessageVisibilityBatchRequestEntry ) SetId ( v string ) * ChangeMessageVisibilityBatchRequestEntry {
s . Id = & v
return s
}
// SetReceiptHandle sets the ReceiptHandle field's value.
func ( s * ChangeMessageVisibilityBatchRequestEntry ) SetReceiptHandle ( v string ) * ChangeMessageVisibilityBatchRequestEntry {
s . ReceiptHandle = & v
return s
}
// SetVisibilityTimeout sets the VisibilityTimeout field's value.
func ( s * ChangeMessageVisibilityBatchRequestEntry ) SetVisibilityTimeout ( v int64 ) * ChangeMessageVisibilityBatchRequestEntry {
s . VisibilityTimeout = & v
return s
}
2017-01-02 21:35:31 +01:00
// Encloses the Id of an entry in ChangeMessageVisibilityBatch.
2016-01-29 20:53:56 +01:00
type ChangeMessageVisibilityBatchResultEntry struct {
_ struct { } ` type:"structure" `
// Represents a message whose visibility timeout has been changed successfully.
2016-10-17 23:21:08 +02:00
//
// Id is a required field
2016-01-29 20:53:56 +01:00
Id * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s ChangeMessageVisibilityBatchResultEntry ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ChangeMessageVisibilityBatchResultEntry ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetId sets the Id field's value.
func ( s * ChangeMessageVisibilityBatchResultEntry ) SetId ( v string ) * ChangeMessageVisibilityBatchResultEntry {
s . Id = & v
return s
}
2016-01-29 20:53:56 +01:00
type ChangeMessageVisibilityInput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue whose message's visibility is changed.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
2017-01-02 21:35:31 +01:00
// The receipt handle associated with the message whose visibility timeout is
// changed. This parameter is returned by the ReceiveMessage action.
2016-10-17 23:21:08 +02:00
//
// ReceiptHandle is a required field
2016-01-29 20:53:56 +01:00
ReceiptHandle * string ` type:"string" required:"true" `
2017-01-02 21:35:31 +01:00
// The new value for the message's visibility timeout (in seconds). Values values:
// 0 to 43200. Maximum: 12 hours.
2016-10-17 23:21:08 +02:00
//
// VisibilityTimeout is a required field
2016-01-29 20:53:56 +01:00
VisibilityTimeout * int64 ` type:"integer" required:"true" `
}
// String returns the string representation
func ( s ChangeMessageVisibilityInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ChangeMessageVisibilityInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ChangeMessageVisibilityInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ChangeMessageVisibilityInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if s . ReceiptHandle == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ReceiptHandle" ) )
}
if s . VisibilityTimeout == nil {
invalidParams . Add ( request . NewErrParamRequired ( "VisibilityTimeout" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetQueueUrl sets the QueueUrl field's value.
func ( s * ChangeMessageVisibilityInput ) SetQueueUrl ( v string ) * ChangeMessageVisibilityInput {
s . QueueUrl = & v
return s
}
// SetReceiptHandle sets the ReceiptHandle field's value.
func ( s * ChangeMessageVisibilityInput ) SetReceiptHandle ( v string ) * ChangeMessageVisibilityInput {
s . ReceiptHandle = & v
return s
}
// SetVisibilityTimeout sets the VisibilityTimeout field's value.
func ( s * ChangeMessageVisibilityInput ) SetVisibilityTimeout ( v int64 ) * ChangeMessageVisibilityInput {
s . VisibilityTimeout = & v
return s
}
2016-01-29 20:53:56 +01:00
type ChangeMessageVisibilityOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s ChangeMessageVisibilityOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ChangeMessageVisibilityOutput ) GoString ( ) string {
return s . String ( )
}
type CreateQueueInput struct {
_ struct { } ` type:"structure" `
// A map of attributes with their corresponding values.
//
// The following lists the names, descriptions, and values of the special request
2016-11-19 19:41:01 +01:00
// parameters that the CreateQueue action uses:
2016-01-29 20:53:56 +01:00
//
2017-05-11 13:24:29 +02:00
// * DelaySeconds - The length of time, in seconds, for which the delivery
// of all messages in the queue is delayed. Valid values: An integer from
2018-10-17 02:12:35 +02:00
// 0 to 900 seconds (15 minutes). Default: 0.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * MaximumMessageSize - The limit of how many bytes a message can contain
2017-01-02 21:35:31 +01:00
// before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes
2018-10-17 02:12:35 +02:00
// (1 KiB) to 262,144 bytes (256 KiB). Default: 262,144 (256 KiB).
2016-07-15 15:49:02 +02:00
//
2017-05-11 13:24:29 +02:00
// * MessageRetentionPeriod - The length of time, in seconds, for which Amazon
// SQS retains a message. Valid values: An integer from 60 seconds (1 minute)
2018-10-17 02:12:35 +02:00
// to 1,209,600 seconds (14 days). Default: 345,600 (4 days).
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * Policy - The queue's policy. A valid AWS policy. For more information
// about policy structure, see Overview of AWS IAM Policies (http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html)
// in the Amazon IAM User Guide.
2016-07-15 15:49:02 +02:00
//
2017-05-11 13:24:29 +02:00
// * ReceiveMessageWaitTimeSeconds - The length of time, in seconds, for
// which a ReceiveMessage action waits for a message to arrive. Valid values:
2018-10-17 02:12:35 +02:00
// An integer from 0 to 20 (seconds). Default: 0.
2016-07-15 15:49:02 +02:00
//
2017-12-13 00:27:05 +01:00
// * RedrivePolicy - The string that includes the parameters for the dead-letter
// queue functionality of the source queue. For more information about the
// redrive policy and dead-letter queues, see Using Amazon SQS Dead-Letter
// Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html)
// in the Amazon Simple Queue Service Developer Guide.
//
// deadLetterTargetArn - The Amazon Resource Name (ARN) of the dead-letter queue
// to which Amazon SQS moves messages after the value of maxReceiveCount
// is exceeded.
2016-07-15 15:49:02 +02:00
//
2017-12-13 00:27:05 +01:00
// maxReceiveCount - The number of times a message is delivered to the source
2018-10-17 02:12:35 +02:00
// queue before being moved to the dead-letter queue. When the ReceiveCount
// for a message exceeds the maxReceiveCount for a queue, Amazon SQS moves
// the message to the dead-letter-queue.
2017-12-13 00:27:05 +01:00
//
// The dead-letter queue of a FIFO queue must also be a FIFO queue. Similarly,
// the dead-letter queue of a standard queue must also be a standard queue.
2016-11-19 19:41:01 +01:00
//
2018-10-17 02:12:35 +02:00
// * VisibilityTimeout - The visibility timeout for the queue, in seconds.
// Valid values: An integer from 0 to 43,200 (12 hours). Default: 30. For
// more information about the visibility timeout, see Visibility Timeout
// (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-11-19 19:41:01 +01:00
//
2017-05-11 13:24:29 +02:00
// The following attributes apply only to server-side-encryption (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html):
//
// * KmsMasterKeyId - The ID of an AWS-managed customer master key (CMK)
// for Amazon SQS or a custom CMK. For more information, see Key Terms (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms).
// While the alias of the AWS-managed CMK for Amazon SQS is always alias/aws/sqs,
2017-12-13 00:27:05 +01:00
// the alias of a custom CMK can, for example, be alias/MyAlias. For more
2017-05-11 13:24:29 +02:00
// examples, see KeyId (http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters)
// in the AWS Key Management Service API Reference.
//
// * KmsDataKeyReusePeriodSeconds - The length of time, in seconds, for which
// Amazon SQS can reuse a data key (http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys)
// to encrypt or decrypt messages before calling AWS KMS again. An integer
// representing seconds, between 60 seconds (1 minute) and 86,400 seconds
2018-10-17 02:12:35 +02:00
// (24 hours). Default: 300 (5 minutes). A shorter time period provides better
// security but results in more calls to KMS which might incur charges after
// Free Tier. For more information, see How Does the Data Key Reuse Period
// Work? (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work).
2017-05-11 13:24:29 +02:00
//
//
2016-11-19 19:41:01 +01:00
// The following attributes apply only to FIFO (first-in-first-out) queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html):
//
2017-05-11 13:24:29 +02:00
// * FifoQueue - Designates a queue as FIFO. Valid values: true, false. You
// can provide this attribute only during queue creation. You can't change
// it for an existing queue. When you set this attribute, you must also provide
// the MessageGroupId for your messages explicitly.
2016-11-19 19:41:01 +01:00
//
// For more information, see FIFO Queue Logic (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-11-19 19:41:01 +01:00
//
2017-05-11 13:24:29 +02:00
// * ContentBasedDeduplication - Enables content-based deduplication. Valid
// values: true, false. For more information, see Exactly-Once Processing
// (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// Every message must have a unique MessageDeduplicationId,
//
// You may provide a MessageDeduplicationId explicitly.
//
// If you aren't able to provide a MessageDeduplicationId and you enable ContentBasedDeduplication
// for your queue, Amazon SQS uses a SHA-256 hash to generate the MessageDeduplicationId
// using the body of the message (but not the attributes of the message).
//
//
// If you don't provide a MessageDeduplicationId and the queue doesn't have
// ContentBasedDeduplication set, the action fails with an error.
//
// If the queue has ContentBasedDeduplication set, your MessageDeduplicationId
// overrides the generated one.
//
// When ContentBasedDeduplication is in effect, messages with identical content
// sent within the deduplication interval are treated as duplicates and only
// one copy of the message is delivered.
//
// If you send one message with ContentBasedDeduplication enabled and then another
// message with a MessageDeduplicationId that is the same as the one generated
// for the first MessageDeduplicationId, the two messages are treated as
// duplicates and only one copy of the message is delivered.
2016-01-29 20:53:56 +01:00
Attributes map [ string ] * string ` locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
2016-11-19 19:41:01 +01:00
// The name of the new queue. The following limits apply to this name:
//
// * A queue name can have up to 80 characters.
//
2017-01-02 21:35:31 +01:00
// * Valid values: alphanumeric characters, hyphens (-), and underscores
// (_).
2016-11-19 19:41:01 +01:00
//
// * A FIFO queue name must end with the .fifo suffix.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueName is a required field
2016-01-29 20:53:56 +01:00
QueueName * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s CreateQueueInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s CreateQueueInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * CreateQueueInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "CreateQueueInput" }
if s . QueueName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueName" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributes sets the Attributes field's value.
func ( s * CreateQueueInput ) SetAttributes ( v map [ string ] * string ) * CreateQueueInput {
s . Attributes = v
return s
}
// SetQueueName sets the QueueName field's value.
func ( s * CreateQueueInput ) SetQueueName ( v string ) * CreateQueueInput {
s . QueueName = & v
return s
}
2017-01-02 21:35:31 +01:00
// Returns the QueueUrl attribute of the created queue.
2016-01-29 20:53:56 +01:00
type CreateQueueOutput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// The URL of the created Amazon SQS queue.
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" `
}
// String returns the string representation
func ( s CreateQueueOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s CreateQueueOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetQueueUrl sets the QueueUrl field's value.
func ( s * CreateQueueOutput ) SetQueueUrl ( v string ) * CreateQueueOutput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
type DeleteMessageBatchInput struct {
_ struct { } ` type:"structure" `
// A list of receipt handles for the messages to be deleted.
2016-10-17 23:21:08 +02:00
//
// Entries is a required field
2016-01-29 20:53:56 +01:00
Entries [ ] * DeleteMessageBatchRequestEntry ` locationNameList:"DeleteMessageBatchRequestEntry" type:"list" flattened:"true" required:"true" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue from which messages are deleted.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s DeleteMessageBatchInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteMessageBatchInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * DeleteMessageBatchInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "DeleteMessageBatchInput" }
if s . Entries == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Entries" ) )
}
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if s . Entries != nil {
for i , v := range s . Entries {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "Entries" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetEntries sets the Entries field's value.
func ( s * DeleteMessageBatchInput ) SetEntries ( v [ ] * DeleteMessageBatchRequestEntry ) * DeleteMessageBatchInput {
s . Entries = v
return s
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * DeleteMessageBatchInput ) SetQueueUrl ( v string ) * DeleteMessageBatchInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
// For each message in the batch, the response contains a DeleteMessageBatchResultEntry
// tag if the message is deleted or a BatchResultErrorEntry tag if the message
2016-11-19 19:41:01 +01:00
// can't be deleted.
2016-01-29 20:53:56 +01:00
type DeleteMessageBatchOutput struct {
_ struct { } ` type:"structure" `
// A list of BatchResultErrorEntry items.
2016-10-17 23:21:08 +02:00
//
// Failed is a required field
2016-01-29 20:53:56 +01:00
Failed [ ] * BatchResultErrorEntry ` locationNameList:"BatchResultErrorEntry" type:"list" flattened:"true" required:"true" `
// A list of DeleteMessageBatchResultEntry items.
2016-10-17 23:21:08 +02:00
//
// Successful is a required field
2016-01-29 20:53:56 +01:00
Successful [ ] * DeleteMessageBatchResultEntry ` locationNameList:"DeleteMessageBatchResultEntry" type:"list" flattened:"true" required:"true" `
}
// String returns the string representation
func ( s DeleteMessageBatchOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteMessageBatchOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetFailed sets the Failed field's value.
func ( s * DeleteMessageBatchOutput ) SetFailed ( v [ ] * BatchResultErrorEntry ) * DeleteMessageBatchOutput {
s . Failed = v
return s
}
// SetSuccessful sets the Successful field's value.
func ( s * DeleteMessageBatchOutput ) SetSuccessful ( v [ ] * DeleteMessageBatchResultEntry ) * DeleteMessageBatchOutput {
s . Successful = v
return s
}
2016-01-29 20:53:56 +01:00
// Encloses a receipt handle and an identifier for it.
type DeleteMessageBatchRequestEntry struct {
_ struct { } ` type:"structure" `
// An identifier for this particular receipt handle. This is used to communicate
2017-01-02 21:35:31 +01:00
// the result.
//
// The Ids of a batch request need to be unique within a request
2016-10-17 23:21:08 +02:00
//
// Id is a required field
2016-01-29 20:53:56 +01:00
Id * string ` type:"string" required:"true" `
// A receipt handle.
2016-10-17 23:21:08 +02:00
//
// ReceiptHandle is a required field
2016-01-29 20:53:56 +01:00
ReceiptHandle * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s DeleteMessageBatchRequestEntry ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteMessageBatchRequestEntry ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * DeleteMessageBatchRequestEntry ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "DeleteMessageBatchRequestEntry" }
if s . Id == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Id" ) )
}
if s . ReceiptHandle == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ReceiptHandle" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetId sets the Id field's value.
func ( s * DeleteMessageBatchRequestEntry ) SetId ( v string ) * DeleteMessageBatchRequestEntry {
s . Id = & v
return s
}
// SetReceiptHandle sets the ReceiptHandle field's value.
func ( s * DeleteMessageBatchRequestEntry ) SetReceiptHandle ( v string ) * DeleteMessageBatchRequestEntry {
s . ReceiptHandle = & v
return s
}
2017-01-02 21:35:31 +01:00
// Encloses the Id of an entry in DeleteMessageBatch.
2016-01-29 20:53:56 +01:00
type DeleteMessageBatchResultEntry struct {
_ struct { } ` type:"structure" `
// Represents a successfully deleted message.
2016-10-17 23:21:08 +02:00
//
// Id is a required field
2016-01-29 20:53:56 +01:00
Id * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s DeleteMessageBatchResultEntry ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteMessageBatchResultEntry ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetId sets the Id field's value.
func ( s * DeleteMessageBatchResultEntry ) SetId ( v string ) * DeleteMessageBatchResultEntry {
s . Id = & v
return s
}
2016-01-29 20:53:56 +01:00
type DeleteMessageInput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue from which messages are deleted.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
// The receipt handle associated with the message to delete.
2016-10-17 23:21:08 +02:00
//
// ReceiptHandle is a required field
2016-01-29 20:53:56 +01:00
ReceiptHandle * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s DeleteMessageInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteMessageInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * DeleteMessageInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "DeleteMessageInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if s . ReceiptHandle == nil {
invalidParams . Add ( request . NewErrParamRequired ( "ReceiptHandle" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetQueueUrl sets the QueueUrl field's value.
func ( s * DeleteMessageInput ) SetQueueUrl ( v string ) * DeleteMessageInput {
s . QueueUrl = & v
return s
}
// SetReceiptHandle sets the ReceiptHandle field's value.
func ( s * DeleteMessageInput ) SetReceiptHandle ( v string ) * DeleteMessageInput {
s . ReceiptHandle = & v
return s
}
2016-01-29 20:53:56 +01:00
type DeleteMessageOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s DeleteMessageOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteMessageOutput ) GoString ( ) string {
return s . String ( )
}
type DeleteQueueInput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue to delete.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s DeleteQueueInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteQueueInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * DeleteQueueInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "DeleteQueueInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetQueueUrl sets the QueueUrl field's value.
func ( s * DeleteQueueInput ) SetQueueUrl ( v string ) * DeleteQueueInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
type DeleteQueueOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s DeleteQueueOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s DeleteQueueOutput ) GoString ( ) string {
return s . String ( )
}
type GetQueueAttributesInput struct {
_ struct { } ` type:"structure" `
2016-11-19 19:41:01 +01:00
// A list of attributes for which to retrieve information.
2016-07-15 15:49:02 +02:00
//
2017-01-02 21:35:31 +01:00
// In the future, new attributes might be added. If you write code that calls
// this action, we recommend that you structure your code so that it can handle
// new attributes gracefully.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// The following attributes are supported:
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * All - Returns all values.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// * ApproximateNumberOfMessages - Returns the approximate number of messages
// available for retrieval from the queue.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * ApproximateNumberOfMessagesDelayed - Returns the approximate number
2018-10-17 02:12:35 +02:00
// of messages in the queue that are delayed and not available for reading
// immediately. This can happen when the queue is configured as a delay queue
// or when a message has been sent with a delay parameter.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * ApproximateNumberOfMessagesNotVisible - Returns the approximate number
2018-10-17 02:12:35 +02:00
// of messages that are in flight. Messages are considered to be in flight
// if they have been sent to a client but have not yet been deleted or have
// not yet reached the end of their visibility window.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * CreatedTimestamp - Returns the time when the queue was created in seconds
2017-01-02 21:35:31 +01:00
// (epoch time (http://en.wikipedia.org/wiki/Unix_time)).
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * DelaySeconds - Returns the default delay on the queue in seconds.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * LastModifiedTimestamp - Returns the time when the queue was last changed
2017-01-02 21:35:31 +01:00
// in seconds (epoch time (http://en.wikipedia.org/wiki/Unix_time)).
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * MaximumMessageSize - Returns the limit of how many bytes a message can
// contain before Amazon SQS rejects it.
2016-07-15 15:49:02 +02:00
//
2017-05-11 13:24:29 +02:00
// * MessageRetentionPeriod - Returns the length of time, in seconds, for
// which Amazon SQS retains a message.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * Policy - Returns the policy of the queue.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * QueueArn - Returns the Amazon resource name (ARN) of the queue.
2016-07-15 15:49:02 +02:00
//
2017-05-11 13:24:29 +02:00
// * ReceiveMessageWaitTimeSeconds - Returns the length of time, in seconds,
// for which the ReceiveMessage action waits for a message to arrive.
2016-07-15 15:49:02 +02:00
//
2017-12-13 00:27:05 +01:00
// * RedrivePolicy - Returns the string that includes the parameters for
// dead-letter queue functionality of the source queue. For more information
// about the redrive policy and dead-letter queues, see Using Amazon SQS
// Dead-Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html)
// in the Amazon Simple Queue Service Developer Guide.
//
// deadLetterTargetArn - The Amazon Resource Name (ARN) of the dead-letter queue
// to which Amazon SQS moves messages after the value of maxReceiveCount
// is exceeded.
//
// maxReceiveCount - The number of times a message is delivered to the source
2018-10-17 02:12:35 +02:00
// queue before being moved to the dead-letter queue. When the ReceiveCount
// for a message exceeds the maxReceiveCount for a queue, Amazon SQS moves
// the message to the dead-letter-queue.
2016-11-19 19:41:01 +01:00
//
// * VisibilityTimeout - Returns the visibility timeout for the queue. For
// more information about the visibility timeout, see Visibility Timeout
2016-12-15 15:48:01 +01:00
// (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-11-19 19:41:01 +01:00
//
2017-05-11 13:24:29 +02:00
// The following attributes apply only to server-side-encryption (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html):
//
// * KmsMasterKeyId - Returns the ID of an AWS-managed customer master key
// (CMK) for Amazon SQS or a custom CMK. For more information, see Key Terms
// (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms).
//
//
// * KmsDataKeyReusePeriodSeconds - Returns the length of time, in seconds,
// for which Amazon SQS can reuse a data key to encrypt or decrypt messages
2017-12-13 00:27:05 +01:00
// before calling AWS KMS again. For more information, see How Does the Data
// Key Reuse Period Work? (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work).
//
2017-05-11 13:24:29 +02:00
//
2016-11-19 19:41:01 +01:00
// The following attributes apply only to FIFO (first-in-first-out) queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html):
//
// * FifoQueue - Returns whether the queue is FIFO. For more information,
// see FIFO Queue Logic (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-11-19 19:41:01 +01:00
//
2017-05-11 13:24:29 +02:00
// To determine whether a queue is FIFO (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html),
// you can check whether QueueName ends with the .fifo suffix.
//
2016-11-19 19:41:01 +01:00
// * ContentBasedDeduplication - Returns whether content-based deduplication
// is enabled for the queue. For more information, see Exactly-Once Processing
// (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
AttributeNames [ ] * string ` locationNameList:"AttributeName" type:"list" flattened:"true" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue whose attribute information is retrieved.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s GetQueueAttributesInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s GetQueueAttributesInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * GetQueueAttributesInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "GetQueueAttributesInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributeNames sets the AttributeNames field's value.
func ( s * GetQueueAttributesInput ) SetAttributeNames ( v [ ] * string ) * GetQueueAttributesInput {
s . AttributeNames = v
return s
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * GetQueueAttributesInput ) SetQueueUrl ( v string ) * GetQueueAttributesInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
// A list of returned queue attributes.
type GetQueueAttributesOutput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// A map of attributes to their respective values.
2016-01-29 20:53:56 +01:00
Attributes map [ string ] * string ` locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
}
// String returns the string representation
func ( s GetQueueAttributesOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s GetQueueAttributesOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetAttributes sets the Attributes field's value.
func ( s * GetQueueAttributesOutput ) SetAttributes ( v map [ string ] * string ) * GetQueueAttributesOutput {
s . Attributes = v
return s
}
2016-01-29 20:53:56 +01:00
type GetQueueUrlInput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// The name of the queue whose URL must be fetched. Maximum 80 characters. Valid
// values: alphanumeric characters, hyphens (-), and underscores (_).
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueName is a required field
2016-01-29 20:53:56 +01:00
QueueName * string ` type:"string" required:"true" `
// The AWS account ID of the account that created the queue.
QueueOwnerAWSAccountId * string ` type:"string" `
}
// String returns the string representation
func ( s GetQueueUrlInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s GetQueueUrlInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * GetQueueUrlInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "GetQueueUrlInput" }
if s . QueueName == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueName" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetQueueName sets the QueueName field's value.
func ( s * GetQueueUrlInput ) SetQueueName ( v string ) * GetQueueUrlInput {
s . QueueName = & v
return s
}
// SetQueueOwnerAWSAccountId sets the QueueOwnerAWSAccountId field's value.
func ( s * GetQueueUrlInput ) SetQueueOwnerAWSAccountId ( v string ) * GetQueueUrlInput {
s . QueueOwnerAWSAccountId = & v
return s
}
2018-10-17 02:12:35 +02:00
// For more information, see Interpreting Responses (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-api-responses.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
type GetQueueUrlOutput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// The URL of the queue.
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" `
}
// String returns the string representation
func ( s GetQueueUrlOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s GetQueueUrlOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetQueueUrl sets the QueueUrl field's value.
func ( s * GetQueueUrlOutput ) SetQueueUrl ( v string ) * GetQueueUrlOutput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
type ListDeadLetterSourceQueuesInput struct {
_ struct { } ` type:"structure" `
2017-12-13 00:27:05 +01:00
// The URL of a dead-letter queue.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s ListDeadLetterSourceQueuesInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListDeadLetterSourceQueuesInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ListDeadLetterSourceQueuesInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ListDeadLetterSourceQueuesInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetQueueUrl sets the QueueUrl field's value.
func ( s * ListDeadLetterSourceQueuesInput ) SetQueueUrl ( v string ) * ListDeadLetterSourceQueuesInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
// A list of your dead letter source queues.
type ListDeadLetterSourceQueuesOutput struct {
_ struct { } ` type:"structure" `
// A list of source queue URLs that have the RedrivePolicy queue attribute configured
2017-12-13 00:27:05 +01:00
// with a dead-letter queue.
2016-10-17 23:21:08 +02:00
//
// QueueUrls is a required field
2016-01-29 20:53:56 +01:00
QueueUrls [ ] * string ` locationName:"queueUrls" locationNameList:"QueueUrl" type:"list" flattened:"true" required:"true" `
}
// String returns the string representation
func ( s ListDeadLetterSourceQueuesOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListDeadLetterSourceQueuesOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetQueueUrls sets the QueueUrls field's value.
func ( s * ListDeadLetterSourceQueuesOutput ) SetQueueUrls ( v [ ] * string ) * ListDeadLetterSourceQueuesOutput {
s . QueueUrls = v
return s
}
2017-12-13 00:27:05 +01:00
type ListQueueTagsInput struct {
_ struct { } ` type:"structure" `
// The URL of the queue.
//
// QueueUrl is a required field
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s ListQueueTagsInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListQueueTagsInput ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ListQueueTagsInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ListQueueTagsInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * ListQueueTagsInput ) SetQueueUrl ( v string ) * ListQueueTagsInput {
s . QueueUrl = & v
return s
}
type ListQueueTagsOutput struct {
_ struct { } ` type:"structure" `
// The list of all tags added to the specified queue.
Tags map [ string ] * string ` locationName:"Tag" locationNameKey:"Key" locationNameValue:"Value" type:"map" flattened:"true" `
}
// String returns the string representation
func ( s ListQueueTagsOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListQueueTagsOutput ) GoString ( ) string {
return s . String ( )
}
// SetTags sets the Tags field's value.
func ( s * ListQueueTagsOutput ) SetTags ( v map [ string ] * string ) * ListQueueTagsOutput {
s . Tags = v
return s
}
2016-01-29 20:53:56 +01:00
type ListQueuesInput struct {
_ struct { } ` type:"structure" `
// A string to use for filtering the list results. Only those queues whose name
// begins with the specified string are returned.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-01-29 20:53:56 +01:00
QueueNamePrefix * string ` type:"string" `
}
// String returns the string representation
func ( s ListQueuesInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListQueuesInput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetQueueNamePrefix sets the QueueNamePrefix field's value.
func ( s * ListQueuesInput ) SetQueueNamePrefix ( v string ) * ListQueuesInput {
s . QueueNamePrefix = & v
return s
}
2016-01-29 20:53:56 +01:00
// A list of your queues.
type ListQueuesOutput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// A list of queue URLs, up to 1,000 entries.
2016-01-29 20:53:56 +01:00
QueueUrls [ ] * string ` locationNameList:"QueueUrl" type:"list" flattened:"true" `
}
// String returns the string representation
func ( s ListQueuesOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ListQueuesOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetQueueUrls sets the QueueUrls field's value.
func ( s * ListQueuesOutput ) SetQueueUrls ( v [ ] * string ) * ListQueuesOutput {
s . QueueUrls = v
return s
}
2016-01-29 20:53:56 +01:00
// An Amazon SQS message.
type Message struct {
_ struct { } ` type:"structure" `
2018-10-17 02:12:35 +02:00
// A map of the attributes requested in ReceiveMessage to their respective values.
// Supported attributes:
//
// * ApproximateReceiveCount
//
// * ApproximateFirstReceiveTimestamp
//
// * MessageDeduplicationId
//
// * MessageGroupId
//
// * SenderId
//
// * SentTimestamp
//
// * SequenceNumber
//
// ApproximateFirstReceiveTimestamp and SentTimestamp are each returned as an
2016-01-29 20:53:56 +01:00
// integer representing the epoch time (http://en.wikipedia.org/wiki/Unix_time)
// in milliseconds.
Attributes map [ string ] * string ` locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
// The message's contents (not URL-encoded).
Body * string ` type:"string" `
// An MD5 digest of the non-URL-encoded message body string.
MD5OfBody * string ` type:"string" `
2017-01-02 21:35:31 +01:00
// An MD5 digest of the non-URL-encoded message attribute string. You can use
// this attribute to verify that Amazon SQS received the message correctly.
// Amazon SQS URL-decodes the message before creating the MD5 digest. For information
2017-05-11 13:24:29 +02:00
// about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt).
2016-01-29 20:53:56 +01:00
MD5OfMessageAttributes * string ` type:"string" `
// Each message attribute consists of a Name, Type, and Value. For more information,
2018-10-17 02:12:35 +02:00
// see Amazon SQS Message Attributes (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
MessageAttributes map [ string ] * MessageAttributeValue ` locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
2017-01-02 21:35:31 +01:00
// A unique identifier for the message. A MessageIdis considered unique across
2016-01-29 20:53:56 +01:00
// all AWS accounts for an extended period of time.
MessageId * string ` type:"string" `
// An identifier associated with the act of receiving the message. A new receipt
// handle is returned every time you receive a message. When deleting a message,
// you provide the last received receipt handle to delete the message.
ReceiptHandle * string ` type:"string" `
}
// String returns the string representation
func ( s Message ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s Message ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetAttributes sets the Attributes field's value.
func ( s * Message ) SetAttributes ( v map [ string ] * string ) * Message {
s . Attributes = v
return s
}
// SetBody sets the Body field's value.
func ( s * Message ) SetBody ( v string ) * Message {
s . Body = & v
return s
}
// SetMD5OfBody sets the MD5OfBody field's value.
func ( s * Message ) SetMD5OfBody ( v string ) * Message {
s . MD5OfBody = & v
return s
}
// SetMD5OfMessageAttributes sets the MD5OfMessageAttributes field's value.
func ( s * Message ) SetMD5OfMessageAttributes ( v string ) * Message {
s . MD5OfMessageAttributes = & v
return s
}
// SetMessageAttributes sets the MessageAttributes field's value.
func ( s * Message ) SetMessageAttributes ( v map [ string ] * MessageAttributeValue ) * Message {
s . MessageAttributes = v
return s
}
// SetMessageId sets the MessageId field's value.
func ( s * Message ) SetMessageId ( v string ) * Message {
s . MessageId = & v
return s
}
// SetReceiptHandle sets the ReceiptHandle field's value.
func ( s * Message ) SetReceiptHandle ( v string ) * Message {
s . ReceiptHandle = & v
return s
}
2017-01-02 21:35:31 +01:00
// The user-specified message attribute value. For string data types, the Value
2016-01-29 20:53:56 +01:00
// attribute has the same restrictions on the content as the message body. For
2016-11-19 19:41:01 +01:00
// more information, see SendMessage.
2016-01-29 20:53:56 +01:00
//
2017-01-02 21:35:31 +01:00
// Name, type, value and the message body must not be empty or null. All parts
// of the message attribute, including Name, Type, and Value, are part of the
// message size restriction (256 KB or 262,144 bytes).
2016-01-29 20:53:56 +01:00
type MessageAttributeValue struct {
_ struct { } ` type:"structure" `
// Not implemented. Reserved for future use.
BinaryListValues [ ] [ ] byte ` locationName:"BinaryListValue" locationNameList:"BinaryListValue" type:"list" flattened:"true" `
2017-01-02 21:35:31 +01:00
// Binary type attributes can store any binary data, such as compressed data,
// encrypted data, or images.
2016-03-18 20:35:09 +01:00
//
// BinaryValue is automatically base64 encoded/decoded by the SDK.
2016-01-29 20:53:56 +01:00
BinaryValue [ ] byte ` type:"blob" `
// Amazon SQS supports the following logical data types: String, Number, and
2016-07-15 15:49:02 +02:00
// Binary. For the Number data type, you must use StringValue.
//
2018-10-17 02:12:35 +02:00
// You can also append custom labels. For more information, see Amazon SQS Message
// Attributes (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-10-17 23:21:08 +02:00
//
// DataType is a required field
2016-01-29 20:53:56 +01:00
DataType * string ` type:"string" required:"true" `
// Not implemented. Reserved for future use.
StringListValues [ ] * string ` locationName:"StringListValue" locationNameList:"StringListValue" type:"list" flattened:"true" `
2017-01-02 21:35:31 +01:00
// Strings are Unicode with UTF-8 binary encoding. For a list of code values,
2016-11-19 19:41:01 +01:00
// see ASCII Printable Characters (http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters).
2016-01-29 20:53:56 +01:00
StringValue * string ` type:"string" `
}
// String returns the string representation
func ( s MessageAttributeValue ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s MessageAttributeValue ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * MessageAttributeValue ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "MessageAttributeValue" }
if s . DataType == nil {
invalidParams . Add ( request . NewErrParamRequired ( "DataType" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetBinaryListValues sets the BinaryListValues field's value.
func ( s * MessageAttributeValue ) SetBinaryListValues ( v [ ] [ ] byte ) * MessageAttributeValue {
s . BinaryListValues = v
return s
}
// SetBinaryValue sets the BinaryValue field's value.
func ( s * MessageAttributeValue ) SetBinaryValue ( v [ ] byte ) * MessageAttributeValue {
s . BinaryValue = v
return s
}
// SetDataType sets the DataType field's value.
func ( s * MessageAttributeValue ) SetDataType ( v string ) * MessageAttributeValue {
s . DataType = & v
return s
}
// SetStringListValues sets the StringListValues field's value.
func ( s * MessageAttributeValue ) SetStringListValues ( v [ ] * string ) * MessageAttributeValue {
s . StringListValues = v
return s
}
// SetStringValue sets the StringValue field's value.
func ( s * MessageAttributeValue ) SetStringValue ( v string ) * MessageAttributeValue {
s . StringValue = & v
return s
}
2016-01-29 20:53:56 +01:00
type PurgeQueueInput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// The URL of the queue from which the PurgeQueue action deletes messages.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s PurgeQueueInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s PurgeQueueInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * PurgeQueueInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "PurgeQueueInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetQueueUrl sets the QueueUrl field's value.
func ( s * PurgeQueueInput ) SetQueueUrl ( v string ) * PurgeQueueInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
type PurgeQueueOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s PurgeQueueOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s PurgeQueueOutput ) GoString ( ) string {
return s . String ( )
}
type ReceiveMessageInput struct {
_ struct { } ` type:"structure" `
2018-10-17 02:12:35 +02:00
// A list of s that need to be returned along with each message. These attributes
// include:
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * All - Returns all values.
//
// * ApproximateFirstReceiveTimestamp - Returns the time the message was
2017-01-02 21:35:31 +01:00
// first received from the queue (epoch time (http://en.wikipedia.org/wiki/Unix_time)
// in milliseconds).
2016-11-19 19:41:01 +01:00
//
// * ApproximateReceiveCount - Returns the number of times a message has
// been received from the queue but not deleted.
//
// * SenderId
//
// For an IAM user, returns the IAM user ID, for example ABCDEFGHI1JKLMNOPQ23R.
//
// For an IAM role, returns the IAM role ID, for example ABCDE1F2GH3I4JK5LMNOP:i-a123b456.
2016-01-29 20:53:56 +01:00
//
2016-11-19 19:41:01 +01:00
// * SentTimestamp - Returns the time the message was sent to the queue (epoch
2017-01-02 21:35:31 +01:00
// time (http://en.wikipedia.org/wiki/Unix_time) in milliseconds).
2016-01-29 20:53:56 +01:00
//
2018-10-17 02:12:35 +02:00
// * MessageDeduplicationId - Returns the value provided by the producer
// that calls the SendMessage action.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// * MessageGroupId - Returns the value provided by the producer that calls
2016-11-19 19:41:01 +01:00
// the SendMessage action. Messages with the same MessageGroupId are returned
// in sequence.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * SequenceNumber - Returns the value provided by Amazon SQS.
2016-01-29 20:53:56 +01:00
AttributeNames [ ] * string ` locationNameList:"AttributeName" type:"list" flattened:"true" `
// The maximum number of messages to return. Amazon SQS never returns more messages
2018-10-17 02:12:35 +02:00
// than this value (however, fewer messages might be returned). Valid values:
// 1 to 10. Default: 1.
2016-01-29 20:53:56 +01:00
MaxNumberOfMessages * int64 ` type:"integer" `
2017-01-02 21:35:31 +01:00
// The name of the message attribute, where N is the index.
//
// * The name can contain alphanumeric characters and the underscore (_),
// hyphen (-), and period (.).
//
// * The name is case-sensitive and must be unique among all attribute names
// for the message.
//
// * The name must not start with AWS-reserved prefixes such as AWS. or Amazon.
// (or any casing variants).
//
// * The name must not start or end with a period (.), and it should not
// have periods in succession (..).
//
// * The name can be up to 256 characters long.
2016-01-29 20:53:56 +01:00
//
// When using ReceiveMessage, you can send a list of attribute names to receive,
2017-01-02 21:35:31 +01:00
// or you can return all of the attributes by specifying All or .* in your request.
// You can also use all message attributes starting with a prefix, for example
// bar.*.
2016-01-29 20:53:56 +01:00
MessageAttributeNames [ ] * string ` locationNameList:"MessageAttributeName" type:"list" flattened:"true" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue from which messages are received.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
2016-11-19 19:41:01 +01:00
// This parameter applies only to FIFO (first-in-first-out) queues.
//
// The token used for deduplication of ReceiveMessage calls. If a networking
// issue occurs after a ReceiveMessage action, and instead of a response you
// receive a generic error, you can retry the same action with an identical
// ReceiveRequestAttemptId to retrieve the same set of messages, even if their
// visibility timeout has not yet expired.
//
// * You can use ReceiveRequestAttemptId only for 5 minutes after a ReceiveMessage
// action.
//
// * When you set FifoQueue, a caller of the ReceiveMessage action can provide
// a ReceiveRequestAttemptId explicitly.
//
// * If a caller of the ReceiveMessage action doesn't provide a ReceiveRequestAttemptId,
// Amazon SQS generates a ReceiveRequestAttemptId.
//
// * You can retry the ReceiveMessage action with the same ReceiveRequestAttemptId
// if none of the messages have been modified (deleted or had their visibility
// changes).
//
// * During a visibility timeout, subsequent calls with the same ReceiveRequestAttemptId
// return the same messages and receipt handles. If a retry occurs within
// the deduplication interval, it resets the visibility timeout. For more
2016-12-15 15:48:01 +01:00
// information, see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html)
2016-11-19 19:41:01 +01:00
// in the Amazon Simple Queue Service Developer Guide.
//
2018-10-17 02:12:35 +02:00
// If a caller of the ReceiveMessage action still processes messages when the
// visibility timeout expires and messages become visible, another worker
// consuming from the same queue can receive the same messages and therefore
// process duplicates. Also, if a consumer whose message processing time
// is longer than the visibility timeout tries to delete the processed messages,
2016-11-19 19:41:01 +01:00
// the action fails with an error.
//
// To mitigate this effect, ensure that your application observes a safe threshold
// before the visibility timeout expires and extend the visibility timeout
// as necessary.
//
// * While messages with a particular MessageGroupId are invisible, no more
// messages belonging to the same MessageGroupId are returned until the visibility
// timeout expires. You can still receive messages with another MessageGroupId
// as long as it is also visible.
//
// * If a caller of ReceiveMessage can't track the ReceiveRequestAttemptId,
2017-01-02 21:35:31 +01:00
// no retries work until the original visibility timeout expires. As a result,
// delays might occur but the messages in the queue remain in a strict order.
2016-11-19 19:41:01 +01:00
//
// The length of ReceiveRequestAttemptId is 128 characters. ReceiveRequestAttemptId
// can contain alphanumeric characters (a-z, A-Z, 0-9) and punctuation (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~).
//
// For best practices of using ReceiveRequestAttemptId, see Using the ReceiveRequestAttemptId
2018-10-17 02:12:35 +02:00
// Request Parameter (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-receiverequestattemptid-request-parameter.html)
2016-11-19 19:41:01 +01:00
// in the Amazon Simple Queue Service Developer Guide.
ReceiveRequestAttemptId * string ` type:"string" `
2016-01-29 20:53:56 +01:00
// The duration (in seconds) that the received messages are hidden from subsequent
// retrieve requests after being retrieved by a ReceiveMessage request.
VisibilityTimeout * int64 ` type:"integer" `
2017-01-02 21:35:31 +01:00
// The duration (in seconds) for which the call waits for a message to arrive
// in the queue before returning. If a message is available, the call returns
2017-12-13 00:27:05 +01:00
// sooner than WaitTimeSeconds. If no messages are available and the wait time
// expires, the call returns successfully with an empty list of messages.
2016-01-29 20:53:56 +01:00
WaitTimeSeconds * int64 ` type:"integer" `
}
// String returns the string representation
func ( s ReceiveMessageInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ReceiveMessageInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * ReceiveMessageInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "ReceiveMessageInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributeNames sets the AttributeNames field's value.
func ( s * ReceiveMessageInput ) SetAttributeNames ( v [ ] * string ) * ReceiveMessageInput {
s . AttributeNames = v
return s
}
// SetMaxNumberOfMessages sets the MaxNumberOfMessages field's value.
func ( s * ReceiveMessageInput ) SetMaxNumberOfMessages ( v int64 ) * ReceiveMessageInput {
s . MaxNumberOfMessages = & v
return s
}
// SetMessageAttributeNames sets the MessageAttributeNames field's value.
func ( s * ReceiveMessageInput ) SetMessageAttributeNames ( v [ ] * string ) * ReceiveMessageInput {
s . MessageAttributeNames = v
return s
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * ReceiveMessageInput ) SetQueueUrl ( v string ) * ReceiveMessageInput {
s . QueueUrl = & v
return s
}
// SetReceiveRequestAttemptId sets the ReceiveRequestAttemptId field's value.
func ( s * ReceiveMessageInput ) SetReceiveRequestAttemptId ( v string ) * ReceiveMessageInput {
s . ReceiveRequestAttemptId = & v
return s
}
// SetVisibilityTimeout sets the VisibilityTimeout field's value.
func ( s * ReceiveMessageInput ) SetVisibilityTimeout ( v int64 ) * ReceiveMessageInput {
s . VisibilityTimeout = & v
return s
}
// SetWaitTimeSeconds sets the WaitTimeSeconds field's value.
func ( s * ReceiveMessageInput ) SetWaitTimeSeconds ( v int64 ) * ReceiveMessageInput {
s . WaitTimeSeconds = & v
return s
}
2016-01-29 20:53:56 +01:00
// A list of received messages.
type ReceiveMessageOutput struct {
_ struct { } ` type:"structure" `
// A list of messages.
Messages [ ] * Message ` locationNameList:"Message" type:"list" flattened:"true" `
}
// String returns the string representation
func ( s ReceiveMessageOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s ReceiveMessageOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetMessages sets the Messages field's value.
func ( s * ReceiveMessageOutput ) SetMessages ( v [ ] * Message ) * ReceiveMessageOutput {
s . Messages = v
return s
}
2016-01-29 20:53:56 +01:00
type RemovePermissionInput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// The identification of the permission to remove. This is the label added using
2016-01-29 20:53:56 +01:00
// the AddPermission action.
2016-10-17 23:21:08 +02:00
//
// Label is a required field
2016-01-29 20:53:56 +01:00
Label * string ` type:"string" required:"true" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue from which permissions are removed.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s RemovePermissionInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s RemovePermissionInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * RemovePermissionInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "RemovePermissionInput" }
if s . Label == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Label" ) )
}
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetLabel sets the Label field's value.
func ( s * RemovePermissionInput ) SetLabel ( v string ) * RemovePermissionInput {
s . Label = & v
return s
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * RemovePermissionInput ) SetQueueUrl ( v string ) * RemovePermissionInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
type RemovePermissionOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s RemovePermissionOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s RemovePermissionOutput ) GoString ( ) string {
return s . String ( )
}
type SendMessageBatchInput struct {
_ struct { } ` type:"structure" `
// A list of SendMessageBatchRequestEntry items.
2016-10-17 23:21:08 +02:00
//
// Entries is a required field
2016-01-29 20:53:56 +01:00
Entries [ ] * SendMessageBatchRequestEntry ` locationNameList:"SendMessageBatchRequestEntry" type:"list" flattened:"true" required:"true" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue to which batched messages are sent.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s SendMessageBatchInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s SendMessageBatchInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * SendMessageBatchInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "SendMessageBatchInput" }
if s . Entries == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Entries" ) )
}
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if s . Entries != nil {
for i , v := range s . Entries {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "Entries" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetEntries sets the Entries field's value.
func ( s * SendMessageBatchInput ) SetEntries ( v [ ] * SendMessageBatchRequestEntry ) * SendMessageBatchInput {
s . Entries = v
return s
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * SendMessageBatchInput ) SetQueueUrl ( v string ) * SendMessageBatchInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
// For each message in the batch, the response contains a SendMessageBatchResultEntry
// tag if the message succeeds or a BatchResultErrorEntry tag if the message
// fails.
type SendMessageBatchOutput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// A list of BatchResultErrorEntry items with error details about each message
// that can't be enqueued.
2016-10-17 23:21:08 +02:00
//
// Failed is a required field
2016-01-29 20:53:56 +01:00
Failed [ ] * BatchResultErrorEntry ` locationNameList:"BatchResultErrorEntry" type:"list" flattened:"true" required:"true" `
// A list of SendMessageBatchResultEntry items.
2016-10-17 23:21:08 +02:00
//
// Successful is a required field
2016-01-29 20:53:56 +01:00
Successful [ ] * SendMessageBatchResultEntry ` locationNameList:"SendMessageBatchResultEntry" type:"list" flattened:"true" required:"true" `
}
// String returns the string representation
func ( s SendMessageBatchOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s SendMessageBatchOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetFailed sets the Failed field's value.
func ( s * SendMessageBatchOutput ) SetFailed ( v [ ] * BatchResultErrorEntry ) * SendMessageBatchOutput {
s . Failed = v
return s
}
// SetSuccessful sets the Successful field's value.
func ( s * SendMessageBatchOutput ) SetSuccessful ( v [ ] * SendMessageBatchResultEntry ) * SendMessageBatchOutput {
s . Successful = v
return s
}
2017-01-02 21:35:31 +01:00
// Contains the details of a single Amazon SQS message along with an Id.
2016-01-29 20:53:56 +01:00
type SendMessageBatchRequestEntry struct {
_ struct { } ` type:"structure" `
2017-05-11 13:24:29 +02:00
// The length of time, in seconds, for which a specific message is delayed.
// Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive DelaySeconds
// value become available for processing after the delay period is finished.
// If you don't specify a value, the default value for the queue is applied.
2016-11-19 19:41:01 +01:00
//
// When you set FifoQueue, you can't set DelaySeconds per message. You can set
// this parameter only on a queue level.
2016-01-29 20:53:56 +01:00
DelaySeconds * int64 ` type:"integer" `
2017-01-02 21:35:31 +01:00
// An identifier for a message in this batch used to communicate the result.
//
// The Ids of a batch request need to be unique within a request
2016-10-17 23:21:08 +02:00
//
2018-10-17 02:12:35 +02:00
// This identifier can have up to 80 characters. The following characters are
// accepted: alphanumeric characters, hyphens(-), and underscores (_).
//
2016-10-17 23:21:08 +02:00
// Id is a required field
2016-01-29 20:53:56 +01:00
Id * string ` type:"string" required:"true" `
// Each message attribute consists of a Name, Type, and Value. For more information,
2018-10-17 02:12:35 +02:00
// see Amazon SQS Message Attributes (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
MessageAttributes map [ string ] * MessageAttributeValue ` locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
2017-01-02 21:35:31 +01:00
// The body of the message.
2016-10-17 23:21:08 +02:00
//
// MessageBody is a required field
2016-01-29 20:53:56 +01:00
MessageBody * string ` type:"string" required:"true" `
2016-11-19 19:41:01 +01:00
// This parameter applies only to FIFO (first-in-first-out) queues.
//
// The token used for deduplication of messages within a 5-minute minimum deduplication
// interval. If a message with a particular MessageDeduplicationId is sent successfully,
// subsequent messages with the same MessageDeduplicationId are accepted successfully
// but aren't delivered. For more information, see Exactly-Once Processing
// (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-11-19 19:41:01 +01:00
//
// * Every message must have a unique MessageDeduplicationId,
//
// You may provide a MessageDeduplicationId explicitly.
//
// If you aren't able to provide a MessageDeduplicationId and you enable ContentBasedDeduplication
// for your queue, Amazon SQS uses a SHA-256 hash to generate the MessageDeduplicationId
// using the body of the message (but not the attributes of the message).
//
//
// If you don't provide a MessageDeduplicationId and the queue doesn't have
// ContentBasedDeduplication set, the action fails with an error.
//
// If the queue has ContentBasedDeduplication set, your MessageDeduplicationId
// overrides the generated one.
//
// * When ContentBasedDeduplication is in effect, messages with identical
// content sent within the deduplication interval are treated as duplicates
// and only one copy of the message is delivered.
//
// * If you send one message with ContentBasedDeduplication enabled and then
// another message with a MessageDeduplicationId that is the same as the
// one generated for the first MessageDeduplicationId, the two messages are
// treated as duplicates and only one copy of the message is delivered.
//
2018-10-17 02:12:35 +02:00
// The MessageDeduplicationId is available to the consumer of the message (this
2016-11-19 19:41:01 +01:00
// can be useful for troubleshooting delivery issues).
//
// If a message is sent successfully but the acknowledgement is lost and the
// message is resent with the same MessageDeduplicationId after the deduplication
// interval, Amazon SQS can't detect duplicate messages.
//
2018-10-17 02:12:35 +02:00
// Amazon SQS continues to keep track of the message deduplication ID even after
// the message is received and deleted.
//
2016-11-19 19:41:01 +01:00
// The length of MessageDeduplicationId is 128 characters. MessageDeduplicationId
// can contain alphanumeric characters (a-z, A-Z, 0-9) and punctuation (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~).
//
// For best practices of using MessageDeduplicationId, see Using the MessageDeduplicationId
2018-10-17 02:12:35 +02:00
// Property (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagededuplicationid-property.html)
2016-11-19 19:41:01 +01:00
// in the Amazon Simple Queue Service Developer Guide.
MessageDeduplicationId * string ` type:"string" `
// This parameter applies only to FIFO (first-in-first-out) queues.
//
// The tag that specifies that a message belongs to a specific message group.
// Messages that belong to the same message group are processed in a FIFO manner
// (however, messages in different message groups might be processed out of
// order). To interleave multiple ordered streams within a single queue, use
// MessageGroupId values (for example, session data for multiple users). In
2018-10-17 02:12:35 +02:00
// this scenario, multiple consumers can process the queue, but the session
// data of each user is processed in a FIFO fashion.
2016-11-19 19:41:01 +01:00
//
// * You must associate a non-empty MessageGroupId with a message. If you
// don't provide a MessageGroupId, the action fails.
//
// * ReceiveMessage might return messages with multiple MessageGroupId values.
// For each MessageGroupId, the messages are sorted by time sent. The caller
// can't specify a MessageGroupId.
//
2018-10-17 02:12:35 +02:00
// The length of MessageGroupId is 128 characters. Valid values: alphanumeric
2016-11-19 19:41:01 +01:00
// characters and punctuation (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~).
//
// For best practices of using MessageGroupId, see Using the MessageGroupId
2018-10-17 02:12:35 +02:00
// Property (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html)
2016-11-19 19:41:01 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2017-05-11 13:24:29 +02:00
//
// MessageGroupId is required for FIFO queues. You can't use it for Standard
// queues.
2016-11-19 19:41:01 +01:00
MessageGroupId * string ` type:"string" `
2016-01-29 20:53:56 +01:00
}
// String returns the string representation
func ( s SendMessageBatchRequestEntry ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s SendMessageBatchRequestEntry ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * SendMessageBatchRequestEntry ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "SendMessageBatchRequestEntry" }
if s . Id == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Id" ) )
}
if s . MessageBody == nil {
invalidParams . Add ( request . NewErrParamRequired ( "MessageBody" ) )
}
if s . MessageAttributes != nil {
for i , v := range s . MessageAttributes {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "MessageAttributes" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetDelaySeconds sets the DelaySeconds field's value.
func ( s * SendMessageBatchRequestEntry ) SetDelaySeconds ( v int64 ) * SendMessageBatchRequestEntry {
s . DelaySeconds = & v
return s
}
// SetId sets the Id field's value.
func ( s * SendMessageBatchRequestEntry ) SetId ( v string ) * SendMessageBatchRequestEntry {
s . Id = & v
return s
}
// SetMessageAttributes sets the MessageAttributes field's value.
func ( s * SendMessageBatchRequestEntry ) SetMessageAttributes ( v map [ string ] * MessageAttributeValue ) * SendMessageBatchRequestEntry {
s . MessageAttributes = v
return s
}
// SetMessageBody sets the MessageBody field's value.
func ( s * SendMessageBatchRequestEntry ) SetMessageBody ( v string ) * SendMessageBatchRequestEntry {
s . MessageBody = & v
return s
}
// SetMessageDeduplicationId sets the MessageDeduplicationId field's value.
func ( s * SendMessageBatchRequestEntry ) SetMessageDeduplicationId ( v string ) * SendMessageBatchRequestEntry {
s . MessageDeduplicationId = & v
return s
}
// SetMessageGroupId sets the MessageGroupId field's value.
func ( s * SendMessageBatchRequestEntry ) SetMessageGroupId ( v string ) * SendMessageBatchRequestEntry {
s . MessageGroupId = & v
return s
}
2017-01-02 21:35:31 +01:00
// Encloses a MessageId for a successfully-enqueued message in a SendMessageBatch.
2016-01-29 20:53:56 +01:00
type SendMessageBatchResultEntry struct {
_ struct { } ` type:"structure" `
// An identifier for the message in this batch.
2016-10-17 23:21:08 +02:00
//
// Id is a required field
2016-01-29 20:53:56 +01:00
Id * string ` type:"string" required:"true" `
2017-01-02 21:35:31 +01:00
// An MD5 digest of the non-URL-encoded message attribute string. You can use
// this attribute to verify that Amazon SQS received the message correctly.
// Amazon SQS URL-decodes the message before creating the MD5 digest. For information
2017-05-11 13:24:29 +02:00
// about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt).
2016-01-29 20:53:56 +01:00
MD5OfMessageAttributes * string ` type:"string" `
2017-01-02 21:35:31 +01:00
// An MD5 digest of the non-URL-encoded message attribute string. You can use
// this attribute to verify that Amazon SQS received the message correctly.
// Amazon SQS URL-decodes the message before creating the MD5 digest. For information
2017-05-11 13:24:29 +02:00
// about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt).
2016-10-17 23:21:08 +02:00
//
// MD5OfMessageBody is a required field
2016-01-29 20:53:56 +01:00
MD5OfMessageBody * string ` type:"string" required:"true" `
// An identifier for the message.
2016-10-17 23:21:08 +02:00
//
// MessageId is a required field
2016-01-29 20:53:56 +01:00
MessageId * string ` type:"string" required:"true" `
2016-11-19 19:41:01 +01:00
2017-01-02 21:35:31 +01:00
// This parameter applies only to FIFO (first-in-first-out) queues.
2016-11-19 19:41:01 +01:00
//
2017-05-11 13:24:29 +02:00
// The large, non-consecutive number that Amazon SQS assigns to each message.
2016-11-19 19:41:01 +01:00
//
// The length of SequenceNumber is 128 bits. As SequenceNumber continues to
// increase for a particular MessageGroupId.
SequenceNumber * string ` type:"string" `
2016-01-29 20:53:56 +01:00
}
// String returns the string representation
func ( s SendMessageBatchResultEntry ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s SendMessageBatchResultEntry ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetId sets the Id field's value.
func ( s * SendMessageBatchResultEntry ) SetId ( v string ) * SendMessageBatchResultEntry {
s . Id = & v
return s
}
// SetMD5OfMessageAttributes sets the MD5OfMessageAttributes field's value.
func ( s * SendMessageBatchResultEntry ) SetMD5OfMessageAttributes ( v string ) * SendMessageBatchResultEntry {
s . MD5OfMessageAttributes = & v
return s
}
// SetMD5OfMessageBody sets the MD5OfMessageBody field's value.
func ( s * SendMessageBatchResultEntry ) SetMD5OfMessageBody ( v string ) * SendMessageBatchResultEntry {
s . MD5OfMessageBody = & v
return s
}
// SetMessageId sets the MessageId field's value.
func ( s * SendMessageBatchResultEntry ) SetMessageId ( v string ) * SendMessageBatchResultEntry {
s . MessageId = & v
return s
}
// SetSequenceNumber sets the SequenceNumber field's value.
func ( s * SendMessageBatchResultEntry ) SetSequenceNumber ( v string ) * SendMessageBatchResultEntry {
s . SequenceNumber = & v
return s
}
2016-01-29 20:53:56 +01:00
type SendMessageInput struct {
_ struct { } ` type:"structure" `
2017-05-11 13:24:29 +02:00
// The length of time, in seconds, for which to delay a specific message. Valid
// values: 0 to 900. Maximum: 15 minutes. Messages with a positive DelaySeconds
// value become available for processing after the delay period is finished.
// If you don't specify a value, the default value for the queue applies.
2016-11-19 19:41:01 +01:00
//
// When you set FifoQueue, you can't set DelaySeconds per message. You can set
// this parameter only on a queue level.
2016-01-29 20:53:56 +01:00
DelaySeconds * int64 ` type:"integer" `
// Each message attribute consists of a Name, Type, and Value. For more information,
2018-10-17 02:12:35 +02:00
// see Amazon SQS Message Attributes (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
MessageAttributes map [ string ] * MessageAttributeValue ` locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
2017-01-02 21:35:31 +01:00
// The message to send. The maximum string size is 256 KB.
//
2017-05-11 13:24:29 +02:00
// A message can include only XML, JSON, and unformatted text. The following
// Unicode characters are allowed:
2017-01-02 21:35:31 +01:00
//
2017-05-11 13:24:29 +02:00
// #x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF
2017-01-02 21:35:31 +01:00
//
2017-05-11 13:24:29 +02:00
// Any characters not included in this list will be rejected. For more information,
// see the W3C specification for characters (http://www.w3.org/TR/REC-xml/#charsets).
2016-10-17 23:21:08 +02:00
//
// MessageBody is a required field
2016-01-29 20:53:56 +01:00
MessageBody * string ` type:"string" required:"true" `
2016-11-19 19:41:01 +01:00
// This parameter applies only to FIFO (first-in-first-out) queues.
//
// The token used for deduplication of sent messages. If a message with a particular
// MessageDeduplicationId is sent successfully, any messages sent with the same
// MessageDeduplicationId are accepted successfully but aren't delivered during
// the 5-minute deduplication interval. For more information, see Exactly-Once
// Processing (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-11-19 19:41:01 +01:00
//
// * Every message must have a unique MessageDeduplicationId,
//
// You may provide a MessageDeduplicationId explicitly.
//
// If you aren't able to provide a MessageDeduplicationId and you enable ContentBasedDeduplication
// for your queue, Amazon SQS uses a SHA-256 hash to generate the MessageDeduplicationId
// using the body of the message (but not the attributes of the message).
//
//
// If you don't provide a MessageDeduplicationId and the queue doesn't have
// ContentBasedDeduplication set, the action fails with an error.
//
// If the queue has ContentBasedDeduplication set, your MessageDeduplicationId
// overrides the generated one.
//
// * When ContentBasedDeduplication is in effect, messages with identical
// content sent within the deduplication interval are treated as duplicates
// and only one copy of the message is delivered.
//
// * If you send one message with ContentBasedDeduplication enabled and then
// another message with a MessageDeduplicationId that is the same as the
// one generated for the first MessageDeduplicationId, the two messages are
// treated as duplicates and only one copy of the message is delivered.
//
2018-10-17 02:12:35 +02:00
// The MessageDeduplicationId is available to the consumer of the message (this
2016-11-19 19:41:01 +01:00
// can be useful for troubleshooting delivery issues).
//
2017-01-02 21:35:31 +01:00
// If a message is sent successfully but the acknowledgement is lost and the
2016-11-19 19:41:01 +01:00
// message is resent with the same MessageDeduplicationId after the deduplication
// interval, Amazon SQS can't detect duplicate messages.
//
2018-10-17 02:12:35 +02:00
// Amazon SQS continues to keep track of the message deduplication ID even after
// the message is received and deleted.
//
2016-11-19 19:41:01 +01:00
// The length of MessageDeduplicationId is 128 characters. MessageDeduplicationId
// can contain alphanumeric characters (a-z, A-Z, 0-9) and punctuation (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~).
//
// For best practices of using MessageDeduplicationId, see Using the MessageDeduplicationId
2018-10-17 02:12:35 +02:00
// Property (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagededuplicationid-property.html)
2016-11-19 19:41:01 +01:00
// in the Amazon Simple Queue Service Developer Guide.
MessageDeduplicationId * string ` type:"string" `
// This parameter applies only to FIFO (first-in-first-out) queues.
//
// The tag that specifies that a message belongs to a specific message group.
// Messages that belong to the same message group are processed in a FIFO manner
// (however, messages in different message groups might be processed out of
// order). To interleave multiple ordered streams within a single queue, use
// MessageGroupId values (for example, session data for multiple users). In
2018-10-17 02:12:35 +02:00
// this scenario, multiple consumers can process the queue, but the session
// data of each user is processed in a FIFO fashion.
2016-11-19 19:41:01 +01:00
//
// * You must associate a non-empty MessageGroupId with a message. If you
// don't provide a MessageGroupId, the action fails.
//
// * ReceiveMessage might return messages with multiple MessageGroupId values.
// For each MessageGroupId, the messages are sorted by time sent. The caller
// can't specify a MessageGroupId.
//
2018-10-17 02:12:35 +02:00
// The length of MessageGroupId is 128 characters. Valid values: alphanumeric
2016-11-19 19:41:01 +01:00
// characters and punctuation (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~).
//
// For best practices of using MessageGroupId, see Using the MessageGroupId
2018-10-17 02:12:35 +02:00
// Property (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html)
2016-11-19 19:41:01 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2017-05-11 13:24:29 +02:00
//
// MessageGroupId is required for FIFO queues. You can't use it for Standard
// queues.
2016-11-19 19:41:01 +01:00
MessageGroupId * string ` type:"string" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue to which a message is sent.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s SendMessageInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s SendMessageInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * SendMessageInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "SendMessageInput" }
if s . MessageBody == nil {
invalidParams . Add ( request . NewErrParamRequired ( "MessageBody" ) )
}
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if s . MessageAttributes != nil {
for i , v := range s . MessageAttributes {
if v == nil {
continue
}
if err := v . Validate ( ) ; err != nil {
invalidParams . AddNested ( fmt . Sprintf ( "%s[%v]" , "MessageAttributes" , i ) , err . ( request . ErrInvalidParams ) )
}
}
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetDelaySeconds sets the DelaySeconds field's value.
func ( s * SendMessageInput ) SetDelaySeconds ( v int64 ) * SendMessageInput {
s . DelaySeconds = & v
return s
}
// SetMessageAttributes sets the MessageAttributes field's value.
func ( s * SendMessageInput ) SetMessageAttributes ( v map [ string ] * MessageAttributeValue ) * SendMessageInput {
s . MessageAttributes = v
return s
}
// SetMessageBody sets the MessageBody field's value.
func ( s * SendMessageInput ) SetMessageBody ( v string ) * SendMessageInput {
s . MessageBody = & v
return s
}
// SetMessageDeduplicationId sets the MessageDeduplicationId field's value.
func ( s * SendMessageInput ) SetMessageDeduplicationId ( v string ) * SendMessageInput {
s . MessageDeduplicationId = & v
return s
}
// SetMessageGroupId sets the MessageGroupId field's value.
func ( s * SendMessageInput ) SetMessageGroupId ( v string ) * SendMessageInput {
s . MessageGroupId = & v
return s
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * SendMessageInput ) SetQueueUrl ( v string ) * SendMessageInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
// The MD5OfMessageBody and MessageId elements.
type SendMessageOutput struct {
_ struct { } ` type:"structure" `
2017-01-02 21:35:31 +01:00
// An MD5 digest of the non-URL-encoded message attribute string. You can use
// this attribute to verify that Amazon SQS received the message correctly.
// Amazon SQS URL-decodes the message before creating the MD5 digest. For information
2017-05-11 13:24:29 +02:00
// about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt).
2016-01-29 20:53:56 +01:00
MD5OfMessageAttributes * string ` type:"string" `
2017-01-02 21:35:31 +01:00
// An MD5 digest of the non-URL-encoded message attribute string. You can use
// this attribute to verify that Amazon SQS received the message correctly.
// Amazon SQS URL-decodes the message before creating the MD5 digest. For information
2017-05-11 13:24:29 +02:00
// about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt).
2016-01-29 20:53:56 +01:00
MD5OfMessageBody * string ` type:"string" `
2017-01-02 21:35:31 +01:00
// An attribute containing the MessageId of the message sent to the queue. For
2016-12-15 15:48:01 +01:00
// more information, see Queue and Message Identifiers (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-message-identifiers.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-01-29 20:53:56 +01:00
MessageId * string ` type:"string" `
2016-11-19 19:41:01 +01:00
2017-01-02 21:35:31 +01:00
// This parameter applies only to FIFO (first-in-first-out) queues.
2016-11-19 19:41:01 +01:00
//
2017-05-11 13:24:29 +02:00
// The large, non-consecutive number that Amazon SQS assigns to each message.
2016-11-19 19:41:01 +01:00
//
// The length of SequenceNumber is 128 bits. SequenceNumber continues to increase
// for a particular MessageGroupId.
SequenceNumber * string ` type:"string" `
2016-01-29 20:53:56 +01:00
}
// String returns the string representation
func ( s SendMessageOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s SendMessageOutput ) GoString ( ) string {
return s . String ( )
}
2016-11-19 19:41:01 +01:00
// SetMD5OfMessageAttributes sets the MD5OfMessageAttributes field's value.
func ( s * SendMessageOutput ) SetMD5OfMessageAttributes ( v string ) * SendMessageOutput {
s . MD5OfMessageAttributes = & v
return s
}
// SetMD5OfMessageBody sets the MD5OfMessageBody field's value.
func ( s * SendMessageOutput ) SetMD5OfMessageBody ( v string ) * SendMessageOutput {
s . MD5OfMessageBody = & v
return s
}
// SetMessageId sets the MessageId field's value.
func ( s * SendMessageOutput ) SetMessageId ( v string ) * SendMessageOutput {
s . MessageId = & v
return s
}
// SetSequenceNumber sets the SequenceNumber field's value.
func ( s * SendMessageOutput ) SetSequenceNumber ( v string ) * SendMessageOutput {
s . SequenceNumber = & v
return s
}
2016-01-29 20:53:56 +01:00
type SetQueueAttributesInput struct {
_ struct { } ` type:"structure" `
// A map of attributes to set.
//
// The following lists the names, descriptions, and values of the special request
2016-11-19 19:41:01 +01:00
// parameters that the SetQueueAttributes action uses:
//
2017-05-11 13:24:29 +02:00
// * DelaySeconds - The length of time, in seconds, for which the delivery
// of all messages in the queue is delayed. Valid values: An integer from
2018-10-17 02:12:35 +02:00
// 0 to 900 (15 minutes). Default: 0.
2016-11-19 19:41:01 +01:00
//
// * MaximumMessageSize - The limit of how many bytes a message can contain
2017-01-02 21:35:31 +01:00
// before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes
2018-10-17 02:12:35 +02:00
// (1 KiB) up to 262,144 bytes (256 KiB). Default: 262,144 (256 KiB).
2016-11-19 19:41:01 +01:00
//
2017-05-11 13:24:29 +02:00
// * MessageRetentionPeriod - The length of time, in seconds, for which Amazon
// SQS retains a message. Valid values: An integer representing seconds,
2018-10-17 02:12:35 +02:00
// from 60 (1 minute) to 1,209,600 (14 days). Default: 345,600 (4 days).
2017-01-02 21:35:31 +01:00
//
2016-11-19 19:41:01 +01:00
//
// * Policy - The queue's policy. A valid AWS policy. For more information
// about policy structure, see Overview of AWS IAM Policies (http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html)
// in the Amazon IAM User Guide.
//
2017-05-11 13:24:29 +02:00
// * ReceiveMessageWaitTimeSeconds - The length of time, in seconds, for
// which a ReceiveMessage action waits for a message to arrive. Valid values:
2018-10-17 02:12:35 +02:00
// an integer from 0 to 20 (seconds). Default: 0.
2016-01-29 20:53:56 +01:00
//
2017-12-13 00:27:05 +01:00
// * RedrivePolicy - The string that includes the parameters for the dead-letter
// queue functionality of the source queue. For more information about the
// redrive policy and dead-letter queues, see Using Amazon SQS Dead-Letter
// Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html)
// in the Amazon Simple Queue Service Developer Guide.
//
// deadLetterTargetArn - The Amazon Resource Name (ARN) of the dead-letter queue
// to which Amazon SQS moves messages after the value of maxReceiveCount
// is exceeded.
//
// maxReceiveCount - The number of times a message is delivered to the source
2018-10-17 02:12:35 +02:00
// queue before being moved to the dead-letter queue. When the ReceiveCount
// for a message exceeds the maxReceiveCount for a queue, Amazon SQS moves
// the message to the dead-letter-queue.
2016-07-15 15:49:02 +02:00
//
2017-12-13 00:27:05 +01:00
// The dead-letter queue of a FIFO queue must also be a FIFO queue. Similarly,
// the dead-letter queue of a standard queue must also be a standard queue.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// * VisibilityTimeout - The visibility timeout for the queue, in seconds.
// Valid values: an integer from 0 to 43,200 (12 hours). Default: 30. For
// more information about the visibility timeout, see Visibility Timeout
// (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-07-15 15:49:02 +02:00
//
2017-05-11 13:24:29 +02:00
// The following attributes apply only to server-side-encryption (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html):
//
// * KmsMasterKeyId - The ID of an AWS-managed customer master key (CMK)
// for Amazon SQS or a custom CMK. For more information, see Key Terms (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms).
// While the alias of the AWS-managed CMK for Amazon SQS is always alias/aws/sqs,
2017-12-13 00:27:05 +01:00
// the alias of a custom CMK can, for example, be alias/MyAlias. For more
2017-05-11 13:24:29 +02:00
// examples, see KeyId (http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters)
// in the AWS Key Management Service API Reference.
//
// * KmsDataKeyReusePeriodSeconds - The length of time, in seconds, for which
// Amazon SQS can reuse a data key (http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys)
// to encrypt or decrypt messages before calling AWS KMS again. An integer
// representing seconds, between 60 seconds (1 minute) and 86,400 seconds
2018-10-17 02:12:35 +02:00
// (24 hours). Default: 300 (5 minutes). A shorter time period provides better
// security but results in more calls to KMS which might incur charges after
// Free Tier. For more information, see How Does the Data Key Reuse Period
// Work? (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work).
2017-05-11 13:24:29 +02:00
//
//
2016-11-19 19:41:01 +01:00
// The following attribute applies only to FIFO (first-in-first-out) queues
// (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html):
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// * ContentBasedDeduplication - Enables content-based deduplication. For
// more information, see Exactly-Once Processing (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing)
2017-12-13 00:27:05 +01:00
// in the Amazon Simple Queue Service Developer Guide.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// Every message must have a unique MessageDeduplicationId,
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// You may provide a MessageDeduplicationId explicitly.
2016-07-15 15:49:02 +02:00
//
2016-11-19 19:41:01 +01:00
// If you aren't able to provide a MessageDeduplicationId and you enable ContentBasedDeduplication
// for your queue, Amazon SQS uses a SHA-256 hash to generate the MessageDeduplicationId
// using the body of the message (but not the attributes of the message).
//
//
// If you don't provide a MessageDeduplicationId and the queue doesn't have
// ContentBasedDeduplication set, the action fails with an error.
//
// If the queue has ContentBasedDeduplication set, your MessageDeduplicationId
// overrides the generated one.
//
// When ContentBasedDeduplication is in effect, messages with identical content
// sent within the deduplication interval are treated as duplicates and only
// one copy of the message is delivered.
//
// If you send one message with ContentBasedDeduplication enabled and then another
// message with a MessageDeduplicationId that is the same as the one generated
// for the first MessageDeduplicationId, the two messages are treated as
// duplicates and only one copy of the message is delivered.
//
2016-10-17 23:21:08 +02:00
// Attributes is a required field
2016-01-29 20:53:56 +01:00
Attributes map [ string ] * string ` locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" required:"true" `
2017-01-02 21:35:31 +01:00
// The URL of the Amazon SQS queue whose attributes are set.
2016-07-15 15:49:02 +02:00
//
2018-10-17 02:12:35 +02:00
// Queue URLs and names are case-sensitive.
2016-10-17 23:21:08 +02:00
//
// QueueUrl is a required field
2016-01-29 20:53:56 +01:00
QueueUrl * string ` type:"string" required:"true" `
}
// String returns the string representation
func ( s SetQueueAttributesInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s SetQueueAttributesInput ) GoString ( ) string {
return s . String ( )
}
2016-05-05 03:06:27 +02:00
// Validate inspects the fields of the type to determine if they are valid.
func ( s * SetQueueAttributesInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "SetQueueAttributesInput" }
if s . Attributes == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Attributes" ) )
}
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
2016-11-19 19:41:01 +01:00
// SetAttributes sets the Attributes field's value.
func ( s * SetQueueAttributesInput ) SetAttributes ( v map [ string ] * string ) * SetQueueAttributesInput {
s . Attributes = v
return s
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * SetQueueAttributesInput ) SetQueueUrl ( v string ) * SetQueueAttributesInput {
s . QueueUrl = & v
return s
}
2016-01-29 20:53:56 +01:00
type SetQueueAttributesOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s SetQueueAttributesOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s SetQueueAttributesOutput ) GoString ( ) string {
return s . String ( )
}
2017-12-13 00:27:05 +01:00
type TagQueueInput struct {
_ struct { } ` type:"structure" `
// The URL of the queue.
//
// QueueUrl is a required field
QueueUrl * string ` type:"string" required:"true" `
// The list of tags to be added to the specified queue.
//
// Tags is a required field
Tags map [ string ] * string ` locationName:"Tag" locationNameKey:"Key" locationNameValue:"Value" type:"map" flattened:"true" required:"true" `
}
// String returns the string representation
func ( s TagQueueInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s TagQueueInput ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * TagQueueInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "TagQueueInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if s . Tags == nil {
invalidParams . Add ( request . NewErrParamRequired ( "Tags" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * TagQueueInput ) SetQueueUrl ( v string ) * TagQueueInput {
s . QueueUrl = & v
return s
}
// SetTags sets the Tags field's value.
func ( s * TagQueueInput ) SetTags ( v map [ string ] * string ) * TagQueueInput {
s . Tags = v
return s
}
type TagQueueOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s TagQueueOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s TagQueueOutput ) GoString ( ) string {
return s . String ( )
}
type UntagQueueInput struct {
_ struct { } ` type:"structure" `
// The URL of the queue.
//
// QueueUrl is a required field
QueueUrl * string ` type:"string" required:"true" `
// The list of tags to be removed from the specified queue.
//
// TagKeys is a required field
TagKeys [ ] * string ` locationNameList:"TagKey" type:"list" flattened:"true" required:"true" `
}
// String returns the string representation
func ( s UntagQueueInput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UntagQueueInput ) GoString ( ) string {
return s . String ( )
}
// Validate inspects the fields of the type to determine if they are valid.
func ( s * UntagQueueInput ) Validate ( ) error {
invalidParams := request . ErrInvalidParams { Context : "UntagQueueInput" }
if s . QueueUrl == nil {
invalidParams . Add ( request . NewErrParamRequired ( "QueueUrl" ) )
}
if s . TagKeys == nil {
invalidParams . Add ( request . NewErrParamRequired ( "TagKeys" ) )
}
if invalidParams . Len ( ) > 0 {
return invalidParams
}
return nil
}
// SetQueueUrl sets the QueueUrl field's value.
func ( s * UntagQueueInput ) SetQueueUrl ( v string ) * UntagQueueInput {
s . QueueUrl = & v
return s
}
// SetTagKeys sets the TagKeys field's value.
func ( s * UntagQueueInput ) SetTagKeys ( v [ ] * string ) * UntagQueueInput {
s . TagKeys = v
return s
}
type UntagQueueOutput struct {
_ struct { } ` type:"structure" `
}
// String returns the string representation
func ( s UntagQueueOutput ) String ( ) string {
return awsutil . Prettify ( s )
}
// GoString returns the string representation
func ( s UntagQueueOutput ) GoString ( ) string {
return s . String ( )
}
2016-01-29 20:53:56 +01:00
const (
2016-11-19 19:41:01 +01:00
// MessageSystemAttributeNameSenderId is a MessageSystemAttributeName enum value
MessageSystemAttributeNameSenderId = "SenderId"
// MessageSystemAttributeNameSentTimestamp is a MessageSystemAttributeName enum value
MessageSystemAttributeNameSentTimestamp = "SentTimestamp"
// MessageSystemAttributeNameApproximateReceiveCount is a MessageSystemAttributeName enum value
MessageSystemAttributeNameApproximateReceiveCount = "ApproximateReceiveCount"
// MessageSystemAttributeNameApproximateFirstReceiveTimestamp is a MessageSystemAttributeName enum value
MessageSystemAttributeNameApproximateFirstReceiveTimestamp = "ApproximateFirstReceiveTimestamp"
// MessageSystemAttributeNameSequenceNumber is a MessageSystemAttributeName enum value
MessageSystemAttributeNameSequenceNumber = "SequenceNumber"
// MessageSystemAttributeNameMessageDeduplicationId is a MessageSystemAttributeName enum value
MessageSystemAttributeNameMessageDeduplicationId = "MessageDeduplicationId"
// MessageSystemAttributeNameMessageGroupId is a MessageSystemAttributeName enum value
MessageSystemAttributeNameMessageGroupId = "MessageGroupId"
)
const (
// QueueAttributeNameAll is a QueueAttributeName enum value
QueueAttributeNameAll = "All"
2016-10-17 23:21:08 +02:00
// QueueAttributeNamePolicy is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNamePolicy = "Policy"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameVisibilityTimeout is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameVisibilityTimeout = "VisibilityTimeout"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameMaximumMessageSize is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameMaximumMessageSize = "MaximumMessageSize"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameMessageRetentionPeriod is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameMessageRetentionPeriod = "MessageRetentionPeriod"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameApproximateNumberOfMessages is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameApproximateNumberOfMessages = "ApproximateNumberOfMessages"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameApproximateNumberOfMessagesNotVisible is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameApproximateNumberOfMessagesNotVisible = "ApproximateNumberOfMessagesNotVisible"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameCreatedTimestamp is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameCreatedTimestamp = "CreatedTimestamp"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameLastModifiedTimestamp is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameLastModifiedTimestamp = "LastModifiedTimestamp"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameQueueArn is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameQueueArn = "QueueArn"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameApproximateNumberOfMessagesDelayed is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameApproximateNumberOfMessagesDelayed = "ApproximateNumberOfMessagesDelayed"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameDelaySeconds is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameDelaySeconds = "DelaySeconds"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameReceiveMessageWaitTimeSeconds is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameReceiveMessageWaitTimeSeconds = "ReceiveMessageWaitTimeSeconds"
2016-10-17 23:21:08 +02:00
// QueueAttributeNameRedrivePolicy is a QueueAttributeName enum value
2016-01-29 20:53:56 +01:00
QueueAttributeNameRedrivePolicy = "RedrivePolicy"
2016-11-19 19:41:01 +01:00
// QueueAttributeNameFifoQueue is a QueueAttributeName enum value
QueueAttributeNameFifoQueue = "FifoQueue"
// QueueAttributeNameContentBasedDeduplication is a QueueAttributeName enum value
QueueAttributeNameContentBasedDeduplication = "ContentBasedDeduplication"
2017-05-11 13:24:29 +02:00
// QueueAttributeNameKmsMasterKeyId is a QueueAttributeName enum value
QueueAttributeNameKmsMasterKeyId = "KmsMasterKeyId"
// QueueAttributeNameKmsDataKeyReusePeriodSeconds is a QueueAttributeName enum value
QueueAttributeNameKmsDataKeyReusePeriodSeconds = "KmsDataKeyReusePeriodSeconds"
2016-01-29 20:53:56 +01:00
)