# Lambda

Kubemq aws-lambda target connector allows services using kubemq server to access aws lambda service.

## Prerequisites

The following required to run the aws-lambda target connector:

* kubemq cluster
* aws account with lambda active service
* kubemq-source deployment

## Configuration

lambda target connector configuration properties:

| Properties Key   | Required | Description                       | Example                        |
| ---------------- | -------- | --------------------------------- | ------------------------------ |
| aws\_key         | yes      | aws key                           | aws key supplied by aws        |
| aws\_secret\_key | yes      | aws secret key                    | aws secret key supplied by aws |
| region           | yes      | region                            | aws region                     |
| token            | no       | aws token ("default" empty string | aws token                      |

Example:

```yaml
bindings:
  - name: kubemq-query-aws-lambda
    source:
      kind: kubemq.query
      name: kubemq-query
      properties:
        address: "kubemq-cluster:50000"
        client_id: "kubemq-query-aws-lambda-connector"
        auth_token: ""
        channel: "query.aws.lambda"
        group:   ""
        auto_reconnect: "true"
        reconnect_interval_seconds: "1"
        max_reconnects: "0"
    target:
      kind: aws.lambda
      name: aws-lambda
      properties:
        aws_key: "id"
        aws_secret_key: 'json'
        region:  "region"
        token: ""
```

## Usage

### List Lambda

List all lambdas

List Lambda:

| Metadata Key | Required | Description    | Possible values |
| ------------ | -------- | -------------- | --------------- |
| method       | yes      | type of method | "list"          |

Example:

```javascript
{
  "metadata": {
    "method": "list"
  },
  "data": null
}
```

### Create Lambda

create a new lambda.

Create Lambda:

| Metadata Key    | Required | Description                                  | Possible values                                                         |
| --------------- | -------- | -------------------------------------------- | ----------------------------------------------------------------------- |
| method          | yes      | type of method                               | "create"                                                                |
| zip\_file\_name | yes      | name of the zip file                         | "file.zip"                                                              |
| handler\_name   | yes      | lambda handler name                          | "handler-path"                                                          |
| role            | yes      | aws role name                                | "arn:aws:iam::0000000:myRole"                                           |
| runtime         | yes      | lambda runtime version                       | see <https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html> |
| function\_name  | yes      | lambda function name                         | string                                                                  |
| data            | yes      | the function code , in byte array            | byte array                                                              |
| memory\_size    | no       | memory\_size needed default of 256           | int                                                                     |
| timeout         | no       | timeout set for task default of 15 (seconds) | int                                                                     |
| description     | no       | function description default of ""           | string                                                                  |

Example:

```javascript
{
  "metadata": {
    "method": "create",
    "zip_file_name": "myfile.zip",
    "handler_name": "myhandler",
    "role": "arn:aws:iam::0000000:myRole",
    "runtime": "nodejs12.x",
    "function_name": "testfunction",
    "memory_size": "256",
    "timeout": "3",
    "description": "my awesome testing method"
  },
  "data": "ZXhwb3J0cy5oYW5kbGVyID0gYXN5bmMgKGV2ZW50KSA9PiB7CiAgICAvLyBUT0RPIGltcGxlbWVudAogICAgY29uc3QgcmVzcG9uc2UgPSB7CiAgICAgICAgc3RhdHVzQ29kZTogMjAwLAogICAgICAgIGJvZHk6IEpTT04uc3RyaW5naWZ5KCdIZWxsbyBmcm9tIExhbWJkYSEnKSwKICAgIH07CiAgICByZXR1cm4gcmVzcG9uc2U7Cn07Cg=="
}
```

### Run Lambda

run a specific lambda

Run Lambda:

| Metadata Key   | Required | Description                          | Possible values |
| -------------- | -------- | ------------------------------------ | --------------- |
| method         | yes      | type of method                       | "run"           |
| function\_name | yes      | lambda function name                 | string          |
| data           | yes      | the run request code , in byte array | byte array      |

Example:

```javascript
{
  "metadata": {
    "method": "run",
    "function_name": "testfunction",
  },
  "data": "bXkgb2JqZWN0"
}
```

### Delete Lambda

Delete Lambda:

| Metadata Key   | Required | Description          | Possible values |
| -------------- | -------- | -------------------- | --------------- |
| method         | yes      | type of method       | "delete"        |
| function\_name | yes      | lambda function name | string          |

Example:

```javascript
{
  "metadata": {
    "method": "delete",
    "function_name": "testfunction"
  },
  "data": null
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kubemq.io/configuration/connectors/kubemq-targets/aws/lambda.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.