Class: Aws::Lambda::Types::UpdateFunctionConfigurationRequest

Inherits:

Struct

Object
Struct
Aws::Lambda::Types::UpdateFunctionConfigurationRequest

show all

Includes:: Structure

Defined in:: lib/aws-sdk-lambda/types.rb

Overview

Note:

When making an API call, you may pass UpdateFunctionConfigurationRequest data as a hash:

{
  function_name: "FunctionName", # required
  role: "RoleArn",
  handler: "Handler",
  description: "Description",
  timeout: 1,
  memory_size: 1,
  vpc_config: {
    subnet_ids: ["SubnetId"],
    security_group_ids: ["SecurityGroupId"],
  },
  environment: {
    variables: {
      "EnvironmentVariableName" => "EnvironmentVariableValue",
    },
  },
  runtime: "nodejs", # accepts nodejs, nodejs4.3, nodejs6.10, nodejs8.10, nodejs10.x, nodejs12.x, nodejs14.x, nodejs16.x, java8, java8.al2, java11, python2.7, python3.6, python3.7, python3.8, python3.9, dotnetcore1.0, dotnetcore2.0, dotnetcore2.1, dotnetcore3.1, dotnet6, nodejs4.3-edge, go1.x, ruby2.5, ruby2.7, provided, provided.al2, nodejs18.x
  dead_letter_config: {
    target_arn: "ResourceArn",
  },
  kms_key_arn: "KMSKeyArn",
  tracing_config: {
    mode: "Active", # accepts Active, PassThrough
  },
  revision_id: "String",
  layers: ["LayerVersionArn"],
  file_system_configs: [
    {
      arn: "FileSystemArn", # required
      local_mount_path: "LocalMountPath", # required
    },
  ],
  image_config: {
    entry_point: ["String"],
    command: ["String"],
    working_directory: "WorkingDirectory",
  },
  ephemeral_storage: {
    size: 1, # required
  },
  snap_start: {
    apply_on: "PublishedVersions", # accepts PublishedVersions, None
  },
}

Constant Summary collapse

SENSITIVE =

[]

Instance Attribute Summary collapse

#dead_letter_config ⇒ Types::DeadLetterConfig

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

A description of the function.
#environment ⇒ Types::Environment

Environment variables that are accessible from function code during execution.
#ephemeral_storage ⇒ Types::EphemeralStorage

The size of the function's `/tmp` directory in MB.
#file_system_configs ⇒ Array<Types::FileSystemConfig>

Connection settings for an Amazon EFS file system.
#function_name ⇒ String

The name of the Lambda function.
#handler ⇒ String

The name of the method within your code that Lambda calls to run your function.
#image_config ⇒ Types::ImageConfig
Container image configuration values][1

that override the values in the container image Docker file.
#kms_key_arn ⇒ String

The ARN of the Key Management Service (KMS) key that's used to encrypt your function's environment variables.
#layers ⇒ Array<String>

A list of [function layers] to add to the function's execution environment.
#memory_size ⇒ Integer

The amount of [memory available to the function] at runtime.
#revision_id ⇒ String

Update the function only if the revision ID matches the ID that's specified.
#role ⇒ String

The Amazon Resource Name (ARN) of the function's execution role.
#runtime ⇒ String

The identifier of the function's [runtime].
#snap_start ⇒ Types::SnapStart

The function's [SnapStart] setting.
#timeout ⇒ Integer

The amount of time (in seconds) that Lambda allows a function to run before stopping it.
#tracing_config ⇒ Types::TracingConfig

Set `Mode` to `Active` to sample and trace a subset of incoming requests with [X-Ray].
#vpc_config ⇒ Types::VpcConfig

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

Instance Attribute Details

#dead_letter_config ⇒ `Types::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].

[1]: docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq

Returns:

(Types::DeadLetterConfig)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#description ⇒ `String`

A description of the function.

Returns:

(String)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#environment ⇒ `Types::Environment`

Environment variables that are accessible from function code during execution.

Returns:

(Types::Environment)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#ephemeral_storage ⇒ `Types::EphemeralStorage`

The size of the function's `/tmp` directory in MB. The default value is 512, but can be any whole number between 512 and 10,240 MB.

Returns:

(Types::EphemeralStorage)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#file_system_configs ⇒ `Array<Types::FileSystemConfig>`

Connection settings for an Amazon EFS file system.

Returns:

(Array<Types::FileSystemConfig>)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#function_name ⇒ `String`

The name of the Lambda function.

**Name formats**

**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)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#handler ⇒ `String`

