#### Human Readable Output
### aws-lambda-invoke
***
Invokes a Lambda function. Specify just a function name to invoke the latest version of the function. To invoke a published version, use the Qualifier parameter to specify a version or alias. If you use the RequestResponse (synchronous) invocation option, note that the function may be invoked multiple times if a timeout is reached. For functions with a long timeout, your client may be disconnected during synchronous invocation while it waits for a response. Use the "timeout" and "retries" arguments to control this behavior. If you use the Event (asynchronous) invocation option, the function will be invoked at least once in response to an event and the function must be idempotent to handle this.
#### Required Permissions
* `AWSLambdaRole`: more details [here](https://docs.aws.amazon.com/lambda/latest/dg/access-control-identity-based.html).
#### Base Command
`aws-lambda-invoke`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| functionName | The name of the Lambda function. | Required |
| invocationType | Choose from the following options. RequestResponse (default) - Invoke the function synchronously. Keep the connection open until the function returns a response or times out. Event - Invoke the function asynchronously. Send events that fail multiple times to the function's dead-letter queue (if configured). DryRun - Validate parameter values and verify that the user or role has permission to invoke the function. Possible values are: Event, RequestResponse, DryRun. | Optional |
| logType | You can set this optional parameter to Tail in the request only if you specify the InvocationType parameter with value RequestResponse . In this case, AWS Lambda returns the base64-encoded last 4 KB of log data produced by your Lambda function in the x-amz-log-result header. Possible values are: None, Tail. | Optional |
| clientContext | Using the ClientContext you can pass client-specific information to the Lambda function you are invoking. | Optional |
| payload | JSON that you want to provide to your Lambda function as input. | Optional |
| qualifier | Specify a version or alias to invoke a published version of the function. | Optional |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
| retries | The maximum retry attempts when connection or throttling errors are encountered. Set to 0 to disable retries. If not specified, will use the instances configured default timeout. | Optional |
| timeout | The time in seconds till a timeout exception is reached. You can specify just the read timeout (for example 60) or also the connect timeout followed after a comma (for example 60,10). If not specified, will use the instances configured default timeout. | Optional |
#### Context Output
| **Path** | **Type** | **Description** |
| --- | --- | --- |
| AWS.Lambda.InvokedFunctions.FunctionName | string | The name of the Lambda function. |
| AWS.Lambda.InvokedFunctions.FunctionError | string | Indicates whether an error occurred while executing the Lambda function. If an error occurred this field will have one of two values; Handled or Unhandled. Handled errors are errors that are reported by the function while the Unhandled errors are those detected and reported by AWS Lambda. Unhandled errors include out of memory errors and function timeouts. |
| AWS.Lambda.InvokedFunctions.LogResult | string | Logs for the Lambda function invocation. This is present only if the invocation type is RequestResponse and the logs were requested. |
| AWS.Lambda.InvokedFunctions.Payload | string | The JSON representation of the object returned by the Lambda function. This is present only if the invocation type is RequestResponse. |
| AWS.Lambda.InvokedFunctions.ExecutedVersion | string | The function version that has been executed. This value is returned only if the invocation type is RequestResponse. |
| AWS.Lambda.InvokedFunctions.Region | string | The AWS Region. |
| AWS.Lambda.InvokedFunctions.RequestPayload | unknown | The JSON representation of the object passed to the Lambda function as input. |
#### Command Example
```!aws-lambda-invoke functionName="test_echo" logType="Tail" payload="{\"value\":\"test\"}"```
#### Context Example
```json
{
"AWS": {
"Lambda": {
"InvokedFunctions": {
"ExecutedVersion": "$LATEST",
"FunctionName": "test_echo",
"LogResult": "START RequestId: c24e087f-5c05-4e92-a1a8-e54f2d6cd925 Version: $LATEST\nEND RequestId: c24e087f-5c05-4e92-a1a8-e54f2d6cd925\nREPORT RequestId: c24e087f-5c05-4e92-a1a8-e54f2d6cd925\tDuration: 16.00 ms\tBilled Duration: 16 ms\tMemory Size: 128 MB\tMax Memory Used: 65 MB\tInit Duration: 133.86 ms\t\n",
"Payload": "{\"message\":\"Your function executed successfully!\",\"payload\":{\"value\":\"test\"}}",
"Region": "us-west-2"
}
}
}
}
```
#### Human Readable Output
>### AWS Lambda Invoked Functions
>
>|ExecutedVersion|FunctionName|LogResult|Payload|Region|
>|---|---|---|---|---|
>| $LATEST | test_echo | START RequestId: c24e087f-5c05-4e92-a1a8-e54f2d6cd925 Version: $LATEST<br/>END RequestId: c24e087f-5c05-4e92-a1a8-e54f2d6cd925<br/>REPORT RequestId: c24e087f-5c05-4e92-a1a8-e54f2d6cd925 Duration: 16.00 ms Billed Duration: 16 ms Memory Size: 128 MB Max Memory Used: 65 MB Init Duration: 133.86 ms <br/> | {"message":"Your function executed successfully!","payload":{"value":"test"}} | us-west-2 |
### aws-lambda-get-account-settings
***
Retrieves details about your account's limits and usage in an AWS Region.
#### Required Permissions
* `AWSLambda_ReadOnlyAccess`: more details [here](https://docs.aws.amazon.com/lambda/latest/dg/security_iam_troubleshoot.html#security_iam_troubleshoot-admin-deprecation).
#### Base Command
`aws-lambda-get-account-settings`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| region | The AWS Region. If not specified the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
#### Context Output
| **Path** | **Type** | **Description** |
| --- | --- | --- |
| AWS.Lambda.AccountLimit.TotalCodeSize | number | The amount of storage space that you can use for all deployment packages and layer archives. |
| AWS.Lambda.AccountLimit.CodeSizeUnzipped | number | The maximum size of your function's code and layers when they're extracted. |
| AWS.Lambda.AccountLimit.CodeSizeZipped | number | The maximum size of a deployment package when it's uploaded directly to AWS Lambda. Use Amazon S3 for larger files. |
| AWS.Lambda.AccountLimit.ConcurrentExecutions | number | The maximum number of simultaneous function executions. |
| AWS.Lambda.AccountLimit.UnreservedConcurrentExecutions | number | The maximum number of simultaneous function executions, minus the capacity that's reserved for individual functions with PutFunctionConcurrency . |
| AWS.Lambda.AccountUsage.TotalCodeSize | number | The amount of storage space, in bytes, that's being used by deployment packages and layer archives. |
| AWS.Lambda.AccountUsage. FunctionCount | number | The number of Lambda functions. |
#### Command Example
```!aws-lambda-get-account-settings```
#### Context Example
```json
{
"AWS": {
"Lambda": {
"Functions": {
"AccountLimit": {
"CodeSizeUnzipped": 262144000,
"CodeSizeZipped": 52428800,
"ConcurrentExecutions": 1000,
"TotalCodeSize": 80530636800,
"UnreservedConcurrentExecutions": 1000
},
"AccountUsage": {
"FunctionCount": 3,
"TotalCodeSize": 272431
},
"Region": "us-west-2",
"ResponseMetadata": {
"HTTPHeaders": {
"connection": "keep-alive",
"content-length": "393",
"content-type": "application/json",
"date": "Sat, 02 Jan 2021 17:53:27 GMT",
"x-amzn-requestid": "2030cf7b-b4f7-4f57-b13b-1572cdaa3286"
},
"HTTPStatusCode": 200,
"RequestId": "2030cf7b-b4f7-4f57-b13b-1572cdaa3286",
"RetryAttempts": 0
}
}
}
}
}
```
#### Human Readable Output
>### AWS Lambda Functions
>
>|AccountLimit|AccountUsage|
>|---|---|
>| TotalCodeSize: 80530636800<br/>CodeSizeUnzipped: 262144000<br/>CodeSizeZipped: 52428800<br/>ConcurrentExecutions: 1000<br/>UnreservedConcurrentExecutions: 1000 | TotalCodeSize: 272431<br/>FunctionCount: 3 |
### aws-lambda-get-policy
***
Returns the resource-based IAM policy for a function, version, or alias.
#### Base Command
`aws-lambda-get-policy`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
| functionName | The name of the Lambda function, version, or alias. You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length. | Required |
#### Context Output
| **Path** | **Type** | **Description** |
| --- | --- | --- |
| AWS.Lambda.Policy.Version | String | The version of the policy. |
| AWS.Lambda.Policy.Id | String | The ID of the policy. |
| AWS.Lambda.Policy.Statement.Sid | String | The statement ID within the policy. |
| AWS.Lambda.Policy.Statement.Effect | String | The effect \(allow/deny\) specified in the policy statement. |
| AWS.Lambda.Policy.Statement.Principal.AWS | String | The AWS principal ARN specified in the AWS Lambda policy statement. |
| AWS.Lambda.Policy.Statement.Action | String | The action specified in the AWS Lambda policy statement. |
| AWS.Lambda.Policy.Statement.Resource | String | The resource ARN specified in the AWS Lambda policy statement. |
| AWS.Lambda.RevisionId | String | A unique identifier for the current revision of the policy. |
#### Command example
```!aws-lambda-get-policy functionName="test"```
#### Context Example
```json
{
"AWS": {
"Lambda": {
"Policy": {
"Id": "default",
"Statement": [
{
"Action": "lambda",
"Condition": {
"ArnLike": {
"AWS:SourceArn": "arn:aws:dummy-api:dummy:12345678:dummy/*/*/test"
}
},
"Effect": "Allow",
"Principal": {
"Service": "apidummy.dummy.com"
},
"Resource": "arn:aws:dummy-api:dummy:12345678:dummy/*/*/test",
"Sid": "lambda-1111-1111-1111-1111-1111"
}
],
"Version": "2012-10-17"
},
"RevisionId": "1111-1111-111-111-11111"
}
}
}
```
#### Human Readable Output
>### Policy
>
>|Action|Effect|Id|Resource|RevisionId|Sid|Version|Principal|
>|---|---|---|---|---|---|---|
>| lambda | Allow | default | arn:aws:dummy-api:dummy:12345678:dummy/*/*/test | 1111-1111-111-111-11111 | arn:aws:dummy-api:dummy:12345678:dummy/*/*/test | 2015-10-17 | apidummy.dummy.com |
### aws-lambda-list-versions-by-function
***
Returns a list of versions, with the version-specific configuration of each.
#### Base Command
`aws-lambda-list-versions-by-function`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
| functionName | The name of the Lambda function, version, or alias. You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length. | Required |
| Marker | Specify the pagination token that’s returned by a previous request to retrieve the next page of results. | Optional |
| MaxItems | The maximum number of versions to return. Note that ListVersionsByFunction returns a maximum of 50 items in each response, even if you set the number higher. | Optional |
#### Context Output
| **Path** | **Type** | **Description** |
| --- | --- | --- |
| AWS.Lambda.NextMarker | String | The pagination token that's included if more results are available. |
| AWS.Lambda.Versions.FunctionName | String | The name of the function. |
| AWS.Lambda.Versions.FunctionArn | String | The function’s Amazon Resource Name \(ARN\). |
| AWS.Lambda.Versions.Runtime | String | The identifier of the function’s runtime. Runtime is required if the deployment package is a .zip file archive. |
| AWS.Lambda.Versions.Role | String | The function’s execution role. |
| AWS.Lambda.Versions.Handler | String | The function that Lambda calls to begin running your function. |
| AWS.Lambda.Versions.CodeSize | Number | The size of the function’s deployment package, in bytes. |
| AWS.Lambda.Versions.Description | String | The function’s description. |
| AWS.Lambda.Versions.Timeout | Number | The amount of time in seconds that Lambda allows a function to run before stopping it. |
| AWS.Lambda.Versions.MemorySize | Number | The amount of memory available to the function at runtime. |
| AWS.Lambda.Versions.LastModified | String | The date and time that the function was last updated, in ISO-8601 format \(YYYY-MM-DDThh:mm:ss.sTZD\). |
| AWS.Lambda.Versions.CodeSha256 | String | The SHA256 hash of the function’s deployment package. |
| AWS.Lambda.Versions.Version | String | The version of the Lambda function. |
| AWS.Lambda.Versions.VpcConfig.SubnetIds | String | A list of VPC subnet IDs. |
| AWS.Lambda.Versions.VpcConfig.SecurityGroupIds | String | A list of VPC security group IDs. |
| AWS.Lambda.Versions.VpcConfig.VpcId | String | The ID of the VPC. |
| AWS.Lambda.Versions.DeadLetterConfig.TargetArn | String | The Amazon Resource Name \(ARN\) of an Amazon SQS queue or Amazon SNS topic. |
| AWS.Lambda.Versions.Environment.Variables.string | String | Environment variable key-value pairs. Omitted from CloudTrail logs. |
| AWS.Lambda.Versions.Environment.Error.ErrorCode | String | The error code for environment variables that couldn't be applied. |
| AWS.Lambda.Versions.Environment.Error.Message | String | The error message for environment variables that couldn't be applied. |
| AWS.Lambda.Versions.KMSKeyArn | String | The ARN of the KMS key used to encrypt the function's environment variables. |
| AWS.Lambda.Versions.TracingConfig.Mode | String | The tracing mode for the Lambda function. |
| AWS.Lambda.Versions.MasterArn | String | The ARN of the main function for Lambda@Edge functions. |
| AWS.Lambda.Versions.FunctionVersion | String | The specific function version. |
| AWS.Lambda.Versions.Tags | Object | The tags assigned to the Lambda function. |
| AWS.Lambda.Versions.State | String | The current state of the function. When the state is Inactive, you can reactivate the function by invoking it. |
| AWS.Lambda.Versions.StateReason | String | The reason for the function’s current state. |
| AWS.Lambda.Versions.StateReasonCode | String | The reason code for the current state of the function. |
| AWS.Lambda.Versions.LastUpdateStatus | String | The status of the last update that was performed on the function. This is first set to Successful after function creation completes. |
| AWS.Lambda.Versions.LastUpdateStatusReason | String | The reason for the last update that was performed on the function. |
| AWS.Lambda.Versions.LastUpdateStatusReasonCode | String | The reason code for the last update operation status. |
| AWS.Lambda.Versions.PackageType | String | The type of deployment package. Set to Image for container image and set Zip for .zip file archive. |
| AWS.Lambda.Versions.ImageConfigResponse.ImageConfigError.ErrorCode | String | The error code for image configuration. |
| AWS.Lambda.Versions.ImageConfigResponse.ImageConfigError.Message | String | The error message for image configuration. |
| AWS.Lambda.Versions.ImageConfigResponse.ImageConfigError.Type | String | The error type for image configuration. |
| AWS.Lambda.Versions.ImageConfigResponse.ImageConfig | Object | The image configuration values. |
#### Command example
```!aws-lambda-list-versions-by-function functionName=test```
#### Context Example
```json
{
"AWS": {
"Lambda": {
"Versions": [
{
"Architectures": [
"test"
],
"CodeSha256": "111111111111111",
"CodeSize": 111,
"Description": "",
"EphemeralStorage": {
"Size": 111
},
"FunctionArn": "arn:aws:dummy-api:dummy:12345678:dummy/*/*/test",
"FunctionName": "test",
"Handler": "handler",
"LastModified": "2024-06-05T11:54:29.646+0000",
"MemorySize": 128,
"PackageType": "Zip",
"RevisionId": "11111-11111-1111",
"Role": "dummyy.111111:role/dummy-role/test-role-11111",
"Runtime": "nodejs18.x",
"SnapStart": {
"ApplyOn": "None",
"OptimizationStatus": "Off"
},
"Timeout": 3,
"TracingConfig": {
"Mode": "PassThrough"
},
"Version": "$LATEST"
}
]
}
}
}
```
#### Human Readable Output
>### Versions
>
>|Function Name|Role|Runtime|Last Modified|State|Description|
>|---|---|---|---|---|---|
>| test | dummy.111111:role/dummy-role/test-role-11111 | nodejs18.x | 2024-06-05T11:54:29.646+0000 | | |
### aws-lambda-get-function-url-config
***
Returns details about a Lambda function URL.
#### Base Command
`aws-lambda-get-function-url-config`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
| functionName | The name of the Lambda function, version, or alias. You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length. | Required |
| qualifier | The alias name. | Optional |
#### Context Output
| **Path** | **Type** | **Description** |
| --- | --- | --- |
| AWS.Lambda.FunctionURLConfig.FunctionUrl | String | The HTTP URL endpoint for the function. |
| AWS.Lambda.FunctionURLConfig.FunctionArn | String | The Amazon Resource Name \(ARN\) of your function. |
| AWS.Lambda.FunctionURLConfig.AuthType | String | The type of authentication that the function URL uses. Set to AWS_IAM if you want to restrict access to authenticated users only. Set to NONE if you want to bypass IAM authentication to create a public endpoint. |
| AWS.Lambda.FunctionURLConfig.Cors.AllowCredentials | Boolean | Whether to allow cookies or other credentials in requests to the function URL. The default is false. |
| AWS.Lambda.FunctionURLConfig.Cors.AllowHeaders | List | The HTTP headers that origins can include in requests to the function URL. For example Date, Keep-Alive, X-Custom-Header. |
| AWS.Lambda.FunctionURLConfig.Cors.AllowMethods | List | The HTTP methods that are allowed when calling the function URL. For example GET, POST, DELETE, or the wildcard character \( \*\). |
| AWS.Lambda.FunctionURLConfig.Cors.AllowOrigins | List | The origins that can access the function URL.You can list any number of specific origins, separated by a comma. For example https://www.example.com, http://localhost:8080. Alternatively, you can grant access to all origins using the wildcard character \( \*\). |
| AWS.Lambda.FunctionURLConfig.Cors.ExposeHeaders | List | The HTTP headers in the function response that you want to expose to origins that call the function URL. For example Date, Keep-Alive, X-Custom-Header. |
| AWS.Lambda.FunctionURLConfig.Cors.MaxAge | Number | The maximum amount of time, in seconds, that web browsers can cache results of a preflight request. By default, this is set to 0, which means that the browser doesn’t cache results. |
| AWS.Lambda.FunctionURLConfig.CreationTime | String | When the function URL was created, in ISO-8601 format \(YYYY-MM-DDThh:mm:ss.sTZD\). |
| AWS.Lambda.FunctionURLConfig.LastModifiedTime | String | When the function URL configuration was last updated, in ISO-8601 format \(YYYY-MM-DDThh:mm:ss.sTZD\). |
| AWS.Lambda.FunctionURLConfig.InvokeMode | String | Use one of the following options: BUFFERED – This is the default option. Lambda invokes your function using the Invoke API operation. Invocation results are available when the payload is complete. The maximum payload size is 6 MB. RESPONSE_STREAM – Your function streams payload results as they become available. Lambda invokes your function using the InvokeWithResponseStream API operation. The maximum response payload size is 20 MB, however, you can request a quota increase. |
#### Command example
```!aws-lambda-get-function-url-config functionName="test"```
#### Context Example
```json
{
"AWS": {
"Lambda": {
"FunctionURLConfig": {
"AuthType": "NONE",
"CreationTime": "2024-05-02T07:23:12.573458Z",
"FunctionArn": "dummy111111:role/dummy/test-11111",
"FunctionUrl": "hxxps://dummy.com/",
"InvokeMode": "BUFFERED",
"LastModifiedTime": "2024-05-02T07:23:12.573458Z"
}
}
}
}
```
#### Human Readable Output
>### Function URL Config
>
>|Auth Type|Creation Time|Function Arn|Function Url|Invoke Mode|Last Modified Time|
>|---|---|---|---|---|---|
>| NONE | 2024-05-02T07:23:12.573458Z | dummy.111111:role/dummy/test-11111 | hxxps:<span>//</span>dummy.com/ | BUFFERED | 2024-05-02T07:23:12.573458Z |
### aws-lambda-get-function-configuration
***
Returns the version-specific settings of a Lambda function or version. The output includes only options that can vary between versions of a function.
#### Base Command
`aws-lambda-get-function-configuration`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
| functionName | The name of the Lambda function, version, or alias. You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length. | Required |
| qualifier | Specify a version or alias to get details about a published version of the function. | Optional |
#### Context Output
| **Path** | **Type** | **Description** |
| --- | --- | --- |
| AWS.Lambda.FunctionConfig.FunctionName | String | The name of the function. |
| AWS.Lambda.FunctionConfig.FunctionArn | String | The function’s Amazon Resource Name \(ARN\). |
| AWS.Lambda.FunctionConfig.Runtime | String | The identifier of the function’s runtime. Runtime is required if the deployment package is a .zip file archive. |
| AWS.Lambda.FunctionConfig.Role | String | The function’s execution role. |
| AWS.Lambda.FunctionConfig.Handler | String | The function that Lambda calls to begin running your function. |
| AWS.Lambda.FunctionConfig.CodeSize | Number | The size of the function’s deployment package, in bytes. |
| AWS.Lambda.FunctionConfig.Description | String | The function’s description. |
| AWS.Lambda.FunctionConfig.Timeout | Number | The amount of time in seconds that Lambda allows a function to run before stopping it. |
| AWS.Lambda.FunctionConfig.MemorySize | Number | The amount of memory available to the function at runtime. |
| AWS.Lambda.FunctionConfig.LastModified | String | The date and time that the function was last updated, in ISO-8601 format \(YYYY-MM-DDThh:mm:ss.sTZD\). |
| AWS.Lambda.FunctionConfig.CodeSha256 | String | The SHA256 hash of the function’s deployment package. |
| AWS.Lambda.FunctionConfig.Version | String | The version of the Lambda function. |
| AWS.Lambda.FunctionConfig.VpcConfig.SubnetIds | String | A list of VPC subnet IDs. |
| AWS.Lambda.FunctionConfig.VpcConfig.SecurityGroupIds | String | A list of VPC security group IDs. |
| AWS.Lambda.FunctionConfig.VpcConfig.VpcId | String | The ID of the VPC. |
| AWS.Lambda.FunctionConfig.DeadLetterConfig.TargetArn | String | The Amazon Resource Name \(ARN\) of an Amazon SQS queue or Amazon SNS topic. |
| AWS.Lambda.FunctionConfig.Environment.Variables.string | String | Environment variable key-value pairs. Omitted from CloudTrail logs. |
| AWS.Lambda.FunctionConfig.Environment.Error.ErrorCode | String | The error code for environment variables that couldn't be applied. |
| AWS.Lambda.FunctionConfig.Environment.Error.Message | String | The error message for environment variables that couldn't be applied. |
| AWS.Lambda.FunctionConfig.KMSKeyArn | String | The ARN of the KMS key used to encrypt the function's environment variables. |
| AWS.Lambda.FunctionConfig.TracingConfig.Mode | String | The tracing mode for the Lambda function. |
| AWS.Lambda.FunctionConfig.MasterArn | String | The ARN of the main function for Lambda@Edge functions. |
| AWS.Lambda.FunctionConfig.FunctionVersion | String | The specific function version. |
| AWS.Lambda.FunctionConfig.Tags | Object | The tags assigned to the Lambda function. |
| AWS.Lambda.FunctionConfig.State | String | The current state of the function. When the state is Inactive, you can reactivate the function by invoking it. |
| AWS.Lambda.FunctionConfig.StateReason | String | The reason for the function’s current state. |
| AWS.Lambda.FunctionConfig.StateReasonCode | String | The reason code for the current state of the function. |
| AWS.Lambda.FunctionConfig.LastUpdateStatus | String | The status of the last update that was performed on the function. This is first set to Successful after function creation completes. |
| AWS.Lambda.FunctionConfig.LastUpdateStatusReason | String | The reason for the last update that was performed on the function. |
| AWS.Lambda.FunctionConfig.LastUpdateStatusReasonCode | String | The reason code for the last update operation status. |
| AWS.Lambda.FunctionConfig.PackageType | String | The type of deployment package. Set to Image for container image and set Zip for .zip file archive. |
| AWS.Lambda.FunctionConfig.ImageConfigResponse.ImageConfigError.ErrorCode | String | The error code for image configuration. |
| AWS.Lambda.FunctionConfig.ImageConfigResponse.ImageConfigError.Message | String | The error message for image configuration. |
| AWS.Lambda.FunctionConfig.ImageConfigResponse.ImageConfigError.Type | String | The error type for image configuration. |
| AWS.Lambda.FunctionConfig.ImageConfigResponse.ImageConfig | Object | The image configuration values. |
#### Command example
```!aws-lambda-get-function-configuration functionName=test```
#### Context Example
```json
{
"AWS": {
"Lambda": {
"FunctionConfig": {
"Architectures": [
"x86"
],
"CodeSha256": "111111/1111111",
"CodeSize": 000,
"Description": "",
"EphemeralStorage": {
"Size": 000
},
"FunctionArn": "arn:aws:lambda:dummy1111:function:test",
"FunctionName": "test",
"Handler": "handler",
"LastModified": "2024-06-05T11:54:29.646+0000",
"LastUpdateStatus": "Successful",
"MemorySize": 128,
"PackageType": "Zip",
"RevisionId": "11111-1111-11111",
"Role": "11111:role/dummy-role/test-role-11111",
"Runtime": "nodejs18.x",
"RuntimeVersionConfig": {
"RuntimeVersionArn": "arn:aws:lambda:dummy::runtime11111111"
},
"SnapStart": {
"ApplyOn": "None",
"OptimizationStatus": "Off"
},
"State": "Active",
"Timeout": 3,
"TracingConfig": {
"Mode": "PassThrough"
},
"Version": "$LATEST"
}
}
}
}
```
#### Human Readable Output
>### Function Configuration
>
>|Code Sha256|Description|Function Arn|Function Name|Revision Id|Runtime|State|
>|---|---|---|---|---|---|---|
>| 11111111 | | dummy:role/dummy-role/test-role-11111 | test | 11111-11111-111 | nodejs18.x | Active |
### aws-lambda-delete-function-url-config
***
Deletes a Lambda function URL. When you delete a function URL, you can’t recover it. Creating a new function URL results in a different URL address.
#### Base Command
`aws-lambda-delete-function-url-config`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
| functionName | The name of the Lambda function, version, or alias. You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length. | Required |
| qualifier | Specify a version or alias to get details about a published version of the function. | Optional |
#### Context Output
There is no context output for this command.
### aws-lambda-delete-function
***
Deletes a Lambda function. To delete a specific function version, use the Qualifier parameter. Otherwise, all versions and aliases are deleted.
#### Base Command
`aws-lambda-delete-function`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
| functionName | The name of the Lambda function, version, or alias. You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length. | Required |
| qualifier | Specify a version or alias to get details about a published version of the function. | Optional |
#### Context Output
There is no context output for this command.
### aws-lambda-create-function
***
Creates a Lambda function. To create a function, you need a deployment package and an execution role.
#### Base Command
`aws-lambda-create-function`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| functionName | The name of the Lambda function. | Required |
| runtime | The runtime environment for the function. | Required |
| handler | The name of the method within your code that Lambda calls to execute your function. Example: lambda_function.lambda_handler'. | Required |
| code | Entry ID of the uploaded base64-encoded contents of the deployment package. Amazon Web Services SDK and CLI clients handle the encoding for you. | Optional |
| S3-bucket | An Amazon S3 bucket in the same Amazon Web Services Region as your function. The bucket can be in a different Amazon Web Services account. | Optional |
| description | A description of the function. | Optional |
| functionTimeout | The amount of time that Lambda allows a function to run before stopping it. Default is 3. | Optional |
| memorySize | The amount of memory available to the function at runtime. Default is 128. | Optional |
| publish | Set to true to publish the first version of the function during creation. Possible values are: True, False. | Optional |
| vpcConfig | Json string contains SubnetIds - list of VPC subnet IDs, SecurityGroupIds - A list of VPC security group IDs, and boolean Ipv6AllowedForDualStack - allows outbound IPv6 traffic. | Optional |
| packageType | The type of deployment package. Possible values are: Image, Zip. | Optional |
| environment | The environment variables for the function. Should be given as key-value pairs in a json string. | Optional |
| tracingConfig | The tracing configuration for the function. Set to Active to sample and trace a subset of incoming requests with X-Ray. Default is Active. | Optional |
| tags | The list of tags to apply to the function. | Optional |
| role | The Amazon Resource Name (ARN) of the function’s execution role. | Required |
| layers | A list of function layers to add to the function's execution environment. | Optional |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
#### Context Output
| **Path** | **Type** | **Description** |
| --- | --- | --- |
| AWS.Lambda.Functions.FunctionName | string | The name of the function. |
| AWS.Lambda.Functions.FunctionArn | string | The function’s Amazon Resource Name \(ARN\). |
| AWS.Lambda.Functions.Runtime | string | The identifier of the function’s runtime. Runtime is required if the deployment package is a .zip file archive. |
| AWS.Lambda.Functions.Role | string | The function’s execution role. |
| AWS.Lambda.Functions.Handler | string | The function that Lambda calls to begin running your function. |
| AWS.Lambda.Functions.CodeSize | number | The size of the function’s deployment package, in bytes. |
| AWS.Lambda.Functions.Description | string | The function’s description. |
| AWS.Lambda.Functions.Timeout | number | The amount of time in seconds that Lambda allows a function to run before stopping it. |
| AWS.Lambda.Functions.MemorySize | number | The amount of memory available to the function at runtime. |
| AWS.Lambda.Functions.Version | string | The version of the Lambda function. |
| AWS.Lambda.Functions.VpcConfig.SubnetIds | list | A list of VPC subnet IDs. |
| AWS.Lambda.Functions.VpcConfig.SecurityGroupIds | list | A list of VPC security group IDs. |
| AWS.Lambda.Functions.VpcConfig.VpcId | string | The ID of the VPC. |
| AWS.Lambda.Functions.VpcConfig.Ipv6AllowedForDualStack | boolean | Allows outbound IPv6 traffic on VPC functions that are connected to dual-stack subnets. |
| AWS.Lambda.Functions.PackageType | string | The type of deployment package. Set to Image for container image and set Zip for .zip file archive. |
| AWS.Lambda.Functions.LastModified | string | The date and time that the function was last updated, in ISO-8601 format \(YYYY-MM-DDThh:mm:ss.sTZD\). |
#### Command example
```!aws-lambda-create-function code=entry_id functionName=test runtime=nodejs role=test-role handler=test.handler vpcConfig="{\"SubnetIds\": [\"subnet-1\",\"subnet-2\"], \"SecurityGroupIds\":[\"sg-1\"]}"```
#### Context Example
```json
{
"AWS": {
"Lambda": {
"Functions": {
"FunctionName": "test",
"FunctionArn": "test",
"Runtime": "nodejs",
"Role": "test-role",
"Handler": "test.handler",
"CodeSize": 30,
"Description": "test function",
"Timeout": 30,
"MemorySize": 123,
"Version": "test",
"VpcConfig": {
"SubnetIds": ["subnet-1","subnet-2"],
"SecurityGroupIds": ["sg-1"],
"VpcId": "test",
"Ipv6AllowedForDualStack": true},
"PackageType": "Zip",
"LastModified": "test"}
}
}
}
```
#### Human Readable Output
>### Create Function
>
>| Function Name |Function Arn|Runtime| Role | Handler |Code Size|Description|Timeout|Memory Size|Version| Vpc Config |Package Type|Last Modified|
>|---------------|---|---|-----------|--------------|---|---|---|---|---|-----------------------------------------------------------------------------------------------------------------------|---|---|
>| test | test | nodejs | test-role | test.handler | 30 | test function | 30 | 123 | test | SubnetIds: subnet-1,<br/>subnet-2<br/>SecurityGroupIds: sg-1<br/>VpcId: test<br/>Ipv6AllowedForDualStack: true | Zip | test |
### aws-lambda-publish-layer-version
***
Creates an Lambda layer from a ZIP archive.
#### Base Command
`aws-lambda-publish-layer-version`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| layer-name | The name or Amazon Resource Name (ARN) of the layer. | Required |
| description | The description of the version. | Optional |
| s3-bucket | The Amazon S3 bucket of the layer archive. | Optional |
| s3-key | The Amazon S3 key of the layer archive. | Optional |
| s3-object-version | For versioned objects, the version of the layer archive object to use. | Optional |
| zip-file | Entry ID of the base64-encoded contents of the layer archive. | Optional |
| compatible-runtimes | The name of the method within your code that Lambda calls to execute your function. | Optional |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
| compatible-architectures | A list of compatible architectures. Possible values are: x86_64, arm64. | Optional |
#### Context Output
| **Path** | **Type** | **Description** |
| --- | --- | --- |
| AWS.Lambda.Layers.LayerVersionArn | string | The ARN of the layer version. |
| AWS.Lambda.Layers.LayerArn | string | The ARN of the layer. |
| AWS.Lambda.Layers.Description | string | The description of the version. |
| AWS.Lambda.Layers.CreatedDate | string | The date that the layer version was created, in ISO-8601 format \(YYYY-MM-DDThh:mm:ss.sTZD\). |
| AWS.Lambda.Layers.Version | number | The version number. |
| AWS.Lambda.Layers.CompatibleRuntimes | list | The layer’s compatible runtimes. |
| AWS.Lambda.Layers.CompatibleArchitectures | list | The layer’s compatible architectures. |
#### Command example
```!aws-lambda-publish-layer-version layer-name=test zip-file=entry_id description=test-layer-3
```
#### Context Example
```json
{
"CompatibleRuntimes": ["nodejs"],
"CreatedDate": "2024-03-01T10:12:00.0TZD",
"Description": "test",
"LayerArn": "test_layer_arn",
"LayerVersionArn": "test_version_arn",
"Version": 2
}
```
#### Human Readable Output
>### Publish Layer Version
>
>|Layer Version Arn|Layer Arn|Description|Created Date|Version|Compatible Runtimes|
>|---|---|---|---|---|---|
>| test_version_arn | test_layer_arn | test | 2024-03-01T10:12:00.0TZD | 2 | nodejs |
### aws-lambda-list-layer-version
***
Lists the versions of an Lambda layer.
#### Base Command
`aws-lambda-list-layer-version`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| compatible-runtime | A runtime identifier. For example, java21. | Optional |
| layer-name | The name or Amazon Resource Name (ARN) of the layer. | Required |
| token | A pagination token returned by a previous call. | Optional |
| limit | The maximum number of versions to return. | Optional |
| compatible-architecture | The compatible instruction set architecture. | Optional |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
#### Context Output
| **Path** | **Type** | **Description** |
| --- | --- | --- |
| AWS.Lambda.LayerVersionsNextToken | string | A pagination token returned when the response doesn’t contain all versions. |
| AWS.Lambda.Layers.LayerVersionArn | string | The ARN of the layer version. |
| AWS.Lambda.Layers.Version | number | The version number. |
| AWS.Lambda.Layers.Description | string | The description of the version. |
| AWS.Lambda.Layers.CreatedDate | string | The date that the version was created, in ISO 8601 format. For example, 2018-11-27T15:10:45.123\+0000. |
| AWS.Lambda.Layers.CompatibleRuntimes | list | The layer’s compatible runtimes. |
| AWS.Lambda.Layers.LicenseInfo | string | The layer’s open-source license. |
| AWS.Lambda.Layers.CompatibleArchitectures | list | A list of compatible instruction set architectures. |
#### Command example
```!aws-lambda-list-layer-version layer-name=test```
#### Context Example
```json
{
"NextMarker": "test_marker",
"LayerVersions": [{
"LayerVersionArn": "testLayer",
"Version": 1,
"Description": "test",
"CreatedDate": "2018-11-27T15:10:45.123+0000",
"CompatibleRuntimes": ["nodejs"],
"LicenseInfo": "test",
"CompatibleArchitectures": ["x86_64"]
}]
}
```
#### Human Readable Output
>### Layer Version List
>
>|Compatible Architectures|Compatible Runtimes|Created Date|Description|Layer Version Arn|License Info|Version|
>|---|---|---|---|---|---|---|
>| x86_64 | nodejs | 2018-11-27T15:10:45.123+0000 | test | testLayer | test | 1 |
### aws-lambda-delete-layer-version
***
Deletes a version of an Lambda layer.
#### Base Command
`aws-lambda-delete-layer-version`
#### Input
| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| version-number | The version number. | Required |
| layer-name | The name or Amazon Resource Name (ARN) of the layer. | Required |
| region | The AWS Region. If not specified, the default region will be used. Possible values are: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-central-1, eu-west-2, ap-northeast-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-south-1, sa-east-1, eu-north-1, eu-west-3. | Optional |
| roleArn | The Amazon Resource Name (ARN) of the role to assume. | Optional |
| roleSessionName | An identifier for the assumed role session. | Optional |
| roleSessionDuration | The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) up to the maximum session duration setting for the role. | Optional |
#### Command example
```!aws-lambda-delete-layer-version version-number=4 layer-name=test_layer```
#### Context Output
There is no context output for this command.
#### Human Readable Output
>Deleted version number 2 of testLayer Successfully