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 -> (строка)
Runtime -> (строка)
Идентификатор среды выполнения функции. Среда выполнения требуется, если пакет развертывания представляет собой архив .zip. Указание среды выполнения приводит к ошибке при развертывании функции с помощью образа контейнера.
В следующем списке указаны устаревшие среды выполнения. Lambda блокирует создание новых функций и обновление существующих функций вскоре после того, как каждая среда выполнения устаревает. Дополнительную информацию см. в разделе Использование среды выполнения после устаревания.
Список всех поддерживаемых сред выполнения см. в разделе Поддерживаемые среды выполнения.
Роль -> (строка)
Обработчик -> (строка)
РазмерКода -> (целое число)
Описание -> (строка)
Таймаут -> (целое число)
РазмерПамяти -> (целое число)
ПоследнееИзменение -> (строка)
CodeSha256 -> (строка)
Версия -> (строка)
VpcConfig -> (структура)
Настройка сети функции.
SubnetIds -> (список)
Список идентификаторов подсетей VPC.
(строка)
SecurityGroupIds -> (список)
Список идентификаторов групп безопасности VPC.
(строка)
VpcId -> (строка)
Ipv6AllowedForDualStack -> (логическое)
DeadLetterConfig -> (структура)
Очередь сообщений с ошибками функции.
TargetArn -> (строка)
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 -> (строка)
RevisionId -> (строка)
Слои -> (список)
Слои функции.
(структура)
Слой Lambda.
Arn -> (строка)
РазмерКода -> (целое число)
SigningProfileVersionArn -> (строка)
SigningJobArn -> (строка)
Состояние -> (строка)
Inactive, вы можете повторно активировать функцию, вызвав ее.ПричинаСостояния -> (строка)
КодПричиныСостояния -> (строка)
Creating, вы не можете вызывать или изменять функцию.СтатусПоследнегоОбновления -> (строка)
Successful после завершения создания функции.ПричинаПоследнегоОбновления -> (строка)
КодПричинПоследнегоОбновления -> (строка)
FileSystemConfigs -> (список)
Настройки подключения к файловой системе Amazon EFS.
(структура)
Подробности о подключении функции Lambda к файловой системе Amazon EFS.
Arn -> (строка)
LocalMountPath -> (строка)
/mnt/.ТипПакеты -> (строка)
Image для образа контейнера и в Zip для архива .zip.ImageConfigResponse -> (структура)
Значения конфигурации изображения функции.
ImageConfig -> (структура)
Значения конфигурации, которые переопределяют Dockerfile образа контейнера.
EntryPoint -> (список)
Указывает точку входа в ваше приложение, которая обычно является местоположением исполняемого файла среды выполнения.
(строка)
Command -> (список)
Указывает параметры, которые вы хотите передать вместе с ENTRYPOINT.
(строка)
WorkingDirectory -> (строка)
Ошибка -> (структура)
Ответ об ошибке для GetFunctionConfiguration.
КодОшибки -> (строка)
Сообщение -> (строка)
SigningProfileVersionArn -> (строка)
SigningJobArn -> (строка)
Architectures -> (список)
Архитектура набора инструкций, которую поддерживает функция. Архитектура — строковый массив с одним из допустимых значений. Значение по умолчанию для архитектуры — x86_64.
(строка)
EphemeralStorage -> (структура)
Размер каталога /tmp функции в МБ. Значение по умолчанию равно 512, но может быть любым целым числом от 512 до 10 240 МБ. Дополнительную информацию см. в разделе Настройка временного хранилища (консоль).
Размер -> (целое число)
/tmp функции.SnapStart -> (структура)
Установите ApplyOn в PublishedVersions, чтобы создать снимок инициализированной среды выполнения при публикации версии функции. Дополнительную информацию см. в разделе Улучшение производительности запуска с помощью SnapStart Lambda.
ПрименятьК -> (строка)
PublishedVersions Lambda создает снимок среды выполнения при публикации версии функции.СтатусОптимизации -> (строка)
RuntimeVersionConfig -> (структура)
ARN среды выполнения и любые возникшие ошибки.
RuntimeVersionArn -> (строка)
Ошибка -> (структура)
Ответ об ошибке, когда Lambda не может получить версию среды выполнения для функции.
КодОшибки -> (строка)
Сообщение -> (строка)
LoggingConfig -> (структура)
Настройки конфигурации журналов Amazon CloudWatch для функции.
ФорматЖурнала -> (строка)
УровеньПодробностейПриложения -> (строка)
TRACE — самый высокий уровень, а FATAL — самый низкий.УровеньПодробностейСистемы -> (строка)
DEBUG — самый высокий уровень, а WARN — самый низкий.ГруппаЖурналов -> (строка)
/aws/lambda/<function name>. Чтобы использовать другую группу журналов, введите существующее имя группы журналов или имя новой группы журналов.
© Copyright 2025, Amazon Web Services. Created using Sphinx.