Spec-Zone.ru › AWS CLI v2

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

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

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

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

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

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

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

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

Сокращённый синтаксис:

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

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:_-]+’’.

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

ARN версии.

CreationTimestamp -> (строка)

Время создания версии в миллисекундах с начала эпохи.

Id -> (строка)

Идентификатор родительского определения, с которым связана версия.

Version -> (строка)

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

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

Spec-Zone.ru

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