Spec-Zone.ru › AWS CLI v2

[ aws . dynamodb ]

восстановление-таблицы-из-резервной-копии

Описание

Создает новую таблицу из существующей резервной копии. Любое количество пользователей может выполнить до 50 одновременных восстановлений (любого типа) в данном аккаунте.

Вы можете вызывать RestoreTableFromBackup не чаще, чем 10 раз в секунду.

Вы должны вручную настроить следующее для восстановленной таблицы:

  • Политики автоматического масштабирования
  • Политики IAM
  • Метрики и тревоги Amazon CloudWatch
  • Теги
  • Настройки потока
  • Настройки Time to Live (TTL)

См. также: Документация API AWS

Синтаксис

  restore-table-from-backup
--target-table-name <value>
--backup-arn <value>
[--billing-mode-override <value>]
[--global-secondary-index-override <value>]
[--local-secondary-index-override <value>]
[--provisioned-throughput-override <value>]
[--on-demand-throughput-override <value>]
[--sse-specification-override <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]

Параметры

--target-table-name (строка)

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

--backup-arn (строка)

Amazon Resource Name (ARN), связанный с резервной копией.

--billing-mode-override (строка)

Режим выставления счетов для восстановленной таблицы.

Возможные значения:

  • PROVISIONED
  • PAY_PER_REQUEST

--global-secondary-index-override (список)

Список глобальных вторичных индексов для восстановленной таблицы. Индексы должны соответствовать существующим вторичным индексам. Вы можете выбрать, какие индексы исключить при восстановлении.

(структура)

Представляет свойства глобального вторичного индекса.

IndexName -> (строка)

Имя глобального вторичного индекса. Имя должно быть уникальным среди всех других индексов в этой таблице.

KeySchema -> (список)

Полная схема ключей для глобального вторичного индекса, состоящая из одной или нескольких пар имён атрибутов и типов ключей:

  • HASH - первичный ключ
  • RANGE - сортировочный ключ

Примечание

Первичный ключ элемента также известен как атрибут хэширования. Термин «атрибут хэширования» происходит от использования DynamoDB внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений их первичного ключа.

Сортировочный ключ элемента также известен как атрибут диапазона. Термин «атрибут диапазона» происходит от способа хранения DynamoDB элементов с одинаковым первичным ключом физически близко друг к другу в отсортированном порядке по значению сортировочного ключа.

(структура)

Представляет один элемент схемы ключей. Схема ключей определяет атрибуты, составляющие первичный ключ таблицы или ключевые атрибуты индекса.

Один KeySchemaElement представляет ровно один атрибут первичного ключа. Например, простой первичный ключ будет представлен одним KeySchemaElement (для первичного ключа). Сложный первичный ключ потребует одного KeySchemaElement для первичного ключа и другого KeySchemaElement для сортировочного ключа.

KeySchemaElement должен быть скалярным атрибутом верхнего уровня (не вложенный атрибут). Тип данных должен быть одним из String, Number или Binary. Атрибут не может быть вложен в список или карту.

AttributeName -> (строка)

Имя атрибута ключа.

KeyType -> (строка)

Роль, которую этот атрибут ключа будет выполнять:

  • HASH - первичный ключ
  • RANGE - сортировочный ключ

Примечание

Первичный ключ элемента также известен как атрибут хэширования. Термин «атрибут хэширования» происходит от использования DynamoDB внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений их первичного ключа.

Сортировочный ключ элемента также известен как атрибут диапазона. Термин «атрибут диапазона» происходит от способа хранения DynamoDB элементов с одинаковым первичным ключом физически близко друг к другу в отсортированном порядке по значению сортировочного ключа.

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

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

ProjectionType -> (строка)

Набор атрибутов, которые проектируются в индекс:

  • KEYS_ONLY - Проектируются только ключи индекса и первичные ключи.
  • INCLUDE - В дополнение к атрибутам, описанным в KEYS_ONLY , вторичный индекс будет включать другие атрибуты, которые вы укажете.
  • ALL - Все атрибуты таблицы проектируются в индекс.

При использовании консоли DynamoDB ALL выбрано по умолчанию.

NonKeyAttributes -> (список)

Представляет имена атрибутов, не являющихся ключами, которые будут спроектированы в индекс.

Для глобальных и локальных вторичных индексов суммарное количество NonKeyAttributes по всем вторичным индексам не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это засчитывается как два разных атрибута при определении общего количества. Это ограничение применяется только в том случае, если вы задаёте ProjectionType INCLUDE . Вы по-прежнему можете указать ProjectionType ALL для проекции всех атрибутов из исходной таблицы, даже если таблица имеет более 100 атрибутов.

(строка)

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

Представляет параметры пропускной способности с предварительной резервацией для указанного глобального вторичного индекса. Вы должны использовать либо OnDemandThroughput , либо ProvisionedThroughput в зависимости от режима емкости вашей таблицы.

Для текущих минимальных и максимальных значений пропускной способности с предварительной резервацией см. Раздел «Квоты службы, аккаунта и таблицы» в «Руководстве разработчика Amazon DynamoDB».

ReadCapacityUnits -> (целое)

Максимальное количество чтений с сильной консистенцией, потребляемых в секунду, прежде чем DynamoDB вернёт ThrottlingException . Дополнительную информацию см. в разделе «Определение требований к чтению и записи» в «Руководстве разработчика Amazon DynamoDB».

Если режим пропускной способности чтения/записи PAY_PER_REQUEST, значение устанавливается в 0.

WriteCapacityUnits -> (целое)

Максимальное количество записей, потребляемых в секунду, прежде чем DynamoDB вернёт ThrottlingException . Дополнительную информацию см. в разделе «Определение требований к чтению и записи» в «Руководстве разработчика Amazon DynamoDB».

Если режим пропускной способности чтения/записи PAY_PER_REQUEST, значение устанавливается в 0.

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

