Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

Перезапуск группы фрагментов БД

Описание

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

Данная операция применяется только к группам фрагментов БД Aurora Limitless.

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

Синтаксис

  reboot-db-shard-group
--db-shard-group-identifier <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 (строка)

Имя группы фрагментов БД для перезапуска.

--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 для вывода.

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

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

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

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

Примеры

Примечание

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

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

Пример 1: Перезапуск группы фрагментов БД

В следующем reboot-db-shard-group примере перезапускается группа фрагментов БД.

aws rds reboot-db-shard-group \
    --db-shard-group-identifier my-db-shard-group

Вывод:

{
    "DBShardGroups": [
        {
            "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 или экземпляра Amazon Aurora DB» в Руководстве пользователя Amazon Aurora.

Пример 2: Описание групп фрагментов БД

В следующем describe-db-shard-groups примере извлекаются данные о ваших группах фрагментов БД после выполнения команды reboot-db-shard-group. Группа фрагментов БД my-db-shard-group сейчас перезапускается.

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": "rebooting",
            "PubliclyAccessible": false,
            "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
        }
    ]
}

Дополнительную информацию см. в разделе «Перезапуск кластера Amazon Aurora DB или экземпляра Amazon Aurora DB» в Руководстве пользователя Amazon Aurora.

Вывод

DBShardGroupResourceId -> (строка)

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

DBShardGroupIdentifier -> (строка)

Имя группы фрагментов БД.

DBClusterIdentifier -> (строка)

Имя основного кластера БД для группы фрагментов БД.

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

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

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

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

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

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

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

Status -> (строка)

Статус группы фрагментов БД.

PubliclyAccessible -> (булево)

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

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

Если группа фрагментов БД не доступна для публичного доступа, это внутренняя группа фрагментов БД с 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:. Строка может содержать только символы Юникода, цифры, пробелы, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

Value -> (строка)

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

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

Spec-Zone.ru

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