Spec-Zone.ru › AWS CLI v2

[ aws . lambda ]

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

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

СредствоВиртуальногоВыполнения -> (строка)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ХешКодаSha256 -> (строка)

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

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

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

НастройкаVpc -> (структура)

Настройка сетевого взаимодействия функции.

ИдентификаторыПодсетей -> (список)

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

(строка)

ИдентификаторыГруппыБезопасности -> (список)

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

(строка)

ИдентификаторVpc -> (строка)

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

РазрешениеIpv6ДляДвойнойСтекировки -> (логическое значение)

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

НастройкаОчередиСНеудачнымВыполнением -> (структура)

Очередь с необработанными сообщениями функции.

TargetArn -> (строка)

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

Среда -> (структура)

Переменные среды функции. Исключены из журналов 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@Edge — ARN основной функции.

ИдентификаторРевизии -> (строка)

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

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

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

(структура)

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 -> (список)

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

(строка)

Команда -> (список)

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

(строка)

РабочийКаталог -> (строка)

Указывает рабочий каталог.

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

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

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

Код ошибки.

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

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

SigningProfileVersionArn -> (строка)

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

SigningJobArn -> (строка)

ARN задания подписи.

Архитектуры -> (список)

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

(строка)

ВременноеХранилище -> (структура)

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

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

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

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

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

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

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

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

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

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

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

RuntimeVersionArn -> (строка)

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

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

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

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

Код ошибки.

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

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

НастройкаЖурналирования -> (структура)

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

ФорматЛога -> (строка)

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

УровеньПодробностиПрикладныхЛогов -> (строка)

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

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

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

ГруппаЛогов -> (строка)

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

Код -> (структура)

Пакет развертывания функции или версии.

ТипРепозитория -> (строка)

Сервис, на котором размещен файл.

Местоположение -> (строка)

Предопределенная URL-адреса, которую вы можете использовать для загрузки пакета развертывания.

ImageUri -> (строка)

URI контейнерного образа в Amazon ECR-реестре.

ResolvedImageUri -> (строка)

Разрешенный URI для образа.

SourceKMSKeyArn -> (строка)

ARN управляемого клиентом ключа Key Management Service (KMS), используемого для шифрования пакета развертывания .zip вашей функции. Если вы не предоставите управляемый клиентом ключ, Lambda будет использовать ключ, принадлежащий Amazon Web Services.

Теги -> (отображение)

Теги функции. Lambda возвращает данные тегов только в случае наличия явных разрешений для lambda:ListTags.

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

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

ОшибкаТегов -> (структура)

Объект, содержащий подробности об ошибке, связанной с получением тегов.

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

Код ошибки.

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

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

Конкурентность -> (структура)

Зарезервированная конкуретность функции.

ReservedConcurrentExecutions -> (целое число)

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

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

Spec-Zone.ru

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