Максимальное количество единиц чтения и записи для указанного глобального вторичного индекса. Если вы используете этот параметр, вы должны указать MaxReadRequestUnits , MaxWriteRequestUnits или оба. Вы должны использовать либо OnDemandThroughput , либо ProvisionedThroughput в зависимости от режима емкости вашей таблицы.

MaxReadRequestUnits -> (целое)

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

Чтобы указать максимальное значение OnDemandThroughput для вашей таблицы, установите значение MaxReadRequestUnits как больше или равно 1. Чтобы удалить установленное максимальное значение OnDemandThroughput вашей таблицы, установите значение MaxReadRequestUnits в -1.

MaxWriteRequestUnits -> (целое)

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

Чтобы указать максимальное значение OnDemandThroughput для вашей таблицы, установите значение MaxWriteRequestUnits как больше или равно 1. Чтобы удалить установленное максимальное значение OnDemandThroughput вашей таблицы, установите значение MaxWriteRequestUnits в -1.

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

Представляет значение тёплой пропускной способности (в единицах чтения в секунду и единицах записи в секунду) для указанного вторичного индекса. Если вы используете этот параметр, вы должны указать ReadUnitsPerSecond , WriteUnitsPerSecond или оба.

ReadUnitsPerSecond -> (целое)

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

WriteUnitsPerSecond -> (целое)

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

Сокращенный синтаксис:

IndexName=string,KeySchema=[{AttributeName=string,KeyType=string},{AttributeName=string,KeyType=string}],Projection={ProjectionType=string,NonKeyAttributes=[string,string]},ProvisionedThroughput={ReadCapacityUnits=long,WriteCapacityUnits=long},OnDemandThroughput={MaxReadRequestUnits=long,MaxWriteRequestUnits=long},WarmThroughput={ReadUnitsPerSecond=long,WriteUnitsPerSecond=long} ...

Синтаксис JSON:

[
  {
    "IndexName": "string",
    "KeySchema": [
      {
        "AttributeName": "string",
        "KeyType": "HASH"|"RANGE"
      }
      ...
    ],
    "Projection": {
      "ProjectionType": "ALL"|"KEYS_ONLY"|"INCLUDE",
      "NonKeyAttributes": ["string", ...]
    },
    "ProvisionedThroughput": {
      "ReadCapacityUnits": long,
      "WriteCapacityUnits": long
    },
    "OnDemandThroughput": {
      "MaxReadRequestUnits": long,
      "MaxWriteRequestUnits": long
    },
    "WarmThroughput": {
      "ReadUnitsPerSecond": long,
      "WriteUnitsPerSecond": long
    }
  }
  ...
]

--local-secondary-index-override (список)

Список локальных вторичных индексов для восстановленной таблицы. Предоставленные индексы должны соответствовать существующим вторичным индексам. Вы можете выбрать исключить некоторые или все индексы во время восстановления.

(структура)

Представляет свойства локального вторичного индекса.

IndexName -> (строка)

Имя локального вторичного индекса. Имя должно быть уникальным среди всех других индексов в этой таблице.

KeySchema -> (список)

Полная схема ключа для локального вторичного индекса, состоящая из одной или нескольких пар имен атрибутов и типов ключей:

  • HASH - ключ разбиения
  • RANGE - ключ сортировки

Примечание

Ключ разбиения элемента также известен как его атрибут хэширования. Термин «атрибут хэширования» происходит от использования DynamoDB внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений ключа разбиения.

Ключ сортировки элемента также известен как его атрибут диапазона. Термин «атрибут диапазона» происходит от способа хранения DynamoDB элементов с одинаковым ключом разбиения физически рядом, в отсортированном порядке по значению ключа сортировки.

(структура)

Представляет один элемент схемы ключа. Схема ключа определяет атрибуты, составляющие первичный ключ таблицы или ключевые атрибуты индекса.

KeySchemaElement представляет ровно один атрибут первичного ключа. Например, простой первичный ключ будет представлен одним KeySchemaElement (для ключа разбиения). Составной первичный ключ потребовал бы один KeySchemaElement для ключа разбиения и другой KeySchemaElement для ключа сортировки.

KeySchemaElement должен быть скалярным атрибутом верхнего уровня (не вложенным атрибутом). Тип данных должен быть строкой, числом или двоичным. Атрибут не может быть вложен в список или карту.

AttributeName -> (строка)

Имя ключевого атрибута.

KeyType -> (строка)

Роль, которую этот ключевой атрибут будет выполнять:

  • HASH - ключ разбиения
  • RANGE - ключ сортировки

Примечание

Ключ разбиения элемента также известен как его атрибут хэширования. Термин «атрибут хэширования» происходит от использования DynamoDB внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений ключа разбиения.

Ключ сортировки элемента также известен как его атрибут диапазона. Термин «атрибут диапазона» происходит от способа хранения DynamoDB элементов с одинаковым ключом разбиения физически рядом, в отсортированном порядке по значению ключа сортировки.

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

Представляет атрибуты, которые копируются (проектируются) из таблицы в локальный вторичный индекс. Они дополняют атрибуты первичного ключа и ключа индекса, которые автоматически проектируются.

ProjectionType -> (строка)

Набор атрибутов, которые проектируются в индекс:

  • KEYS_ONLY - Проектируются только индекс и первичные ключи.
  • INCLUDE - В дополнение к атрибутам, описанным в KEYS_ONLY, вторичный индекс будет содержать другие атрибуты, не являющиеся ключами, которые вы укажете.
  • ALL - Все атрибуты таблицы проектируются в индекс.

При использовании консоли DynamoDB ALL выбирается по умолчанию.

NonKeyAttributes -> (список)

Представляет имена атрибутов, не являющихся ключами, которые будут спроецированы в индекс.

Для глобальных и локальных вторичных индексов общее количество NonKeyAttributes, суммированное по всем вторичным индексам, не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это считается двумя различными атрибутами при определении общего количества. Это ограничение применяется только при указании ProjectionType INCLUDE. Вы по-прежнему можете указать ProjectionType ALL, чтобы спроецировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.

(строка)

