Invoking a function

Note

To allow any user to invoke (call) a function, make it public. For more information about access rights, see Access management.

To access the function, use its name or unique ID, which can be obtained using the command:

$ yc serverless function list
+----------------------+--------------------+----------------------+
|          ID          |        NAME        |      FOLDER ID       |
+----------------------+--------------------+----------------------+
| b097d9ous3gep99khe83 | my-beta-function   | aoek49ghmknnpj1ll45e |
+----------------------+--------------------+----------------------+

As an example, we use the function described in Creating a function version.

HTTP

CLI

Note

For security reasons, the function can only be called using TLS protocol.

Call the function as a regular HTTP request, such as by entering the function call link in your browser address bar. Call link format:

https://functions.yandexcloud.net/<function ID>

The function call link is also shown in the http_invoke_url parameter when creating a function.

Example of function call with no additional parameters:
```
https://functions.yandexcloud.net/b09bhaokchn9pnbrlseb
```
The response depends on the function you call. In this case, it will be as follows:
```
Hello, World!
```
Example of function call with the name parameter added to the URL:
```
https://functions.yandexcloud.net/b09bhaokchn9pnbrlseb?name=<user name>
```
The following response appears on the page:
```
Hello, Username!
```

Call the function by specifying in the parameter a name for the greeting:

$ yc serverless function invoke b09bhaokchn9pnbrlseb -d '{"queryStringParameters": {"name": "Username"}}'

{"statusCode": 200, "headers": {"Content-Type": "text/plain"}, "isBase64Encoded": false, "body": "Hello, Username!"}

For more information about the structure of functions called in different ways (HTTP or CLI), see Invoking a function.