DeleteStream
Удаляет поток, все его сегменты и данные.
При успехе метод инициирует удаление потока, переводит создаваемый поток в статус DELETING
и возвращает HTTP-ответ с кодом 200.
Удалить поток можно, только если он находится в статусе ACTIVE
.
Поток будет находиться в статусе DELETING
, пока Data Streams не завершит удаление. Поток данных в статусе DELETING
может продолжать обрабатывать операции чтения и записи данных, такие как PutRecord
, PutRecords
и GetRecords
до завершения удаления. Чтобы узнать статус потока, используйте метод DescribeStream.
Если приложение обратится к удаленному потоку, оно получит ошибку ResourceNotFoundException
.
Запрос
Запрос содержит данные в формате JSON.
{
"EnforceConsumerDeletion": boolean,
"StreamName": "string"
}
Параметры запроса
Параметр | Описание |
---|---|
EnforceConsumerDeletion |
Если этот параметр не задан или имеет значение false и у потока есть зарегистрированные потребители, то поток не удаляется, возвращается ошибка ResourceInUseException .Тип: Булев Обязательный: Нет |
StreamName |
Имя потока данных. Тип: Строка Размер: 1 -128 символов.Возможные значения: [a-zA-Z][a-zA-Z0-9-]+*(?<!-)$ Обязательный: Да |
Ответ
В случае успеха возвращается ответ с кодом HTTP 200 и пустым телом.
Ошибки
Параметр | Описание | Код HTTP |
---|---|---|
LimitExceededException |
Превышено максимальное число запросов. | 400 |
ResourceInUseException |
Ресурс используется другой операцией. | 400 |
ResourceNotFoundException |
Запрошенный ресурс не найден. | 400 |
Могут возникать ошибки, общие для всех методов.