Сокращенная синтаксическая конструкция:

IndexName=string,KeySchema=[{AttributeName=string,KeyType=string},{AttributeName=string,KeyType=string}],Projection={ProjectionType=string,NonKeyAttributes=[string,string]} ...

Синтаксис JSON:

[
  {
    "IndexName": "string",
    "KeySchema": [
      {
        "AttributeName": "string",
        "KeyType": "HASH"|"RANGE"
      }
      ...
    ],
    "Projection": {
      "ProjectionType": "ALL"|"KEYS_ONLY"|"INCLUDE",
      "NonKeyAttributes": ["string", ...]
    }
  }
  ...
]

--provisioned-throughput-override (структура)

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

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

Максимальное количество сильных согласованных чтений, потребляемых в секунду, прежде чем DynamoDB вернет ThrottlingException. Для получения дополнительной информации см. Раздел «Указание требований к чтению и записи» в руководстве разработчика Amazon DynamoDB.

Если режим пропускной способности для чтения/записи равен PAY_PER_REQUEST, значение устанавливается в 0.

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

Максимальное количество записей, потребляемых в секунду, прежде чем DynamoDB вернет ThrottlingException. Для получения дополнительной информации см. Раздел «Указание требований к чтению и записи» в руководстве разработчика Amazon DynamoDB.

Если режим пропускной способности для чтения/записи равен PAY_PER_REQUEST, значение устанавливается в 0.

Сокращенная синтаксическая конструкция:

ReadCapacityUnits=long,WriteCapacityUnits=long

Синтаксис JSON:

{
  "ReadCapacityUnits": long,
  "WriteCapacityUnits": long
}

--on-demand-throughput-override (структура)

Устанавливает максимальное количество единиц чтения и записи для указанной таблицы по запросу. Если вы используете этот параметр, вы должны указать MaxReadRequestUnits, MaxWriteRequestUnits или оба.

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

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

Для указания максимального OnDemandThroughput для вашей таблицы установите значение MaxReadRequestUnits как больше или равно 1. Чтобы удалить максимальное OnDemandThroughput, которое в настоящее время установлено для вашей таблицы, установите значение MaxReadRequestUnits в -1.

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

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

Чтобы указать максимальное OnDemandThroughput для вашей таблицы, установите значение MaxWriteRequestUnits как больше или равно 1. Чтобы удалить максимальное OnDemandThroughput, которое в настоящее время установлено для вашей таблицы, установите значение MaxWriteRequestUnits в -1.

Сокращенная синтаксическая конструкция:

MaxReadRequestUnits=long,MaxWriteRequestUnits=long

Синтаксис JSON:

{
  "MaxReadRequestUnits": long,
  "MaxWriteRequestUnits": long
}

--sse-specification-override (структура)

Новые параметры шифрования на стороне сервера для восстановленной таблицы.

Enabled -> (булево)

Указывает, выполняется ли шифрование на стороне сервера с использованием управляемого Amazon Web Services ключа или ключа Amazon Web Services. Если включено (true), тип шифрования на стороне сервера устанавливается в KMS и используется управляемый Amazon Web Services ключ (применяются сборы KMS). Если отключено (false) или не указано, шифрование на стороне сервера устанавливается в ключ Amazon Web Services.

SSEType -> (строка)

Тип шифрования на стороне сервера. Поддерживается только одно значение:

  • KMS - Шифрование на стороне сервера с использованием Key Management Service. Ключ хранится в вашем аккаунте и управляется KMS (применяются сборы KMS).

KMSMasterKeyId -> (строка)

Ключ KMS, который должен использоваться для шифрования KMS. Для указания ключа используйте его идентификатор ключа, Amazon Resource Name (ARN), имя псевдонима или ARN псевдонима. Обратите внимание, что этот параметр необходимо указывать только в случае, если ключ отличается от стандартного ключа DynamoDB alias/aws/dynamodb.

Сокращенная синтаксическая конструкция:

Enabled=boolean,SSEType=string,KMSMasterKeyId=string

Синтаксис JSON:

{
  "Enabled": true|false,
  "SSEType": "AES256"|"KMS",
  "KMSMasterKeyId": "string"
}

--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 (boolean)

Включить отладку.

--endpoint-url (string)

Переопределить URL команды на указанный URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение по умолчанию по проверке SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один запрос для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла аутентификации.

--region (string)

Использовать регион. Переопределяет настройки из конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/отключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Кредиты не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Файл с сертификатами CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаут. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаут. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Отключить пагинатор CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запроса параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, подобные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. Смотрите Использование кавычек со строками в Руководстве пользователя AWS CLI.

Восстановление таблицы DynamoDB из резервной копии

Следующий restore-table-from-backup пример восстанавливает указанную таблицу из резервной копии.

aws dynamodb restore-table-from-backup \
    --target-table-name MusicCollection \
    --backup-arnarn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01576616366715-b4e58d3a

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "Artist",
                "AttributeType": "S"
            },
            {
                "AttributeName": "SongTitle",
                "AttributeType": "S"
            }
        ],
        "TableName": "MusicCollection2",
        "KeySchema": [
            {
                "AttributeName": "Artist",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "SongTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": 1576618274.326,
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 5,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection2",
        "TableId": "114865c9-5ef3-496c-b4d1-c4cbdd2d44fb",
        "BillingModeSummary": {
            "BillingMode": "PROVISIONED"
        },
        "RestoreSummary": {
            "SourceBackupArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/backup/01576616366715-b4e58d3a",
            "SourceTableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection",
            "RestoreDateTime": 1576616366.715,
            "RestoreInProgress": true
        }
    }
}

Дополнительную информацию см. в разделе "Восстановление резервной копии DynamoDB по запросу" в Руководстве разработчика Amazon DynamoDB.

Вывод

ОписаниеТаблицы -> (структура)

Описание таблицы, созданной из существующей резервной копии.

ОпределенияАтрибутов -> (список)

Массив объектов AttributeDefinition. Каждый из этих объектов описывает один атрибут в таблице и схеме индекса ключей.

