You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::Lambda::Types::CreateFunctionRequest

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing CreateFunctionRequest as input to an Aws::Client method, you can use a vanilla Hash:

{
  function_name: "FunctionName", # required
  runtime: "nodejs", # required, accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, java8, java8.al2, java11, python2.7, python3.6, python3.7, python3.8, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, dotnetcore3.1, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided, provided.al2
  role: "RoleArn", # required
  handler: "Handler", # required
  code: { # required
    zip_file: "data",
    s3_bucket: "S3Bucket",
    s3_key: "S3Key",
    s3_object_version: "S3ObjectVersion",
  },
  description: "Description",
  timeout: 1,
  memory_size: 1,
  publish: false,
  vpc_config: {
    subnet_ids: ["SubnetId"],
    security_group_ids: ["SecurityGroupId"],
  },
  dead_letter_config: {
    target_arn: "ResourceArn",
  },
  environment: {
    variables: {
      "EnvironmentVariableName" => "EnvironmentVariableValue",
    },
  },
  kms_key_arn: "KMSKeyArn",
  tracing_config: {
    mode: "Active", # accepts Active, PassThrough
  },
  tags: {
    "TagKey" => "TagValue",
  },
  layers: ["LayerVersionArn"],
  file_system_configs: [
    {
      arn: "FileSystemArn", # required
      local_mount_path: "LocalMountPath", # required
    },
  ],
}

Instance Attribute Summary collapse

Instance Attribute Details

#codeTypes::FunctionCode

The code for the function.

Returns:

#dead_letter_configTypes::DeadLetterConfig

A dead letter queue configuration that specifies the queue or topic where Lambda sends asynchronous events when they fail processing. For more information, see Dead Letter Queues.

Returns:

  • (Types::DeadLetterConfig)

    A dead letter queue configuration that specifies the queue or topic where Lambda sends asynchronous events when they fail processing.

#descriptionString

A description of the function.

Returns:

  • (String)

    A description of the function.

#environmentTypes::Environment

Environment variables that are accessible from function code during execution.

Returns:

  • (Types::Environment)

    Environment variables that are accessible from function code during execution.

#file_system_configsArray<Types::FileSystemConfig>

Connection settings for an Amazon EFS file system.

Returns:

#function_nameString

The name of the Lambda function.

Name formats .title

  • Function name - my-function.

  • Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.

  • Partial ARN - 123456789012:function:my-function.

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

Returns:

  • (String)

    The name of the Lambda function.

#handlerString

The name of the method within your code that Lambda calls to execute your function. The format includes the file name. It can also include namespaces and other qualifiers, depending on the runtime. For more information, see Programming Model.

Returns:

  • (String)

    The name of the method within your code that Lambda calls to execute your function.

#kms_key_arnString

The ARN of the AWS Key Management Service (AWS KMS) key that\'s used to encrypt your function\'s environment variables. If it\'s not provided, AWS Lambda uses a default service key.

Returns:

  • (String)

    The ARN of the AWS Key Management Service (AWS KMS) key that\'s used to encrypt your function\'s environment variables.

#layersArray<String>

A list of function layers to add to the function\'s execution environment. Specify each layer by its ARN, including the version.

Returns:

  • (Array<String>)

    A list of [function layers][1] to add to the function\'s execution environment.

#memory_sizeInteger

The amount of memory that your function has access to. Increasing the function\'s memory also increases its CPU allocation. The default value is 128 MB. The value must be a multiple of 64 MB.

Returns:

  • (Integer)

    The amount of memory that your function has access to.

#publishBoolean

Set to true to publish the first version of the function during creation.

Returns:

  • (Boolean)

    Set to true to publish the first version of the function during creation.

#roleString

The Amazon Resource Name (ARN) of the function\'s execution role.

Returns:

  • (String)

    The Amazon Resource Name (ARN) of the function\'s execution role.

#runtimeString

The identifier of the function\'s runtime.

Returns:

  • (String)

    The identifier of the function\'s [runtime][1].

#tagsHash<String,String>

A list of tags to apply to the function.

Returns:

  • (Hash<String,String>)

    A list of [tags][1] to apply to the function.

#timeoutInteger

The amount of time that Lambda allows a function to run before stopping it. The default is 3 seconds. The maximum allowed value is 900 seconds.

Returns:

  • (Integer)

    The amount of time that Lambda allows a function to run before stopping it.

#tracing_configTypes::TracingConfig

Set Mode to Active to sample and trace a subset of incoming requests with AWS X-Ray.

Returns:

  • (Types::TracingConfig)

    Set Mode to Active to sample and trace a subset of incoming requests with AWS X-Ray.

#vpc_configTypes::VpcConfig

For network connectivity to AWS resources in a VPC, specify a list of security groups and subnets in the VPC. When you connect a function to a VPC, it can only access resources and the internet through that VPC. For more information, see VPC Settings.

Returns:

  • (Types::VpcConfig)

    For network connectivity to AWS resources in a VPC, specify a list of security groups and subnets in the VPC.