Spec-Zone.ru › AWS CLI v2

[ aws . dynamodb ]

описание-автомасштабирования-реплики-таблицы

Описание

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

Предупреждение

Для глобальных таблиц данная операция применяется только к глобальным таблицам, использующим версию 2019.11.21 (текущая версия).

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

Синтаксис

  describe-table-replica-auto-scaling
--table-name <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]

Параметры

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

Имя таблицы. Вы также можете указать Amazon Resource Name (ARN) таблицы в этом параметре.

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--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 (логическое значение)

Отключить кли-пейджер для вывода.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

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

Следующий describe-table-replica-auto-scaling пример отображает параметры автоматического масштабирования для реплик MusicCollection глобальной таблицы.

aws dynamodb describe-table-replica-auto-scaling \
    --table-name MusicCollection

Вывод:

{
    "TableAutoScalingDescription": {
        "TableName": "MusicCollection",
        "TableStatus": "ACTIVE",
        "Replicas": [
            {
                "RegionName": "us-east-1",
                "GlobalSecondaryIndexes": [],
                "ReplicaProvisionedReadCapacityAutoScalingSettings": {
                    "MinimumUnits": 5,
                    "MaximumUnits": 40000,
                    "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable",
                    "ScalingPolicies": [
                        {
                            "PolicyName": "DynamoDBReadCapacityUtilization:table/MusicCollection",
                            "TargetTrackingScalingPolicyConfiguration": {
                                "TargetValue": 70.0
                            }
                        }
                    ]
                },
                "ReplicaProvisionedWriteCapacityAutoScalingSettings": {
                    "MinimumUnits": 5,
                    "MaximumUnits": 40000,
                    "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable",
                    "ScalingPolicies": [
                        {
                            "PolicyName": "DynamoDBWriteCapacityUtilization:table/MusicCollection",
                            "TargetTrackingScalingPolicyConfiguration": {
                                "TargetValue": 70.0
                            }
                        }
                    ]
                },
                "ReplicaStatus": "ACTIVE"
            },
            {
                "RegionName": "us-east-2",
                "GlobalSecondaryIndexes": [],
                "ReplicaProvisionedReadCapacityAutoScalingSettings": {
                    "MinimumUnits": 5,
                    "MaximumUnits": 40000,
                    "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable",
                    "ScalingPolicies": [
                        {
                            "PolicyName": "DynamoDBReadCapacityUtilization:table/MusicCollection",
                            "TargetTrackingScalingPolicyConfiguration": {
                                "TargetValue": 70.0
                            }
                        }
                    ]
                },
                "ReplicaProvisionedWriteCapacityAutoScalingSettings": {
                    "MinimumUnits": 5,
                    "MaximumUnits": 40000,
                    "AutoScalingRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable",
                    "ScalingPolicies": [
                        {
                            "PolicyName": "DynamoDBWriteCapacityUtilization:table/MusicCollection",
                            "TargetTrackingScalingPolicyConfiguration": {
                                "TargetValue": 70.0
                            }
                        }
                    ]
                },
                "ReplicaStatus": "ACTIVE"
            }
        ]
    }
}

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

Вывод

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

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

TableName -> (строка)

Имя таблицы.

TableStatus -> (строка)

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

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

Replicas -> (список)

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

(structure)

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

RegionName -> (string)

Регион, в котором существует реплика.

GlobalSecondaryIndexes -> (list)

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

(structure)

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

IndexName -> (string)

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

IndexStatus -> (string)

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

  • CREATING - Индекс создается.
  • UPDATING - Конфигурация таблицы/индекса обновляется. Таблица/индекс остаются доступными для операций с данными, когда UPDATING
  • DELETING - Индекс удаляется.
  • ACTIVE - Индекс готов к использованию.

ProvisionedReadCapacityAutoScalingSettings -> (structure)

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

MinimumUnits -> (long)

Минимальное количество единиц емкости, до которых следует уменьшить глобальную таблицу или глобальный вторичный индекс.

MaximumUnits -> (long)

