Связаться с намиПодключиться

Создание функции на Kotlin

Статья создана
Улучшена
Обновлена 21 апреля 2025 г.

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

Перед началом работы

Создайте каталог в Yandex Cloud.

Создайте функцию

  1. В консоли управления перейдите в каталог, в котором хотите создать функцию.
  2. Выберите сервис Cloud Functions.
  3. Нажмите кнопку Создать функцию.
  4. Введите имя функции — kotlin-function.
  5. Нажмите кнопку Создать.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы создать функцию, выполните команду:

yc serverless function create --name=kotlin-function

Результат:

id: d4eek526ai42********
folder_id: b1gt6g8ht345********
created_at: "2024-12-19T20:02:56.039Z"
name: kotlin-function
http_invoke_url: https://functions.yandexcloud.net/d4eek526ai42********
status: ACTIVE

Создать функцию можно с помощью метода API create.

Создать функцию можно с помощью плагина Yandex Cloud Toolkit для семейства IDE на платформе IntelliJ от JetBrains.

Создайте первую версию функции

Чтобы создать версию функции, вы можете воспользоваться одним из форматов загрузки кода. Для примера будет использован ZIP-архив.

Важно

Файл больше 3,5 МБ необходимо загружать через Object Storage. Подробнее об ограничениях читайте в разделе Квоты и лимиты в Cloud Functions.

Подготовьте ZIP-архив с кодом функции

  1. Сохраните следующий код в файл с названием Handler.kt:

    data class Request(
    val httpMethod: String?,
    val headers: Map<String, String> = mapOf(),
    val body: String = ""
)

data class Response(
    val statusCode: Int,
    val body: String
)

fun handle(request: Request): Response {
    return Response(200, "Hello World!")
}

  2. Добавьте файл Handler.kt в ZIP-архив hello-kotlin.zip.

Создайте версию функции

  1. В консоли управления перейдите в каталог, в котором находится функция.
  2. Выберите сервис Cloud Functions.
  3. Выберите функцию kotlin-function.
  4. В разделе Последняя версия нажмите кнопку Создать в редакторе.
  5. Выберите среду выполнения Kotlin 2.0.
  6. Отключите опцию Добавить файлы с примерами кода и нажмите кнопку Продолжить.
  7. Задайте параметры версии:
    • Способ — ZIP-архив.
    • Файл — прикрепите файл hello-kotlin.zip.
    • Точка входа — Handler.
    • Таймаут — 3.
    • Память — 128 МБ.
    • Сервисный аккаунт — Не выбрано.
  8. Нажмите кнопку Сохранить изменения.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы создать версию функции, выполните команду:

yc serverless function version create \
  --function-name=kotlin-function \
  --runtime kotlin20 \
  --entrypoint Handler \
  --memory 128m \
  --execution-timeout 3s \
  --source-path ./hello-kotlin.zip

Где:

  • --function-name — имя функции, версию которой вы хотите создать.
  • --runtime — среда выполнения.
  • --entrypoint — точка входа, указывается в формате <имя_файла_с_функцией>.<имя_обработчика>.
  • --memory — объем RAM.
  • --execution-timeout — максимальное время выполнения функции до таймаута.
  • --source-path — ZIP-архив c кодом функции и необходимыми зависимостями.

Результат:

done (10s)
id: d4ektme8jo2d********
function_id: d4e9arrf01oh********
created_at: "2024-12-19T20:22:15.942Z"
runtime: kotlin20
entrypoint: Handler
resources:
  memory: "134217728"
execution_timeout: 3s
image_size: "4096"
status: ACTIVE
tags:
  - $latest
log_options:
  folder_id: b1gt6g8ht345********
concurrency: "1"

Создать версию функции можно с помощью метода API createVersion.

Создать версию функции можно с помощью плагина Yandex Cloud Toolkit для семейства IDE на платформе IntelliJ от JetBrains.

Вызовите функцию

Примечание

Чтобы любой пользователь мог вызывать функцию, необходимо сделать ее публичной. Подробнее о правах читайте в разделе Управление доступом в Cloud Functions.

  1. В консоли управления перейдите в каталог, в котором находится функция.

  2. Выберите сервис Cloud Functions.

  3. Выберите функцию.

  4. Перейдите на вкладку Тестирование.

  5. В поле Тег версии выберите $latest, чтобы вызвать последнюю версию функции.

  6. В поле Шаблон данных выберите Без шаблона.

  7. В поле Входные данные введите:

    {}

  8. Нажмите кнопку Запустить тест.

  9. В разделе Результат тестирования, в поле Состояние функции, будет показан статус тестирования. Важно: максимальное время выполнения функции до таймаута (включая начальную инициализацию при первом запуске) — 10 минут.

  10. В поле Ответ функции появится результат выполнения функции:

    {
    "statusCode": 200,
    "body": "Hello World!"
}

Чтобы вызвать функцию, выполните команду:

yc serverless function invoke <идентификатор_функции> -d '{}'

Результат:

{"statusCode":200,"body":"Hello World!"}

По умолчанию вызывается версия функции с тегом $latest.

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

Для обеспечения безопасности функцию можно вызвать только по протоколу HTTPS. Вызовите ее как обычный HTTPS-запрос, вставив ссылку в адресную строку браузера и добавив в URL параметр name:

https://functions.yandexcloud.net/<идентификатор_функции>

На странице появится ответ:

Hello World!

Вызвать функцию можно с помощью плагина Yandex Cloud Toolkit для семейства IDE на платформе IntelliJ от JetBrains.

Что дальше

Предыдущая
Java
Следующая
Обзор