Spec-Zone.ru › AWS CLI v2

[ aws . keyspaces ]

восстановление-таблицы

Описание

Восстанавливает таблицу до указанной точки во времени в пределах 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 (метка времени)

Метка времени восстановления в формате ISO 8601.

--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 -> (строка)

Amazon Resource Name (ARN) управляемого пользователем ключа KMS, например 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=ENABLED
  • status=DISABLED

Если не указано, используется значение по умолчанию status=DISABLED.

Для получения дополнительной информации см. Восстановление в определённый момент времени в руководстве разработчика Amazon Keyspaces.

status -> (строка)

Доступные варианты:

  • status=ENABLED
  • status=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 -> (строка)

Ключ тега. Ключи тегов чувствительны к регистру. Каждый ресурс Amazon Keyspaces может иметь не более одного тега с одинаковым ключом. Если вы пытаетесь добавить существующий тег (с тем же ключом), значение существующего тега будет обновлено на новое значение.

value -> (строка)

Значение тега. Значения тегов чувствительны к регистру и могут быть null.

Сокращенная запись:

key=string,value=string ...

Формат JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--auto-scaling-specification (структура)

Дополнительные параметры автоматического масштабирования для восстановленной таблицы в режиме выделенной пропускной способности. Указывает, может ли служба управлять пропускной способностью выделенной таблицы автоматически от вашего имени. Автоматическое масштабирование Amazon Keyspaces помогает эффективно выделять пропускную способность для изменяющихся рабочих нагрузок, автоматически увеличивая и уменьшая пропускную способность чтения и записи вашей таблицы в ответ на трафик приложения.

Для получения дополнительной информации см. Управление пропускной способностью автоматически с помощью автоматического масштабирования Amazon Keyspaces в руководстве разработчика Amazon Keyspaces.

writeCapacityAutoScaling -> (структура)

Настройки автоматического масштабирования для пропускной способности записи таблицы.

autoScalingDisabled -> (булево)

Этот необязательный параметр включает автоматическое масштабирование для таблицы, если он равен false.

minimumUnits -> (целое число)

Минимальный уровень пропускной способности, который таблица всегда должна поддерживать. Значение должно быть между 1 и максимальным квотой пропускной способности в секунду для вашего аккаунта (по умолчанию 40 000).

maximumUnits -> (целое число)

Управляйте затратами, указав максимальное количество пропускной способности для выделения. Значение должно быть между 1 и максимальной квотой пропускной способности в секунду для вашего аккаунта (по умолчанию 40 000).

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 -> (целое число)

Минимальный уровень пропускной способности, который таблица всегда должна поддерживать. Значение должно быть между 1 и максимальным квотой пропускной способности в секунду для вашего аккаунта (по умолчанию 40 000).

maximumUnits -> (целое число)

Управляйте затратами, указав максимальное количество пропускной способности для выделения. Значение должно быть между 1 и максимальной квотой пропускной способности в секунду для вашего аккаунта (по умолчанию 40 000).

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 -> (строка)

Регион Amazon Web Services.

readCapacityUnits -> (целое число)

Предоставленные единицы пропускной способности чтения для таблицы в нескольких регионах в указанном регионе Amazon Web Services.

readCapacityAutoScaling -> (структура)

Настройки автоматического масштабирования пропускной способности чтения для таблицы в нескольких регионах в указанном регионе Amazon Web Services.

autoScalingDisabled -> (булево)

Этот необязательный параметр включает автоматическое масштабирование для таблицы, если он установлен в значение false.

minimumUnits -> (целое число)

Минимальный уровень пропускной способности, который таблица всегда должна быть готова поддерживать. Значение должно быть между 1 и максимальным квотой пропускной способности в секунду для вашей учетной записи (по умолчанию 40 000).

maximumUnits -> (целое число)

Управляйте затратами, указав максимальное количество пропускной способности для предоставления. Значение должно быть между 1 и максимальной квотой пропускной способности в секунду для вашей учетной записи (по умолчанию 40 000).

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 -> (строка)

Amazon Resource Name (ARN) восстановленной таблицы.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API