Максимальное количество единиц емкости, до которых следует увеличить глобальную таблицу или глобальный вторичный индекс.

AutoScalingDisabled -> (boolean)

Отключено автоматическое масштабирование для этой глобальной таблицы или глобального вторичного индекса.

AutoScalingRoleArn -> (string)

Роль ARN, используемая для настройки политики автоматического масштабирования.

ScalingPolicies -> (list)

Информация о политиках масштабирования.

(structure)

Представляет свойства политики масштабирования.

PolicyName -> (string)

Название политики масштабирования.

TargetTrackingScalingPolicyConfiguration -> (structure)

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

DisableScaleIn -> (boolean)

Указывает, отключено ли масштабирование посредством политики отслеживания целевого значения. Если значение равно true, масштабирование уменьшения отключено, и политика отслеживания целевого значения не удалит емкость из масштабируемого ресурса. В противном случае масштабирование уменьшения включено, и политика отслеживания целевого значения может удалить емкость из масштабируемого ресурса. Значение по умолчанию — false.

ScaleInCooldown -> (integer)

Количество времени в секундах, по истечении которого после завершения действия масштабирования уменьшения может начаться следующее действие масштабирования уменьшения. Период ожидания используется для блокировки последующих запросов на уменьшение масштаба до истечения срока действия. Следует масштабировать уменьшение консервативно, чтобы защитить доступность приложения. Однако, если другая тревога активирует политику масштабирования увеличения во время периода ожидания после масштабирования уменьшения, автоматическое масштабирование приложений немедленно увеличивает масштаб вашего масштабируемого целевого объекта.

ScaleOutCooldown -> (integer)

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

TargetValue -> (double)

Целевое значение для метрики. Диапазон от 8.515920e-109 до 1.174271e+108 (Base 10) или от 2e-360 до 2e360 (Base 2).

ProvisionedWriteCapacityAutoScalingSettings -> (structure)

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

MinimumUnits -> (long)

Минимальное количество единиц емкости, до которых следует уменьшить глобальную таблицу или глобальный вторичный индекс.

MaximumUnits -> (long)

Максимальное количество единиц емкости, до которых следует увеличить глобальную таблицу или глобальный вторичный индекс.

AutoScalingDisabled -> (boolean)

Отключено автоматическое масштабирование для этой глобальной таблицы или глобального вторичного индекса.

AutoScalingRoleArn -> (string)

Роль ARN, используемая для настройки политики автоматического масштабирования.

ScalingPolicies -> (list)

Информация о политиках масштабирования.

(structure)

Представляет свойства политики масштабирования.

PolicyName -> (string)

Название политики масштабирования.

TargetTrackingScalingPolicyConfiguration -> (structure)

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

DisableScaleIn -> (boolean)

Указывает, отключено ли масштабирование посредством политики отслеживания целевого значения. Если значение равно true, масштабирование уменьшения отключено, и политика отслеживания целевого значения не удалит емкость из масштабируемого ресурса. В противном случае масштабирование уменьшения включено, и политика отслеживания целевого значения может удалить емкость из масштабируемого ресурса. Значение по умолчанию — false.

ScaleInCooldown -> (integer)

Количество времени в секундах, по истечении которого после завершения действия масштабирования уменьшения может начаться следующее действие масштабирования уменьшения. Период ожидания используется для блокировки последующих запросов на уменьшение масштаба до истечения срока действия. Следует масштабировать уменьшение консервативно, чтобы защитить доступность приложения. Однако, если другая тревога активирует политику масштабирования увеличения во время периода ожидания после масштабирования уменьшения, автоматическое масштабирование приложений немедленно увеличивает масштаб вашего масштабируемого целевого объекта.

ScaleOutCooldown -> (integer)

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

TargetValue -> (double)

Целевое значение для метрики. Диапазон от 8.515920e-109 до 1.174271e+108 (Base 10) или от 2e-360 до 2e360 (Base 2).

ReplicaProvisionedReadCapacityAutoScalingSettings -> (structure)

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

MinimumUnits -> (long)

Минимальное количество единиц емкости, до которых следует уменьшить глобальную таблицу или глобальный вторичный индекс.