Каждый объект AttributeDefinition в этом массиве состоит из:

  • AttributeName - Название атрибута.
  • AttributeType - Тип данных для атрибута.

(структура)

Представляет атрибут для описания схемы таблицы и индексов.

ИмяАтрибута -> (строка)

Имя атрибута.

ТипАтрибута -> (строка)

Тип данных для атрибута, где:

  • S - атрибут имеет тип Строка
  • N - атрибут имеет тип Число
  • B - атрибут имеет тип Двоичные данные

ИмяТаблицы -> (строка)

Имя таблицы.

СхемаКлючей -> (список)

Структура первичного ключа таблицы. Каждый элемент KeySchemaElement состоит из:

  • AttributeName - Имя атрибута.
  • KeyType - Роль атрибута:
    • HASH - ключ разбиения
    • RANGE - ключ сортировки

Примечание

Ключ разбиения элемента также известен как атрибут хэширования. Термин «атрибут хэширования» происходит от использования DynamoDB внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений их ключа разбиения.

Ключ сортировки элемента также известен как атрибут диапазона. Термин «атрибут диапазона» происходит от способа, которым DynamoDB хранит элементы с одинаковым ключом разбиения физически близко друг к другу в отсортированном порядке по значению ключа сортировки.

Для получения дополнительной информации о первичных ключах см. раздел Первичный ключ в руководстве разработчика Amazon DynamoDB.

(структура)

Представляет один элемент схемы ключей. Схема ключей определяет атрибуты, составляющие первичный ключ таблицы или ключевые атрибуты индекса.

Элемент KeySchemaElement представляет ровно один атрибут первичного ключа. Например, простой первичный ключ будет представлен одним элементом KeySchemaElement (для ключа разбиения). Сложный первичный ключ потребует одного элемента KeySchemaElement для ключа разбиения и другого элемента KeySchemaElement для ключа сортировки.

Элемент KeySchemaElement должен быть скалярным атрибутом верхнего уровня (не вложенным атрибутом). Тип данных должен быть String, Number или Binary. Атрибут не может быть вложен в список или карту.

ИмяАтрибута -> (строка)

Имя ключевого атрибута.

ТипКлюча -> (строка)

Роль, которую этот ключевой атрибут будет выполнять:

  • HASH - ключ разбиения
  • RANGE - ключ сортировки

Примечание

Ключ разбиения элемента также известен как атрибут хэширования. Термин «атрибут хэширования» происходит от использования DynamoDB внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений их ключа разбиения.

Ключ сортировки элемента также известен как атрибут диапазона. Термин «атрибут диапазона» происходит от способа, которым DynamoDB хранит элементы с одинаковым ключом разбиения физически близко друг к другу в отсортированном порядке по значению ключа сортировки.

СтатусТаблицы -> (строка)

Текущее состояние таблицы:

  • CREATING - Таблица создается.
  • UPDATING - Конфигурация таблицы/индекса обновляется. Таблица/индекс остается доступной для операций с данными при UPDATING.
  • DELETING - Таблица удаляется.
  • ACTIVE - Таблица готова к использованию.
  • INACCESSIBLE_ENCRYPTION_CREDENTIALS - Ключ KMS, используемый для шифрования таблицы, недоступен. Операции с таблицей могут завершиться сбоем из-за невозможности использовать ключ KMS. DynamoDB инициирует процесс архивирования таблицы, если ключ KMS таблицы остается недоступным более семи дней.
  • ARCHIVING - Таблица архивируется. Операции недоступны до завершения архивирования.
  • ARCHIVED - Таблица архивирована. Дополнительную информацию см. в разделе ПричинаАрхивации.

ДатаСоздание -> (временная метка)

Дата и время создания таблицы в формате временной метки Unix.

ПропускнаяСпособность -> (структура)

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

ПоследнееУвеличение -> (временная метка)

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

ПоследнееУменьшение -> (временная метка)

Дата и время последнего уменьшения пропускной способности для этой таблицы.

КоличествоУменьшенийСегодня -> (длинное целое число)

Количество уменьшений пропускной способности для этой таблицы в течение текущего UTC-календарного дня. Максимальное количество уменьшений пропускной способности см. в разделе Квоты сервиса, учетной записи и таблицы в руководстве разработчика Amazon DynamoDB.

ЕдиницыПропускнойСпособностиЧтения -> (длинное целое число)

Максимальное количество чтений со строгой последовательностью, потребляемых в секунду, прежде чем DynamoDB вернет ThrottlingException. Чтения с нестрогой последовательностью требуют меньших затрат, чем чтения со строгой последовательностью, поэтому установка в 50 ReadCapacityUnits в секунду обеспечивает 100 чтений с нестрогой последовательностью ReadCapacityUnits в секунду.

ЕдиницыПропускнойСпособностиЗаписи -> (длинное целое число)

Максимальное количество записей, потребляемых в секунду, прежде чем DynamoDB вернет ThrottlingException.

РазмерТаблицыБайты -> (длинное целое число)

Общий размер указанной таблицы в байтах. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отображаться в этом значении.

КоличествоЭлементов -> (длинное целое число)

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

ArnТаблицы -> (строка)

Идентификатор Amazon Resource Name (ARN), который однозначно идентифицирует таблицу.

ИдентификаторТаблицы -> (строка)

Уникальный идентификатор таблицы, для которой была создана резервная копия.

СводкаРежимаПлаты -> (структура)

Содержит сведения о режиме пропускной способности чтения/записи.

РежимПлаты -> (строка)

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

  • PROVISIONED - Устанавливает режим пропускной способности чтения/записи в PROVISIONED. Рекомендуется использовать PROVISIONED для предсказуемых рабочих нагрузок.
  • PAY_PER_REQUEST - Устанавливает режим пропускной способности чтения/записи в PAY_PER_REQUEST. Рекомендуется использовать PAY_PER_REQUEST для непредсказуемых рабочих нагрузок.

