GetQueueAttributes

Description

Gets one or all attributes of a queue. Queues currently have two attributes you can get:

ApproximateNumberOfMessages (see Resources Required to Process Messages for more information)
VisibilityTimeout (see Visibility Timeout for more information)

	Important
	Before the 2007-05-01 release introduced the `GetQueueAttributes` action, you retrieved the visibility timeout by using the `GetVisibilityTimeout` action. As of the 2007-05-01 release of Amazon SQS, the `GetVisibilityTimeout` action has been deprecated.

Request Parameters

The following table lists the special request parameters the action uses (in addition to the common request parameters listed in Common Request Parameters).

Name Description Required

Name	Description	Required
`Attribute`	The attribute you want to get. Setting this value to `All` returns all the queue's attributes. Type: String Valid values: `All` \| `ApproximateNumberOfMessages` \| `VisibilityTimeout`	Yes

Attribute

The attribute you want to get. Setting this value to All returns all the queue's attributes.

Type: String

Valid values: All | ApproximateNumberOfMessages | VisibilityTimeout

Yes

Response Elements

The following table lists the response elements the action returns (in addition to the common response elements listed in The Structure of a Response). See the Sample Response.

Name Description

Name	Description
`Attribute`	The attribute. Type: String Valid Values: `ApproximateNumberOfMessages` \| `VisibilityTimeout` Ancestor: `AttributedValue`
`AttributedValue`	An element containing each attribute's information. Ancestor: `GetQueueAttributesResponse` Child: `Attribute`, `Value`
`Value`	The value for the attribute. Type: String Ancestor: `AttributedValue`

Attribute

The attribute.

Type: String

Valid Values: ApproximateNumberOfMessages | VisibilityTimeout

Ancestor: AttributedValue

AttributedValue

An element containing each attribute's information.

Ancestor: GetQueueAttributesResponse

Child: Attribute, Value

Value

The value for the attribute.

Type: String

Ancestor: AttributedValue

Special Errors

The following table lists the special errors the action returns (in addition to the common errors listed in Common Errors).

Error	Description	HTTP Status Code
InvalidAttributeName	Unknown attribute	400

Examples

The following example Query request gets all the attribute values for the specified queue.

Sample Request

http://queue.amazon.com/A29E9VSPHGOG23/queue2
?Action=GetQueueAttributes
&Attribute=All
&AWSAccessKeyId=0GS7553JW74RRM612K02EXAMPLE
&Version=2007-05-01
&Expires=2007-05-12T12:00:00Z
&Signature=Dqlp3Sd6ljTUA9Uf6SGtEExwUQEXAMPLE=

Sample Response

<GetQueueAttributesResponse>
    <AttributedValue>
      <Attribute>ApproximateNumberOfMessages</Attribute>
      <Value>2900</Value>
    </AttributedValue>
    <AttributedValue>
      <Attribute>VisibilityTimeout</Attribute>
      <Value>35</Value>
    </AttributedValue>
    <ResponseStatus>
      <StatusCode>Success</StatusCode>
      <RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
    </ResponseStatus>
</GetQueueAttributesResponse>

Related Actions

SetQueueAttributes