Метод UpdateTimeToLive
Включает или отключает TTL для указанной таблицы.
В случае успеха возвращает текущее значение TimeToLiveSpecification. Операция может длиться до часа. Дополнительные вызовы метода для одной и той же таблицы будут возвращать ошибку ValidationException, пока операция не завершится.
Механизм проверки TTL сравнивает текущее время в формате Unix time со временем, которое хранится в TTL-атрибуте элемента. Если оно меньше текущего времени, элемент помечается как устаревший и впоследствии удаляется.
Элементы с истекшим TTL обычно удаляются в течение двух дней, время удаления зависит от характера рабочей нагрузки. Устаревшие, но еще не удаленные элементы отображаются при чтении, запросе и сканировании. При удалении элементов из таблицы они немедленно удаляются из локального и глобального вторичного индекса так же, как и при стандартной операции удаления.
Устаревшие элементы удаляются так, чтобы обеспечить достаточную пропускную способность для других операций с данными.
Запрос
Запрос содержит данные в формате JSON.
{
"TableName": "string",
"TimeToLiveSpecification": {
"AttributeName": "string",
"Enabled": boolean
}
}
Параметры
| Параметр | Описание |
|---|---|
TableName |
Имя таблицы, для которой включается или отключается TTL. Может содержать путь в иерархии каталогов вида path/to/table. Тип: Строка Длина: 3 - 255 символов. Шаблон: [a-zA-Z0-9_.-]+ Обязательно: Да |
TimeToLiveSpecification |
Параметры, используемые для включения или отключения TTL для указанной таблицы. Тип: Объект типа TimeToLiveSpecification.Обязательно: Да |
Ответ
В случае успеха вернется HTTP с кодом 200.
Запрос возвращает данные в формате JSON.
{
"TimeToLiveSpecification": {
"AttributeName": "string",
"Enabled": boolean
}
}
Параметры
| Параметр | Описание |
|---|---|
TimeToLiveSpecification |
Результат операции. Тип: Объект типа TimeToLiveSpecification. |
Ошибки
| Параметр | Описание |
|---|---|
InternalServerError |
Произошла внутренняя ошибка на стороне сервера. Код состояния HTTP: 500 |
LimitExceededException |
Превышен лимит операций над таблицами. Одновременно допускается до 50 операций над таблицами, включая CreateTable, UpdateTable, DeleteTable, UpdateTimeToLive, RestoreTableFromBackup, и RestoreTableToPointInTime.Код состояния HTTP: 400 |
ResourceInUseException |
Ресурс используется другой операцией. Код состояния HTTP: 400 |
ResourceNotFoundException |
Указанная таблица не существует или находится в состоянии не ACTIVE.Код состояния HTTP: 400 |
Также могут возникать Общие ошибки, одинаковые для всех методов.