Spec-Zone.ru › AWS CLI v2

[ aws . greengrass ]

get-function-definition-version

Описание

Получает информацию о версии определения функции Lambda, включая функции Lambda, включённые в версию, и их конфигурации.

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

Синтаксис

  get-function-definition-version
--function-definition-id <value>
--function-definition-version-id <value>
[--next-token <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-definition-id (строка) Идентификатор определения функции Lambda.

--function-definition-version-id (строка) Идентификатор версии определения функции. Это значение соответствует свойству ‘’Version’’ соответствующего объекта ‘’VersionInformation’’, возвращаемого запросами ‘’ListFunctionDefinitionVersions’’. Если версия является последней, связанной с определением функции, значение также соответствует свойству ‘’LatestVersion’’ соответствующего объекта ‘’DefinitionInformation’’.

--next-token (строка) Токен для следующего набора результатов или ‘’null’’, если дополнительных результатов нет.

--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
  • таблица
  • 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

Следующий get-function-definition-version запрос информации о указанной версии указанного определения функции. Чтобы получить идентификаторы всех версий определения функции, используйте команду list-function-definition-versions. Чтобы получить идентификатор последней добавленной версии определения функции, используйте команду get-function-definition и проверьте свойство LatestVersion.

aws greengrass get-function-definition-version \
    --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85" \
    --function-definition-version-id "9748fda7-1589-4fcc-ac94-f5559e88678b"

Вывод:

{
    "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b",
    "CreationTimestamp": "2019-06-18T17:04:30.776Z",
    "Definition": {
        "Functions": [
            {
                "FunctionArn": "arn:aws:lambda:::function:GGIPDetector:1",
                "FunctionConfiguration": {
                    "Environment": {},
                    "MemorySize": 32768,
                    "Pinned": true,
                    "Timeout": 3
                },
                "Id": "26b69bdb-e547-46bc-9812-84ec04b6cc8c"
            },
            {
                "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:GG_HelloWorld",
                "FunctionConfiguration": {
                    "EncodingType": "json",
                    "Environment": {
                        "Variables": {}
                    },
                    "MemorySize": 16384,
                    "Pinned": true,
                    "Timeout": 25
                },
                "Id": "384465a8-eedf-48c6-b793-4c35f7bfae9b"
            }
        ]
    },
    "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
    "Version": "9748fda7-1589-4fcc-ac94-f5559e88678b"
}

Вывод

Arn -> (строка)

ARN версии определения функции.

CreationTimestamp -> (строка)

Время в миллисекундах с начала эпохи, когда была создана версия определения функции.

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

Информация об определении.

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

Настройка по умолчанию, которая применяется ко всем функциям Lambda в этой версии определения функции. Индивидуальные функции Lambda могут переопределять эти настройки.

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

Информация о настройках выполнения функции Lambda.

IsolationMode -> (строка)

Указывает, выполняется ли функция Lambda в контейнере Greengrass (по умолчанию) или без контейнеризации. Если ваш сценарий не требует запуска без контейнеризации, рекомендуется использовать контейнер Greengrass. Опустите это значение, чтобы запустить функцию Lambda с контейнеризацией по умолчанию для группы.

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

Указывает пользователя и группу, права которых используются при запуске функции Lambda. Вы можете указать одно или оба значения для переопределения значений по умолчанию. Рекомендуется избегать запуска от имени root, если это не абсолютно необходимо, чтобы минимизировать риск непреднамеренных изменений или вредоносных атак. Чтобы запустить от имени root, необходимо установить «IsolationMode» в «NoContainer» и обновить config.json в «greengrass-root/config», установив «allowFunctionsToRunAsRoot» в «yes».

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

Идентификатор группы, права которой используются для запуска функции Lambda.

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

Идентификатор пользователя, права которого используются для запуска функции Lambda.

Functions -> (список)

Список функций Lambda в этой версии определения функции.

(структура)

Информация о функции Lambda.

FunctionArn -> (строка)

ARN функции Lambda.

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

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

EncodingType -> (строка)

Ожидаемый тип кодирования входной полезной нагрузки для функции. По умолчанию — «json».

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

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

AccessSysfs -> (булево)

Если true, функция Lambda имеет разрешение на доступ к папке /sys хоста. Используйте это, когда функции Lambda нужно читать информацию о устройствах из /sys. Это значение применяется только при запуске функции Lambda в контейнере Greengrass.

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

Настройки, относящиеся к выполнению функции Lambda

IsolationMode -> (строка)

Указывает, выполняется ли функция Lambda в контейнере Greengrass (по умолчанию) или без контейнеризации. Если ваш сценарий не требует запуска без контейнеризации, рекомендуется использовать контейнер Greengrass. Опустите это значение, чтобы запустить функцию Lambda с контейнеризацией по умолчанию для группы.

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

Указывает пользователя и группу, права которых используются при запуске функции Lambda. Вы можете указать одно или оба значения для переопределения значений по умолчанию. Рекомендуется избегать запуска от имени root, если это не абсолютно необходимо, чтобы минимизировать риск непреднамеренных изменений или вредоносных атак. Чтобы запустить от имени root, необходимо установить «IsolationMode» в «NoContainer» и обновить config.json в «greengrass-root/config», установив «allowFunctionsToRunAsRoot» в «yes».

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

Идентификатор группы, права которой используются для запуска функции Lambda.

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

Идентификатор пользователя, права которого используются для запуска функции Lambda.

ResourceAccessPolicies -> (список)

Список ресурсов с разрешениями, к которым функция Lambda получит доступ. Функция Lambda может иметь не более 10 ресурсов. ResourceAccessPolicies применяются только при запуске функции Lambda в контейнере Greengrass.

(структура)

Политика, используемая функцией для доступа к ресурсу.

Permission -> (строка)

Разрешения функции Lambda на ресурс. Может быть «rw» (чтение/запись) или «ro» (только чтение).

ResourceId -> (строка)

Идентификатор ресурса. (Этот идентификатор присваивается ресурсу при создании определения ресурса.)

Variables -> (карта)

Переменные среды для конфигурации функции Lambda.

key -> (строка)

value -> (строка)

ExecArgs -> (строка)

Аргументы выполнения.

Executable -> (строка)

Имя исполняемого файла функции.

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

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

Pinned -> (булево)

True, если функция закреплена. Закрепленная функция долгоживущая и запускается при запуске ядра.

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

Разрешенное время выполнения функции, по истечении которого Lambda должна завершить функцию. Этот таймаут по-прежнему применяется к закреплённым функциям Lambda для каждого запроса.

FunctionRuntimeOverride -> (строка)

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

Id -> (строка)

Дескриптивный или произвольный идентификатор функции. Это значение должно быть уникальным в рамках версии определения функции. Максимальная длина 128 символов со схемой «[a-zA-Z0-9:_-]+».

Id -> (строка)

Идентификатор версии определения функции.

NextToken -> (строка)

Токен для следующего набора результатов или «null», если дополнительных результатов нет.

Version -> (строка)

Версия версии определения функции.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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