Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Data Streams
  • Управление доступом
  • Правила тарификации
    • Обзор
    • Все методы
      • CreateStream
      • DecreaseStreamRetentionPeriod
      • DeleteStream
      • DescribeStream
      • IncreaseStreamRetentionPeriod
      • GetRecords
      • GetShardIterator
      • ListStreams
      • PutRecord
      • PutRecords
      • UpdateShardCount
    • Общие ошибки
    • Примеры
  • Вопросы и ответы

В этой статье:

  • Запрос
  • Параметры запроса
  • Ответ
  • Параметры ответа
  • Ошибки
  1. HTTP API, совместимый с Amazon Kinesis Data Streams
  2. Методы
  3. UpdateShardCount

UpdateShardCount

Статья создана
Yandex Cloud
Обновлена 23 сентября 2021 г.
Открыть в Markdown
  • Запрос
    • Параметры запроса
  • Ответ
    • Параметры ответа
  • Ошибки

Обновляет количество сегментов указанного потока данных. Доступно только увеличение числа сегментов.

При успехе метод переводит поток в статус UPDATING и возвращает HTTP-ответ с кодом 200 и данные в формате JSON. После завершения обновления поток будет переведен в статус ACTIVE. Время масштабирования зависит от размера потока и может занять несколько минут. Можно продолжать читать данные из потока и записывать данные в поток в статусе UPDATING.

ЗапросЗапрос

Запрос содержит данные в формате JSON.

{
  "ScalingType": "string",
  "StreamName": "string",
  "TargetShardCount": number
}

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

Параметр Описание
ScalingType Тип масштабирования. Масштабирование UNIFORM_SCALING создает сегменты одинакового размера.

Тип: Строка
Возможные значения: UNIFORM_SCALING
Обязательный: Да
StreamName Имя потока данных.

Тип: Строка
Размер: 1-128 символов.
Возможные значения: [a-zA-Z][a-zA-Z0-9-]+*(?<!-)$
Обязательный: Да
TargetShardCount Целевое количество сегментов.

Тип: Целое число
Минимальное значение: 1
Обязательный: Да

ОтветОтвет

В случае успеха возвращаются HTTP-ответ с кодом 200 и данные в формате JSON.

{
  "CurrentShardCount": number,
  "StreamName": "string",
  "TargetShardCount": number
}

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

Параметр Описание
CurrentShardCount Текущее количество сегментов.

Тип: Целое число
Минимальное значение: 1
Обязательный: Да
StreamName Имя потока данных.

Тип: Строка
Размер: 1-128 символов.
Возможные значения: [a-zA-Z][a-zA-Z0-9-]+*(?<!-)$
Обязательный: Да
TargetShardCount Целевое количество сегментов.

Тип: Целое число
Минимальное значение: 1
Обязательный: Да

ОшибкиОшибки

Параметр Описание Код HTTP
InvalidArgumentException Недопустимый аргумент. Дополнительные сведения смотрите в сообщении об ошибке. 400
LimitExceededException Превышено максимальное число запросов. 400
ResourceInUseException Ресурс используется другой операцией. 400
ResourceNotFoundException Запрошенный ресурс не найден. 400

Могут возникать ошибки, общие для всех методов.

Была ли статья полезна?

Предыдущая
PutRecords
Следующая
Общие ошибки
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»