@aws-lite/lambda v0.1.0

@aws-lite/lambda

Official aws-lite plugin for Lambda

Maintained by: @architect

Install

npm i @aws-lite/lambda

Optionally install types:

npm i -D @aws-lite/lambda-types

Reference

Reference documentation with examples at aws-lite.org

Methods

AddLayerVersionPermission

Canonical AWS API doc

Properties:

• LayerName (string) required
  • Name or ARN of the layer
• RevisionId (string)
  • Update the function config only if the current revision ID matches the specified RevisionId; used to avoid modifying a function that has changed since you last read it
• VersionNumber (number) required
  • The version number of the layer
• Action (string) required
  • The API action that grants access to the layer, for example lambda:GetLayerVersion
• OrganizationId (string)
  • When Principal is set to *, permission will be granted to all accounts in the specified organization
• Principal (string)
  • Account ID being granted permissions. Use * along with the OrganizationId to grant permissions to all accounts in the specified organization
• StatementId (string) required
  • ID to distinguish the policy from other policies on the same layer version

AddPermission

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Qualifier (string)
  • Specify a version or alias to invoke a published version of the function
• Action (string) required
  • Action that the principal can use on the function, for example, lambda:InvokeFunction
• EventSourceToken (string)
  • A token that Alexa Smart Home requires from the invoker
• FunctionUrlAuthType (string)
  • The type of authentication that your 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
• Principal (string) required
  • The AWS service or AWS account that invokes the function
• PrincipalOrgID (string)
  • The identifier for your organization in AWS Organizations
• RevisionId (string)
  • Update the function config only if the current revision ID matches the specified RevisionId; used to avoid modifying a function that has changed since you last read it
• SourceAccount (string)
  • ID of the AWS account that owns the resource
• SourceArn (string)
  • ARN of the AWS resource that invokes the function, such as an Amazon S3 bucket
• StatementId (string) required
  • A statement identifier that differentiates the statement from others in the same policy

CreateAlias

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Description (string)
  • Description of the function
• FunctionVersion (string) required
  • Version of the aliased function
• Name (string) required
  • Name of the alias
• RoutingConfig (object)
  • Configure function version weights
  • More details (AWS)

CreateCodeSigningConfig

Canonical AWS API doc

Properties:

• AllowedPublishers (object) required
  • Signing profiles for this code signing configuration
  • More details (AWS)
• CodeSigningPolicies (object)
  • Define actions to take if validation checks fail
  • More details (AWS)
• Description (string)
  • Description of the function

CreateFunction

Canonical AWS API doc

Properties:

• Code (object) required
  • Code payload to be run in Lambda; object can contain: ImageUri (ECR image), S3Bucket + S3Key + S3ObjectVersion (S3 bucket in the same region, key, and optional version), or ZipFile (base64-encoded zip)
  • More details (AWS)
• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Role (string) required
  • ARN of the function's execution role
• Architectures (array)
  • System architecture, array can contain either x86_64 (default) or arm64
• CodeSigningConfigArn (string)
  • ARN of a code-signing configuration used to enable code signing for this function
• DeadLetterConfig (object)
  • Dead-letter queue configuration
  • More details (AWS)
• Description (string)
  • Description of the function
• Environment (object)
  • Environment variable configuration
  • More details (AWS)
• EphemeralStorage (object)
  • Size of the function /tmp directory (in MB), from 512 (default) to 10240
  • More details (AWS)
• FileSystemConfigs (array)
  • EFS file system connection settings
  • More details (AWS)
• Handler (string)
  • The name of the handler file and method method within your code that Lambda calls to run your function (e.g. index.handler)
  • More details (AWS)
• ImageConfig (object)
  • Container image configuration (overrides Docker file)
  • More details (AWS)
• KMSKeyArn (string)
  • ARN of the Key Management Service (KMS) customer managed key used to encrypt your function environment variables
• Layers (array)
  • List of function layer ARNs (including version) to add to the function execution environment
