Contact UsGet started
© 2024 Direct Cursus Technology L.L.C.

Invoking a container in Serverless Containers

Written by
Updated at August 29, 2024

You can invoke a container:

Invoking a container triggers the active revision.

The application must retrieve the number of the port for receiving requests, from the PORT environment variable. The variable value is set by the service automatically.

HTTPS

When calling a container over HTTPS, an HTTP request is passed to the application deployed in the container.

Filtering message headers

When being passed to the container, some HTTP request and response headers change, as described below.

Removed from a request:

  • "Expect"
  • "Te"
  • "Trailer"
  • "Upgrade"
  • "Proxy-Authenticate"
  • "Authorization"
  • "Connection"
  • "Content-Md5"
  • "Max-Forwards"
  • "Server"
  • "Transfer-Encoding"
  • "Www-Authenticate"
  • "Cookie"

  • Removed from a response:

    • "Host"
    • "Authorization"
    • "User-Agent"
    • "Connection"
    • "Max-Forwards"
    • "Cookie"
    • "X-Request-Id"
    • "X-Function-Id"
    • "X-Function-Version-Id"
    • "X-Content-Type-Options"

  • Cause an error if present in a response:

    • "Proxy-Authenticate"
    • "Transfer-Encoding"
    • "Via"

  • Overwritten by adding the X-Yf-Remapped- prefix:

    • "Content-Md5"
    • "Date"
    • "Server"
    • "Www-Authenticate"

IP address of the request source

If a request contains the X-Forwarded-For header, the specified IP addresses and the IP address of the user that invoked the container are provided in this header. If this header is missing, the request only transmits the IP address of the user who invoked the container.

Triggers

When invoking a container using a trigger, an HTTP POST request is sent to the address the container is invoked at. The request body contains a JSON description of the trigger event. The request source IP is provided in the same way as when invoking a container using HTTPS. Learn more about triggers.

Yandex API Gateway extension

When invoking a container using the API Gateway, the container is handed over an HTTP request addressed to the API gateway. In this case, the Host header specifies the host on which the user accessed the API gateway rather than the container's host. The request source IP is provided in the same way as when invoking a container using HTTPS. Learn more about the extension in the Yandex API Gateway documentation.

Previous
Container
Next
Long-lived containers