Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Решения
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Message Queue
  • Начало работы
    • Быстрый старт
    • Поддерживаемые инструменты
    • Примеры кода
      • Python
      • Node.js
      • PHP
      • Celery
      • JMS
      • Laravel
      • Terraform
  • Пошаговые инструкции
    • Обзор
    • Создание новой очереди сообщений
    • Отправка сообщений
    • Прием и удаление сообщений
    • Удаление очереди сообщений
  • Концепции
    • Обзор
    • Очереди сообщений
    • Сообщения
    • Дедупликация
    • Таймаут видимости
    • Long Polling
    • Dead Letter Queue
    • Отложенная доставка сообщений в очереди
    • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
  • Yandex Message Queue API
    • Обзор
    • Queue
      • CreateQueue
      • DeleteQueue
      • GetQueueAttributes
      • GetQueueUrl
      • ListQueues
      • PurgeQueue
      • SetQueueAttributes
    • Message
      • ChangeMessageVisibility
      • ChangeMessageVisibilityBatch
      • DeleteMessage
      • DeleteMessageBatch
      • ReceiveMessage
      • SendMessage
      • SendMessageBatch
    • Типы данных
      • BatchResultErrorEntry
      • ChangeMessageVisibilityBatchRequestEntry
      • ChangeMessageVisibilityBatchResultEntry
      • DeleteMessageBatchRequestEntry
      • DeleteMessageBatchResultEntry
      • Message
      • MessageAttributeValue
      • SendMessageBatchRequestEntry
      • SendMessageBatchResultEntry
    • Стандартные ошибки
  • Публичные материалы
  • Вопросы и ответы
  1. Yandex Message Queue API
  2. Queue
  3. SetQueueAttributes

SetQueueAttributes

  • Запрос
    • Параметры запроса
  • Ответ
    • Поля успешного ответа
    • Ошибки SetQueueAttributes
  • Пример запроса
  • Пример ответа

Метод для задания атрибутов указанной очереди. Изменение атрибутов может занять до 60 секунд. Изменение атрибута MessageRetentionPeriod может занять до 15 минут.

Запрос

Параметры запроса

Параметр Тип Обязательный параметр Описание
QueueUrl string Да URL очереди.
Attributes.N.* список атрибутов Да Список атрибутов очереди.

Атрибуты

Атрибуты очереди. Атрибуты передаются в виде списка. Подробнее о передаче списочных параметров см. Использование API.

Attribute.N.Name (атрибут)
Attribute.N.Value (значение атрибута)
Атрибут Тип Описание
DelaySeconds integer Время в секундах, на которое сообщения будут скрыты после отправки. Возможные значения от 0 до 900 секунд (15 минут). Значение по умолчанию: 0.
MaximumMessageSize integer Максимальный размер сообщения в байтах. Возможные значения: 1024 байта (1 KБ) до 262144 байт (256 КБ). Значение по умолчанию: 262144 (256 КБ).
MessageRetentionPeriod integer Срок хранения сообщений в секундах. Возможные значения: от 60 секунда (1 минута) до 1209600 секунд (14 дней). Значение по умолчанию: 345600 (4 дня).
ReceiveMessageWaitTimeSeconds integer Время ожидания для метода ReceiveMessage в секундах. Возможные значения: от 0 to 20 секунд. Значение по умолчанию: 0.
RedrivePolicy string Политика перенаправления сообщений в Dead Letter Queue. Тип исходной очереди и очереди DLQ должны быть одинаковыми: для очередей FIFO очередь DLQ тоже должна быть очередью FIFO. Включает два параметра:
  • deadLetterTargetArn — ARN очереди, в которую будут перенаправляться сообщения. ARN очереди можно получить с помощью вызова метода GetQueueAttributes.
  • maxReceiveCount — максимальное количество попыток считывания сообщения из очереди перед перенаправлением в DLQ. Когда значение параметра ReceiveCount у сообщения превышает значение maxReceiveCount, сообщение перенаправляется в DLQ.
VisibilityTimeout integer Таймаут видимости сообщений в очереди в секундах. Возможные значения: от 0 до 43000 секунд. Значение по умолчанию: 30.

Атрибуты очередей FIFO

Атрибут Описание
ContentBasedDeduplication Флаг, включающий дедупликацию по содержимому сообщения. Возможные значения: true или false.

Неподдерживаемые атрибуты

Атрибут Тип Описание
KmsMasterKeyId string Атрибут не поддерживается в Yandex Message Queue.
KmsDataKeyReusePeriodSeconds string Атрибут не поддерживается в Yandex Message Queue.

Ответ

Поля успешного ответа

Ответ не содержит полей.

Ошибки SetQueueAttributes

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки.

Код HTTP Идентификатор ошибки Описание
400 InvalidAttributeName Неверное имя атрибута.

Пример запроса

Action=SetQueueAttributes
&Version=2012-11-05
&QueueUrl=https://message-queue.api.cloud.yandex.net/b1g8ad42m6he1ooql78r/dj600000000000le07ol/sample-queue
&Attribute.1.Name=DelaySeconds
&Attribute.1.Value=10
&Attribute.2.Name=VisibilityTimeout
&Attribute.2.Value=20

Подробнее о формировании запросов см. в разделе Общий вид запросов к API.

Пример ответа

<SetQueueAttributesResponse>
    <ResponseMetadata>
        <RequestId>87acfbed-5254a88a-ef8d6306-e5fd93e-74626d14b02d992c99e5fa1b97c0ac82</RequestId>
    </ResponseMetadata>
</SetQueueAttributesResponse>
В этой статье:
  • Запрос
  • Параметры запроса
  • Ответ
  • Поля успешного ответа
  • Ошибки SetQueueAttributes
  • Пример запроса
  • Пример ответа
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»