• MemorySize (number)
  • Amount of memory available (in MB) at runtime from 128 to 10240; increasing memory also increases CPU allocation
• PackageType (string)
  • Deployment package type, either Image (container image) or Zip (zip archive)
• Publish (boolean)
  • Set to true to publish the first version of the function during creation
• Runtime (string)
  • Runtime identifier
  • More details (AWS)
• SnapStart (object)
  • SnapStart settings
  • More details (AWS)
• Tags (array)
  • List of tags to apply to the function
• Timeout (number)
  • Time (in seconds) a function is allowed to run before being stopped, from 3 (default) to 900
• TracingConfig (object)
  • Sample and trace a subset of incoming requests with X-Ray
  • More details (AWS)
• VpcConfig (object)
  • VPC networking configuration
  • More details (AWS)

DeleteAlias

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Name (string) required
  • Name of the alias

DeleteCodeSigningConfig

Canonical AWS API doc

Properties:

• CodeSigningConfigArn (string) required
  • ARN of the code signing configuration

DeleteEventSourceMapping

Canonical AWS API doc

Properties:

• UUID (string) required
  • UUID of the event source mapping

DeleteFunctionConcurrency

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias

GetAccountSettings

Canonical AWS API doc

Properties:

GetAlias

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Name (string) required
  • Name of the function alias

GetCodeSigningConfig

Canonical AWS API doc

Properties:

• CodeSigningConfigArn (string) required
  • ARN of the code signing configuration

GetEventSourceMapping

Canonical AWS API doc

Properties:

• UUID (string) required
  • ARN of the event source mapping

GetFunction

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Qualifier (string)
  • Specify a version or alias to invoke a published version of the function

GetFunctionCodeSigningConfig

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias

GetFunctionConcurrency

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias

GetFunctionConfiguration

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Qualifier (string)
  • Specify a version or alias to invoke a published version of the function

GetFunctionEventInvokeConfig

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Qualifier (string)
  • Specify a version or alias to invoke a published version of the function

GetFunctionUrlConfig

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Qualifier (string)
  • Specify a version or alias to invoke a published version of the function

GetLayerVersion

Canonical AWS API doc

Properties:

• LayerName (string) required
  • Name or ARN of the layer
• VersionNumber (number) required
  • The version number of the layer

GetLayerVersionByArn

Canonical AWS API doc

Properties:

• Arn (string) required
  • The ARN of the layer version

GetLayerVersionPolicy

Canonical AWS API doc

Properties:

• LayerName (string) required
  • Name or ARN of the layer
• VersionNumber (number) required
  • The version number of the layer

GetPolicy

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Qualifier (string)
  • Specify a version or alias to invoke a published version of the function

GetProvisionedConcurrencyConfig

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Qualifier (string) required
  • The version number or alias name

GetRuntimeManagementConfig

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Qualifier (string)
  • Specify a version or alias to invoke a published version of the function

Invoke

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• InvocationType (string)
  • Set invocation type to one of: RequestResponse (default, synchronous), Event (asynchronous), DryRun (validate invoke request only)
• Payload (array, object) required
  • Event payload to invoke function with
• LogType (string)
  • Set to Tail to include the execution log in the X-Amz-Log-Result response header of synchronously invoked functions
• ClientContext (string)
  • Up to 3,583 bytes of base64-encoded data to pass to the function in the context object
• Qualifier (string)
  • Specify a version or alias to invoke a published version of the function

PutFunctionConcurrency

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• ReservedConcurrentExecutions (number) required
  • number of simultaneous executions to reserve

UpdateAlias

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Name (string) required
  • Name of the alias
• Description (string)
  • Description of the function
• FunctionVersion (string)
  • Version of the aliased function
• RevisionId (string)
  • Update the function config only if the current revision ID matches the specified RevisionId; used to avoid modifying a function that has changed since you last read it
• RoutingConfig (object)
  • Configure function version weights
  • More details (AWS)

UpdateFunctionCode

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• Architectures (array)
  • System architecture, array can contain either x86_64 (default) or arm64
