Struct UpdateFunctionConfigurationFluentBuilder

pub struct UpdateFunctionConfigurationFluentBuilder { /* private fields */ }

Fluent builder constructing a request to UpdateFunctionConfiguration.

Modify the version-specific settings of a Lambda function.

When you update a function, Lambda provisions an instance of the function and its supporting resources. If your function connects to a VPC, this process can take a minute. During this time, you can't modify the function, but you can still invoke it. The LastUpdateStatus, LastUpdateStatusReason, and LastUpdateStatusReasonCode fields in the response from GetFunctionConfiguration indicate when the update is complete and the function is processing events with the new configuration. For more information, see Lambda function states.

These settings can vary between versions of a function and are locked when you publish a version. You can't modify the configuration of a published version, only the unpublished version.

To configure function concurrency, use PutFunctionConcurrency. To grant invoke permissions to an Amazon Web Services account or Amazon Web Services service, use AddPermission.

Implementations

impl UpdateFunctionConfigurationFluentBuilder

pub fn as_input(&self) -> &UpdateFunctionConfigurationInputBuilder

Access the UpdateFunctionConfiguration as a reference.

pub async fn send( self, ) -> Result<UpdateFunctionConfigurationOutput, SdkError<UpdateFunctionConfigurationError, HttpResponse>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn customize( self, ) -> CustomizableOperation<UpdateFunctionConfigurationOutput, UpdateFunctionConfigurationError, Self>

Consumes this builder, creating a customizable operation that can be modified before being sent.

pub fn function_name(self, input: impl Into<String>) -> Self

The name or ARN 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.

pub fn set_function_name(self, input: Option<String>) -> Self

The name or ARN 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.

pub fn get_function_name(&self) -> &Option<String>

The name or ARN 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.

pub fn role(self, input: impl Into<String>) -> Self

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

pub fn set_role(self, input: Option<String>) -> Self

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

pub fn get_role(&self) -> &Option<String>

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

pub fn handler(self, input: impl Into<String>) -> Self

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.

pub fn set_handler(self, input: Option<String>) -> Self

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.

pub fn get_handler(&self) -> &Option<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.

pub fn description(self, input: impl Into<String>) -> Self

A description of the function.

pub fn set_description(self, input: Option<String>) -> Self

A description of the function.

pub fn get_description(&self) -> &Option<String>

A description of the function.

pub fn timeout(self, input: i32) -> Self

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.

pub fn set_timeout(self, input: Option<i32>) -> Self

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.

pub fn get_timeout(&self) -> &Option<i32>

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.

pub fn memory_size(self, input: i32) -> Self

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.

pub fn set_memory_size(self, input: Option<i32>) -> Self

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.

pub fn get_memory_size(&self) -> &Option<i32>

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.

pub fn vpc_config(self, input: VpcConfig) -> Self

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.

pub fn set_vpc_config(self, input: Option<VpcConfig>) -> Self

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.

pub fn get_vpc_config(&self) -> &Option<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.

pub fn environment(self, input: Environment) -> Self

Environment variables that are accessible from function code during execution.

pub fn set_environment(self, input: Option<Environment>) -> Self

Environment variables that are accessible from function code during execution.

pub fn get_environment(&self) -> &Option<Environment>

Environment variables that are accessible from function code during execution.

pub fn runtime(self, input: Runtime) -> Self

The identifier of the function's runtime. Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.

The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see Runtime use after deprecation.

For a list of all currently supported runtimes, see Supported runtimes.

pub fn set_runtime(self, input: Option<Runtime>) -> Self

The identifier of the function's runtime. Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.

The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see Runtime use after deprecation.

For a list of all currently supported runtimes, see Supported runtimes.

pub fn get_runtime(&self) -> &Option<Runtime>

The identifier of the function's runtime. Runtime is required if the deployment package is a .zip file archive. Specifying a runtime results in an error if you're deploying a function using a container image.

The following list includes deprecated runtimes. Lambda blocks creating new functions and updating existing functions shortly after each runtime is deprecated. For more information, see Runtime use after deprecation.

For a list of all currently supported runtimes, see Supported runtimes.

pub fn dead_letter_config(self, input: DeadLetterConfig) -> Self

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.

pub fn set_dead_letter_config(self, input: Option<DeadLetterConfig>) -> Self

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.

pub fn get_dead_letter_config(&self) -> &Option<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.

pub fn kms_key_arn(self, input: impl Into<String>) -> Self

