2628 lines
94 KiB
Go
2628 lines
94 KiB
Go
// THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT.
|
|
|
|
// Package sqs provides a client for Amazon Simple Queue Service.
|
|
package sqs
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/aws/aws-sdk-go/aws/awsutil"
|
|
"github.com/aws/aws-sdk-go/aws/request"
|
|
"github.com/aws/aws-sdk-go/private/protocol"
|
|
"github.com/aws/aws-sdk-go/private/protocol/query"
|
|
)
|
|
|
|
const opAddPermission = "AddPermission"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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)
|
|
req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
|
|
req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
|
|
output = &AddPermissionOutput{}
|
|
req.Data = output
|
|
return
|
|
}
|
|
|
|
// 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,
|
|
// a parameter list with two elements looks like this:
|
|
func (c *SQS) AddPermission(input *AddPermissionInput) (*AddPermissionOutput, error) {
|
|
req, out := c.AddPermissionRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opChangeMessageVisibility = "ChangeMessageVisibility"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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)
|
|
req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
|
|
req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
|
|
output = &ChangeMessageVisibilityOutput{}
|
|
req.Data = output
|
|
return
|
|
}
|
|
|
|
// 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
|
|
// 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.
|
|
func (c *SQS) ChangeMessageVisibility(input *ChangeMessageVisibilityInput) (*ChangeMessageVisibilityOutput, error) {
|
|
req, out := c.ChangeMessageVisibilityRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opChangeMessageVisibilityBatch = "ChangeMessageVisibilityBatch"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// 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
|
|
// 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:
|
|
func (c *SQS) ChangeMessageVisibilityBatch(input *ChangeMessageVisibilityBatchInput) (*ChangeMessageVisibilityBatchOutput, error) {
|
|
req, out := c.ChangeMessageVisibilityBatchRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opCreateQueue = "CreateQueue"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// 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
|
|
// attribute.
|
|
//
|
|
// 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,
|
|
// a parameter list with two elements looks like this:
|
|
func (c *SQS) CreateQueue(input *CreateQueueInput) (*CreateQueueOutput, error) {
|
|
req, out := c.CreateQueueRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opDeleteMessage = "DeleteMessage"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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)
|
|
req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
|
|
req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
|
|
output = &DeleteMessageOutput{}
|
|
req.Data = output
|
|
return
|
|
}
|
|
|
|
// 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.
|
|
func (c *SQS) DeleteMessage(input *DeleteMessageInput) (*DeleteMessageOutput, error) {
|
|
req, out := c.DeleteMessageRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opDeleteMessageBatch = "DeleteMessageBatch"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// 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,
|
|
// a parameter list with two elements looks like this:
|
|
func (c *SQS) DeleteMessageBatch(input *DeleteMessageBatchInput) (*DeleteMessageBatchOutput, error) {
|
|
req, out := c.DeleteMessageBatchRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opDeleteQueue = "DeleteQueue"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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)
|
|
req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
|
|
req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
|
|
output = &DeleteQueueOutput{}
|
|
req.Data = output
|
|
return
|
|
}
|
|
|
|
// 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.
|
|
func (c *SQS) DeleteQueue(input *DeleteQueueInput) (*DeleteQueueOutput, error) {
|
|
req, out := c.DeleteQueueRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opGetQueueAttributes = "GetQueueAttributes"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// Gets attributes for the specified queue.
|
|
//
|
|
// 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:
|
|
func (c *SQS) GetQueueAttributes(input *GetQueueAttributesInput) (*GetQueueAttributesOutput, error) {
|
|
req, out := c.GetQueueAttributesRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opGetQueueUrl = "GetQueueUrl"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// 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.
|
|
func (c *SQS) GetQueueUrl(input *GetQueueUrlInput) (*GetQueueUrlOutput, error) {
|
|
req, out := c.GetQueueUrlRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opListDeadLetterSourceQueues = "ListDeadLetterSourceQueues"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// 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).
|
|
func (c *SQS) ListDeadLetterSourceQueues(input *ListDeadLetterSourceQueuesInput) (*ListDeadLetterSourceQueuesOutput, error) {
|
|
req, out := c.ListDeadLetterSourceQueuesRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opListQueues = "ListQueues"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// 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.
|
|
func (c *SQS) ListQueues(input *ListQueuesInput) (*ListQueuesOutput, error) {
|
|
req, out := c.ListQueuesRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opPurgeQueue = "PurgeQueue"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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)
|
|
req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
|
|
req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
|
|
output = &PurgeQueueOutput{}
|
|
req.Data = output
|
|
return
|
|
}
|
|
|
|
// Deletes the messages in a queue specified by the queue URL.
|
|
//
|
|
// When you use the PurgeQueue API, the deleted messages in the queue cannot
|
|
// 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.
|
|
func (c *SQS) PurgeQueue(input *PurgeQueueInput) (*PurgeQueueOutput, error) {
|
|
req, out := c.PurgeQueueRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opReceiveMessage = "ReceiveMessage"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// 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.
|
|
func (c *SQS) ReceiveMessage(input *ReceiveMessageInput) (*ReceiveMessageOutput, error) {
|
|
req, out := c.ReceiveMessageRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opRemovePermission = "RemovePermission"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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)
|
|
req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
|
|
req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
|
|
output = &RemovePermissionOutput{}
|
|
req.Data = output
|
|
return
|
|
}
|
|
|
|
// Revokes any permissions in the queue policy that matches the specified Label
|
|
// parameter. Only the owner of the queue can remove permissions.
|
|
func (c *SQS) RemovePermission(input *RemovePermissionInput) (*RemovePermissionOutput, error) {
|
|
req, out := c.RemovePermissionRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opSendMessage = "SendMessage"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// 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]
|
|
func (c *SQS) SendMessage(input *SendMessageInput) (*SendMessageOutput, error) {
|
|
req, out := c.SendMessageRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opSendMessageBatch = "SendMessageBatch"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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
|
|
}
|
|
|
|
// 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
|
|
// will be rejected.
|
|
//
|
|
// #x9 | #xA | #xD | [#x20 to #xD7FF] | [#xE000 to #xFFFD] | [#x10000 to #x10FFFF]
|
|
//
|
|
// 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,
|
|
// a parameter list with two elements looks like this:
|
|
func (c *SQS) SendMessageBatch(input *SendMessageBatchInput) (*SendMessageBatchOutput, error) {
|
|
req, out := c.SendMessageBatchRequest(input)
|
|
err := req.Send()
|
|
return out, err
|
|
}
|
|
|
|
const opSetQueueAttributes = "SetQueueAttributes"
|
|
|
|
// 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.
|
|
//
|
|
// 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)
|
|
// }
|
|
//
|
|
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)
|
|
req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
|
|
req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
|
|
output = &SetQueueAttributesOutput{}
|
|
req.Data = output
|
|
return
|
|
}
|
|
|
|
// 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.
|
|
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.
|
|
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.
|
|
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.
|
|
Label *string `type:"string" required:"true"`
|
|
|
|
// The URL of the Amazon SQS queue to take action on.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
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.
|
|
Code *string `type:"string" required:"true"`
|
|
|
|
// The id of an entry in a batch request.
|
|
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.
|
|
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.
|
|
Entries []*ChangeMessageVisibilityBatchRequestEntry `locationNameList:"ChangeMessageVisibilityBatchRequestEntry" type:"list" flattened:"true" required:"true"`
|
|
|
|
// The URL of the Amazon SQS queue to take action on.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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.
|
|
Failed []*BatchResultErrorEntry `locationNameList:"BatchResultErrorEntry" type:"list" flattened:"true" required:"true"`
|
|
|
|
// A list of ChangeMessageVisibilityBatchResultEntry items.
|
|
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:
|
|
//
|
|
//
|
|
//
|
|
// Your_Receipt_Handle]]>
|
|
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.
|
|
Id *string `type:"string" required:"true"`
|
|
|
|
// A receipt handle.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// Encloses the id of an entry in ChangeMessageVisibilityBatch.
|
|
type ChangeMessageVisibilityBatchResultEntry struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// Represents a message whose visibility timeout has been changed successfully.
|
|
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.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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.
|
|
ReceiptHandle *string `type:"string" required:"true"`
|
|
|
|
// The new value (in seconds - from 0 to 43200 - maximum 12 hours) for the message's
|
|
// visibility timeout.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
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:
|
|
//
|
|
// DelaySeconds - The time in seconds that the delivery of all messages in
|
|
// the queue will be delayed. An integer from 0 to 900 (15 minutes). The default
|
|
// 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)
|
|
// in the Amazon SQS Developer Guide.
|
|
//
|
|
// 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.
|
|
Attributes map[string]*string `locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"`
|
|
|
|
// The name for the queue to be created.
|
|
//
|
|
// Queue names are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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.
|
|
Entries []*DeleteMessageBatchRequestEntry `locationNameList:"DeleteMessageBatchRequestEntry" type:"list" flattened:"true" required:"true"`
|
|
|
|
// The URL of the Amazon SQS queue to take action on.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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.
|
|
Failed []*BatchResultErrorEntry `locationNameList:"BatchResultErrorEntry" type:"list" flattened:"true" required:"true"`
|
|
|
|
// A list of DeleteMessageBatchResultEntry items.
|
|
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.
|
|
Id *string `type:"string" required:"true"`
|
|
|
|
// A receipt handle.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// Encloses the id an entry in DeleteMessageBatch.
|
|
type DeleteMessageBatchResultEntry struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// Represents a successfully deleted message.
|
|
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.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
QueueUrl *string `type:"string" required:"true"`
|
|
|
|
// The receipt handle associated with the message to delete.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
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.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
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"`
|
|
|
|
// 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.
|
|
AttributeNames []*string `locationNameList:"AttributeName" type:"list" flattened:"true"`
|
|
|
|
// The URL of the Amazon SQS queue to take action on.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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.
|
|
//
|
|
// Queue names are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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.
|
|
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.
|
|
//
|
|
// Queue names are case-sensitive.
|
|
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.
|
|
//
|
|
// BinaryValue is automatically base64 encoded/decoded by the SDK.
|
|
BinaryValue []byte `type:"blob"`
|
|
|
|
// Amazon SQS supports the following logical data types: String, Number, and
|
|
// 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).
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
type PurgeQueueInput struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The queue URL of the queue to delete the messages from when using the PurgeQueue
|
|
// API.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
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"`
|
|
|
|
// A list of attributes that need to be returned along with each message. These
|
|
// attributes include:
|
|
//
|
|
// All - returns all values.
|
|
//
|
|
// ApproximateFirstReceiveTimestamp - returns the time when the message was
|
|
// first received from the queue (epoch time in milliseconds).
|
|
//
|
|
// ApproximateReceiveCount - returns the number of times a message has been
|
|
// 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.
|
|
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
|
|
// request. You can also use "bar.*" to return all message attributes starting
|
|
// with the "bar" prefix.
|
|
MessageAttributeNames []*string `locationNameList:"MessageAttributeName" type:"list" flattened:"true"`
|
|
|
|
// The URL of the Amazon SQS queue to take action on.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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.
|
|
Label *string `type:"string" required:"true"`
|
|
|
|
// The URL of the Amazon SQS queue to take action on.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
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.
|
|
Entries []*SendMessageBatchRequestEntry `locationNameList:"SendMessageBatchRequestEntry" type:"list" flattened:"true" required:"true"`
|
|
|
|
// The URL of the Amazon SQS queue to take action on.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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.
|
|
Failed []*BatchResultErrorEntry `locationNameList:"BatchResultErrorEntry" type:"list" flattened:"true" required:"true"`
|
|
|
|
// A list of SendMessageBatchResultEntry items.
|
|
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.
|
|
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.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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.
|
|
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).
|
|
MD5OfMessageBody *string `type:"string" required:"true"`
|
|
|
|
// An identifier for the message.
|
|
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.
|
|
MessageBody *string `type:"string" required:"true"`
|
|
|
|
// The URL of the Amazon SQS queue to take action on.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
// 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:
|
|
//
|
|
// DelaySeconds - The time in seconds that the delivery of all messages in
|
|
// the queue will be delayed. An integer from 0 to 900 (15 minutes). The default
|
|
// 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.
|
|
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.
|
|
//
|
|
// Queue URLs are case-sensitive.
|
|
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()
|
|
}
|
|
|
|
// 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
|
|
}
|
|
|
|
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 (
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNamePolicy = "Policy"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameVisibilityTimeout = "VisibilityTimeout"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameMaximumMessageSize = "MaximumMessageSize"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameMessageRetentionPeriod = "MessageRetentionPeriod"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameApproximateNumberOfMessages = "ApproximateNumberOfMessages"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameApproximateNumberOfMessagesNotVisible = "ApproximateNumberOfMessagesNotVisible"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameCreatedTimestamp = "CreatedTimestamp"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameLastModifiedTimestamp = "LastModifiedTimestamp"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameQueueArn = "QueueArn"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameApproximateNumberOfMessagesDelayed = "ApproximateNumberOfMessagesDelayed"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameDelaySeconds = "DelaySeconds"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameReceiveMessageWaitTimeSeconds = "ReceiveMessageWaitTimeSeconds"
|
|
// @enum QueueAttributeName
|
|
QueueAttributeNameRedrivePolicy = "RedrivePolicy"
|
|
)
|