Spec-Zone.ru › AWS CLI v2

[ aws . lambda ]

get-function-configuration

Описание

Возвращает настройки функции Lambda или версии, специфичные для версии. Вывод включает только параметры, которые могут отличаться между версиями функции. Для изменения этих настроек используйте UpdateFunctionConfiguration.

Чтобы получить все детали функции, включая настройки на уровне функции, используйте GetFunction.

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

Синтаксис

  get-function-configuration
--function-name <value>
[--qualifier <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, версии или алиаса.

Форматы имён
  • Имя функции – my-function (только имя), my-function:v1 (с алиасом).
  • ARN функции – arn:aws:lambda:us-west-2:123456789012:function:my-function .
  • Частичный ARN – 123456789012:function:my-function .

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

--qualifier (строка)

Укажите версию или алиас, чтобы получить детали опубликованной версии функции.

--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 (строка)

Регион для использования. Переопределяет настройки config/env.

--version (строка)

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

--color (строка)

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

  • вкл
  • выкл
  • авто

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Образ сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки config/env.

--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, специфичные для версии

Следующий пример отображает настройки версии 2 функции my-function.

aws lambda get-function-configuration \
    --function-name  my-function:2

Вывод:

{
    "FunctionName": "my-function",
    "LastModified": "2019-09-26T20:28:40.438+0000",
    "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d",
    "MemorySize": 256,
    "Version": "2",
    "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq",
    "Timeout": 3,
    "Runtime": "nodejs10.x",
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=",
    "Description": "",
    "VpcConfig": {
        "SubnetIds": [],
        "VpcId": "",
        "SecurityGroupIds": []
    },
    "CodeSize": 304,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:2",
    "Handler": "index.handler"
}

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

Вывод

ИмяФункции -> (строка)

Название функции.

FunctionArn -> (строка)

Amazon Resource Name (ARN) функции.

Runtime -> (строка)

Идентификатор среды выполнения функции. Среда выполнения требуется, если пакет развертывания представляет собой архив .zip. Указание среды выполнения приводит к ошибке при развертывании функции с помощью образа контейнера.

В следующем списке указаны устаревшие среды выполнения. Lambda блокирует создание новых функций и обновление существующих функций вскоре после того, как каждая среда выполнения устаревает. Дополнительную информацию см. в разделе Использование среды выполнения после устаревания.

Список всех поддерживаемых сред выполнения см. в разделе Поддерживаемые среды выполнения.

Роль -> (строка)

Роль выполнения функции.

Обработчик -> (строка)

Функция, которую Lambda вызывает для начала выполнения вашей функции.

РазмерКода -> (целое число)

Размер пакета развертывания функции в байтах.

Описание -> (строка)

Описание функции.

Таймаут -> (целое число)

Количество времени в секундах, которое Lambda позволяет функции выполняться перед ее остановкой.

РазмерПамяти -> (целое число)

Объем памяти, доступный функции во время выполнения.

ПоследнееИзменение -> (строка)

Дата и время последнего обновления функции в формате ISO-8601 (ГГГГ-ММ-ДДТчч:мм:сс.сTZD).

CodeSha256 -> (строка)

Хеш SHA256 пакета развертывания функции.

Версия -> (строка)

Версия функции Lambda.

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

Настройка сети функции.

SubnetIds -> (список)

Список идентификаторов подсетей VPC.

(строка)

SecurityGroupIds -> (список)

Список идентификаторов групп безопасности VPC.

(строка)

VpcId -> (строка)

Идентификатор VPC.

Ipv6AllowedForDualStack -> (логическое)

Разрешает исходящий трафик IPv6 для функций VPC, подключенных к сетям двойной стековой.

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

Очередь сообщений с ошибками функции.

TargetArn -> (строка)

Amazon Resource Name (ARN) очереди Amazon SQS или темы Amazon SNS.

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

Переменные окружения функции. Исключены из журналов CloudTrail.

Variables -> (массив)

Пары значений ключей переменных окружения. Исключены из журналов CloudTrail.

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

значение -> (строка)

Ошибка -> (структура)

Сообщения об ошибках для переменных окружения, которые не были применены.

КодОшибки -> (строка)

Код ошибки.

Сообщение -> (строка)

Сообщение об ошибке.

KMSKeyArn -> (строка)

ARN управляемого ключа KMS, используемого для шифрования следующих ресурсов:

  • Переменные окружения функции.
  • Снимки Lambda SnapStart функции.
  • При использовании с SourceKMSKeyArn, распакованная версия пакета развертывания .zip, используемая для вызовов функций. Дополнительную информацию см. в разделе Указание управляемого ключа для Lambda.
  • Оптимизированная версия образа контейнера, используемая для вызовов функций. Обратите внимание, что это не тот же ключ, который используется для защиты вашего образа контейнера в Amazon Elastic Container Registry (Amazon ECR). Дополнительную информацию см. в разделе Жизненный цикл функции.

Если вы не укажете управляемый ключ, Lambda использует управляемый ключ Amazon Web Services.

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

Настройка отслеживания X-Ray функции.

Режим -> (строка)

Режим отслеживания.

MasterArn -> (строка)

Для функций Lambda@Edge — ARN основной функции.

RevisionId -> (строка)

Последняя обновленная ревизия функции или псевдонима.

Слои -> (список)

Слои функции.

(структура)

Слой Lambda.

Arn -> (строка)

Amazon Resource Name (ARN) слоя функции.

РазмерКода -> (целое число)

Размер архива слоя в байтах.

SigningProfileVersionArn -> (строка)

Amazon Resource Name (ARN) версии профиля подписи.

SigningJobArn -> (строка)

Amazon Resource Name (ARN) задачи подписи.

Состояние -> (строка)

Текущее состояние функции. Если состояние Inactive, вы можете повторно активировать функцию, вызвав ее.

ПричинаСостояния -> (строка)

Причина текущего состояния функции.

КодПричиныСостояния -> (строка)

Код причины текущего состояния функции. Если код Creating, вы не можете вызывать или изменять функцию.

СтатусПоследнегоОбновления -> (строка)

Статус последнего обновления функции. Сначала устанавливается в Successful после завершения создания функции.

ПричинаПоследнегоОбновления -> (строка)

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

КодПричинПоследнегоОбновления -> (строка)

Код причины последнего обновления функции.

FileSystemConfigs -> (список)

Настройки подключения к файловой системе Amazon EFS.

(структура)

Подробности о подключении функции Lambda к файловой системе Amazon EFS.

Arn -> (строка)

Amazon Resource Name (ARN) точки доступа Amazon EFS, предоставляющей доступ к файловой системе.

LocalMountPath -> (строка)

Путь, по которому функция может получить доступ к файловой системе, начинающийся с /mnt/.

ТипПакеты -> (строка)

Тип пакета развертывания. Устанавливается в Image для образа контейнера и в Zip для архива .zip.

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

Значения конфигурации изображения функции.

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

Значения конфигурации, которые переопределяют Dockerfile образа контейнера.

EntryPoint -> (список)

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

(строка)

Command -> (список)

Указывает параметры, которые вы хотите передать вместе с ENTRYPOINT.

(строка)

WorkingDirectory -> (строка)

Указывает рабочую директорию.

Ошибка -> (структура)

Ответ об ошибке для GetFunctionConfiguration.

КодОшибки -> (строка)

Код ошибки.

Сообщение -> (строка)

Сообщение об ошибке.

SigningProfileVersionArn -> (строка)

ARN версии профиля подписи.

SigningJobArn -> (строка)

ARN задачи подписи.

Architectures -> (список)

Архитектура набора инструкций, которую поддерживает функция. Архитектура — строковый массив с одним из допустимых значений. Значение по умолчанию для архитектуры — x86_64.

(строка)

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

Размер каталога /tmp функции в МБ. Значение по умолчанию равно 512, но может быть любым целым числом от 512 до 10 240 МБ. Дополнительную информацию см. в разделе Настройка временного хранилища (консоль).

Размер -> (целое число)

Размер каталога /tmp функции.

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

Установите ApplyOn в PublishedVersions, чтобы создать снимок инициализированной среды выполнения при публикации версии функции. Дополнительную информацию см. в разделе Улучшение производительности запуска с помощью SnapStart Lambda.

ПрименятьК -> (строка)

При установке в PublishedVersions Lambda создает снимок среды выполнения при публикации версии функции.

СтатусОптимизации -> (строка)

Когда вы предоставите квалифицированный Amazon Resource Name (ARN), этот элемент ответа указывает, активирован ли SnapStart для указанной версии функции.

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

ARN среды выполнения и любые возникшие ошибки.

RuntimeVersionArn -> (строка)

ARN версии среды выполнения, которую вы хотите использовать для функции.

Ошибка -> (структура)

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

КодОшибки -> (строка)

Код ошибки.

Сообщение -> (строка)

Сообщение об ошибке.

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

Настройки конфигурации журналов Amazon CloudWatch для функции.

ФорматЖурнала -> (строка)

Формат, в котором Lambda отправляет журналы приложения и системы вашей функции в CloudWatch. Выберите простой текст или структурированный JSON.

УровеньПодробностейПриложения -> (строка)

Установите этот параметр для фильтрации журналов приложения вашей функции, которые Lambda отправляет в CloudWatch. Lambda отправляет только журналы приложения на выбранном уровне детализации и ниже, где TRACE — самый высокий уровень, а FATAL — самый низкий.

УровеньПодробностейСистемы -> (строка)

Установите этот параметр для фильтрации журналов системы вашей функции, которые Lambda отправляет в CloudWatch. Lambda отправляет только журналы системы на выбранном уровне детализации и ниже, где DEBUG — самый высокий уровень, а WARN — самый низкий.

ГруппаЖурналов -> (строка)

Имя группы журналов Amazon CloudWatch, в которую функция отправляет журналы. По умолчанию функции Lambda отправляют журналы в группу журналов по умолчанию с именем /aws/lambda/<function name>. Чтобы использовать другую группу журналов, введите существующее имя группы журналов или имя новой группы журналов.

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

Spec-Zone.ru

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