Spec-Zone.ru › AWS CLI v2

[ aws . globalaccelerator ]

обновить-акселератор

Описание

Обновление акселератора для внесения изменений, таких как:

  • Изменение имени акселератора.
  • Отключение акселератора, чтобы он больше не принимал или не маршрутизировал трафик, или чтобы вы могли его удалить.
  • Включение акселератора, если он отключен.
  • Изменение типа IP-адреса на двойной стек, если это IPv4, или изменение типа IP-адреса на IPv4, если это двойной стек.

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

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

Глобальный акселератор — это глобальная служба, которая поддерживает конечные точки во многих регионах Amazon Web Services, но для создания, обновления или работы с акселераторами необходимо указать регион США Запад (Орегон). То есть, например, укажите --region us-west-2 в командах Amazon Web Services CLI.

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

Синтаксис

  update-accelerator
--accelerator-arn <value>
[--name <value>]
[--ip-address-type <value>]
[--ip-addresses <value>]
[--enabled | --no-enabled]
[--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]

Параметры

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

Amazon Resource Name (ARN) акселератора для обновления.

--name (строка)

Имя акселератора. Имя может содержать не более 64 символов, должно содержать только буквенно-цифровые символы, точки (.) или дефисы (-), и не должно начинаться или заканчиваться дефисом или точкой.

--ip-address-type (строка)

Тип IP-адреса, который поддерживает акселератор. Для стандартного акселератора значение может быть IPV4 или DUAL_STACK.

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

  • IPV4
  • DUAL_STACK

--ip-addresses (список)

IP-адреса для акселератора.

(строка)

Синтаксис:

"string" "string" ...

--enabled | --no-enabled (логическое значение)

Указывает, включен ли акселератор. Значение равно true или false. По умолчанию значение равно true.

Если значение установлено в true, акселератор не может быть удален. Если значение установлено в false, акселератор может быть удален.

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

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

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

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

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

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

Примеры

Примечание

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

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

Для обновления акселератора

В следующем update-accelerator примере изменяется имя акселератора на ExampleAcceleratorNew. Необходимо указать регион US-West-2 (Oregon) для создания или обновления акселераторов.

aws globalaccelerator update-accelerator \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --name ExampleAcceleratorNew

Вывод:

{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleAcceleratorNew",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1232394847,
        "LastModifiedTime": 1232395654
    }
}

Для получения дополнительной информации, ознакомьтесь с разделом Акселераторы в AWS Global Accelerator в руководстве разработчика AWS Global Accelerator.

Вывод

Ускоритель -> (структура)

Информация об обновленном ускорителе.

AcceleratorArn -> (строка)

Amazon Resource Name (ARN) ускорителя.

Name -> (строка)

Имя ускорителя. Имя должно содержать только буквенно-цифровые символы или дефисы (-), и не должно начинаться или заканчиваться дефисом.

IpAddressType -> (строка)

Тип IP-адреса, поддерживаемый ускорителем. Для стандартного ускорителя значение может быть IPV4 или DUAL_STACK.

Enabled -> (логическое значение)

Указывает, включен ли ускоритель. Значение равно true или false. По умолчанию значение равно true.

Если значение установлено в true, ускоритель не может быть удален. Если значение установлено в false, ускоритель может быть удален.

IpSets -> (список)

Статические IP-адреса, которые Global Accelerator связывает с ускорителем.

(структура)

Сложный тип для набора IP-адресов ускорителя.

IpFamily -> (строка)

IpFamily устарел и был заменён на IpAddressFamily.

IpAddresses -> (список)

Массив IP-адресов в наборе IP-адресов. Набор IP-адресов может содержать не более двух IP-адресов.

(строка)

IpAddressFamily -> (строка)

Типы IP-адресов, включённые в этот набор IP-адресов.

DnsName -> (строка)

Имя доменной системы (DNS), которое Global Accelerator создаёт и указывает на статические IPv4-адреса ускорителя.

Конвенция именования для имени DNS ускорителя следующая: малая буква «a», за которой следует 16-битная случайная шестнадцатеричная строка, за которой следует .awsglobalaccelerator.com. Например: a1234567890abcdef.awsglobalaccelerator.com.

Если у вас есть ускоритель с двойной стековой архитектурой, у вас также есть второе имя DNS, DualStackDnsName , которое указывает как на запись A, так и на запись AAAA для всех четырёх статических адресов ускорителя: два IPv4-адреса и два IPv6-адреса.

Дополнительную информацию о имени DNS по умолчанию см. в разделе Поддержка адресации DNS в Global Accelerator в Руководстве разработчика Global Accelerator.

Status -> (строка)

Описание состояния развертывания ускорителя.

CreatedTime -> (метка времени)

Дата и время создания ускорителя.

LastModifiedTime -> (метка времени)

Дата и время последнего изменения ускорителя.

DualStackDnsName -> (строка)

Имя доменной системы (DNS), которое Global Accelerator создаёт и указывает на четыре статических IP-адреса ускорителя с двойной стековой архитектурой: два IPv4-адреса и два IPv6-адреса.

Конвенция именования для имени DNS двойной стековой архитектуры следующая: малая буква «a», за которой следует 16-битная случайная шестнадцатеричная строка, за которой следует .dualstack.awsglobalaccelerator.com. Например: a1234567890abcdef.dualstack.awsglobalaccelerator.com.

Примечание: Global Accelerator также назначает ускорителю имя DNS по умолчанию, DnsName, которое указывает только на статические IPv4-адреса.

Дополнительную информацию см. в разделе Поддержка адресации DNS в Global Accelerator в Руководстве разработчика Global Accelerator.

Events -> (список)

История изменений, которые вы вносите в ускоритель в Global Accelerator.

(структура)

Сложный тип, который содержит значение Timestamp и Message для изменений, которые вы вносите в ускоритель в Global Accelerator. Сообщения, хранящиеся здесь, предоставляют информацию о ходе выполнения или об ошибках при обновлении ускорителя с IPv4 на двойную стековую архитектуру или с двойной стековой архитектуры на IPv4. Global Accelerator хранит не более десяти сообщений об событиях.

Message -> (строка)

Строка, содержащая сообщение Event, описывающее изменения или ошибки при обновлении ускорителя в Global Accelerator с IPv4 на двойную стековую архитектуру или с двойной стековой архитектуры на IPv4.

Timestamp -> (метка времени)

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

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

Spec-Zone.ru

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