ПоследнееОбновлениеНаПлатуЗаЗапрос -> (временная метка)

Представляет время, когда PAY_PER_REQUEST был в последний раз установлен в качестве режима пропускной способности чтения/записи.

ДополнительныеИндексы -> (список)

Представляет один или несколько локальных вторичных индексов таблицы. Каждый индекс ограничен значением заданного ключа разбиения. Таблицы с одним или несколькими локальными вторичными индексами ограничены размером коллекции элементов, где количество данных в данной коллекции не должно превышать 10 ГБ. Каждый элемент состоит из:

  • IndexName - Название локального вторичного индекса.
  • KeySchema - Указывает полную схему ключа индекса. Имена атрибутов в схеме ключа должны содержать от 1 до 255 символов (включительно). Схема ключа должна начинаться с того же ключа разбиения, что и таблица.
  • Projection - Указывает атрибуты, которые копируются (проектируются) из таблицы в индекс. Они дополняют атрибуты первичного ключа и ключа индекса, которые автоматически проектируются. Каждое указание атрибута состоит из:
    • ProjectionType - Один из следующих вариантов:
      • KEYS_ONLY - В индекс проектируются только индекс и первичные ключи.
      • INCLUDE - В индекс проектируются только указанные атрибуты таблицы. Список проектируемых атрибутов находится в NonKeyAttributes .
      • ALL - В индекс проектируются все атрибуты таблицы.
    • NonKeyAttributes - Список одного или нескольких имён атрибутов, не являющихся ключами, которые проектируются во вторичный индекс. Общее количество атрибутов, указанных в NonKeyAttributes , суммарно по всем вторичным индексам, не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это учитывается как два отдельных атрибута при определении общего количества. Это ограничение действует только при указании ProjectionType INCLUDE . Вы всё ещё можете указать ProjectionType ALL, чтобы спроецировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.
  • IndexSizeBytes - Представляет общий размер индекса в байтах. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.
  • ItemCount - Представляет количество элементов в индексе. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.

Если таблица находится в состоянии DELETING, информация об индексах не будет возвращена.

(структура)

Представляет свойства локального вторичного индекса.

IndexName -> (строка)

Представляет название локального вторичного индекса.

KeySchema -> (список)

Полная схема ключа локального вторичного индекса, состоящая из одного или нескольких пар имён атрибутов и типов ключей:

  • HASH - ключ разбиения
  • RANGE - ключ сортировки

Примечание

Ключ разбиения элемента также известен как его атрибут хэширования . Термин «атрибут хэширования» происходит от использования DynamoDB внутренней функции хэширования для равномерного распределения элементов данных по разделам на основе значений их ключа разбиения.

Ключ сортировки элемента также известен как его атрибут диапазона . Термин «атрибут диапазона» происходит от способа, которым DynamoDB хранит элементы с одинаковым ключом разбиения физически рядом, в отсортированном порядке по значению ключа сортировки.

(структура)

Представляет один элемент схемы ключа. Схема ключа определяет атрибуты, составляющие первичный ключ таблицы или ключевые атрибуты индекса.

KeySchemaElement представляет ровно один атрибут первичного ключа. Например, простой первичный ключ будет представлен одним KeySchemaElement (для ключа разбиения). Составной первичный ключ потребовал бы одного KeySchemaElement для ключа разбиения и другого KeySchemaElement для ключа сортировки.

KeySchemaElement должен быть скалярным атрибутом верхнего уровня (не вложенным атрибутом). Тип данных должен быть String, Number или Binary. Атрибут не может быть вложен в список или карту.

AttributeName -> (строка)

Имя ключевого атрибута.

KeyType -> (строка)

Роль, которую этот ключевой атрибут будет выполнять:

  • HASH - ключ разбиения
  • RANGE - ключ сортировки

Примечание

Ключ разбиения элемента также известен как его атрибут хэширования . Термин «атрибут хэширования» происходит от использования DynamoDB внутренней функции хэширования для равномерного распределения элементов данных по разделам на основе значений их ключа разбиения.

Ключ сортировки элемента также известен как его атрибут диапазона . Термин «атрибут диапазона» происходит от способа, которым DynamoDB хранит элементы с одинаковым ключом разбиения физически рядом, в отсортированном порядке по значению ключа сортировки.

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

Представляет атрибуты, которые копируются (проектируются) из таблицы в глобальный вторичный индекс. Они дополняют атрибуты первичного ключа и ключа индекса, которые автоматически проектируются.

ProjectionType -> (строка)

Набор атрибутов, которые проектируются в индекс:

  • KEYS_ONLY - В индекс проектируются только индекс и первичные ключи.
  • INCLUDE - В дополнение к атрибутам, описанным в KEYS_ONLY , вторичный индекс будет включать другие атрибуты, не являющиеся ключами, которые вы укажете.
  • ALL - В индекс проектируются все атрибуты таблицы.

При использовании консоли DynamoDB, ALL выбирается по умолчанию.

NonKeyAttributes -> (список)

Представляет имена атрибутов, не являющихся ключами, которые будут спроецированы в индекс.

Для глобальных и локальных вторичных индексов общее количество NonKeyAttributes , суммарно по всем вторичным индексам, не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это учитывается как два отдельных атрибута при определении общего количества. Это ограничение действует только при указании ProjectionType INCLUDE . Вы всё ещё можете указать ProjectionType ALL, чтобы спроецировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.

(строка)

IndexSizeBytes -> (целое число с длинной точностью)

Общий размер указанного индекса в байтах. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.

ItemCount -> (целое число с длинной точностью)

Количество элементов в указанном индексе. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.

IndexArn -> (строка)

Amazon Resource Name (ARN), уникально идентифицирующий индекс.

GlobalSecondaryIndexes -> (список)

