com.amazonaws.services.sqs.model

Class GetQueueAttributesRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.sqs.model.GetQueueAttributesRequest

All Implemented Interfaces:

Serializable

public class GetQueueAttributesRequest
extends AmazonWebServiceRequest
implements Serializable

Container for the parameters to the GetQueueAttributes operation.

Gets attributes for the specified queue.

NOTE: 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:

&Attribute.1=this

&Attribute.2=that

See Also:

AmazonSQS.getQueueAttributes(GetQueueAttributesRequest), Serialized Form

Constructor Summary

Constructors

Constructor and Description
GetQueueAttributesRequest() Default constructor for a new GetQueueAttributesRequest object.
GetQueueAttributesRequest(String queueUrl) Constructs a new GetQueueAttributesRequest object.
GetQueueAttributesRequest(String queueUrl, List<String> attributeNames) Constructs a new GetQueueAttributesRequest object.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
List<String>	getAttributeNames() A list of attributes to retrieve information for.
String	getQueueUrl() The URL of the Amazon SQS queue to take action on.
int	hashCode()
void	setAttributeNames(Collection<String> attributeNames) A list of attributes to retrieve information for.
void	setQueueUrl(String queueUrl) The URL of the Amazon SQS queue to take action on.
String	toString() Returns a string representation of this object; useful for testing and debugging.
GetQueueAttributesRequest	withAttributeNames(Collection<String> attributeNames) A list of attributes to retrieve information for.
GetQueueAttributesRequest	withAttributeNames(QueueAttributeName... attributeNames) A list of attributes to retrieve information for.
GetQueueAttributesRequest	withAttributeNames(String... attributeNames) A list of attributes to retrieve information for.
GetQueueAttributesRequest	withQueueUrl(String queueUrl) The URL of the Amazon SQS queue to take action on.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setRequestCredentials, setRequestMetricCollector, withRequestMetricCollector

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

GetQueueAttributesRequest

public GetQueueAttributesRequest()

Default constructor for a new GetQueueAttributesRequest object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.

GetQueueAttributesRequest

public GetQueueAttributesRequest(String queueUrl)

Constructs a new GetQueueAttributesRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:

queueUrl - The URL of the Amazon SQS queue to take action on.

Queue URLs are case-sensitive.

GetQueueAttributesRequest

public GetQueueAttributesRequest(String queueUrl,
                                 List<String> attributeNames)

Constructs a new GetQueueAttributesRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:

queueUrl - The URL of the Amazon SQS queue to take action on.

Queue URLs are case-sensitive.

attributeNames - 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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

Method Detail

getQueueUrl

public String getQueueUrl()

The URL of the Amazon SQS queue to take action on.

Queue URLs are case-sensitive.

Returns:

The URL of the Amazon SQS queue to take action on.

Queue URLs are case-sensitive.

setQueueUrl

public void setQueueUrl(String queueUrl)

The URL of the Amazon SQS queue to take action on.

Queue URLs are case-sensitive.

Parameters:

queueUrl - The URL of the Amazon SQS queue to take action on.

Queue URLs are case-sensitive.

withQueueUrl

public GetQueueAttributesRequest withQueueUrl(String queueUrl)

The URL of the Amazon SQS queue to take action on.

Queue URLs are case-sensitive.

Returns a reference to this object so that method calls can be chained together.

Parameters:

queueUrl - The URL of the Amazon SQS queue to take action on.

Queue URLs are case-sensitive.

Returns:

A reference to this updated object so that method calls can be chained together.

getAttributeNames

public List<String> getAttributeNames()

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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

Returns:

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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

setAttributeNames

public void setAttributeNames(Collection<String> attributeNames)

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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

Parameters:

attributeNames - 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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

withAttributeNames

public GetQueueAttributesRequest withAttributeNames(String... attributeNames)

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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

Returns a reference to this object so that method calls can be chained together.

Parameters:

attributeNames - 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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

Returns:

A reference to this updated object so that method calls can be chained together.

withAttributeNames

public GetQueueAttributesRequest withAttributeNames(Collection<String> attributeNames)

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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

Returns a reference to this object so that method calls can be chained together.

Parameters:

attributeNames - 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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

Returns:

A reference to this updated object so that method calls can be chained together.

withAttributeNames

public GetQueueAttributesRequest withAttributeNames(QueueAttributeName... attributeNames)

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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

Returns a reference to this object so that method calls can be chained together.

Parameters:

attributeNames - 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 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 in the Amazon SQS Developer Guide.

• VisibilityTimeout - returns the visibility timeout for the queue. For more information about visibility timeout, see Visibility Timeout 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 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.

Returns:

A reference to this updated object so that method calls can be chained together.

toString

public String toString()

Returns a string representation of this object; useful for testing and debugging.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object