[ aws . greengrass ]
create-function-definition-version
Описание
Создаёт версию определения функции Lambda, которая уже была определена.
См. также: Документация API AWS
Синтаксис
create-function-definition-version
[--amzn-client-token <value>]
[--default-config <value>]
--function-definition-id <value>
[--functions <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]
Параметры
--amzn-client-token (строка) Маркер клиента, используемый для корреляции запросов и ответов.
--default-config (структура) Параметры по умолчанию, применяемые ко всем функциям Lambda в данной версии определения функции. Индивидуальные функции Lambda могут переопределять эти параметры.Исполнение -> (структура)
Информация о конфигурации, определяющая, как выполняется функция Lambda.
IsolationMode -> (строка)
RunAs -> (структура)
Указывает пользователя и группу, чьи права используются при выполнении функции Lambda. Вы можете указать одно или оба значения, чтобы переопределить значения по умолчанию. Рекомендуется избегать выполнения от имени root, если это не абсолютно необходимо, чтобы минимизировать риск непреднамеренных изменений или злоумышленных атак. Чтобы выполнить от имени root, необходимо установить ‘’IsolationMode’’ в ‘’NoContainer’’ и обновить config.json в ‘’greengrass-root/config’’, установив ‘’allowFunctionsToRunAsRoot’’ в ‘’yes’’.
Gid -> (целое число)
Uid -> (целое число)
Сокращённый синтаксис:
Execution={IsolationMode=string,RunAs={Gid=integer,Uid=integer}}
Синтаксис JSON:
{
"Execution": {
"IsolationMode": "GreengrassContainer"|"NoContainer",
"RunAs": {
"Gid": integer,
"Uid": integer
}
}
}
--function-definition-id (строка) Идентификатор определения функции Lambda.
--functions (список) Список функций Lambda в данной версии определения функции.(структура)
Информация о функции Lambda.
FunctionArn -> (строка)
FunctionConfiguration -> (структура)
Конфигурация функции Lambda.
EncodingType -> (строка)
Environment -> (структура)
Конфигурация среды функции.
AccessSysfs -> (логическое значение)
Execution -> (структура)
Настройка, связанная с выполнением функции Lambda
IsolationMode -> (строка)
RunAs -> (структура)
Указывает пользователя и группу, чьи права используются при выполнении функции Lambda. Вы можете указать одно или оба значения, чтобы переопределить значения по умолчанию. Рекомендуется избегать выполнения от имени root, если это не абсолютно необходимо, чтобы минимизировать риск непреднамеренных изменений или злоумышленных атак. Чтобы выполнить от имени root, необходимо установить ‘’IsolationMode’’ в ‘’NoContainer’’ и обновить config.json в ‘’greengrass-root/config’’, установив ‘’allowFunctionsToRunAsRoot’’ в ‘’yes’’.
Gid -> (целое число)
Uid -> (целое число)
ResourceAccessPolicies -> (список)
Список ресурсов с их правами, к которым функция Lambda получит доступ. Функция Lambda может иметь не более 10 ресурсов. ResourceAccessPolicies применяются только при запуске функции Lambda в контейнере Greengrass.
(структура)
Политика, используемая функцией для доступа к ресурсу.
Permission -> (строка)
ResourceId -> (строка)
Variables -> (карта)
Переменные среды для конфигурации функции Lambda.
key -> (строка)
value -> (строка)
ExecArgs -> (строка)
Executable -> (строка)
MemorySize -> (целое число)
Pinned -> (логическое значение)
Timeout -> (целое число)
FunctionRuntimeOverride -> (строка)
Id -> (строка)
Синтаксис JSON:
[
{
"FunctionArn": "string",
"FunctionConfiguration": {
"EncodingType": "binary"|"json",
"Environment": {
"AccessSysfs": true|false,
"Execution": {
"IsolationMode": "GreengrassContainer"|"NoContainer",
"RunAs": {
"Gid": integer,
"Uid": integer
}
},
"ResourceAccessPolicies": [
{
"Permission": "ro"|"rw",
"ResourceId": "string"
}
...
],
"Variables": {"string": "string"
...}
},
"ExecArgs": "string",
"Executable": "string",
"MemorySize": integer,
"Pinned": true|false,
"Timeout": integer,
"FunctionRuntimeOverride": "string"
},
"Id": "string"
}
...
]
--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 команды на указанный.
--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 (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/отключить цветной вывод.
- on
- off
- auto
--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.
Для создания версии определения функции
Следующий create-function-definition-version пример создаёт новую версию указанного определения функции. Эта версия определяет единственную функцию с идентификатором Hello-World-function, разрешает доступ к файловой системе и указывает максимальный размер памяти и время выполнения.
aws greengrass create-function-definition-version \
--cli-input-json "{\"FunctionDefinitionId\": \"e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3\",\"Functions\": [{\"Id\": \"Hello-World-function\", \"FunctionArn\": \""arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld_Counter:gghw-alias"\",\"FunctionConfiguration\": {\"Environment\": {\"AccessSysfs\": true},\"Executable\": \"greengrassHelloWorldCounter.function_handler\",\"MemorySize\": 16000,\"Pinned\": false,\"Timeout\": 25}}]}"
Вывод:
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3/versions/74abd1cc-637e-4abe-8684-9a67890f4043",
"CreationTimestamp": "2019-06-25T22:03:43.376Z",
"Id": "e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3",
"Version": "74abd1cc-637e-4abe-8684-9a67890f4043"
}
Вывод
Arn -> (строка)
CreationTimestamp -> (строка)
Id -> (строка)
Version -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.