Глобальные вторичные индексы (если есть) в таблице. Каждый индекс ограничен значением заданного ключа разбиения. Каждый элемент состоит из:

  • Backfilling - Если true, то индекс в настоящее время находится на фазе заполнения. Заполнение происходит только при добавлении нового глобального вторичного индекса в таблицу. Это процесс, при котором DynamoDB заполняет новый индекс данными из таблицы. (Этот атрибут не отображается для индексов, созданных во время операции CreateTable.) Вы можете удалить индекс, который создаётся в фазе Backfilling, когда IndexStatus установлено как CREATING и Backfilling равно true. Вы не можете удалить индекс, который создаётся, когда IndexStatus установлено как CREATING и Backfilling равно false. (Этот атрибут не отображается для индексов, созданных во время операции CreateTable.)
  • IndexName - Название глобального вторичного индекса.
  • IndexSizeBytes - Общий размер глобального вторичного индекса в байтах. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.
  • IndexStatus - Текущий статус глобального вторичного индекса:
    • CREATING - Индекс создаётся.
    • UPDATING - Индекс обновляется.
    • DELETING - Индекс удаляется.
    • ACTIVE - Индекс готов к использованию.
  • ItemCount - Количество элементов в глобальном вторичном индексе. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.
  • KeySchema - Указывает полную схему ключа индекса. Имена атрибутов в схеме ключа должны быть от 1 до 255 символов (включительно). Схема ключа должна начинаться с того же ключа разбиения, что и таблица.
  • Projection - Указывает атрибуты, которые копируются (проектируются) из таблицы в индекс. Они дополняют атрибуты первичного ключа и ключа индекса, которые автоматически проектируются. Каждое указание атрибута состоит из:
    • ProjectionType - Один из следующих вариантов:
      • KEYS_ONLY - В индекс проектируются только индекс и первичные ключи.
      • INCLUDE - В дополнение к атрибутам, описанным в KEYS_ONLY , вторичный индекс будет включать другие атрибуты, не являющиеся ключами, которые вы укажете.
      • ALL - В индекс проектируются все атрибуты таблицы.
    • NonKeyAttributes - Список одного или нескольких имён атрибутов, не являющихся ключами, которые проектируются во вторичный индекс. Общее количество атрибутов, указанных в NonKeyAttributes , суммарно по всем вторичным индексам, не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это учитывается как два отдельных атрибута при определении общего количества. Это ограничение действует только при указании ProjectionType INCLUDE . Вы всё ещё можете указать ProjectionType ALL, чтобы спроецировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.
  • ProvisionedThroughput - Параметры пропускной способности для глобального вторичного индекса, состоящие из единиц пропускной способности чтения и записи, а также данных об увеличениях и уменьшениях.

Если таблица находится в состоянии DELETING, информация об индексах не будет возвращена.

(структура)

Представляет свойства глобального вторичного индекса.

IndexName -> (строка)

Название глобального вторичного индекса.

KeySchema -> (список)

Полная схема ключей для глобального вторичного индекса, которая состоит из одной или нескольких пар имён атрибутов и типов ключей:

  • HASH - ключ разбиения
  • RANGE - сортировочный ключ

Примечание

Ключ разбиения элемента также известен как его атрибут хеширования. Термин «атрибут хеширования» происходит от использования DynamoDB внутренней функции хеширования для равномерного распределения элементов данных по разделам на основе значений ключа разбиения.

Сортировочный ключ элемента также известен как его атрибут диапазона. Термин «атрибут диапазона» происходит от способа, которым DynamoDB хранит элементы с одинаковым ключом разбиения физически близко друг к другу в отсортированном порядке по значению сортировочного ключа.

(структура)

Представляет один элемент схемы ключей. Схема ключей определяет атрибуты, составляющие первичный ключ таблицы или атрибуты ключа индекса.

KeySchemaElement представляет ровно один атрибут первичного ключа. Например, простой первичный ключ будет представлен одним KeySchemaElement (для ключа разбиения). Сложный первичный ключ потребует одного KeySchemaElement для ключа разбиения и другого KeySchemaElement для сортировочного ключа.

KeySchemaElement должен быть скалярным атрибутом верхнего уровня (не вложенным атрибутом). Тип данных должен быть одним из String, Number или Binary. Атрибут не может быть вложен в List или Map.

AttributeName -> (строка)

Имя атрибута ключа.

KeyType -> (строка)

Роль, которую будет выполнять этот атрибут ключа:

  • HASH - ключ разбиения
  • RANGE - сортировочный ключ

Примечание

Ключ разбиения элемента также известен как его атрибут хеширования. Термин «атрибут хеширования» происходит от использования DynamoDB внутренней функции хеширования для равномерного распределения элементов данных по разделам на основе значений ключа разбиения.

Сортировочный ключ элемента также известен как его атрибут диапазона. Термин «атрибут диапазона» происходит от способа, которым DynamoDB хранит элементы с одинаковым ключом разбиения физически близко друг к другу в отсортированном порядке по значению сортировочного ключа.

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

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

ProjectionType -> (строка)

Набор атрибутов, которые проектируются в индекс:

  • KEYS_ONLY - В индекс проектируются только ключи индекса и первичного ключа.
  • INCLUDE - В дополнение к атрибутам, описанным в KEYS_ONLY , вторичный индекс будет включать другие атрибуты, не являющиеся ключами, которые вы укажете.
  • ALL - Все атрибуты таблицы проектируются в индекс.

При использовании консоли DynamoDB по умолчанию выбран ALL.

NonKeyAttributes -> (список)

Представляет имена атрибутов, не являющихся ключами, которые будут спроецированы в индекс.

Для глобальных и локальных вторичных индексов общее количество NonKeyAttributes , суммированное по всем вторичным индексам, не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это учитывается как два отдельных атрибута при определении общего количества. Это ограничение применяется только тогда, когда вы указываете ProjectionType INCLUDE . Вы по-прежнему можете указать ProjectionType ALL для проекции всех атрибутов из исходной таблицы, даже если таблица имеет более 100 атрибутов.

(строка)

IndexStatus -> (строка)

Текущее состояние глобального вторичного индекса:

  • CREATING - Индекс создается.
  • UPDATING - Индекс обновляется.
  • DELETING - Индекс удаляется.
  • ACTIVE - Индекс готов к использованию.

