get-function
Описание
Возвращает информацию о функции или версии функции, включая ссылку для скачивания пакета развертывания, действительную в течение 10 минут. Если указана версия функции, возвращаются только данные, специфичные для этой версии.
См. также: AWS API документация
Синтаксис
get-function
--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
- текст
- таблица
- 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.
Чтобы получить информацию о функции
Следующий get-function пример отображает информацию о функции my-function.
aws lambda get-function \
--function-name my-function
Вывод:
{
"Concurrency": {
"ReservedConcurrentExecutions": 100
},
"Code": {
"RepositoryType": "S3",
"Location": "https://awslambda-us-west-2-tasks.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-function..."
},
"Configuration": {
"TracingConfig": {
"Mode": "PassThrough"
},
"Version": "$LATEST",
"CodeSha256": "5tT2qgzYUHoqwR616pZ2dpkn/0J1FrzJmlKidWaaCgk=",
"FunctionName": "my-function",
"VpcConfig": {
"SubnetIds": [],
"VpcId": "",
"SecurityGroupIds": []
},
"MemorySize": 128,
"RevisionId": "28f0fb31-5c5c-43d3-8955-03e76c5c1075",
"CodeSize": 304,
"FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
"Handler": "index.handler",
"Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
"Timeout": 3,
"LastModified": "2019-09-24T18:20:35.054+0000",
"Runtime": "nodejs10.x",
"Description": ""
}
}
Для получения дополнительной информации см. Конфигурация функции AWS Lambda в Руководстве разработчика AWS Lambda.
Вывод
Настройка -> (структура)
Настройка функции или версии.
ИмяФункции -> (строка)
ФункцияArn -> (строка)
СредствоВиртуальногоВыполнения -> (строка)
Идентификатор среды выполнения функции. СредствоВиртуальногоВыполнения необходимо, если пакет развертывания — архив .zip. Указание среды выполнения при развертывании функции с помощью контейнерного образа приведет к ошибке.
В следующем списке приведены устаревшие средства выполнения. Lambda блокирует создание новых функций и обновление существующих функций вскоре после того, как каждое средство выполнения устареет. Дополнительные сведения см. в разделе Использование среды выполнения после устаревания.
Список всех поддерживаемых в настоящее время сред выполнения см. в разделе Поддерживаемые среды выполнения.
Роль -> (строка)
Обработчик -> (строка)
РазмерКода -> (целое число)
Описание -> (строка)
Таймаут -> (целое число)
РазмерПамяти -> (целое число)
ПоследнееИзменение -> (строка)
ХешКодаSha256 -> (строка)
Версия -> (строка)
НастройкаVpc -> (структура)
Настройка сетевого взаимодействия функции.
ИдентификаторыПодсетей -> (список)
Список идентификаторов подсетей VPC.
(строка)
ИдентификаторыГруппыБезопасности -> (список)
Список идентификаторов групп безопасности VPC.
(строка)
ИдентификаторVpc -> (строка)
РазрешениеIpv6ДляДвойнойСтекировки -> (логическое значение)
НастройкаОчередиСНеудачнымВыполнением -> (структура)
Очередь с необработанными сообщениями функции.
TargetArn -> (строка)
Среда -> (структура)
Переменные среды функции. Исключены из журналов CloudTrail.
Переменные -> (отображение)
Ключ-значение переменных среды. Исключены из журналов CloudTrail.
ключ -> (строка)
значение -> (строка)
Ошибка -> (структура)
Сообщения об ошибках для переменных среды, которые не были применены.
КодОшибки -> (строка)
Сообщение -> (строка)
KMSKeyArn -> (строка)
ARN управляемого клиентом ключа Key Management Service (KMS), используемого для шифрования следующих ресурсов:
- Переменные среды функции.
- Снимки Lambda SnapStart функции.
- При использовании с
SourceKMSKeyArn, разархивированная версия пакета развертывания .zip, используемого для вызовов функции. Дополнительные сведения см. в разделе Указание управляемого клиентом ключа для Lambda. - Оптимизированная версия контейнерного образа, используемого для вызовов функции. Обратите внимание, что это не тот ключ, который используется для защиты вашего контейнерного образа в Amazon Elastic Container Registry (Amazon ECR). Дополнительные сведения см. в разделе Жизненный цикл функции.
Если вы не предоставите управляемый клиентом ключ, Lambda будет использовать ключ, принадлежащий Amazon Web Services, или управляемый Amazon Web Services ключ.
НастройкаОтслеживания -> (структура)
Настройка отслеживания X-Ray для функции.
Режим -> (строка)
MasterArn -> (строка)
ИдентификаторРевизии -> (строка)
Слои -> (список)
Слои функции.
(структура)
Lambda-слой.
Arn -> (строка)
РазмерКода -> (целое число)
SigningProfileVersionArn -> (строка)
SigningJobArn -> (строка)
Состояние -> (строка)
Inactive, вы можете повторно активировать функцию, вызвав ее.ПричинаСостояния -> (строка)
КодПричинаСостояния -> (строка)
Creating, вы не можете вызывать или изменять функцию.СтатусПоследнегоОбновления -> (строка)
Successful.ПричинаПоследнегоОбновления -> (строка)
КодПричинаПоследнегоОбновления -> (строка)
FileSystemConfigs -> (список)
Настройки подключения к файловой системе Amazon EFS.
(структура)
Подробности о подключении между Lambda-функцией и файловой системой Amazon EFS.
Arn -> (строка)
LocalMountPath -> (строка)
/mnt/.ТипПакета -> (строка)
Image для контейнерного образа и в Zip для архива .zip.ImageConfigResponse -> (структура)
Значения конфигурации образа функции.
ImageConfig -> (структура)
Значения конфигурации, которые перезаписывают Dockerfile контейнерного образа.
EntryPoint -> (список)
Указывает точку входа в приложение, которая обычно является местоположением исполняемого файла среды выполнения.
(строка)
Команда -> (список)
Указывает параметры, которые вы хотите передать в ENTRYPOINT.
(строка)
РабочийКаталог -> (строка)
Ошибка -> (структура)
Ответ об ошибке для GetFunctionConfiguration.
КодОшибки -> (строка)
Сообщение -> (строка)
SigningProfileVersionArn -> (строка)
SigningJobArn -> (строка)
Архитектуры -> (список)
Архитектура набора инструкций, которую поддерживает функция. Архитектура — строковый массив с одним из допустимых значений. Значение архитектуры по умолчанию — x86_64.
(строка)
ВременноеХранилище -> (структура)
Размер каталога /tmp функции в МБ. Значение по умолчанию — 512, но может быть любым целым числом от 512 до 10240 МБ. Дополнительные сведения см. в разделе Настройка временного хранилища (консоль).
Размер -> (целое число)
/tmp функции.SnapStart -> (структура)
Установите ApplyOn в PublishedVersions, чтобы создать снимок инициализированной среды выполнения при публикации версии функции. Дополнительные сведения см. в разделе Улучшение производительности запуска с Lambda SnapStart.
ПрименитьК -> (строка)
PublishedVersions Lambda создает снимок среды выполнения при публикации версии функции.СтатусОптимизации -> (строка)
RuntimeVersionConfig -> (структура)
ARN среды выполнения и любые возникшие ошибки.
RuntimeVersionArn -> (строка)
Ошибка -> (структура)
Ответ об ошибке, когда Lambda не может получить версию среды выполнения для функции.
КодОшибки -> (строка)
Сообщение -> (строка)
НастройкаЖурналирования -> (структура)
Настройки конфигурации Amazon CloudWatch Logs для функции.
ФорматЛога -> (строка)
УровеньПодробностиПрикладныхЛогов -> (строка)
TRACE — это самый высокий уровень, а FATAL — самый низкий.УровеньПодробностиСистемныхЛогов -> (строка)
DEBUG — это самый высокий уровень, а WARN — самый низкий.ГруппаЛогов -> (строка)
/aws/lambda/<function name>. Чтобы использовать другую группу логов, введите существующую группу логов или введите имя новой группы логов.Код -> (структура)
Пакет развертывания функции или версии.
ТипРепозитория -> (строка)
Местоположение -> (строка)
ImageUri -> (строка)
ResolvedImageUri -> (строка)
SourceKMSKeyArn -> (строка)
Теги -> (отображение)
Теги функции. Lambda возвращает данные тегов только в случае наличия явных разрешений для lambda:ListTags.
ключ -> (строка)
значение -> (строка)
ОшибкаТегов -> (структура)
Объект, содержащий подробности об ошибке, связанной с получением тегов.
КодОшибки -> (строка)
Сообщение -> (строка)
Конкурентность -> (структура)
Зарезервированная конкуретность функции.
ReservedConcurrentExecutions -> (целое число)
© Copyright 2025, Amazon Web Services. Created using Sphinx.