Spec-Zone.ru › AWS CLI v2

[ aws . lambda ]

создать-псевдоним

Описание

Создаёт псевдоним для версии функции Lambda. Используйте псевдонимы, чтобы предоставить клиентам идентификатор функции, который можно обновить для вызова другой версии.

Вы также можете сопоставить псевдоним для разделения запросов вызова между двумя версиями. Используйте параметр RoutingConfig, чтобы указать вторую версию и процент запросов вызова, которые она получает.

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

Синтаксис

  create-alias
--function-name <value>
--name <value>
--function-version <value>
[--description <value>]
[--routing-config <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]

Параметры

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

Имя или ARN функции Lambda.

Форматы имён
  • Имя функции - MyFunction .
  • ARN функции - arn:aws:lambda:us-west-2:123456789012:function:MyFunction .
  • Частичный ARN - 123456789012:function:MyFunction .

Ограничение длины применяется только к полному ARN. Если вы указываете только имя функции, оно ограничено 64 символами в длину.

--name (строка)

Имя псевдонима.

--function-version (строка)

Версия функции, которую вызывает псевдоним.

--description (строка)

Описание псевдонима.

--routing-config (структура)

Настройка маршрутизации псевдонима.

AdditionalVersionWeights -> (карта)

Вторая версия и процент трафика, направляемого на неё.

ключ -> (строка)

значение -> (двойное)

Сокращённый синтаксис:

AdditionalVersionWeights={KeyName1=double,KeyName2=double}

Синтаксис JSON:

{
  "AdditionalVersionWeights": {"string": double
    ...}
}

--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.

Для создания псевдонима для функции Lambda

Следующий пример create-alias создаёт псевдоним с именем LIVE, который указывает на версию 1 функции Lambda my-function.

aws lambda create-alias \
    --function-name my-function \
    --description "alias for live version of function" \
    --function-version 1 \
    --name LIVE

Вывод:

{
    "FunctionVersion": "1",
    "Name": "LIVE",
    "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
    "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6",
    "Description": "alias for live version of function"
}

Дополнительную информацию см. в разделе Настройка псевдонимов функций AWS Lambda в Руководстве разработчика AWS Lambda.

Вывод

AliasArn -> (строка)

Amazon Resource Name (ARN) псевдонима.

Name -> (строка)

Имя псевдонима.

FunctionVersion -> (строка)

Версия функции, которую вызывает псевдоним.

Description -> (строка)

Описание псевдонима.

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

Настройка маршрутизации псевдонима.

AdditionalVersionWeights -> (карта)

Вторая версия и процент трафика, направляемого на неё.

ключ -> (строка)

значение -> (двойное)

RevisionId -> (строка)

Уникальный идентификатор, который изменяется при обновлении псевдонима.

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

Spec-Zone.ru

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