MaximumUnits -> (long)

Максимальное количество единиц емкости, до которых следует увеличить глобальную таблицу или глобальный вторичный индекс.

AutoScalingDisabled -> (boolean)

Отключено автоматическое масштабирование для этой глобальной таблицы или глобального вторичного индекса.

AutoScalingRoleArn -> (string)

Роль ARN, используемая для настройки политики автоматического масштабирования.

ScalingPolicies -> (list)

Информация о политиках масштабирования.

(structure)

Представляет свойства политики масштабирования.

PolicyName -> (string)

Название политики масштабирования.

TargetTrackingScalingPolicyConfiguration -> (structure)

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

DisableScaleIn -> (boolean)

Указывает, отключено ли масштабирование посредством политики отслеживания целевого значения. Если значение равно true, масштабирование уменьшения отключено, и политика отслеживания целевого значения не удалит емкость из масштабируемого ресурса. В противном случае масштабирование уменьшения включено, и политика отслеживания целевого значения может удалить емкость из масштабируемого ресурса. Значение по умолчанию — false.

ScaleInCooldown -> (integer)

Количество времени в секундах, по истечении которого после завершения действия масштабирования уменьшения может начаться следующее действие масштабирования уменьшения. Период ожидания используется для блокировки последующих запросов на уменьшение масштаба до истечения срока действия. Следует масштабировать уменьшение консервативно, чтобы защитить доступность приложения. Однако, если другая тревога активирует политику масштабирования увеличения во время периода ожидания после масштабирования уменьшения, автоматическое масштабирование приложений немедленно увеличивает масштаб вашего масштабируемого целевого объекта.

ScaleOutCooldown -> (integer)

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

TargetValue -> (double)

Целевое значение для метрики. Диапазон от 8.515920e-109 до 1.174271e+108 (Base 10) или от 2e-360 до 2e360 (Base 2).

ReplicaProvisionedWriteCapacityAutoScalingSettings -> (structure)

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

MinimumUnits -> (long)

Минимальное количество единиц емкости, до которых следует уменьшить глобальную таблицу или глобальный вторичный индекс.

MaximumUnits -> (long)

Максимальное количество единиц емкости, до которых следует увеличить глобальную таблицу или глобальный вторичный индекс.

AutoScalingDisabled -> (boolean)

Отключено автоматическое масштабирование для этой глобальной таблицы или глобального вторичного индекса.

AutoScalingRoleArn -> (string)

Роль ARN, используемая для настройки политики автоматического масштабирования.

ScalingPolicies -> (list)

Информация о политиках масштабирования.

(structure)

Представляет свойства политики масштабирования.

PolicyName -> (string)

Название политики масштабирования.

TargetTrackingScalingPolicyConfiguration -> (structure)

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

DisableScaleIn -> (boolean)

Указывает, отключено ли масштабирование посредством политики отслеживания целевого значения. Если значение равно true, масштабирование уменьшения отключено, и политика отслеживания целевого значения не удалит емкость из масштабируемого ресурса. В противном случае масштабирование уменьшения включено, и политика отслеживания целевого значения может удалить емкость из масштабируемого ресурса. Значение по умолчанию — false.

ScaleInCooldown -> (integer)

Количество времени в секундах, по истечении которого после завершения действия масштабирования уменьшения может начаться следующее действие масштабирования уменьшения. Период ожидания используется для блокировки последующих запросов на уменьшение масштаба до истечения срока действия. Следует масштабировать уменьшение консервативно, чтобы защитить доступность приложения. Однако, если другая тревога активирует политику масштабирования увеличения во время периода ожидания после масштабирования уменьшения, автоматическое масштабирование приложений немедленно увеличивает масштаб вашего масштабируемого целевого объекта.

ScaleOutCooldown -> (integer)

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

TargetValue -> (double)

Целевое значение для метрики. Диапазон от 8.515920e-109 до 1.174271e+108 (Base 10) или от 2e-360 до 2e360 (Base 2).

ReplicaStatus -> (string)

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

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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