CreateStream
Статья создана
Обновлена 24 августа 2021 г.
Создает поток данных.
При успехе метод инициирует создание потока, переводит создаваемый поток в статус 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 |
Могут возникать ошибки, общие для всех методов.