2016-01-29 20:53:56 +01:00
// THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT.
// Package sqs provides a client for Amazon Simple Queue Service.
package sqs
import (
2016-05-05 03:06:27 +02:00
"fmt"
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See AddPermission for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the AddPermission method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
2016-02-15 20:59:49 +01:00
req . Handlers . Unmarshal . Remove ( query . UnmarshalHandler )
req . Handlers . Unmarshal . PushBackNamed ( protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
output = & AddPermissionOutput { }
req . Data = output
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).
// This allows for sharing access to the queue.
//
// When you create a queue, you have full control access rights for the queue.
// Only you (as owner of the queue) can grant or deny permissions to the queue.
// For more information about these permissions, see Shared Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html)
// in the Amazon SQS Developer Guide.
//
// AddPermission writes an Amazon SQS-generated policy. If you want to write
// your own policy, use SetQueueAttributes to upload your policy. For more information
// about writing your own policy, see Using The Access Policy Language (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AccessPolicyLanguage.html)
// in the Amazon SQS Developer Guide.
//
// Some API 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
//
// 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:
// * OverLimit
// The action that you requested would violate a limit. For example, ReceiveMessage
// returns this error if the maximum number of messages inflight has already
// been reached. AddPermission returns this error if the maximum number of permissions
// for the queue has already been reached.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) AddPermission ( input * AddPermissionInput ) ( * AddPermissionOutput , error ) {
req , out := c . AddPermissionRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See ChangeMessageVisibility for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the ChangeMessageVisibility method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
2016-02-15 20:59:49 +01:00
req . Handlers . Unmarshal . Remove ( query . UnmarshalHandler )
req . Handlers . Unmarshal . PushBackNamed ( protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
output = & ChangeMessageVisibilityOutput { }
req . Data = output
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
// value. The maximum allowed timeout value you can set the value to is 12 hours.
// This means you can't extend the timeout of a message in an existing queue
// to more than a total visibility timeout of 12 hours. (For more information
// visibility timeout, see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AboutVT.html)
// in the Amazon SQS Developer Guide.)
//
// For example, let's say you have a message and its default message visibility
// timeout is 5 minutes. After 3 minutes, you call ChangeMessageVisiblity with
// a timeout of 10 minutes. At that time, the timeout for the message would
// be extended by 10 minutes beyond the time of the ChangeMessageVisibility
// call. This results in a total visibility timeout of 13 minutes. You can continue
// to call ChangeMessageVisibility to extend the visibility timeout to a maximum
// of 12 hours. If you try to extend beyond 12 hours, the request will be rejected.
//
// There is a 120,000 limit for the number of inflight messages per queue.
// Messages are inflight after they have been received from the queue by a consuming
// component, but have not yet been deleted from the queue. If you reach the
// 120,000 limit, you will receive an OverLimit error message from Amazon SQS.
// To help avoid reaching the limit, you should delete the messages from the
// queue after they have been processed. You can also increase the number of
// queues you use to process the messages.
//
// If you attempt to set the VisibilityTimeout to an amount more than the maximum
// time left, Amazon SQS returns an error. It will not automatically recalculate
2016-07-15 15:49:02 +02:00
// and increase the timeout to the maximum time remaining.
//
// Unlike with a queue, when you change the visibility timeout for a specific
// message, that timeout value is applied immediately but is not saved in memory
// for that message. If you don't delete a message after it is received, the
// visibility timeout for the message the next time it is received reverts to
// the original timeout value, not the value you set with the ChangeMessageVisibility
// action.
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:
// * AWS.SimpleQueueService.MessageNotInflight
// The message referred to is not in flight.
//
// * ReceiptHandleIsInvalid
// The receipt handle provided is not valid.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ChangeMessageVisibility ( input * ChangeMessageVisibilityInput ) ( * ChangeMessageVisibilityOutput , error ) {
req , out := c . ChangeMessageVisibilityRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See ChangeMessageVisibilityBatch for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the ChangeMessageVisibilityBatch method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & ChangeMessageVisibilityBatchOutput { }
req . Data = output
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.
//
// Because the batch request can result in a combination of successful and
// unsuccessful actions, you should check for batch errors even when the call
2016-07-15 15:49:02 +02:00
// returns an HTTP status code of 200.
//
// Some API 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-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:
// * AWS.SimpleQueueService.TooManyEntriesInBatchRequest
// Batch request contains more number of entries than permissible.
//
// * AWS.SimpleQueueService.EmptyBatchRequest
// Batch request does not contain an entry.
//
// * AWS.SimpleQueueService.BatchEntryIdsNotDistinct
// Two or more batch entries have the same Id in the request.
//
// * AWS.SimpleQueueService.InvalidBatchEntryId
// The Id of a batch entry in a batch request does not abide by the specification.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ChangeMessageVisibilityBatch ( input * ChangeMessageVisibilityBatchInput ) ( * ChangeMessageVisibilityBatchOutput , error ) {
req , out := c . ChangeMessageVisibilityBatchRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See CreateQueue for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the CreateQueue method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & CreateQueueOutput { }
req . Data = output
return
}
2016-10-17 23:21:08 +02:00
// CreateQueue API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Creates a new queue, or returns the URL of an existing one. When you request
// CreateQueue, you provide a name for the queue. To successfully create a new
// queue, you must provide a name that is unique within the scope of your own
// queues.
//
// If you delete a queue, you must wait at least 60 seconds before creating
// a queue with the same name.
//
// You may pass one or more attributes in the request. If you do not provide
// a value for any attribute, the queue will have the default value for that
2016-07-15 15:49:02 +02:00
// attribute.
2016-01-29 20:53:56 +01:00
//
// Use GetQueueUrl to get a queue's URL. GetQueueUrl requires only the QueueName
// parameter.
//
// 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 do not match an existing queue, CreateQueue returns an error.
//
// Some API 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
//
// 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:
// * AWS.SimpleQueueService.QueueDeletedRecently
// You must wait 60 seconds after deleting a queue before you can create another
// with the same name.
//
// * QueueAlreadyExists
// A queue already exists with this name. Amazon SQS returns this error only
// if the request includes attributes whose values differ from those of the
// existing queue.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) CreateQueue ( input * CreateQueueInput ) ( * CreateQueueOutput , error ) {
req , out := c . CreateQueueRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See DeleteMessage for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the DeleteMessage method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
2016-02-15 20:59:49 +01:00
req . Handlers . Unmarshal . Remove ( query . UnmarshalHandler )
req . Handlers . Unmarshal . PushBackNamed ( protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
output = & DeleteMessageOutput { }
req . Data = output
return
}
2016-10-17 23:21:08 +02:00
// DeleteMessage API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Deletes the specified message from the specified queue. You specify the message
// by using the message's receipt handle and not the message ID you received
// when you sent the message. Even if the message is locked by another reader
// due to the visibility timeout setting, it is still deleted from the queue.
// If you leave a message in the queue for longer than the queue's configured
// retention period, Amazon SQS automatically deletes it.
//
// The receipt handle is associated with a specific instance of receiving
// the message. If you receive a message more than once, the receipt handle
// you get each time you receive the message is different. When you request
// DeleteMessage, if you don't provide the most recently received receipt handle
// for the message, the request will still succeed, but the message might not
// be deleted.
//
// It is possible you will receive a message even after you have deleted
// it. This might happen on rare occasions if one of the servers storing a copy
// of the message is unavailable when you request to delete the message. The
// copy remains on the server and might be returned to you again on a subsequent
// receive request. You should create your system to be idempotent so that receiving
// a particular message more than once is not a problem.
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:
// * InvalidIdFormat
// The receipt handle is not valid for the current version.
//
// * ReceiptHandleIsInvalid
// The receipt handle provided is not valid.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) DeleteMessage ( input * DeleteMessageInput ) ( * DeleteMessageOutput , error ) {
req , out := c . DeleteMessageRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See DeleteMessageBatch for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the DeleteMessageBatch method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & DeleteMessageBatchOutput { }
req . Data = output
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
// of DeleteMessage. The result of the delete action on 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.
//
// Some API 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
//
// 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:
// * AWS.SimpleQueueService.TooManyEntriesInBatchRequest
// Batch request contains more number of entries than permissible.
//
// * AWS.SimpleQueueService.EmptyBatchRequest
// Batch request does not contain an entry.
//
// * AWS.SimpleQueueService.BatchEntryIdsNotDistinct
// Two or more batch entries have the same Id in the request.
//
// * AWS.SimpleQueueService.InvalidBatchEntryId
// The Id of a batch entry in a batch request does not abide by the specification.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) DeleteMessageBatch ( input * DeleteMessageBatchInput ) ( * DeleteMessageBatchOutput , error ) {
req , out := c . DeleteMessageBatchRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See DeleteQueue for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the DeleteQueue method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
2016-02-15 20:59:49 +01:00
req . Handlers . Unmarshal . Remove ( query . UnmarshalHandler )
req . Handlers . Unmarshal . PushBackNamed ( protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
output = & DeleteQueueOutput { }
req . Data = output
return
}
2016-10-17 23:21:08 +02:00
// DeleteQueue API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Deletes the queue specified by the queue URL, regardless of whether the queue
// is empty. If the specified queue does not exist, Amazon SQS returns a successful
// response.
//
// Use DeleteQueue with care; once you delete your queue, any messages in
// the queue are no longer available.
//
// 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, a SendMessage request might succeed, but after the 60 seconds,
// the queue and that message you sent no longer exist. Also, when you delete
// a queue, you must wait at least 60 seconds before creating a queue with the
// same name.
//
// We reserve the right to delete queues that have had no activity for more
// than 30 days. For more information, see How Amazon SQS Queues Work (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSConcepts.html)
// in the Amazon SQS 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.
2016-01-29 20:53:56 +01:00
func ( c * SQS ) DeleteQueue ( input * DeleteQueueInput ) ( * DeleteQueueOutput , error ) {
req , out := c . DeleteQueueRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See GetQueueAttributes for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the GetQueueAttributes method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & GetQueueAttributesOutput { }
req . Data = output
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
//
2016-07-15 15:49:02 +02:00
// Some API 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-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:
// * InvalidAttributeName
// The attribute referred to does not exist.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) GetQueueAttributes ( input * GetQueueAttributesInput ) ( * GetQueueAttributesOutput , error ) {
req , out := c . GetQueueAttributesRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See GetQueueUrl for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the GetQueueUrl method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & GetQueueUrlOutput { }
req . Data = output
return
}
2016-10-17 23:21:08 +02:00
// GetQueueUrl API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Returns the URL of an existing queue. This action provides a simple way to
// retrieve the URL of an Amazon SQS queue.
//
// To access a queue that belongs to another AWS account, use the QueueOwnerAWSAccountId
// 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
// shared queue access, see AddPermission or go to Shared Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html)
// in the Amazon SQS 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:
// * AWS.SimpleQueueService.NonExistentQueue
// The queue referred to does not exist.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) GetQueueUrl ( input * GetQueueUrlInput ) ( * GetQueueUrlOutput , error ) {
req , out := c . GetQueueUrlRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See ListDeadLetterSourceQueues for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the ListDeadLetterSourceQueues method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & ListDeadLetterSourceQueuesOutput { }
req . Data = output
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
// configured with a dead letter queue.
//
// For more information about using dead letter queues, see Using Amazon SQS
// Dead Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSDeadLetterQueue.html).
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:
// * AWS.SimpleQueueService.NonExistentQueue
// The queue referred to does not exist.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ListDeadLetterSourceQueues ( input * ListDeadLetterSourceQueuesInput ) ( * ListDeadLetterSourceQueuesOutput , error ) {
req , out := c . ListDeadLetterSourceQueuesRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See ListQueues for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the ListQueues method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & ListQueuesOutput { }
req . Data = output
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
// is 1000. If you specify a value for the optional QueueNamePrefix parameter,
// only queues with a name beginning with the specified value are returned.
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.
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ListQueues ( input * ListQueuesInput ) ( * ListQueuesOutput , error ) {
req , out := c . ListQueuesRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See PurgeQueue for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the PurgeQueue method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
2016-02-15 20:59:49 +01:00
req . Handlers . Unmarshal . Remove ( query . UnmarshalHandler )
req . Handlers . Unmarshal . PushBackNamed ( protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
output = & PurgeQueueOutput { }
req . Data = output
return
}
2016-10-17 23:21:08 +02:00
// PurgeQueue API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Deletes the messages in a queue specified by the queue URL.
//
// When you use the PurgeQueue API, the deleted messages in the queue cannot
2016-07-15 15:49:02 +02:00
// be retrieved.
//
// When you purge a queue, the message deletion process takes up to 60 seconds.
// All messages sent to the queue before calling PurgeQueue will be deleted;
// messages sent to the queue while it is being purged may be deleted. While
// the queue is being purged, messages sent to the queue before PurgeQueue was
// called may be received, but will be deleted within the next minute.
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:
// * AWS.SimpleQueueService.NonExistentQueue
// The queue referred to does not exist.
//
// * AWS.SimpleQueueService.PurgeQueueInProgress
// Indicates that the specified queue previously received a PurgeQueue request
// within the last 60 seconds, the time it can take to delete the messages in
// the queue.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) PurgeQueue ( input * PurgeQueueInput ) ( * PurgeQueueOutput , error ) {
req , out := c . PurgeQueueRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See ReceiveMessage for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the ReceiveMessage method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & ReceiveMessageOutput { }
req . Data = output
return
}
2016-10-17 23:21:08 +02:00
// ReceiveMessage API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Retrieves one or more messages, with a maximum limit of 10 messages, from
// the specified queue. Long poll support is enabled by using the WaitTimeSeconds
// parameter. For more information, see Amazon SQS Long Poll (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html)
// in the Amazon SQS Developer Guide.
//
// Short poll is the default behavior where a weighted random set of machines
// is sampled on a ReceiveMessage call. This means only the messages on the
// sampled machines are returned. If the number of messages in the queue is
// small (less than 1000), it is likely you will 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; in which case you should repeat the request.
//
// For each message returned, the response includes the following:
//
// Message body
//
// MD5 digest of the message body. For information about MD5, go to http://www.faqs.org/rfcs/rfc1321.html
// (http://www.faqs.org/rfcs/rfc1321.html).
//
// Message ID you received when you sent the message to the queue.
//
// Receipt handle.
//
// Message attributes.
//
// MD5 digest of the message attributes.
//
// The receipt handle is the identifier you must provide when deleting the
// message. For more information, see Queue and Message Identifiers (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/ImportantIdentifiers.html)
// in the Amazon SQS Developer Guide.
//
// You can provide the VisibilityTimeout parameter in your request, which
// will be applied to the messages that Amazon SQS returns in the response.
// If you do not include the parameter, the overall visibility timeout for the
// queue is used for the returned messages. For more information, see Visibility
// Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AboutVT.html)
// in the Amazon SQS Developer Guide.
//
// Going forward, new attributes might be added. If you are writing 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:
// * OverLimit
// The action that you requested would violate a limit. For example, ReceiveMessage
// returns this error if the maximum number of messages inflight has already
// been reached. AddPermission returns this error if the maximum number of permissions
// for the queue has already been reached.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) ReceiveMessage ( input * ReceiveMessageInput ) ( * ReceiveMessageOutput , error ) {
req , out := c . ReceiveMessageRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See RemovePermission for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the RemovePermission method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
2016-02-15 20:59:49 +01:00
req . Handlers . Unmarshal . Remove ( query . UnmarshalHandler )
req . Handlers . Unmarshal . PushBackNamed ( protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
output = & RemovePermissionOutput { }
req . Data = output
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
// parameter. Only the owner of the queue can remove permissions.
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.
2016-01-29 20:53:56 +01:00
func ( c * SQS ) RemovePermission ( input * RemovePermissionInput ) ( * RemovePermissionOutput , error ) {
req , out := c . RemovePermissionRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See SendMessage for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the SendMessage method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & SendMessageOutput { }
req . Data = output
return
}
2016-10-17 23:21:08 +02:00
// SendMessage API operation for Amazon Simple Queue Service.
//
2016-01-29 20:53:56 +01:00
// Delivers a message to the specified queue. With Amazon SQS, you now have
// the ability to send large payload messages that are up to 256KB (262,144
// bytes) in size. To send large payloads, you must use an AWS SDK that supports
// SigV4 signing. To verify whether SigV4 is supported for an AWS SDK, check
// the SDK release notes.
//
// The following list shows the characters (in Unicode) allowed in your message,
// according to the W3C XML specification. For more information, go to http://www.w3.org/TR/REC-xml/#charsets
// (http://www.w3.org/TR/REC-xml/#charsets) If you send any characters not included
// in the list, your request will be rejected.
//
// #x9 | #xA | #xD | [#x20 to #xD7FF] | [#xE000 to #xFFFD] | [#x10000 to #x10FFFF]
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:
// * InvalidMessageContents
// The message contains characters outside the allowed set.
//
// * AWS.SimpleQueueService.UnsupportedOperation
// Error code 400. Unsupported operation.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) SendMessage ( input * SendMessageInput ) ( * SendMessageOutput , error ) {
req , out := c . SendMessageRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See SendMessageBatch for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the SendMessageBatch method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
output = & SendMessageBatchOutput { }
req . Data = output
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
// of SendMessage. The result of the send action on each message is reported
// individually in the response. The maximum allowed individual message size
// is 256 KB (262,144 bytes).
//
// The maximum total payload size (i.e., the sum of all a batch's individual
// message lengths) is also 256 KB (262,144 bytes).
//
// If the DelaySeconds parameter is not specified for an entry, the default
// for the queue is used.
//
// The following list shows the characters (in Unicode) that are allowed in
// your message, according to the W3C XML specification. For more information,
// go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
// If you send any characters that are not included in the list, your request
2016-07-15 15:49:02 +02:00
// will be rejected.
//
// #x9 | #xA | #xD | [#x20 to #xD7FF] | [#xE000 to #xFFFD] | [#x10000 to #x10FFFF]
2016-01-29 20:53:56 +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
2016-07-15 15:49:02 +02:00
// returns an HTTP status code of 200.
//
// Some API 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-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:
// * AWS.SimpleQueueService.TooManyEntriesInBatchRequest
// Batch request contains more number of entries than permissible.
//
// * AWS.SimpleQueueService.EmptyBatchRequest
// Batch request does not contain an entry.
//
// * AWS.SimpleQueueService.BatchEntryIdsNotDistinct
// Two or more batch entries have the same Id in the request.
//
// * AWS.SimpleQueueService.BatchRequestTooLong
// The length of all the messages put together is more than the limit.
//
// * AWS.SimpleQueueService.InvalidBatchEntryId
// The Id of a batch entry in a batch request does not abide by the specification.
//
// * AWS.SimpleQueueService.UnsupportedOperation
// Error code 400. Unsupported operation.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) SendMessageBatch ( input * SendMessageBatchInput ) ( * SendMessageBatchOutput , error ) {
req , out := c . SendMessageBatchRequest ( input )
err := req . Send ( )
return out , err
}
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
// value can be used to capture response data after the request's "Send" method
// is called.
//
2016-10-17 23:21:08 +02:00
// See SetQueueAttributes for usage and error information.
//
2016-07-15 15:49:02 +02:00
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the SetQueueAttributes method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // 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)
// }
//
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 { }
}
req = c . newRequest ( op , input , output )
2016-02-15 20:59:49 +01:00
req . Handlers . Unmarshal . Remove ( query . UnmarshalHandler )
req . Handlers . Unmarshal . PushBackNamed ( protocol . UnmarshalDiscardBodyHandler )
2016-01-29 20:53:56 +01:00
output = & SetQueueAttributesOutput { }
req . Data = output
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
// to propagate throughout the SQS system. Changes made to the MessageRetentionPeriod
// attribute can take up to 15 minutes.
//
// Going forward, new attributes might be added. If you are writing 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 SetQueueAttributes for usage and error information.
//
// Returned Error Codes:
// * InvalidAttributeName
// The attribute referred to does not exist.
//
2016-01-29 20:53:56 +01:00
func ( c * SQS ) SetQueueAttributes ( input * SetQueueAttributesInput ) ( * SetQueueAttributesOutput , error ) {
req , out := c . SetQueueAttributesRequest ( input )
err := req . Send ( )
return out , err
}
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)
// who will be 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 AWS account identification, see Your AWS Identifiers (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AWSCredentials.html)
// in the Amazon SQS 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" `
// The action the client wants to allow for the specified principal. The following
// are valid values: * | SendMessage | ReceiveMessage | DeleteMessage | ChangeMessageVisibility
// | GetQueueAttributes | GetQueueUrl. For more information about these actions,
// see Understanding Permissions (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html#PermissionTypes)
// in the Amazon SQS Developer Guide.
//
// Specifying SendMessage, DeleteMessage, or ChangeMessageVisibility for the
// 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" `
// The unique identification of the permission you're setting (e.g., AliceSendMessage).
// Constraints: Maximum 80 characters; alphanumeric characters, hyphens (-),
// and underscores (_) are allowed.
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" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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 ( )
}
// This is used in the responses of batch API to give a detailed description
// of the result of an action on each entry in the request.
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" `
// 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" `
// Whether the error happened due to the sender's fault.
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 ( )
}
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" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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 ( )
}
// Encloses a receipt handle and an entry id for each message in ChangeMessageVisibilityBatch.
//
// All of the following parameters are list parameters that 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-04-02 17:17:21 +02:00
// Your_Receipt_Handle]]>
2016-01-29 20:53:56 +01:00
type ChangeMessageVisibilityBatchRequestEntry struct {
_ struct { } ` type:"structure" `
// An identifier for this particular receipt handle. This is used to communicate
// the result. Note that the Ids of a batch request need to be unique within
// the 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-01-29 20:53:56 +01:00
// Encloses the id of an entry in ChangeMessageVisibilityBatch.
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 ( )
}
type ChangeMessageVisibilityInput struct {
_ struct { } ` type:"structure" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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 whose visibility timeout should
// be 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" `
// The new value (in seconds - from 0 to 43200 - maximum 12 hours) for the message's
// visibility timeout.
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-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
// parameters the CreateQueue action uses:
//
2016-07-15 15:49:02 +02:00
// DelaySeconds - The time in seconds that the delivery of all messages in
2016-04-02 17:17:21 +02:00
// the queue will be delayed. An integer from 0 to 900 (15 minutes). The default
2016-07-15 15:49:02 +02:00
// for this attribute is 0 (zero).
//
// MaximumMessageSize - The limit of how many bytes a message can contain before
// Amazon SQS rejects it. An integer from 1024 bytes (1 KiB) up to 262144 bytes
// (256 KiB). The default for this attribute is 262144 (256 KiB).
//
// MessageRetentionPeriod - The number of seconds Amazon SQS retains a message.
// Integer representing seconds, from 60 (1 minute) to 1209600 (14 days). The
// default for this attribute is 345600 (4 days).
//
// 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.
//
// ReceiveMessageWaitTimeSeconds - The time for which a ReceiveMessage call
// will wait for a message to arrive. An integer from 0 to 20 (seconds). The
// default for this attribute is 0.
//
// RedrivePolicy - The parameters for dead letter queue functionality of the
// source queue. For more information about RedrivePolicy and dead letter queues,
// see Using Amazon SQS Dead Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSDeadLetterQueue.html)
2016-01-29 20:53:56 +01:00
// in the Amazon SQS Developer Guide.
2016-07-15 15:49:02 +02:00
//
// VisibilityTimeout - The visibility timeout for the queue. An integer from
// 0 to 43200 (12 hours). The default for this attribute is 30. For more information
// about visibility timeout, see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AboutVT.html)
// in the Amazon SQS Developer Guide.
//
// Any other valid special request parameters that are specified (such as
// ApproximateNumberOfMessages, ApproximateNumberOfMessagesDelayed, ApproximateNumberOfMessagesNotVisible,
// CreatedTimestamp, LastModifiedTimestamp, and QueueArn) will be ignored.
2016-01-29 20:53:56 +01:00
Attributes map [ string ] * string ` locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
// The name for the queue to be created.
2016-07-15 15:49:02 +02:00
//
// Queue 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-01-29 20:53:56 +01:00
// Returns the QueueUrl element of the created queue.
type CreateQueueOutput struct {
_ struct { } ` type:"structure" `
// The URL for the created Amazon SQS queue.
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 ( )
}
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" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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
// cannot be deleted.
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 ( )
}
// 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
// the result. Note that the Ids of a batch request need to be unique within
// the 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-01-29 20:53:56 +01:00
// Encloses the id an entry in DeleteMessageBatch.
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 ( )
}
type DeleteMessageInput struct {
_ struct { } ` type:"structure" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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-07-15 15:49:02 +02:00
// A list of attributes to retrieve information for. The following attributes
// are supported:
//
// All - returns all values.
//
// ApproximateNumberOfMessages - returns the approximate number of visible
// messages in a queue. For more information, see Resources Required to Process
// Messages (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/ApproximateNumber.html)
// in the Amazon SQS Developer Guide.
//
// ApproximateNumberOfMessagesNotVisible - returns the approximate number of
// messages that are not timed-out and not deleted. For more information, see
// Resources Required to Process Messages (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/ApproximateNumber.html)
// in the Amazon SQS Developer Guide.
//
// VisibilityTimeout - returns the visibility timeout for the queue. For more
// information about visibility timeout, see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AboutVT.html)
// in the Amazon SQS Developer Guide.
//
// CreatedTimestamp - returns the time when the queue was created (epoch time
// in seconds).
//
// LastModifiedTimestamp - returns the time when the queue was last changed
// (epoch time in seconds).
//
// Policy - returns the queue's policy.
//
// MaximumMessageSize - returns the limit of how many bytes a message can contain
// before Amazon SQS rejects it.
//
// MessageRetentionPeriod - returns the number of seconds Amazon SQS retains
// a message.
//
// QueueArn - returns the queue's Amazon resource name (ARN).
//
// ApproximateNumberOfMessagesDelayed - returns the approximate number of messages
// that are pending to be added to the queue.
//
// DelaySeconds - returns the default delay on the queue in seconds.
//
// ReceiveMessageWaitTimeSeconds - returns the time for which a ReceiveMessage
// call will wait for a message to arrive.
//
// RedrivePolicy - returns the parameters for dead letter queue functionality
// of the source queue. For more information about RedrivePolicy and dead letter
// queues, see Using Amazon SQS Dead Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSDeadLetterQueue.html)
// in the Amazon SQS Developer Guide.
//
// Going forward, new attributes might be added. If you are writing code that
// calls this action, we recommend that you structure your code so that it can
// handle new attributes gracefully.
2016-01-29 20:53:56 +01:00
AttributeNames [ ] * string ` locationNameList:"AttributeName" type:"list" flattened:"true" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-01-29 20:53:56 +01:00
// A list of returned queue attributes.
type GetQueueAttributesOutput struct {
_ struct { } ` type:"structure" `
// A map of attributes to the respective values.
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 ( )
}
type GetQueueUrlInput struct {
_ struct { } ` type:"structure" `
// The name of the queue whose URL must be fetched. Maximum 80 characters; alphanumeric
// characters, hyphens (-), and underscores (_) are allowed.
2016-07-15 15:49:02 +02:00
//
// Queue 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-01-29 20:53:56 +01:00
// For more information, see Responses (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/UnderstandingResponses.html)
// in the Amazon SQS Developer Guide.
type GetQueueUrlOutput struct {
_ struct { } ` type:"structure" `
// The URL for the queue.
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 ( )
}
type ListDeadLetterSourceQueuesInput struct {
_ struct { } ` type:"structure" `
// The queue URL of a dead letter queue.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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
// 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 ( )
}
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
//
// Queue 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 ( )
}
// A list of your queues.
type ListQueuesOutput struct {
_ struct { } ` type:"structure" `
// A list of queue URLs, up to 1000 entries.
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 ( )
}
// An Amazon SQS message.
type Message struct {
_ struct { } ` type:"structure" `
// SenderId, SentTimestamp, ApproximateReceiveCount, and/or ApproximateFirstReceiveTimestamp.
// SentTimestamp and ApproximateFirstReceiveTimestamp are each returned as an
// 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" `
// An MD5 digest of the non-URL-encoded message attribute string. This can be
// used to verify that Amazon SQS received the message correctly. Amazon SQS
// first URL decodes the message before creating the MD5 digest. For information
// about MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
MD5OfMessageAttributes * string ` type:"string" `
// Each message attribute consists of a Name, Type, and Value. For more information,
// see Message Attribute Items (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSMessageAttributes.html#SQSMessageAttributesNTV).
MessageAttributes map [ string ] * MessageAttributeValue ` locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
// A unique identifier for the message. Message IDs are considered unique across
// 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 ( )
}
// The user-specified message attribute value. For string data types, the value
// attribute has the same restrictions on the content as the message body. For
// more information, see SendMessage (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessage.html).
//
// Name, type, and value must not be empty or null. In addition, the message
// body should not be empty or null. All parts of the message attribute, including
// name, type, and value, are included in the message size restriction, which
// is currently 256 KB (262,144 bytes).
type MessageAttributeValue struct {
_ struct { } ` type:"structure" `
// Not implemented. Reserved for future use.
BinaryListValues [ ] [ ] byte ` locationName:"BinaryListValue" locationNameList:"BinaryListValue" type:"list" flattened:"true" `
// Binary type attributes can store any binary data, for example, 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.
//
// You can also append custom labels. For more information, see Message Attribute
// Data Types (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSMessageAttributes.html#SQSMessageAttributes.DataTypes).
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" `
// Strings are Unicode with UTF8 binary encoding. For a list of code values,
// see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters (http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters).
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-01-29 20:53:56 +01:00
type PurgeQueueInput struct {
_ struct { } ` type:"structure" `
// The queue URL of the queue to delete the messages from when using the PurgeQueue
// API.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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" `
2016-07-15 15:49:02 +02:00
// A list of attributes that need to be returned along with each message. These
// attributes include:
//
// All - returns all values.
2016-01-29 20:53:56 +01:00
//
2016-07-15 15:49:02 +02:00
// ApproximateFirstReceiveTimestamp - returns the time when the message was
// first received from the queue (epoch time in milliseconds).
2016-01-29 20:53:56 +01:00
//
2016-04-02 17:17:21 +02:00
// ApproximateReceiveCount - returns the number of times a message has been
2016-07-15 15:49:02 +02:00
// received from the queue but not deleted.
//
// SenderId - returns the AWS account number (or the IP address, if anonymous
// access is allowed) of the sender.
//
// SentTimestamp - returns the time when the message was sent to the queue
// (epoch time in milliseconds).
//
// Any other valid special request parameters that are specified (such as
// ApproximateNumberOfMessages, ApproximateNumberOfMessagesDelayed, ApproximateNumberOfMessagesNotVisible,
// CreatedTimestamp, DelaySeconds, LastModifiedTimestamp, MaximumMessageSize,
// MessageRetentionPeriod, Policy, QueueArn, ReceiveMessageWaitTimeSeconds,
// RedrivePolicy, and VisibilityTimeout) will be ignored.
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
// than this value but may return fewer. Values can be from 1 to 10. Default
// is 1.
//
// All of the messages are not necessarily returned.
MaxNumberOfMessages * int64 ` type:"integer" `
// The name of the message attribute, where N is the index. The message attribute
// name can contain the following characters: A-Z, a-z, 0-9, underscore (_),
// hyphen (-), and period (.). The name must not start or end with a period,
// and it should not have successive periods. The name is case sensitive and
// must be unique among all attribute names for the message. The name can be
// up to 256 characters long. The name cannot start with "AWS." or "Amazon."
// (or any variations in casing), because these prefixes are reserved for use
// by Amazon Web Services.
//
// When using ReceiveMessage, you can send a list of attribute names to receive,
// or you can return all of the attributes by specifying "All" or ".*" in your
2016-07-15 15:49:02 +02:00
// request. You can also use "bar.*" to return all message attributes starting
// with the "bar" prefix.
2016-01-29 20:53:56 +01:00
MessageAttributeNames [ ] * string ` locationNameList:"MessageAttributeName" type:"list" flattened:"true" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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 duration (in seconds) that the received messages are hidden from subsequent
// retrieve requests after being retrieved by a ReceiveMessage request.
VisibilityTimeout * int64 ` type:"integer" `
// The duration (in seconds) for which the call will wait for a message to arrive
// in the queue before returning. If a message is available, the call will return
// sooner than WaitTimeSeconds.
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-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 ( )
}
type RemovePermissionInput struct {
_ struct { } ` type:"structure" `
// The identification of the permission to remove. This is the label added with
// 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" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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" `
// A list of BatchResultErrorEntry items with the error detail about each message
// that could not 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 ( )
}
// Contains the details of a single Amazon SQS message along with a Id.
type SendMessageBatchRequestEntry struct {
_ struct { } ` type:"structure" `
// The number of seconds for which the message has to be delayed.
DelaySeconds * int64 ` type:"integer" `
// An identifier for the message in this batch. This is used to communicate
// the result. Note that the Ids of a batch request need to be unique within
// the 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" `
// Each message attribute consists of a Name, Type, and Value. For more information,
// see Message Attribute Items (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSMessageAttributes.html#SQSMessageAttributesNTV).
MessageAttributes map [ string ] * MessageAttributeValue ` locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
// 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" `
}
// 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-01-29 20:53:56 +01:00
// Encloses a message ID for successfully enqueued message of a SendMessageBatch.
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" `
// An MD5 digest of the non-URL-encoded message attribute string. This can be
// used to verify that Amazon SQS received the message batch correctly. Amazon
// SQS first URL decodes the message before creating the MD5 digest. For information
// about MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
MD5OfMessageAttributes * string ` type:"string" `
// An MD5 digest of the non-URL-encoded message body string. This can be used
// to verify that Amazon SQS received the message correctly. Amazon SQS first
// URL decodes the message before creating the MD5 digest. For information about
// MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
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" `
}
// 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 ( )
}
type SendMessageInput struct {
_ struct { } ` type:"structure" `
// The number of seconds (0 to 900 - 15 minutes) to delay a specific message.
// Messages with a positive DelaySeconds value become available for processing
// after the delay time is finished. If you don't specify a value, the default
// value for the queue applies.
DelaySeconds * int64 ` type:"integer" `
// Each message attribute consists of a Name, Type, and Value. For more information,
// see Message Attribute Items (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSMessageAttributes.html#SQSMessageAttributesNTV).
MessageAttributes map [ string ] * MessageAttributeValue ` locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" `
// The message to send. String maximum 256 KB in size. For a list of allowed
// characters, see the preceding important note.
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" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-01-29 20:53:56 +01:00
// The MD5OfMessageBody and MessageId elements.
type SendMessageOutput struct {
_ struct { } ` type:"structure" `
// An MD5 digest of the non-URL-encoded message attribute string. This can be
// used to verify that Amazon SQS received the message correctly. Amazon SQS
// first URL decodes the message before creating the MD5 digest. For information
// about MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
MD5OfMessageAttributes * string ` type:"string" `
// An MD5 digest of the non-URL-encoded message body string. This can be used
// to verify that Amazon SQS received the message correctly. Amazon SQS first
// URL decodes the message before creating the MD5 digest. For information about
// MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
MD5OfMessageBody * string ` type:"string" `
// An element containing the message ID of the message sent to the queue. For
// more information, see Queue and Message Identifiers (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/ImportantIdentifiers.html)
// in the Amazon SQS Developer Guide.
MessageId * string ` type:"string" `
}
// 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 ( )
}
type SetQueueAttributesInput struct {
_ struct { } ` type:"structure" `
// A map of attributes to set.
//
// The following lists the names, descriptions, and values of the special request
// parameters the SetQueueAttributes action uses:
//
2016-07-15 15:49:02 +02:00
// DelaySeconds - The time in seconds that the delivery of all messages in
2016-04-02 17:17:21 +02:00
// the queue will be delayed. An integer from 0 to 900 (15 minutes). The default
2016-07-15 15:49:02 +02:00
// for this attribute is 0 (zero).
//
// MaximumMessageSize - The limit of how many bytes a message can contain before
// Amazon SQS rejects it. An integer from 1024 bytes (1 KiB) up to 262144 bytes
// (256 KiB). The default for this attribute is 262144 (256 KiB).
//
// MessageRetentionPeriod - The number of seconds Amazon SQS retains a message.
// Integer representing seconds, from 60 (1 minute) to 1209600 (14 days). The
// default for this attribute is 345600 (4 days).
//
// 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.
//
// ReceiveMessageWaitTimeSeconds - The time for which a ReceiveMessage call
// will wait for a message to arrive. An integer from 0 to 20 (seconds). The
// default for this attribute is 0.
//
// VisibilityTimeout - The visibility timeout for the queue. An integer from
// 0 to 43200 (12 hours). The default for this attribute is 30. For more information
// about visibility timeout, see Visibility Timeout in the Amazon SQS Developer
// Guide.
//
// RedrivePolicy - The parameters for dead letter queue functionality of the
// source queue. For more information about RedrivePolicy and dead letter queues,
// see Using Amazon SQS Dead Letter Queues in the Amazon SQS Developer Guide.
//
// Any other valid special request parameters that are specified (such as
// ApproximateNumberOfMessages, ApproximateNumberOfMessagesDelayed, ApproximateNumberOfMessagesNotVisible,
// CreatedTimestamp, LastModifiedTimestamp, and QueueArn) will be ignored.
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" `
// The URL of the Amazon SQS queue to take action on.
2016-07-15 15:49:02 +02:00
//
// Queue URLs 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-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 ( )
}
const (
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"
)