The name of the method within your code that Lambda calls to run your function. Handler is required if the deployment package is a .zip file archive. The format includes the file name. It can also include namespaces and other qualifiers, depending on the runtime. For more information, see [Lambda programming model].

[1]: docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html

Returns:

(String)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#image_config ⇒ `Types::ImageConfig`

Container image configuration values][1: that override the values

in the container image Docker file.

[1]: docs.aws.amazon.com/lambda/latest/dg/images-parms.html

Returns:

(Types::ImageConfig)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#kms_key_arn ⇒ `String`

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

Returns:

(String)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#layers ⇒ `Array<String>`

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

[1]: docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html

Returns:

(Array<String>)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#memory_size ⇒ `Integer`

The amount of [memory available to the function] at runtime. Increasing the function memory also increases its CPU allocation. The default value is 128 MB. The value can be any multiple of 1 MB.

[1]: docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-memory-console

Returns:

(Integer)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#revision_id ⇒ `String`

Update the function only if the revision ID matches the ID that's specified. Use this option to avoid modifying a function that has changed since you last read it.

Returns:

(String)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#role ⇒ `String`

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

Returns:

(String)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#runtime ⇒ `String`

The identifier of the function's [runtime]. Runtime is required if the deployment package is a .zip file archive.

[1]: docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html

Returns:

(String)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#snap_start ⇒ `Types::SnapStart`

The function's [SnapStart] setting.

[1]: docs.aws.amazon.com/lambda/latest/dg/snapstart.html

Returns:

(Types::SnapStart)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#timeout ⇒ `Integer`

The amount of time (in seconds) that Lambda allows a function to run before stopping it. The default is 3 seconds. The maximum allowed value is 900 seconds. For more information, see [Lambda execution environment].

[1]: docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html

Returns:

(Integer)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#tracing_config ⇒ `Types::TracingConfig`

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

[1]: docs.aws.amazon.com/lambda/latest/dg/services-xray.html

Returns:

(Types::TracingConfig)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

#vpc_config ⇒ `Types::VpcConfig`

For network connectivity to Amazon Web Services 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 access resources and the internet only through that VPC. For more information, see [Configuring a Lambda function to access resources in a VPC].

[1]: docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html

Returns:

(Types::VpcConfig)

# File 'lib/aws-sdk-lambda/types.rb', line 6637

class UpdateFunctionConfigurationRequest < Struct.new(
  :function_name,
  :role,
  :handler,
  :description,
  :timeout,
  :memory_size,
  :vpc_config,
  :environment,
  :runtime,
  :dead_letter_config,
  :kms_key_arn,
  :tracing_config,
  :revision_id,
  :layers,
  :file_system_configs,
  :image_config,
  :ephemeral_storage,
  :snap_start)
  SENSITIVE = []
  include Aws::Structure
end

Class: Aws::Lambda::Types::UpdateFunctionConfigurationRequest

Overview

Constant Summary collapse

Instance Attribute Summary collapse

Instance Attribute Details

#dead_letter_config ⇒ Types::DeadLetterConfig

#description ⇒ String

#environment ⇒ Types::Environment

#ephemeral_storage ⇒ Types::EphemeralStorage

#file_system_configs ⇒ Array<Types::FileSystemConfig>

#function_name ⇒ String

#handler ⇒ String

#image_config ⇒ Types::ImageConfig

#kms_key_arn ⇒ String

#layers ⇒ Array<String>

#memory_size ⇒ Integer

#revision_id ⇒ String

#role ⇒ String

#runtime ⇒ String

#snap_start ⇒ Types::SnapStart

#timeout ⇒ Integer

#tracing_config ⇒ Types::TracingConfig

#vpc_config ⇒ Types::VpcConfig

#dead_letter_config ⇒ `Types::DeadLetterConfig`

#description ⇒ `String`

#environment ⇒ `Types::Environment`

#ephemeral_storage ⇒ `Types::EphemeralStorage`

#file_system_configs ⇒ `Array<Types::FileSystemConfig>`

#function_name ⇒ `String`

#handler ⇒ `String`

#image_config ⇒ `Types::ImageConfig`

#kms_key_arn ⇒ `String`

#layers ⇒ `Array<String>`

#memory_size ⇒ `Integer`

#revision_id ⇒ `String`

#role ⇒ `String`

#runtime ⇒ `String`

#snap_start ⇒ `Types::SnapStart`

#timeout ⇒ `Integer`

#tracing_config ⇒ `Types::TracingConfig`

#vpc_config ⇒ `Types::VpcConfig`