обновление-настроек-глобальной-таблицы
Описание
Обновляет настройки глобальной таблицы.
Предупреждение
Данная документация относится к версии 2017.11.29 (Legacy) глобальных таблиц, использование которых для новых глобальных таблиц не рекомендуется. Вместо этого, при возможности, следует использовать глобальные таблицы версии 2019.11.21 (Current), так как они обеспечивают большую гибкость, высокую эффективность и потребляют меньше емкости записи, чем версия 2017.11.29 (Legacy).
Чтобы определить, какую версию вы используете, см. Определение версии глобальной таблицы . Чтобы обновить существующие глобальные таблицы из версии 2017.11.29 (Legacy) до версии 2019.11.21 (Current), см. Удаление глобальных таблиц .
См. также: Документация API AWS
Синтаксис
update-global-table-settings
--global-table-name <value>
[--global-table-billing-mode <value>]
[--global-table-provisioned-write-capacity-units <value>]
[--global-table-provisioned-write-capacity-auto-scaling-settings-update <value>]
[--global-table-global-secondary-index-settings-update <value>]
[--replica-settings-update <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]
Параметры
--global-table-name (строка)
--global-table-billing-mode (строка)
Режим выставления счетов для глобальной таблицы. Если GlobalTableBillingMode не указан, глобальная таблица по умолчанию использует режим выставления счетов по емкости PROVISIONED.
-
PROVISIONED- Рекомендуется использоватьPROVISIONEDдля предсказуемых рабочих нагрузок.PROVISIONEDустанавливает режим выставления счетов на режим емкости Provisioned . -
PAY_PER_REQUEST- Рекомендуется использоватьPAY_PER_REQUESTдля непредсказуемых рабочих нагрузок.PAY_PER_REQUESTустанавливает режим выставления счетов на режим емкости On-demand .
Возможные значения:
PROVISIONEDPAY_PER_REQUEST
--global-table-provisioned-write-capacity-units (целое)
ThrottlingException.
--global-table-provisioned-write-capacity-auto-scaling-settings-update (структура)
Настройки автоматического масштабирования для управления выделенной емкостью записи для глобальной таблицы.
MinimumUnits -> (целое)
MaximumUnits -> (целое)
AutoScalingDisabled -> (булево)
AutoScalingRoleArn -> (строка)
ScalingPolicyUpdate -> (структура)
Политика масштабирования для масштабирования целевых единиц емкости глобальной таблицы или глобального вторичного индекса.
PolicyName -> (строка)
TargetTrackingScalingPolicyConfiguration -> (структура)
Представляет конфигурацию политики масштабирования с отслеживанием целевых значений.
DisableScaleIn -> (булево)
ScaleInCooldown -> (целое)
ScaleOutCooldown -> (целое)
TargetValue -> (вещественное число)
Сокращенный синтаксис:
MinimumUnits=long,MaximumUnits=long,AutoScalingDisabled=boolean,AutoScalingRoleArn=string,ScalingPolicyUpdate={PolicyName=string,TargetTrackingScalingPolicyConfiguration={DisableScaleIn=boolean,ScaleInCooldown=integer,ScaleOutCooldown=integer,TargetValue=double}}
Синтаксис JSON:
{
"MinimumUnits": long,
"MaximumUnits": long,
"AutoScalingDisabled": true|false,
"AutoScalingRoleArn": "string",
"ScalingPolicyUpdate": {
"PolicyName": "string",
"TargetTrackingScalingPolicyConfiguration": {
"DisableScaleIn": true|false,
"ScaleInCooldown": integer,
"ScaleOutCooldown": integer,
"TargetValue": double
}
}
}
--global-table-global-secondary-index-settings-update (список)
Представляет настройки глобального вторичного индекса для глобальной таблицы, которые будут изменены.
(структура)
Представляет настройки глобального вторичного индекса для глобальной таблицы, которые будут изменены.
IndexName -> (строка)
ProvisionedWriteCapacityUnits -> (целое)
ThrottlingException.
ProvisionedWriteCapacityAutoScalingSettingsUpdate -> (структура)
Настройки автоматического масштабирования для управления емкостью записи глобального вторичного индекса.
MinimumUnits -> (целое)
MaximumUnits -> (целое)
AutoScalingDisabled -> (булево)
AutoScalingRoleArn -> (строка)
ScalingPolicyUpdate -> (структура)
Политика масштабирования для масштабирования целевых единиц емкости глобального вторичного индекса.
PolicyName -> (строка)
TargetTrackingScalingPolicyConfiguration -> (структура)
Представляет конфигурацию политики масштабирования с отслеживанием целевых значений.
DisableScaleIn -> (булево)
ScaleInCooldown -> (целое)
ScaleOutCooldown -> (целое)
TargetValue -> (вещественное число)
Синтаксис JSON:
[
{
"IndexName": "string",
"ProvisionedWriteCapacityUnits": long,
"ProvisionedWriteCapacityAutoScalingSettingsUpdate": {
"MinimumUnits": long,
"MaximumUnits": long,
"AutoScalingDisabled": true|false,
"AutoScalingRoleArn": "string",
"ScalingPolicyUpdate": {
"PolicyName": "string",
"TargetTrackingScalingPolicyConfiguration": {
"DisableScaleIn": true|false,
"ScaleInCooldown": integer,
"ScaleOutCooldown": integer,
"TargetValue": double
}
}
}
}
...
]
--replica-settings-update (список)
Представляет настройки глобальной таблицы в Регионе, которые будут изменены.
(структура)
Представляет настройки глобальной таблицы в Регионе, которые будут изменены.
RegionName -> (строка)
ReplicaProvisionedReadCapacityUnits -> (целое число)
ThrottlingException. Для получения дополнительной информации см. раздел "Определение требований к чтению и записи" в руководстве разработчика Amazon DynamoDB.ReplicaProvisionedReadCapacityAutoScalingSettingsUpdate -> (структура)
Настройки автоматического масштабирования для управления единицами пропускной способности чтения реплики глобальной таблицы.
MinimumUnits -> (целое число)
MaximumUnits -> (целое число)
AutoScalingDisabled -> (булево)
AutoScalingRoleArn -> (строка)
ScalingPolicyUpdate -> (структура)
Политика масштабирования, которая должна применяться для масштабирования целевых единиц пропускной способности глобальной таблицы или глобального вторичного индекса.
PolicyName -> (строка)
TargetTrackingScalingPolicyConfiguration -> (структура)
Представляет конфигурацию политики масштабирования с отслеживанием целевых значений.
DisableScaleIn -> (булево)
ScaleInCooldown -> (целое число)
ScaleOutCooldown -> (целое число)
TargetValue -> (двойное число)
ReplicaGlobalSecondaryIndexSettingsUpdate -> (список)
Представляет настройки глобального вторичного индекса для глобальной таблицы, которые будут изменены.
(структура)
Представляет настройки глобального вторичного индекса для глобальной таблицы, которые будут изменены.
IndexName -> (строка)
ProvisionedReadCapacityUnits -> (целое число)
ThrottlingException.ProvisionedReadCapacityAutoScalingSettingsUpdate -> (структура)
Настройки автоматического масштабирования для управления единицами пропускной способности чтения реплики глобального вторичного индекса.
MinimumUnits -> (целое число)
MaximumUnits -> (целое число)
AutoScalingDisabled -> (булево)
AutoScalingRoleArn -> (строка)
ScalingPolicyUpdate -> (структура)
Политика масштабирования, которая должна применяться для масштабирования целевых единиц пропускной способности глобальной таблицы или глобального вторичного индекса.
PolicyName -> (строка)
TargetTrackingScalingPolicyConfiguration -> (структура)
Представляет конфигурацию политики масштабирования с отслеживанием целевых значений.
DisableScaleIn -> (булево)
ScaleInCooldown -> (целое число)
ScaleOutCooldown -> (целое число)
TargetValue -> (двойное число)
ReplicaTableClass -> (строка)
Синтаксис JSON:
[
{
"RegionName": "string",
"ReplicaProvisionedReadCapacityUnits": long,
"ReplicaProvisionedReadCapacityAutoScalingSettingsUpdate": {
"MinimumUnits": long,
"MaximumUnits": long,
"AutoScalingDisabled": true|false,
"AutoScalingRoleArn": "string",
"ScalingPolicyUpdate": {
"PolicyName": "string",
"TargetTrackingScalingPolicyConfiguration": {
"DisableScaleIn": true|false,
"ScaleInCooldown": integer,
"ScaleOutCooldown": integer,
"TargetValue": double
}
}
},
"ReplicaGlobalSecondaryIndexSettingsUpdate": [
{
"IndexName": "string",
"ProvisionedReadCapacityUnits": long,
"ProvisionedReadCapacityAutoScalingSettingsUpdate": {
"MinimumUnits": long,
"MaximumUnits": long,
"AutoScalingDisabled": true|false,
"AutoScalingRoleArn": "string",
"ScalingPolicyUpdate": {
"PolicyName": "string",
"TargetTrackingScalingPolicyConfiguration": {
"DisableScaleIn": true|false,
"ScaleInCooldown": integer,
"ScaleOutCooldown": integer,
"TargetValue": double
}
}
}
}
...
],
"ReplicaTableClass": "STANDARD"|"STANDARD_INFREQUENT_ACCESS"
}
...
]
--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 V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла непосредственно независимо от значения параметра cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного параметра cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (булево)
Отключить перелистывание (pager) для вывода.
--cli-auto-prompt (булево)
Автоматически запрашивать параметры входных данных CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросы параметров входных данных CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. Дополнительную информацию см. в разделе "Использование кавычек со строками" в руководстве пользователя AWS CLI.
Для обновления настроек пропускной способности записи с заданным значением в DynamoDB глобальной таблицы
В следующем update-global-table-settings примере устанавливается пропускная способность записи с заданным значением для MusicCollection глобальной таблицы в 15 единиц.
aws dynamodb update-global-table-settings \
--global-table-name MusicCollection \
--global-table-provisioned-write-capacity-units 15
Вывод:
{
"GlobalTableName": "MusicCollection",
"ReplicaSettings": [
{
"RegionName": "eu-west-1",
"ReplicaStatus": "UPDATING",
"ReplicaProvisionedReadCapacityUnits": 10,
"ReplicaProvisionedReadCapacityAutoScalingSettings": {
"AutoScalingDisabled": true
},
"ReplicaProvisionedWriteCapacityUnits": 10,
"ReplicaProvisionedWriteCapacityAutoScalingSettings": {
"AutoScalingDisabled": true
}
},
{
"RegionName": "us-east-1",
"ReplicaStatus": "UPDATING",
"ReplicaProvisionedReadCapacityUnits": 10,
"ReplicaProvisionedReadCapacityAutoScalingSettings": {
"AutoScalingDisabled": true
},
"ReplicaProvisionedWriteCapacityUnits": 10,
"ReplicaProvisionedWriteCapacityAutoScalingSettings": {
"AutoScalingDisabled": true
}
},
{
"RegionName": "us-east-2",
"ReplicaStatus": "UPDATING",
"ReplicaProvisionedReadCapacityUnits": 10,
"ReplicaProvisionedReadCapacityAutoScalingSettings": {
"AutoScalingDisabled": true
},
"ReplicaProvisionedWriteCapacityUnits": 10,
"ReplicaProvisionedWriteCapacityAutoScalingSettings": {
"AutoScalingDisabled": true
}
}
]
}
Для получения дополнительной информации см. раздел DynamoDB Глобальные таблицы в руководстве разработчика Amazon DynamoDB.
Вывод
GlobalTableName -> (строка)
ReplicaSettings -> (список)
Настройки глобальной таблицы для конкретного региона.
(структура)
Представляет свойства реплики.
RegionName -> (строка)
ReplicaStatus -> (строка)
Текущее состояние региона:
-
CREATING- Регион создается. -
UPDATING- Регион обновляется. -
DELETING- Регион удаляется. -
ACTIVE- Регион готов к использованию.
ReplicaBillingModeSummary -> (структура)
Режим емкости чтения/записи реплики.
BillingMode -> (строка)
Определяет способ оплаты за пропускную способность чтения и записи, а также управление емкостью. Этот параметр можно изменить позже.
-
PROVISIONED- Устанавливает режим емкости чтения/записи наPROVISIONED. Рекомендуется использоватьPROVISIONEDдля предсказуемых рабочих нагрузок. -
PAY_PER_REQUEST- Устанавливает режим емкости чтения/записи наPAY_PER_REQUEST. Рекомендуется использоватьPAY_PER_REQUESTдля непредсказуемых рабочих нагрузок.
LastUpdateToPayPerRequestDateTime -> (метка времени)
ReplicaProvisionedReadCapacityUnits -> (целое число)
ThrottlingException. Для получения дополнительной информации см. раздел Указание требований к чтению и записи в Руководстве разработчика Amazon DynamoDB.ReplicaProvisionedReadCapacityAutoScalingSettings -> (структура)
Настройки автоматического масштабирования для емкости чтения реплики глобальной таблицы.
MinimumUnits -> (целое число)
MaximumUnits -> (целое число)
AutoScalingDisabled -> (булево)
AutoScalingRoleArn -> (строка)
ScalingPolicies -> (список)
Информация о политиках масштабирования.
(структура)
Представляет свойства политики масштабирования.
PolicyName -> (строка)
TargetTrackingScalingPolicyConfiguration -> (структура)
Представляет конфигурацию политики масштабирования с отслеживанием целевого значения.
DisableScaleIn -> (булево)
ScaleInCooldown -> (целое число)
ScaleOutCooldown -> (целое число)
TargetValue -> (двойное)
ReplicaProvisionedWriteCapacityUnits -> (целое число)
ThrottlingException. Для получения дополнительной информации см. раздел Указание требований к чтению и записи в Руководстве разработчика Amazon DynamoDB.ReplicaProvisionedWriteCapacityAutoScalingSettings -> (структура)
Настройки автоматического масштабирования для емкости записи реплики глобальной таблицы.
MinimumUnits -> (целое число)
MaximumUnits -> (целое число)
AutoScalingDisabled -> (булево)
AutoScalingRoleArn -> (строка)
ScalingPolicies -> (список)
Информация о политиках масштабирования.
(структура)
Представляет свойства политики масштабирования.
PolicyName -> (строка)
TargetTrackingScalingPolicyConfiguration -> (структура)
Представляет конфигурацию политики масштабирования с отслеживанием целевого значения.
DisableScaleIn -> (булево)
ScaleInCooldown -> (целое число)
ScaleOutCooldown -> (целое число)
TargetValue -> (двойное)
ReplicaGlobalSecondaryIndexSettings -> (список)
Параметры глобального вторичного индекса реплики для глобальной таблицы.
(структура)
Представляет свойства глобального вторичного индекса.
IndexName -> (строка)
IndexStatus -> (строка)
Текущий статус глобального вторичного индекса:
-
CREATING- Глобальный вторичный индекс создается. -
UPDATING- Глобальный вторичный индекс обновляется. -
DELETING- Глобальный вторичный индекс удаляется. -
ACTIVE- Глобальный вторичный индекс готов к использованию.
ProvisionedReadCapacityUnits -> (длинное целое число)
ThrottlingException.ProvisionedReadCapacityAutoScalingSettings -> (структура)
Параметры автоматического масштабирования для единиц пропускной способности чтения реплики глобального вторичного индекса.
MinimumUnits -> (длинное целое число)
MaximumUnits -> (длинное целое число)
AutoScalingDisabled -> (логическое значение)
AutoScalingRoleArn -> (строка)
ScalingPolicies -> (список)
Информация о политиках масштабирования.
(структура)
Представляет свойства политики масштабирования.
PolicyName -> (строка)
TargetTrackingScalingPolicyConfiguration -> (структура)
Представляет конфигурацию политики масштабирования по отслеживанию цели.
DisableScaleIn -> (логическое значение)
ScaleInCooldown -> (целое число)
ScaleOutCooldown -> (целое число)
TargetValue -> (двойное значение)
ProvisionedWriteCapacityUnits -> (длинное целое число)
ThrottlingException.ProvisionedWriteCapacityAutoScalingSettings -> (структура)
Параметры автоматического масштабирования для единиц пропускной способности записи реплики глобального вторичного индекса.
MinimumUnits -> (длинное целое число)
MaximumUnits -> (длинное целое число)
AutoScalingDisabled -> (логическое значение)
AutoScalingRoleArn -> (строка)
ScalingPolicies -> (список)
Информация о политиках масштабирования.
(структура)
Представляет свойства политики масштабирования.
PolicyName -> (строка)
TargetTrackingScalingPolicyConfiguration -> (структура)
Представляет конфигурацию политики масштабирования по отслеживанию цели.
DisableScaleIn -> (логическое значение)
ScaleInCooldown -> (целое число)
ScaleOutCooldown -> (целое число)
TargetValue -> (двойное значение)
ReplicaTableClassSummary -> (структура)
Содержит сведения о классе таблицы.
TableClass -> (строка)
STANDARD и STANDARD_INFREQUENT_ACCESS.LastUpdateDateTime -> (метка времени)
© Copyright 2025, Amazon Web Services. Created using Sphinx.