The ARN of the Key Management Service (KMS) customer managed key that's used to encrypt the following resources:

• The function's environment variables.

• The function's Lambda SnapStart snapshots.

• When used with SourceKMSKeyArn, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see Specifying a customer managed key for Lambda.

• The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see Function lifecycle.

If you don't provide a customer managed key, Lambda uses an Amazon Web Services owned key or an Amazon Web Services managed key.

pub fn set_kms_key_arn(self, input: Option<String>) -> Self

The ARN of the Key Management Service (KMS) customer managed key that's used to encrypt the following resources:

• The function's environment variables.

• The function's Lambda SnapStart snapshots.

• When used with SourceKMSKeyArn, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see Specifying a customer managed key for Lambda.

• The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see Function lifecycle.

If you don't provide a customer managed key, Lambda uses an Amazon Web Services owned key or an Amazon Web Services managed key.

pub fn get_kms_key_arn(&self) -> &Option<String>

The ARN of the Key Management Service (KMS) customer managed key that's used to encrypt the following resources:

• The function's environment variables.

• The function's Lambda SnapStart snapshots.

• When used with SourceKMSKeyArn, the unzipped version of the .zip deployment package that's used for function invocations. For more information, see Specifying a customer managed key for Lambda.

• The optimized version of the container image that's used for function invocations. Note that this is not the same key that's used to protect your container image in the Amazon Elastic Container Registry (Amazon ECR). For more information, see Function lifecycle.

If you don't provide a customer managed key, Lambda uses an Amazon Web Services owned key or an Amazon Web Services managed key.

pub fn tracing_config(self, input: TracingConfig) -> Self

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

pub fn set_tracing_config(self, input: Option<TracingConfig>) -> Self

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

pub fn get_tracing_config(&self) -> &Option<TracingConfig>

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

pub fn revision_id(self, input: impl Into<String>) -> Self

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.

pub fn set_revision_id(self, input: Option<String>) -> Self

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.

pub fn get_revision_id(&self) -> &Option<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.

pub fn layers(self, input: impl Into<String>) -> Self

Appends an item to Layers.

To override the contents of this collection use set_layers.

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

pub fn set_layers(self, input: Option<Vec<String>>) -> Self

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

pub fn get_layers(&self) -> &Option<Vec<String>>

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

pub fn file_system_configs(self, input: FileSystemConfig) -> Self

Appends an item to FileSystemConfigs.

To override the contents of this collection use set_file_system_configs.

Connection settings for an Amazon EFS file system.

pub fn set_file_system_configs( self, input: Option<Vec<FileSystemConfig>>, ) -> Self

Connection settings for an Amazon EFS file system.

pub fn get_file_system_configs(&self) -> &Option<Vec<FileSystemConfig>>

Connection settings for an Amazon EFS file system.

pub fn image_config(self, input: ImageConfig) -> Self

Container image configuration values that override the values in the container image Docker file.

pub fn set_image_config(self, input: Option<ImageConfig>) -> Self

Container image configuration values that override the values in the container image Docker file.

pub fn get_image_config(&self) -> &Option<ImageConfig>

Container image configuration values that override the values in the container image Docker file.

pub fn ephemeral_storage(self, input: EphemeralStorage) -> Self

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. For more information, see Configuring ephemeral storage (console).

pub fn set_ephemeral_storage(self, input: Option<EphemeralStorage>) -> Self

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. For more information, see Configuring ephemeral storage (console).

pub fn get_ephemeral_storage(&self) -> &Option<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. For more information, see Configuring ephemeral storage (console).

pub fn snap_start(self, input: SnapStart) -> Self

The function's SnapStart setting.

pub fn set_snap_start(self, input: Option<SnapStart>) -> Self

The function's SnapStart setting.

pub fn get_snap_start(&self) -> &Option<SnapStart>

The function's SnapStart setting.

pub fn logging_config(self, input: LoggingConfig) -> Self

The function's Amazon CloudWatch Logs configuration settings.

pub fn set_logging_config(self, input: Option<LoggingConfig>) -> Self

The function's Amazon CloudWatch Logs configuration settings.

pub fn get_logging_config(&self) -> &Option<LoggingConfig>

The function's Amazon CloudWatch Logs configuration settings.

Trait Implementations

impl Clone for UpdateFunctionConfigurationFluentBuilder

fn clone(&self) -> UpdateFunctionConfigurationFluentBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UpdateFunctionConfigurationFluentBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.