Prev Feedback Next

SetQueueAttributes

Description

Sets an attribute of a queue. Currently, you can set only the VisibilityTimeout attribute for a queue. See Visibility Timeout for more information.

[Important]Important

Before the 2007-05-01 release introduced the SetQueueAttributes action, you set the visibility timeout by using the SetVisibilityTimeout action. As of the 2007-05-01 release of Amazon SQS, the SetVisibilityTimeout 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).

NameDescriptionRequired

Attribute

The attribute you want to set.

Type: String

Valid value: VisibilityTimeout

Yes

Value

The value of the attribute you want to set.

Type: For visibility timeout, the value must be an integer from 0 to 86400 (24 hours).

Yes

Response Elements

The response contains no special elements besides the common elements listed in The Structure of a Response.

Special Errors

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

ErrorDescriptionHTTP Status Code

InvalidAttributeName

Unknown attribute

400

Examples

The following example Query request sets the visibility timeout to 35 seconds for the specified queue.

http://queue.amazon.com/A29E9VSPHGOG23/queue2
?Action=SetQueueAttributes
&Attribute=VisibilityTimeout
&Value=35
&AWSAccessKeyId=0GS7553JW74RRM612K02EXAMPLE
&Version=2007-05-01
&Expires=2007-05-12T12:00:00Z
&Signature=Dqlp3Sd6ljTUA9Uf6SGtEExwUQEXAMPLE=
<SetQueueAttributesResponse>
     <ResponseStatus>
      <StatusCode>Success</StatusCode>
      <RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
    </ResponseStatus>
</SetQueueAttributesResponse>

Related Actions

Prev Copyright Information Next
 Home