восстановление-таблицы
Описание
Восстанавливает таблицу до указанной точки во времени в пределах earliest_restorable_timestamp и текущего времени. Дополнительную информацию о точках восстановления см. в разделе "Окно времени для непрерывных резервных копий PITR" в Руководстве разработчика Amazon Keyspaces.
Любое количество пользователей может выполнить до 4 одновременных восстановлений (любого типа) в данном аккаунте.
При восстановлении с помощью восстановления по состоянию на определенное время Amazon Keyspaces восстанавливает схему и данные исходной таблицы в состояние, соответствующее выбранной метке времени (day:hour:minute:second), в новую таблицу. Также восстанавливаются настройки Time to Live (TTL) в состоянии, соответствующем выбранной метке времени.
В дополнение к схеме, данным и настройкам TTL таблицы, RestoreTable восстанавливает режим емкости, настройки автоматического масштабирования, настройки шифрования и настройки восстановления по состоянию на определенное время из исходной таблицы. В отличие от схемы, данных и настроек TTL таблицы, которые восстанавливаются на основе выбранной метки времени, эти настройки всегда восстанавливаются на основе настроек таблицы на момент текущего времени или момента удаления таблицы.
Вы также можете перезаписать эти настройки во время восстановления:
- Режим емкости чтения/записи
- Зарезервированные единицы пропускной способности
- Настройки автоматического масштабирования
- Настройки восстановления по состоянию на определенное время (PITR)
- Теги
Дополнительную информацию см. в разделе Настройки восстановления PITR в Руководстве разработчика Amazon Keyspaces.
Обратите внимание, что следующие настройки не восстанавливаются, и их необходимо настроить вручную для новой таблицы:
- Политики управления доступом и идентификацией (IAM)
- Метрики и оповещения Amazon CloudWatch
См. также: Документация API AWS
Синтаксис
restore-table
--source-keyspace-name <value>
--source-table-name <value>
--target-keyspace-name <value>
--target-table-name <value>
[--restore-timestamp <value>]
[--capacity-specification-override <value>]
[--encryption-specification-override <value>]
[--point-in-time-recovery-override <value>]
[--tags-override <value>]
[--auto-scaling-specification <value>]
[--replica-specifications <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--source-keyspace-name (строка)
--source-table-name (строка)
--target-keyspace-name (строка)
--target-table-name (строка)
--restore-timestamp (метка времени)
--capacity-specification-override (структура)
Указывает режим пропускной способности чтения/записи для целевой таблицы. Доступные варианты:
throughputMode:PAY_PER_REQUEST-
throughputMode:PROVISIONED— Режим выделенной пропускной способности требуетreadCapacityUnitsиwriteCapacityUnitsв качестве входных данных.
По умолчанию используется throughput_mode:PAY_PER_REQUEST .
Для получения дополнительной информации см. режимы пропускной способности чтения/записи в руководстве разработчика Amazon Keyspaces.
throughputMode -> (строка)
Режим пропускной способности чтения/записи для таблицы. Доступные варианты:
-
throughputMode:PAY_PER_REQUESTи -
throughputMode:PROVISIONED— Режим выделенной пропускной способности требуетreadCapacityUnitsиwriteCapacityUnitsв качестве входных данных.
По умолчанию используется throughput_mode:PAY_PER_REQUEST .
Для получения дополнительной информации см. режимы пропускной способности чтения/записи в руководстве разработчика Amazon Keyspaces.
readCapacityUnits -> (целое число)
read, определённых в read capacity units (RCUs).writeCapacityUnits -> (целое число)
write, определённых в write capacity units (WCUs).Сокращенная запись:
throughputMode=string,readCapacityUnits=long,writeCapacityUnits=long
Формат JSON:
{
"throughputMode": "PAY_PER_REQUEST"|"PROVISIONED",
"readCapacityUnits": long,
"writeCapacityUnits": long
}
--encryption-specification-override (структура)
Указывает параметры шифрования для целевой таблицы. Вы можете выбрать один из следующих ключей KMS:
-
type:AWS_OWNED_KMS_KEY— Этот ключ принадлежит Amazon Keyspaces. -
type:CUSTOMER_MANAGED_KMS_KEY— Этот ключ хранится в вашем аккаунте и создаётся, принадлежит и управляется вами. Для этого варианта требуетсяkms_key_identifierключа KMS в формате Amazon Resource Name (ARN).
По умолчанию используется type:AWS_OWNED_KMS_KEY .
Для получения дополнительной информации см. Шифрование в состоянии покоя в руководстве разработчика Amazon Keyspaces.
type -> (строка)
Параметр шифрования, заданный для таблицы. Вы можете выбрать один из следующих ключей KMS:
-
type:AWS_OWNED_KMS_KEY— Этот ключ принадлежит Amazon Keyspaces. -
type:CUSTOMER_MANAGED_KMS_KEY— Этот ключ хранится в вашем аккаунте и создаётся, принадлежит и управляется вами. Для этого варианта требуетсяkms_key_identifierключа KMS в формате Amazon Resource Name (ARN).
По умолчанию используется type:AWS_OWNED_KMS_KEY .
Для получения дополнительной информации см. Шифрование в состоянии покоя в руководстве разработчика Amazon Keyspaces.
kmsKeyIdentifier -> (строка)
kms_key_identifier:ARN.Сокращенная запись:
type=string,kmsKeyIdentifier=string
Формат JSON:
{
"type": "CUSTOMER_MANAGED_KMS_KEY"|"AWS_OWNED_KMS_KEY",
"kmsKeyIdentifier": "string"
}
--point-in-time-recovery-override (структура)
Указывает параметры pointInTimeRecovery для целевой таблицы. Доступные варианты:
status=ENABLEDstatus=DISABLED
Если не указано, используется значение по умолчанию status=DISABLED.
Для получения дополнительной информации см. Восстановление в определённый момент времени в руководстве разработчика Amazon Keyspaces.
status -> (строка)
Доступные варианты:
status=ENABLEDstatus=DISABLED
Сокращенная запись:
status=string
Формат JSON:
{
"status": "ENABLED"|"DISABLED"
}
--tags-override (список)
Список тегов в формате ключ-значение, которые будут прикреплены к восстановленной таблице.
Для получения дополнительной информации см. Добавление тегов и меток к ресурсам Amazon Keyspaces в руководстве разработчика Amazon Keyspaces.
(структура)
Описание тега. Тег — это пара ключ-значение. Вы можете добавить до 50 тегов к одному ресурсу Amazon Keyspaces.
Названия и значения тегов, назначенные Amazon Web Services, автоматически получают префикс aws:, который пользователь не может назначить. Названия тегов, назначенные Amazon Web Services, не учитываются при подсчёте лимита тегов (50). Названия пользовательских тегов имеют префикс user: в отчёте об распределении затрат. Применить тег невозможно с обратной силой.
Для получения дополнительной информации см. Добавление тегов и меток к ресурсам Amazon Keyspaces в руководстве разработчика Amazon Keyspaces.
key -> (строка)
value -> (строка)
Сокращенная запись:
key=string,value=string ...
Формат JSON:
[
{
"key": "string",
"value": "string"
}
...
]
--auto-scaling-specification (структура)
Дополнительные параметры автоматического масштабирования для восстановленной таблицы в режиме выделенной пропускной способности. Указывает, может ли служба управлять пропускной способностью выделенной таблицы автоматически от вашего имени. Автоматическое масштабирование Amazon Keyspaces помогает эффективно выделять пропускную способность для изменяющихся рабочих нагрузок, автоматически увеличивая и уменьшая пропускную способность чтения и записи вашей таблицы в ответ на трафик приложения.
Для получения дополнительной информации см. Управление пропускной способностью автоматически с помощью автоматического масштабирования Amazon Keyspaces в руководстве разработчика Amazon Keyspaces.
writeCapacityAutoScaling -> (структура)
Настройки автоматического масштабирования для пропускной способности записи таблицы.
autoScalingDisabled -> (булево)
false.minimumUnits -> (целое число)
maximumUnits -> (целое число)
scalingPolicy -> (структура)
Amazon Keyspaces поддерживает политику автоматического масштабирования target tracking. С помощью этой политики Amazon Keyspaces автоматического масштабирования обеспечивает, что отношение потребляемой к выделенной пропускной способности таблицы сохраняется на целевом значении, которое вы указываете. Вы определяете целевое значение как процент от 20 до 90.
targetTrackingScalingPolicyConfiguration -> (структура)
Автоматическое масштабирование автоматически увеличивает пропускную способность, когда трафик превышает эту целевую скорость использования, и уменьшает её, когда он падает ниже целевого значения. Процент между 20 и 90.
disableScaleIn -> (булево)
Указывает, включено ли scale-in.
При автоматическом уменьшении пропускной способности для таблицы таблица уменьшается. При установке политик масштабирования они не могут уменьшить таблицу ниже её минимальной пропускной способности.
scaleInCooldown -> (целое число)
Указывает scale-in период ожидания.
Период ожидания в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед запуском другой операции масштабирования.
scaleOutCooldown -> (целое число)
Указывает период ожидания увеличения масштаба.
Период ожидания в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед запуском другой операции масштабирования.
targetValue -> (дробное число)
Указывает целевое значение для политики автоматического масштабирования с отслеживанием целевых значений.
Автоматическое масштабирование Amazon Keyspaces автоматически увеличивает пропускную способность, когда трафик превышает эту целевую скорость использования, и уменьшает её, когда он падает ниже целевого значения. Это гарантирует, что отношение потребляемой пропускной способности к выделенной пропускной способности находится на этом значении. Вы определяете targetValue как процент. double значение между 20 и 90.
readCapacityAutoScaling -> (структура)
Настройки автоматического масштабирования для пропускной способности чтения таблицы.
autoScalingDisabled -> (булево)
false.minimumUnits -> (целое число)
maximumUnits -> (целое число)
scalingPolicy -> (структура)
Amazon Keyspaces поддерживает политику автоматического масштабирования target tracking. С помощью этой политики Amazon Keyspaces автоматического масштабирования обеспечивает, что отношение потребляемой к выделенной пропускной способности таблицы сохраняется на целевом значении, которое вы указываете. Вы определяете целевое значение как процент от 20 до 90.
targetTrackingScalingPolicyConfiguration -> (структура)
Автоматическое масштабирование автоматически увеличивает пропускную способность, когда трафик превышает эту целевую скорость использования, и уменьшает её, когда он падает ниже целевого значения. Процент между 20 и 90.
disableScaleIn -> (булево)
Указывает, включено ли scale-in.
При автоматическом уменьшении пропускной способности для таблицы таблица уменьшается. При установке политик масштабирования они не могут уменьшить таблицу ниже её минимальной пропускной способности.
scaleInCooldown -> (целое число)
Указывает scale-in период ожидания.
Период ожидания в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед запуском другой операции масштабирования.
scaleOutCooldown -> (целое число)
Указывает период ожидания увеличения масштаба.
Период ожидания в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед запуском другой операции масштабирования.
targetValue -> (дробное число)
Указывает целевое значение для политики автоматического масштабирования с отслеживанием целевых значений.
Автоматическое масштабирование Amazon Keyspaces автоматически увеличивает пропускную способность, когда трафик превышает эту целевую скорость использования, и уменьшает её, когда он падает ниже целевого значения. Это гарантирует, что отношение потребляемой пропускной способности к выделенной пропускной способности находится на этом значении. Вы определяете targetValue как процент. double значение между 20 и 90.
Формат JSON:
{
"writeCapacityAutoScaling": {
"autoScalingDisabled": true|false,
"minimumUnits": long,
"maximumUnits": long,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": true|false,
"scaleInCooldown": integer,
"scaleOutCooldown": integer,
"targetValue": double
}
}
},
"readCapacityAutoScaling": {
"autoScalingDisabled": true|false,
"minimumUnits": long,
"maximumUnits": long,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": true|false,
"scaleInCooldown": integer,
"scaleOutCooldown": integer,
"targetValue": double
}
}
}
}
--replica-specifications (список)
Дополнительные параметры региона для таблицы в нескольких регионах.
(структура)
Параметры региона Amazon Web Services для таблицы в нескольких регионах.
Для таблицы в нескольких регионах вы можете настроить пропускную способность чтения по-разному для каждого региона Amazon Web Services. Это делается путем настройки следующих параметров.
-
region: Регион, к которому применяются эти настройки. (Обязательно) -
readCapacityUnits: Предоставленные единицы пропускной способности чтения. (Необязательно) -
readCapacityAutoScaling: Настройки автоматического масштабирования пропускной способности чтения для таблицы. (Необязательно)
region -> (строка)
readCapacityUnits -> (целое число)
readCapacityAutoScaling -> (структура)
Настройки автоматического масштабирования пропускной способности чтения для таблицы в нескольких регионах в указанном регионе Amazon Web Services.
autoScalingDisabled -> (булево)
false.minimumUnits -> (целое число)
maximumUnits -> (целое число)
scalingPolicy -> (структура)
Amazon Keyspaces поддерживает политику target tracking автоматического масштабирования. С этой политикой Amazon Keyspaces автоматически масштабирует пропускную способность, чтобы отношение потребленной к предоставленной пропускной способности оставалось на или близко к целевому значению, которое вы укажете. Вы определяете целевое значение как процентное значение между 20 и 90.
targetTrackingScalingPolicyConfiguration -> (структура)
Автоматическое масштабирование увеличивает пропускную способность автоматически, когда трафик превышает эту целевую скорость использования, а затем уменьшает ее, когда он падает ниже целевого значения. Значение должно быть между 20 и 90.
disableScaleIn -> (булево)
Указывает, включена ли функция scale-in.
При автоматическом уменьшении пропускной способности для таблицы таблица уменьшает масштабирование. Когда политики масштабирования установлены, они не позволяют уменьшить масштаб таблицы ниже ее минимальной пропускной способности.
scaleInCooldown -> (целое число)
Указывает период охлаждения scale-in.
Период охлаждения в секундах между действиями масштабирования, позволяющий таблице стабилизироваться перед началом другого действия масштабирования.
scaleOutCooldown -> (целое число)
Указывает период охлаждения для увеличения масштаба.
Период охлаждения в секундах между действиями масштабирования, позволяющий таблице стабилизироваться перед началом другого действия масштабирования.
targetValue -> (двойное число)
Указывает целевое значение для политики автоматического масштабирования по отслеживанию цели.
Amazon Keyspaces автоматически увеличивает пропускную способность, когда трафик превышает эту целевую скорость использования, и затем уменьшает ее, когда он падает ниже целевого значения. Это гарантирует, что отношение потребленной пропускной способности к предоставленной пропускной способности остается на или близко к этому значению. Вы определяете targetValue как процентное значение. Значение должно быть между 20 и 90.
Синтаксис JSON:
[
{
"region": "string",
"readCapacityUnits": long,
"readCapacityAutoScaling": {
"autoScalingDisabled": true|false,
"minimumUnits": long,
"maximumUnits": long,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": true|false,
"scaleInCooldown": integer,
"scaleOutCooldown": integer,
"targetValue": double
}
}
}
}
...
]
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет интерпретирована буквально. Это может не быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если не указано значение или указано значение input, выводит JSON-входной образец, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет образец входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, он проверит входные данные команды и вернёт JSON-образец выходных данных для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (булево)
Включить отладку регистрации.
--endpoint-url (строка)
Переопределить стандартный URL команды указанным URL.
--no-verify-ssl (булево)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (булево)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команд.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла аутентификации.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/отключить цветной вывод.
- включить
- выключить
- автоматически
--no-sign-request (булево)
Не подписывать запросы. Кредиты не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Пакет сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла непосредственно независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (булево)
Отключить кли-пейджер для вывода.
--cli-auto-prompt (булево)
Автоматически запрашивать параметры входных данных CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросы параметров входных данных CLI.
Вывод
restoredTableARN -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.