• DryRun (string)
  • Validate the request parameters and access permissions without modifying the function code (true)
• ImageUri (string)
  • URI of a container image in the Amazon ECR registry (if not using a .zip file)
• Publish (boolean)
  • Publish a new version after after updating the code (true); effectively the same as calling PublishVersion
• RevisionId (string)
  • Update the function config only if the current revision ID matches the specified RevisionId; used to avoid modifying a function that has changed since you last read it
• S3Bucket (string)
  • S3 bucket containing the key of the deployment package; must be in the same region
• S3Key (string)
  • S3 key of the deployment package (must be a .zip file)
• S3ObjectVersion (string)
  • S3 object version to use, if applicable
• ZipFile (string, buffer)
  • File path or raw buffer of the .zip deployment package

UpdateFunctionConfiguration

Canonical AWS API doc

Properties:

• FunctionName (string) required
  • The name of the Lambda function, version, or alias
• DeadLetterConfig (object)
  • Dead-letter queue configuration
  • More details (AWS)
• Description (string)
  • Description of the function
• Environment (object)
  • Environment variable configuration
  • More details (AWS)
• EphemeralStorage (object)
  • Size of the function /tmp directory (in MB), from 512 (default) to 10240
  • More details (AWS)
• FileSystemConfigs (array)
  • EFS file system connection settings
  • More details (AWS)
• Handler (string)
  • The name of the handler file and method method within your code that Lambda calls to run your function (e.g. index.handler)
  • More details (AWS)
• ImageConfig (object)
  • Container image configuration (overrides Docker file)
  • More details (AWS)
• KMSKeyArn (string)
  • ARN of the Key Management Service (KMS) customer managed key used to encrypt your function environment variables
• Layers (array)
  • List of function layer ARNs (including version) to add to the function execution environment
• MemorySize (number)
  • Amount of memory available (in MB) at runtime from 128 to 10240; increasing memory also increases CPU allocation
• RevisionId (string)
  • Update the function config only if the current revision ID matches the specified RevisionId; used to avoid modifying a function that has changed since you last read it
• Role (string)
  • ARN of the function's execution role
• Runtime (string)
  • Runtime identifier
  • More details (AWS)
• SnapStart (object)
  • SnapStart settings
  • More details (AWS)
• Timeout (number)
  • Time (in seconds) a function is allowed to run before being stopped, from 3 (default) to 900
• TracingConfig (object)
  • Sample and trace a subset of incoming requests with X-Ray
  • More details (AWS)
• VpcConfig (object)
  • VPC networking configuration
  • More details (AWS)

Methods yet to be implemented

Please help out by opening a PR!

• CreateEventSourceMapping
• CreateFunctionUrlConfig
• DeleteFunction
• DeleteFunctionCodeSigningConfig
• DeleteFunctionEventInvokeConfig
• DeleteFunctionUrlConfig
• DeleteLayerVersion
• DeleteProvisionedConcurrencyConfig
• InvokeAsync
• InvokeWithResponseStream
• ListAliases
• ListCodeSigningConfigs
• ListEventSourceMappings
• ListFunctionEventInvokeConfigs
• ListFunctions
• ListFunctionsByCodeSigningConfig
• ListFunctionUrlConfigs
• ListLayers
• ListLayerVersions
• ListProvisionedConcurrencyConfigs
• ListTags
• ListVersionsByFunction
• PublishLayerVersion
• PublishVersion
• PutFunctionCodeSigningConfig
• PutFunctionEventInvokeConfig
• PutProvisionedConcurrencyConfig
• PutRuntimeManagementConfig
• RemoveLayerVersionPermission
• RemovePermission
• TagResource
• UntagResource
• UpdateCodeSigningConfig
• UpdateEventSourceMapping
• UpdateFunctionEventInvokeConfig
• UpdateFunctionUrlConfig

Learn more

• More information about the aws-lite plugin API
• Learn about contributing to this and other aws-lite plugins