Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

modify-db-shard-group

Описание

Изменяет параметры группы фрагментов базы данных Aurora Limitless. Вы можете изменить один или несколько параметров, указав их и новые значения в запросе.

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

Синтаксис

  modify-db-shard-group
--db-shard-group-identifier <value>
[--max-acu <value>]
[--min-acu <value>]
[--compute-redundancy <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]

Параметры

--db-shard-group-identifier (строка)

Имя группы фрагментов базы данных для изменения.

--max-acu (двойное)

Максимальная емкость группы фрагментов базы данных в единицах емкости Aurora (ACU).

--min-acu (двойное)

Минимальная емкость группы фрагментов базы данных в единицах емкости Aurora (ACU).

--compute-redundancy (целое)

Указывает, нужно ли создавать резервные группы фрагментов базы данных для группы фрагментов базы данных. Допустимые значения:

  • 0 — Создаёт группу фрагментов базы данных без резервной группы фрагментов. Это значение по умолчанию.
  • 1 — Создаёт группу фрагментов базы данных с резервной группой фрагментов в другой доступной зоне (AZ).
  • 2 — Создаёт группу фрагментов базы данных с двумя резервными группами фрагментов в двух разных AZ.

--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
  • таблица
  • 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 (булево)

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

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Примеры

Примечание

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

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

Пример 1: Изменение группы фрагментов базы данных

Следующий modify-db-shard-group пример изменяет максимальную емкость группы фрагментов базы данных.

aws rds modify-db-shard-group \
    --db-shard-group-identifier my-db-shard-group \
    --max-acu 1000

Вывод:

{
    "DBShardGroups": [
        {
            "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
            "DBShardGroupIdentifier": "my-db-shard-group",
            "DBClusterIdentifier": "my-sv2-cluster",
            "MaxACU": 768.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": false,
            "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        }
    ]
}

Для получения дополнительной информации см. Amazon Aurora DB Clusters в Руководстве пользователя Amazon Aurora.

Пример 2: Описание ваших групп фрагментов базы данных

Следующий describe-db-shard-groups пример извлекает данные о ваших группах фрагментов базы данных после выполнения команды modify-db-shard-group. Максимальная емкость группы фрагментов базы данных my-db-shard-group теперь составляет 1000 единиц емкости Aurora (ACU).

aws rds describe-db-shard-groups

Вывод:

{
    "DBShardGroups": [
        {
            "DBShardGroupResourceId": "shardgroup-7bb446329da94788b3f957746example",
            "DBShardGroupIdentifier": "limitless-test-shard-grp",
            "DBClusterIdentifier": "limitless-test-cluster",
            "MaxACU": 768.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": true,
            "Endpoint": "limitless-test-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        },
        {
            "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
            "DBShardGroupIdentifier": "my-db-shard-group",
            "DBClusterIdentifier": "my-sv2-cluster",
            "MaxACU": 1000.0,
            "ComputeRedundancy": 0,
            "Status": "available",
            "PubliclyAccessible": false,
            "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        }
    ]
}

Для получения дополнительной информации см. Amazon Aurora DB Clusters в Руководстве пользователя Amazon Aurora.

Вывод

DBShardGroupResourceId -> (строка)

Уникальный, неизменяемый идентификатор группы фрагментов базы данных в регионе Amazon Web Services.

DBShardGroupIdentifier -> (строка)

Имя группы фрагментов базы данных.

DBClusterIdentifier -> (строка)

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

MaxACU -> (двойное)

Максимальная емкость группы фрагментов базы данных в единицах емкости Aurora (ACU).

MinACU -> (двойное)

Минимальная емкость группы фрагментов базы данных в единицах емкости Aurora (ACU).

ComputeRedundancy -> (целое)

Указывает, нужно ли создавать резервные группы фрагментов базы данных для группы фрагментов базы данных. Допустимые значения:

  • 0 — Создаёт группу фрагментов базы данных без резервной группы фрагментов. Это значение по умолчанию.
  • 1 — Создаёт группу фрагментов базы данных с резервной группой фрагментов в другой доступной зоне (AZ).
  • 2 — Создаёт группу фрагментов базы данных с двумя резервными группами фрагментов в двух разных AZ.

Status -> (строка)

Статус группы фрагментов базы данных.

PubliclyAccessible -> (булево)

Указывает, доступна ли группа фрагментов базы данных для общего доступа.

Если группа фрагментов базы данных доступна для общего доступа, её DNS-имя разрешается в частный IP-адрес внутри виртуальной частной сети (VPC) группы фрагментов базы данных. Она разрешается в публичный IP-адрес за пределами VPC группы фрагментов базы данных. Доступ к группе фрагментов базы данных в конечном итоге контролируется используемой группой безопасности. Этот общий доступ не разрешен, если группа безопасности, назначенная группе фрагментов базы данных, его не разрешает.

Если группа фрагментов базы данных недоступна для общего доступа, это внутренняя группа фрагментов базы данных с DNS-именем, которое разрешается в частный IP-адрес.

Для получения дополнительной информации см. CreateDBShardGroup.

Эта настройка предназначена только для Aurora Limitless Database.

Endpoint -> (строка)

Точка подключения к группе фрагментов базы данных.

DBShardGroupArn -> (строка)

Amazon Resource Name (ARN) для группы фрагментов базы данных.

TagList -> (список)

Список тегов.

Для получения дополнительной информации см. Тегирование ресурсов Amazon RDS в Руководстве пользователя Amazon RDS или Тегирование ресурсов Amazon Aurora и Amazon RDS в Руководстве пользователя Amazon Aurora.

(структура)

Метаданные, назначенные ресурсу Amazon RDS, представляющие собой пару ключ-значение.

Для получения дополнительной информации см. Тегирование ресурсов Amazon RDS в Руководстве пользователя Amazon RDS или Тегирование ресурсов Amazon Aurora и Amazon RDS в Руководстве пользователя Amazon Aurora.

Key -> (строка)

Ключ — это требуемое имя тега. Значение строки может быть от 1 до 128 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Unicode, цифры, пробелы, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: «^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$»).

Value -> (строка)

Значение — это необязательное значение тега. Значение строки может быть от 1 до 256 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Unicode, цифры, пробелы, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: «^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$»).

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

Spec-Zone.ru

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