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 |
Могут возникать ошибки, общие для всех методов.