Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Cloud Functions
  • Comparison with other Yandex Cloud services
    • Overview
    • Managing dependencies
    • Request handler
    • Invocation context
    • Logging
    • Handling errors
    • Using the SDK
  • Tools
  • Pricing policy
  • Access management
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  • FAQ
  1. Developing in Kotlin
  2. Request handler

Request handler for a function in Kotlin

Written by
Yandex Cloud
Updated at October 21, 2024

A request handler is a method used to process each Kotlin function call. Here is an example of a script with the handle method acting as a handler:

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

fun handle(request: String): Response {
    return Response(200, request)
}

The script processes an incoming HTTP request and outputs its structure and HTTP response code. The script uses a top-level function as the programming model in Kotlin.

When creating a function version, you specify the entry point, i.e., the function that the runtime environment calls as a handler. The entry point name depends on the programming model being used:

  • For top-level functions: <package_name>.<handler_file_name>::<handler_method_name>. For example, somepackage.Handler::handle_http.

    When naming the entry point, specify the file name without its extension.

    If your method is handle, you may skip it.

  • For the YcFunction interface: <package_name>.<class_name>. For example, somepackage.Handler.

The name of the handler file must not contain any . before the extension, e.g., .Handler.kt.

Note

At any given time, one function instance cannot handle more calls than specified in the concurrency parameter. This allows you to use global variables without having to provide data integrity control.

Was the article helpful?

Previous
Managing dependencies
Next
Invocation context
© 2025 Direct Cursus Technology L.L.C.