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. CreateStream

CreateStream

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

Создает поток данных.

При успехе метод инициирует создание потока, переводит создаваемый поток в статус CREATING и возвращает HTTP-ответ с кодом 200. Операции чтения и записи возможны только для потока в статусе ACTIVE. Чтобы узнать статус потока, используйте метод DescribeStream.

При попытке создать больше потоков, чем установлено квотой для вашей учетной записи, запрос вернет ошибку LimitExceededException.

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

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

{
  "StreamName": "string",
  "ShardCount": number,
  "WriteQuotaKbPerSec": number,
  "RetentionPeriodHours": number
}

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

Параметр Описание
StreamName Имя создаваемого потока данных.

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

Тип: Целое число
Минимальное значение: 1.
Обязательный: Да
WriteQuotaKbPerSec Ограничение на запись в поток данных, КБ/с.

Тип: Целое число
Возможные значения: 128, 512, 1024.
Обязательный: Нет
RetentionPeriodHours Время хранения сообщений, часы.

Тип: Целое число
Возможные значения 4, 12, 24.
Обязательный: Нет

ОтветОтвет

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

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

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

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

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

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