set-queue-attributes

URL очереди Amazon SQS, атрибуты которой устанавливаются.

URL и имена очереди чувствительны к регистру.

Массив атрибутов для установки.

Ниже приведен список имен, описаний и значений специальных параметров запроса, которые использует действие SetQueueAttributes:

• DelaySeconds – Время задержки доставки всех сообщений в очереди в секундах. Допустимые значения: целое число от 0 до 900 (15 минут). По умолчанию: 0.
• MaximumMessageSize – Предел размера сообщения в байтах, превышение которого приведет к его отклонению Amazon SQS. Допустимые значения: целое число от 1024 байт (1 Кб) до 262144 байт (256 Кб). По умолчанию: 262144 (256 Кб).
• MessageRetentionPeriod – Время, в секундах, в течение которого Amazon SQS хранит сообщение. Допустимые значения: целое число, представляющее секунды, от 60 (1 минута) до 1209600 (14 дней). По умолчанию: 345600 (4 дня). При изменении атрибутов очереди изменения могут распространяться по всей системе Amazon SQS в течение 60 секунд для большинства атрибутов. Изменения, внесенные в атрибут MessageRetentionPeriod, могут занимать до 15 минут и повлияют на существующие сообщения в очереди, потенциально вызвав их истечение срока действия и удаление, если значение MessageRetentionPeriod будет снижено ниже возраста существующих сообщений.
• Policy – Политика очереди. Действительная политика Amazon Web Services. Дополнительную информацию о структуре политики см. в обзоре политик IAM Amazon Web Services в руководстве пользователя по Identity and Access Management.
• ReceiveMessageWaitTimeSeconds – Время ожидания действия «ReceiveMessage» в секундах. Допустимые значения: целое число от 0 до 20 (секунд). По умолчанию: 0.
• VisibilityTimeout – Таймаут видимости очереди в секундах. Допустимые значения: целое число от 0 до 43200 (12 часов). По умолчанию: 30. Дополнительную информацию о таймауте видимости см. в руководстве разработчика Amazon SQS.

Следующие атрибуты применяются только к очередям с сообщениями-возвратом:

• RedrivePolicy – Строка, содержащая параметры функциональности очереди с сообщениями-возвратом исходной очереди в формате JSON. Параметры следующие:
  • deadLetterTargetArn – Amazon Resource Name (ARN) очереди с сообщениями-возвратом, в которую Amazon SQS перемещает сообщения после превышения значения maxReceiveCount.
  • maxReceiveCount – Количество попыток доставки сообщения в исходную очередь перед перемещением в очередь с сообщениями-возвратом. По умолчанию: 10. Когда значение ReceiveCount для сообщения превышает значение maxReceiveCount для очереди, Amazon SQS перемещает сообщение в очередь с сообщениями-возвратом.
• RedriveAllowPolicy – Строка, содержащая параметры разрешений для разрешения перенаправления в очередь с сообщениями-возвратом и какие исходные очереди могут указать очереди с сообщениями-возвратом в формате JSON. Параметры следующие:
  • redrivePermission – Тип разрешения, определяющий, какие исходные очереди могут указать текущую очередь в качестве очереди с сообщениями-возвратом. Допустимые значения:
    • allowAll – (По умолчанию) Любые исходные очереди в этой учетной записи Amazon Web Services в том же регионе могут указать эту очередь в качестве очереди с сообщениями-возвратом.
    • denyAll – Никакие исходные очереди не могут указать эту очередь в качестве очереди с сообщениями-возвратом.
    • byQueue – Только очереди, указанные параметром sourceQueueArns, могут указать эту очередь в качестве очереди с сообщениями-возвратом.
  • sourceQueueArns – Amazon Resource Names (ARN) исходных очередей, которые могут указать эту очередь в качестве очереди с сообщениями-возвратом и перенаправить сообщения. Вы можете указать этот параметр только тогда, когда параметр redrivePermission установлен в значение byQueue. Вы можете указать до 10 ARN исходных очередей. Чтобы разрешить более 10 исходных очередей указать очереди с сообщениями-возвратом, установите параметр redrivePermission в значение allowAll.

Следующие атрибуты применяются только к шифрованию на стороне сервера:

• KmsMasterKeyId – Идентификатор управляемого Amazon Web Services ключа шифрования (CMK) для Amazon SQS или настраиваемого CMK. Дополнительную информацию см. в разделе Термины.
• KmsDataKeyReusePeriodSeconds – Время в секундах, в течение которого Amazon SQS может повторно использовать ключ данных для шифрования или дешифрования сообщений перед обращением к KMS снова. Целое число, представляющее секунды, между 60 секундами (1 минута) и 86400 секундами (24 часа). По умолчанию: 300 (5 минут). Более короткий период обеспечивает лучшую безопасность, но приводит к большему количеству обращений к KMS, что может повлечь за собой расходы после бесплатного периода. Дополнительную информацию см. в разделе Как работает период повторного использования ключа данных?.
• SqsManagedSseEnabled – Включает шифрование очереди на стороне сервера с использованием ключей шифрования, принадлежащих SQS. Только один вариант шифрования на стороне сервера поддерживается на очередь (например, SSE-KMS или SSE-SQS).

Следующий атрибут применяется только к очередям FIFO (first-in-first-out):

• ContentBasedDeduplication – Включает дублирование по содержимому. Дополнительную информацию см. в разделе Обработка "точно один раз" в руководстве разработчика Amazon SQS. Обратите внимание на следующее:
  • Каждый message должен иметь уникальный MessageDeduplicationId.
    • Вы можете явно указать MessageDeduplicationId.
    • Если вы не можете указать MessageDeduplicationId и включите ContentBasedDeduplication для вашей очереди, Amazon SQS использует хеш SHA-256 для создания MessageDeduplicationId, используя тело сообщения (но не атрибуты сообщения).
    • Если вы не указываете MessageDeduplicationId и в очереди не установлен ContentBasedDeduplication, действие завершится с ошибкой.
    • Если в очереди установлен ContentBasedDeduplication, ваш MessageDeduplicationId переопределит сгенерированный.
  • Когда ContentBasedDeduplication в действии, сообщения с идентичным содержимым, отправленные в течение интервала дублирования, обрабатываются как дубликаты, и только одна копия сообщения доставляется.
  • Если вы отправили одно сообщение с включенным ContentBasedDeduplication, а затем другое сообщение с MessageDeduplicationId, которое такое же, как сгенерированное для первого MessageDeduplicationId, оба сообщения обрабатываются как дубликаты, и только одна копия сообщения доставляется.

Следующие атрибуты применяются только к высокой пропускной способности для очередей FIFO:

• DeduplicationScope – Указывает, происходит ли дублирование сообщений на уровне группы сообщений или очереди. Допустимые значения: messageGroup и queue.
• FifoThroughputLimit – Указывает, применяется ли квота пропускной способности очереди FIFO к всей очереди или по группам сообщений. Допустимые значения: perQueue и perMessageGroupId. Значение perMessageGroupId допускается только когда значение для DeduplicationScope равно messageGroup.

Для включения высокой пропускной способности для очередей FIFO выполните следующие действия:

• Установите DeduplicationScope в значение messageGroup.
• Установите FifoThroughputLimit в значение perMessageGroupId.

Если вы установите эти атрибуты на значения, отличные от показанных для включения высокой пропускной способности, то действует обычная пропускная способность, а дублирование происходит как указано.

Информация о квотах пропускной способности см. в разделе Квоты, связанные с сообщениями, в руководстве разработчика Amazon SQS.

ключ -> (строка)

значение -> (строка)