Backfilling -> (булево)

Указывает, выполняется ли в данный момент обратная загрузка индекса. Обратная загрузка — это процесс чтения элементов из таблицы и определения возможности их добавления в индекс. (Не все элементы подходят: например, у ключа разбиения не может быть дублирующих значений.) Если элемент можно добавить в индекс, DynamoDB это сделает. После обработки всех элементов операция обратной загрузки завершается, и Backfilling принимает значение false.

Вы можете удалить индекс, который создаётся во время фазы Backfilling, когда IndexStatus установлено в CREATING и Backfilling имеет значение true. Вы не можете удалить индекс, который создаётся, когда IndexStatus установлено в CREATING и Backfilling имеет значение false.

Примечание

Для индексов, созданных во время операции CreateTable, атрибут Backfilling не отображается в выводе DescribeTable.

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

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

См. минимальные и максимальные значения предоставленной пропускной способности в разделе «Квоты службы, учётной записи и таблиц» в руководстве разработчика Amazon DynamoDB.

LastIncreaseDateTime -> (временная метка)

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

LastDecreaseDateTime -> (временная метка)

Дата и время последнего уменьшения предоставленной пропускной способности для этой таблицы.

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

Количество уменьшений предоставленной пропускной способности для этой таблицы в течение текущего UTC-календарного дня. См. максимальные значения уменьшений предоставленной пропускной способности в разделе «Квоты службы, учётной записи и таблиц» в руководстве разработчика Amazon DynamoDB.

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

Максимальное количество чтений со строгой последовательностью, потребляемых в секунду, прежде чем DynamoDB вернёт ThrottlingException. Чтения с временной последовательностью требуют меньших усилий, чем чтения со строгой последовательностью, поэтому значение 50 ReadCapacityUnits в секунду обеспечивает 100 чтений с временной последовательностью ReadCapacityUnits в секунду.

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

Максимальное количество записей, потребляемых в секунду, прежде чем DynamoDB вернёт ThrottlingException.

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

Общий размер указанного индекса в байтах. DynamoDB обновляет это значение примерно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.

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

Количество элементов в указанном индексе. DynamoDB обновляет это значение примерно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.

IndexArn -> (строка)

Идентификатор ресурса Amazon (ARN), уникально определяющий индекс.

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

Максимальное количество единиц чтения и записи для указанного глобального вторичного индекса. Если вы используете этот параметр, вы должны указать MaxReadRequestUnits, MaxWriteRequestUnits или оба.

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

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

Чтобы задать максимальное значение OnDemandThroughput для вашей таблицы, установите значение MaxReadRequestUnits как большее или равное 1. Чтобы удалить максимальное значение OnDemandThroughput, которое в настоящее время установлено для вашей таблицы, установите значение MaxReadRequestUnits в -1.

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

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

Чтобы задать максимальное значение OnDemandThroughput для вашей таблицы, установите значение MaxWriteRequestUnits как большее или равное 1. Чтобы удалить максимальное значение OnDemandThroughput, которое в настоящее время установлено для вашей таблицы, установите значение MaxWriteRequestUnits в -1.

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

Представляет значение тепловой пропускной способности (в единицах чтения в секунду и единицах записи в секунду) для указанного вторичного индекса.

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

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

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

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

Status -> (строка)

Представляет состояние тепловой пропускной способности, создаваемой или обновляемой в глобальном вторичном индексе. Состояние может быть только UPDATING или ACTIVE.

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

Текущие настройки DynamoDB Streams для таблицы.

StreamEnabled -> (булево)

Указывает, включены (true) или отключены (false) DynamoDB Streams для таблицы.

StreamViewType -> (строка)

При изменении элемента в таблице, StreamViewType определяет, какая информация записывается в поток для этой таблицы. Допустимые значения для StreamViewType:

  • KEYS_ONLY - В поток записываются только атрибуты ключа изменённого элемента.
  • NEW_IMAGE - В поток записывается весь элемент в его виде после изменения.
  • OLD_IMAGE - В поток записывается весь элемент в его виде до изменения.
  • NEW_AND_OLD_IMAGES - В поток записываются оба изображения элемента — новое и старое.

LatestStreamLabel -> (строка)

Временная метка в формате ISO 8601 для этого потока.

Обратите внимание, что LatestStreamLabel не является уникальным идентификатором потока, так как возможно, что поток из другой таблицы может иметь ту же временную метку. Однако комбинация следующих трех элементов гарантированно уникальна:

  • Идентификатор клиента Amazon Web Services
  • Название таблицы
  • StreamLabel

LatestStreamArn -> (строка)

Идентификатор ресурса Amazon (ARN), уникально определяющий последний поток для этой таблицы.

GlobalTableVersion -> (строка)

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

Replicas -> (список)

Представляет реплики таблицы.

(структура)

Содержит сведения о реплике.

RegionName -> (строка)

Имя региона.

ReplicaStatus -> (строка)

Текущее состояние реплики:

  • CREATING - Реплика создается.
  • UPDATING - Реплика обновляется.
  • DELETING - Реплика удаляется.
  • ACTIVE - Реплика готова к использованию.
  • REGION_DISABLED - Реплика недоступна, так как регион Amazon Web Services отключен.

Примечание

Если регион Amazon Web Services остается недоступным более 20 часов, DynamoDB удалит эту реплику из группы репликации. Реплика не будет удалена, и репликация в/из этого региона прекратится.
  • INACCESSIBLE_ENCRYPTION_CREDENTIALS - Ключ KMS, используемый для шифрования таблицы, недоступен.

Примечание

Если ключ KMS остается недоступным более 20 часов, DynamoDB удалит эту реплику из группы репликации. Реплика не будет удалена, и репликация в/из этого региона прекратится.

ReplicaStatusDescription -> (строка)

Подробная информация о состоянии реплики.

ReplicaStatusPercentProgress -> (строка)

Указывает процент выполнения действия Create, Update или Delete для реплики.

