SetQueueAttributes
Written by
Updated at July 7, 2026
Method for setting attributes for the specified queue. It may take up to 60 seconds to change attributes. It may take up to 15 minutes to change the MessageRetentionPeriod attribute.
Request
Request parameters
| Parameter | Type | Required parameter | Description |
|---|---|---|---|
QueueUrl |
string | Yes | URL of a queue. |
Attributes.N.* |
list of attributes | Yes | List of queue attributes. |
Attributes
Queue attributes. Attributes are sent as a list. For the rules of providing listed attributes, see Using the API.
Attribute.N.Name (attribute)
Attribute.N.Value (attribute value)
| Attribute | Type | Description |
|---|---|---|
DelaySeconds |
integer | Time in seconds the messages will remain hidden after they are sent. Valid values: from 0 to 900 seconds (15 minutes). The default value is 0. |
MaximumMessageSize |
integer | Maximum message size in bytes. The possible values are: from 1,024 bytes (1 KB) up to 262,144 bytes (256 KB). The default value is 262,144 (256 KB). |
MessageRetentionPeriod |
integer | Message retention period, seconds. Valid values: from 60 seconds (1 minute) up to 1,209,600 seconds (14 days). The default value is 345,600 (4 days). |
ReceiveMessageWaitTimeSeconds |
integer | Wait time for the ReceiveMessage method, seconds. Valid values: from 0 to 20 seconds. The default value is 0. |
RedrivePolicy |
string | Redirect policy for moving messages to a dead-letter queue. The source queue and DLQ must be the same type: for FIFO queues, the DLQ must also be a FIFO queue. It includes two parameters:
|
VisibilityTimeout |
integer | Visibility timeout for the queue, seconds. Valid values: from 0 to 43,000 seconds. The default value is 30. |
FIFO queue attributes
| Attribute | Description |
|---|---|
ContentBasedDeduplication |
Enables content-based deduplication. The possible values are true or false. |
Non-supported attributes
| Attribute | Type | Description |
|---|---|---|
KmsMasterKeyId |
string | Not supported in Yandex Message Queue. |
KmsDataKeyReusePeriodSeconds |
string | Not supported in Yandex Message Queue. |
Response
Successful response fields
The response does not contain any fields.
SetQueueAttributes errors
For a list of errors common for all methods, see Common errors.
| HTTP code | Error ID | Description |
|---|---|---|
| 400 | InvalidAttributeName |
The attribute name is invalid. |
Request example
Action=SetQueueAttributes
&Version=2012-11-05
&QueueUrl=https://message-queue.api.cloud.yandex.net/b1g8ad42m6he********/dj6000000000********/sample-queue
&Attribute.1.Name=DelaySeconds
&Attribute.1.Value=10
&Attribute.2.Name=VisibilityTimeout
&Attribute.2.Value=20
For more on request formatting, see General API request format.
Response example
<SetQueueAttributesResponse>
<ResponseMetadata>
<RequestId>87acfbed-5254a88a-ef8d6306-e5fd93e-74626d14b02d992c99e5fa1b********</RequestId>
</ResponseMetadata>
</SetQueueAttributesResponse>