KMSMasterKeyId -> (строка)

Ключ KMS реплики, который будет использоваться для шифрования KMS.

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

Пропускная способность, выделенная для реплики. Если не указано, используется пропускная способность исходной таблицы.

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

Пропускная способность чтения, выделенная для реплики. Если не указано, используется пропускная способность чтения исходной таблицы.

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

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

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

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

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

Представляет значение тепловой пропускной способности для этой реплики.

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

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

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

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

Status -> (строка)

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

GlobalSecondaryIndexes -> (список)

Параметры глобального вторичного индекса, специфичные для реплики.

(структура)

Представляет свойства глобального вторичного индекса реплики.

IndexName -> (строка)

Имя глобального вторичного индекса.

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

Если не указано, используются параметры пропускной способности чтения GSI исходной таблицы.

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

Пропускная способность чтения, выделенная для реплики. Если не указано, используется пропускная способность чтения исходной таблицы.

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

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

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

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

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

Представляет тепловую пропускную способность глобального вторичного индекса для этой реплики.

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

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

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

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

Status -> (строка)

Представляет статус тепловой пропускной способности, создаваемый или обновляемый в глобальном вторичном индексе. Статус может быть только UPDATING или ACTIVE .

ReplicaInaccessibleDateTime -> (временная метка)

Время, когда реплика была впервые обнаружена как недоступная. Для определения причины недоступности проверьте свойство ReplicaStatus.

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

Содержит сведения о классе таблицы.

TableClass -> (строка)

Класс таблицы указанной таблицы. Допустимые значения — STANDARD и STANDARD_INFREQUENT_ACCESS.

LastUpdateDateTime -> (временная метка)

Дата и время последнего обновления класса таблицы.

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

Содержит сведения о восстановлении.

SourceBackupArn -> (строка)

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

SourceTableArn -> (строка)

ARN исходной таблицы резервной копии, которая восстанавливается.

RestoreDateTime -> (временная метка)

Точка времени или время исходной резервной копии.

RestoreInProgress -> (булево значение)

Указывает, выполняется ли процесс восстановления.

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

Описание состояния шифрования на стороне сервера для указанной таблицы.

Status -> (строка)

Представляет текущее состояние шифрования на стороне сервера. Допустимые значения:

  • ENABLED - Шифрование на стороне сервера включено.
  • UPDATING - Шифрование на стороне сервера обновляется.

SSEType -> (строка)

Тип шифрования на стороне сервера. Допустимое значение:

  • KMS - Шифрование на стороне сервера с использованием Key Management Service. Ключ хранится в вашем аккаунте и управляется KMS (применяются сборы KMS).

KMSMasterKeyArn -> (строка)

ARN ключа KMS, используемого для шифрования KMS.

InaccessibleEncryptionDateTime -> (временная метка)

Указывает время, в формате временной метки Unix, когда DynamoDB обнаружил, что ключ KMS таблицы недоступен. Это атрибут будет автоматически очищен, когда DynamoDB обнаружит, что ключ KMS таблицы снова доступен. DynamoDB инициирует процесс архивирования таблицы, если ключ KMS таблицы остается недоступным более чем 7 дней с этой даты.

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

Содержит сведения об архиве таблицы.

ArchivalDateTime -> (временная метка)

Дата и время, когда DynamoDB инициировал архивацию таблицы, в формате временной метки Unix.

ArchivalReason -> (строка)

Причина, по которой DynamoDB архивировал таблицу. В настоящее время единственное возможное значение:

  • INACCESSIBLE_ENCRYPTION_CREDENTIALS - Таблица была архивирована из-за того, что ключ KMS таблицы был недоступен более 7 дней. При архивировании была создана резервная копия по требованию.

ArchivalBackupArn -> (строка)

Amazon Resource Name (ARN) резервной копии, в которую была архивирована таблица, если это применимо в причине архивирования. Если вы хотите восстановить эту резервную копию в ту же таблицу, вам потребуется удалить исходную таблицу.

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

Содержит сведения о классе таблицы.

TableClass -> (строка)

Класс таблицы указанной таблицы. Допустимые значения — STANDARD и STANDARD_INFREQUENT_ACCESS.

LastUpdateDateTime -> (временная метка)

Дата и время последнего обновления класса таблицы.

DeletionProtectionEnabled -> (булево значение)

Указывает, включена ли защита от удаления (true) или отключена (false) для таблицы.

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

Максимальное количество единиц запросов на чтение и запись для указанной таблицы по требованию. Если вы используете этот параметр, вы должны указать MaxReadRequestUnits, MaxWriteRequestUnits или оба.

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

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

Для задания максимального значения OnDemandThroughput для вашей таблицы установите значение MaxReadRequestUnits как больше или равно 1. Чтобы удалить текущее максимальное значение OnDemandThroughput, установленное для вашей таблицы, установите значение MaxReadRequestUnits в -1.

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

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

Для задания максимального значения OnDemandThroughput для вашей таблицы установите значение MaxWriteRequestUnits как больше или равно 1. Чтобы удалить текущее максимальное значение OnDemandThroughput, установленное для вашей таблицы, установите значение MaxWriteRequestUnits в -1.

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

Описывает значение тепловой пропускной способности базовой таблицы.

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

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

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

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

Status -> (строка)

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

MultiRegionConsistency -> (строка)

Указывает один из следующих режимов согласованности для глобальной таблицы:

  • EVENTUAL : Указывает, что глобальная таблица настроена для согласованности по умолчанию во всех регионах.
  • STRONG : Указывает, что глобальная таблица настроена для сильной согласованности во всех регионах (превью).

Примечание

Сильная согласованность во всех регионах (MRSC) — это новая возможность DynamoDB для глобальных таблиц, которая в настоящее время доступна в режиме предварительного просмотра. Дополнительную информацию см. в разделе Сильная согласованность во всех регионах глобальных таблиц .

Если этот параметр не указан, режим согласованности глобальной таблицы по умолчанию — EVENTUAL .

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

Spec-Zone.ru

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