libZSservicesZSamazonka-lambdaZSamazonka-lambda
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.Lambda.UpdateFunctionCode

Description

Updates a Lambda function's code. If code signing is enabled for the function, the code package must be signed by a trusted publisher. For more information, see Configuring code signing.

The function's code is locked when you publish a version. You can't modify the code of a published version, only the unpublished version.

For a function defined as a container image, Lambda resolves the image tag to an image digest. In Amazon ECR, if you update the image tag to a new image, Lambda does not automatically update the function.

Synopsis

Creating a Request

data UpdateFunctionCode Source #

See: newUpdateFunctionCode smart constructor.

Constructors

UpdateFunctionCode' 

Fields

  • s3ObjectVersion :: Maybe Text

    For versioned objects, the version of the deployment package object to use.

  • s3Key :: Maybe Text

    The Amazon S3 key of the deployment package.

  • zipFile :: Maybe (Sensitive Base64)

    The base64-encoded contents of the deployment package. Amazon Web Services SDK and Amazon Web Services CLI clients handle the encoding for you.

  • architectures :: Maybe (NonEmpty Architecture)

    The instruction set architecture that the function supports. Enter a string array with one of the valid values. The default value is x86_64.

  • imageUri :: Maybe Text

    URI of a container image in the Amazon ECR registry.

  • s3Bucket :: Maybe Text

    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.

  • dryRun :: Maybe Bool

    Set to true to validate the request parameters and access permissions without modifying the function code.

  • revisionId :: Maybe Text

    Only update the function 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.

  • publish :: Maybe Bool

    Set to true to publish a new version of the function after updating the code. This has the same effect as calling PublishVersion separately.

  • functionName :: Text

    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.

Instances

Instances details
Eq UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

Show UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

Generic UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

Associated Types

type Rep UpdateFunctionCode :: Type -> Type #

NFData UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

Methods

rnf :: UpdateFunctionCode -> () #

Hashable UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

ToJSON UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

AWSRequest UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

Associated Types

type AWSResponse UpdateFunctionCode #

ToHeaders UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

ToPath UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

ToQuery UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

type Rep UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

type AWSResponse UpdateFunctionCode Source # 
Instance details

Defined in Amazonka.Lambda.UpdateFunctionCode

newUpdateFunctionCode Source #

Create a value of UpdateFunctionCode with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:s3ObjectVersion:UpdateFunctionCode', updateFunctionCode_s3ObjectVersion - For versioned objects, the version of the deployment package object to use.

$sel:s3Key:UpdateFunctionCode', updateFunctionCode_s3Key - The Amazon S3 key of the deployment package.

$sel:zipFile:UpdateFunctionCode', updateFunctionCode_zipFile - The base64-encoded contents of the deployment package. Amazon Web Services SDK and Amazon Web Services CLI clients handle the encoding for you.-- -- Note: This Lens automatically encodes and decodes Base64 data. -- The underlying isomorphism will encode to Base64 representation during -- serialisation, and decode from Base64 representation during deserialisation. -- This Lens accepts and returns only raw unencoded data.

$sel:architectures:UpdateFunctionCode', updateFunctionCode_architectures - The instruction set architecture that the function supports. Enter a string array with one of the valid values. The default value is x86_64.

$sel:imageUri:UpdateFunctionCode', updateFunctionCode_imageUri - URI of a container image in the Amazon ECR registry.

$sel:s3Bucket:UpdateFunctionCode', updateFunctionCode_s3Bucket - 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.

$sel:dryRun:UpdateFunctionCode', updateFunctionCode_dryRun - Set to true to validate the request parameters and access permissions without modifying the function code.

$sel:revisionId:UpdateFunctionCode', updateFunctionCode_revisionId - Only update the function 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.

$sel:publish:UpdateFunctionCode', updateFunctionCode_publish - Set to true to publish a new version of the function after updating the code. This has the same effect as calling PublishVersion separately.

$sel:functionName:UpdateFunctionCode', updateFunctionCode_functionName - 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.

Request Lenses

updateFunctionCode_s3ObjectVersion :: Lens' UpdateFunctionCode (Maybe Text) Source #

For versioned objects, the version of the deployment package object to use.

updateFunctionCode_s3Key :: Lens' UpdateFunctionCode (Maybe Text) Source #

The Amazon S3 key of the deployment package.

updateFunctionCode_zipFile :: Lens' UpdateFunctionCode (Maybe ByteString) Source #

The base64-encoded contents of the deployment package. Amazon Web Services SDK and Amazon Web Services CLI clients handle the encoding for you.-- -- Note: This Lens automatically encodes and decodes Base64 data. -- The underlying isomorphism will encode to Base64 representation during -- serialisation, and decode from Base64 representation during deserialisation. -- This Lens accepts and returns only raw unencoded data.

updateFunctionCode_architectures :: Lens' UpdateFunctionCode (Maybe (NonEmpty Architecture)) Source #

The instruction set architecture that the function supports. Enter a string array with one of the valid values. The default value is x86_64.

updateFunctionCode_imageUri :: Lens' UpdateFunctionCode (Maybe Text) Source #

URI of a container image in the Amazon ECR registry.

updateFunctionCode_s3Bucket :: Lens' UpdateFunctionCode (Maybe Text) Source #

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.

updateFunctionCode_dryRun :: Lens' UpdateFunctionCode (Maybe Bool) Source #

Set to true to validate the request parameters and access permissions without modifying the function code.

updateFunctionCode_revisionId :: Lens' UpdateFunctionCode (Maybe Text) Source #

Only update the function 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.

updateFunctionCode_publish :: Lens' UpdateFunctionCode (Maybe Bool) Source #

Set to true to publish a new version of the function after updating the code. This has the same effect as calling PublishVersion separately.

updateFunctionCode_functionName :: Lens' UpdateFunctionCode Text Source #

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.

Destructuring the Response

data FunctionConfiguration Source #

Details about a function's configuration.

See: newFunctionConfiguration smart constructor.

Constructors

FunctionConfiguration' 

Fields

Instances

Instances details
Eq FunctionConfiguration Source # 
Instance details

Defined in Amazonka.Lambda.Types.FunctionConfiguration

Show FunctionConfiguration Source # 
Instance details

Defined in Amazonka.Lambda.Types.FunctionConfiguration

Generic FunctionConfiguration Source # 
Instance details

Defined in Amazonka.Lambda.Types.FunctionConfiguration

Associated Types

type Rep FunctionConfiguration :: Type -> Type #

NFData FunctionConfiguration Source # 
Instance details

Defined in Amazonka.Lambda.Types.FunctionConfiguration

Methods

rnf :: FunctionConfiguration -> () #

Hashable FunctionConfiguration Source # 
Instance details

Defined in Amazonka.Lambda.Types.FunctionConfiguration

FromJSON FunctionConfiguration Source # 
Instance details

Defined in Amazonka.Lambda.Types.FunctionConfiguration

type Rep FunctionConfiguration Source # 
Instance details

Defined in Amazonka.Lambda.Types.FunctionConfiguration

type Rep FunctionConfiguration = D1 ('MetaData "FunctionConfiguration" "Amazonka.Lambda.Types.FunctionConfiguration" "libZSservicesZSamazonka-lambdaZSamazonka-lambda" 'False) (C1 ('MetaCons "FunctionConfiguration'" 'PrefixI 'True) (((((S1 ('MetaSel ('Just "memorySize") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "runtime") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Runtime))) :*: (S1 ('MetaSel ('Just "state") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe State)) :*: S1 ('MetaSel ('Just "signingProfileVersionArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "lastUpdateStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe LastUpdateStatus)) :*: S1 ('MetaSel ('Just "functionArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "kmsKeyArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "packageType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe PackageType))))) :*: (((S1 ('MetaSel ('Just "fileSystemConfigs") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [FileSystemConfig])) :*: S1 ('MetaSel ('Just "environment") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe EnvironmentResponse))) :*: (S1 ('MetaSel ('Just "deadLetterConfig") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe DeadLetterConfig)) :*: S1 ('MetaSel ('Just "architectures") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (NonEmpty Architecture))))) :*: ((S1 ('MetaSel ('Just "signingJobArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "role'") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "vpcConfig") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe VpcConfigResponse)) :*: S1 ('MetaSel ('Just "version") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))))) :*: ((((S1 ('MetaSel ('Just "functionName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "layers") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Layer]))) :*: (S1 ('MetaSel ('Just "codeSize") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Integer)) :*: S1 ('MetaSel ('Just "handler") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "timeout") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "lastUpdateStatusReason") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "stateReason") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "lastModified") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))) :*: (((S1 ('MetaSel ('Just "codeSha256") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "tracingConfig") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe TracingConfigResponse))) :*: (S1 ('MetaSel ('Just "stateReasonCode") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe StateReasonCode)) :*: S1 ('MetaSel ('Just "imageConfigResponse") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ImageConfigResponse)))) :*: ((S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "lastUpdateStatusReasonCode") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe LastUpdateStatusReasonCode))) :*: (S1 ('MetaSel ('Just "revisionId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "masterArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))))))

newFunctionConfiguration :: FunctionConfiguration Source #

Create a value of FunctionConfiguration with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:memorySize:FunctionConfiguration', functionConfiguration_memorySize - The amount of memory available to the function at runtime.

$sel:runtime:FunctionConfiguration', functionConfiguration_runtime - The runtime environment for the Lambda function.

$sel:state:FunctionConfiguration', functionConfiguration_state - The current state of the function. When the state is Inactive, you can reactivate the function by invoking it.

$sel:signingProfileVersionArn:FunctionConfiguration', functionConfiguration_signingProfileVersionArn - The ARN of the signing profile version.

$sel:lastUpdateStatus:FunctionConfiguration', functionConfiguration_lastUpdateStatus - The status of the last update that was performed on the function. This is first set to Successful after function creation completes.

$sel:functionArn:FunctionConfiguration', functionConfiguration_functionArn - The function's Amazon Resource Name (ARN).

$sel:kmsKeyArn:FunctionConfiguration', functionConfiguration_kmsKeyArn - The KMS key that's used to encrypt the function's environment variables. This key is only returned if you've configured a customer managed CMK.

$sel:packageType:FunctionConfiguration', functionConfiguration_packageType - The type of deployment package. Set to Image for container image and set Zip for .zip file archive.

$sel:fileSystemConfigs:FunctionConfiguration', functionConfiguration_fileSystemConfigs - Connection settings for an Amazon EFS file system.

$sel:environment:FunctionConfiguration', functionConfiguration_environment - The function's environment variables.

$sel:deadLetterConfig:FunctionConfiguration', functionConfiguration_deadLetterConfig - The function's dead letter queue.

$sel:architectures:FunctionConfiguration', functionConfiguration_architectures - The instruction set architecture that the function supports. Architecture is a string array with one of the valid values. The default architecture value is x86_64.

$sel:signingJobArn:FunctionConfiguration', functionConfiguration_signingJobArn - The ARN of the signing job.

$sel:role':FunctionConfiguration', functionConfiguration_role - The function's execution role.

$sel:vpcConfig:FunctionConfiguration', functionConfiguration_vpcConfig - The function's networking configuration.

$sel:version:FunctionConfiguration', functionConfiguration_version - The version of the Lambda function.

$sel:functionName:FunctionConfiguration', functionConfiguration_functionName - The name of the function.

$sel:layers:FunctionConfiguration', functionConfiguration_layers - The function's layers.

$sel:codeSize:FunctionConfiguration', functionConfiguration_codeSize - The size of the function's deployment package, in bytes.

$sel:handler:FunctionConfiguration', functionConfiguration_handler - The function that Lambda calls to begin executing your function.

$sel:timeout:FunctionConfiguration', functionConfiguration_timeout - The amount of time in seconds that Lambda allows a function to run before stopping it.

$sel:lastUpdateStatusReason:FunctionConfiguration', functionConfiguration_lastUpdateStatusReason - The reason for the last update that was performed on the function.

$sel:stateReason:FunctionConfiguration', functionConfiguration_stateReason - The reason for the function's current state.

$sel:lastModified:FunctionConfiguration', functionConfiguration_lastModified - The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).

$sel:codeSha256:FunctionConfiguration', functionConfiguration_codeSha256 - The SHA256 hash of the function's deployment package.

$sel:tracingConfig:FunctionConfiguration', functionConfiguration_tracingConfig - The function's X-Ray tracing configuration.

$sel:stateReasonCode:FunctionConfiguration', functionConfiguration_stateReasonCode - The reason code for the function's current state. When the code is Creating, you can't invoke or modify the function.

$sel:imageConfigResponse:FunctionConfiguration', functionConfiguration_imageConfigResponse - The function's image configuration values.

$sel:description:FunctionConfiguration', functionConfiguration_description - The function's description.

$sel:lastUpdateStatusReasonCode:FunctionConfiguration', functionConfiguration_lastUpdateStatusReasonCode - The reason code for the last update that was performed on the function.

$sel:revisionId:FunctionConfiguration', functionConfiguration_revisionId - The latest updated revision of the function or alias.

$sel:masterArn:FunctionConfiguration', functionConfiguration_masterArn - For Lambda@Edge functions, the ARN of the master function.

Response Lenses

functionConfiguration_memorySize :: Lens' FunctionConfiguration (Maybe Natural) Source #

The amount of memory available to the function at runtime.

functionConfiguration_runtime :: Lens' FunctionConfiguration (Maybe Runtime) Source #

The runtime environment for the Lambda function.

functionConfiguration_state :: Lens' FunctionConfiguration (Maybe State) Source #

The current state of the function. When the state is Inactive, you can reactivate the function by invoking it.

functionConfiguration_lastUpdateStatus :: Lens' FunctionConfiguration (Maybe LastUpdateStatus) Source #

The status of the last update that was performed on the function. This is first set to Successful after function creation completes.

functionConfiguration_functionArn :: Lens' FunctionConfiguration (Maybe Text) Source #

The function's Amazon Resource Name (ARN).

functionConfiguration_kmsKeyArn :: Lens' FunctionConfiguration (Maybe Text) Source #

The KMS key that's used to encrypt the function's environment variables. This key is only returned if you've configured a customer managed CMK.

functionConfiguration_packageType :: Lens' FunctionConfiguration (Maybe PackageType) Source #

The type of deployment package. Set to Image for container image and set Zip for .zip file archive.

functionConfiguration_architectures :: Lens' FunctionConfiguration (Maybe (NonEmpty Architecture)) Source #

The instruction set architecture that the function supports. Architecture is a string array with one of the valid values. The default architecture value is x86_64.

functionConfiguration_codeSize :: Lens' FunctionConfiguration (Maybe Integer) Source #

The size of the function's deployment package, in bytes.

functionConfiguration_handler :: Lens' FunctionConfiguration (Maybe Text) Source #

The function that Lambda calls to begin executing your function.

functionConfiguration_timeout :: Lens' FunctionConfiguration (Maybe Natural) Source #

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

functionConfiguration_lastUpdateStatusReason :: Lens' FunctionConfiguration (Maybe Text) Source #

The reason for the last update that was performed on the function.

functionConfiguration_stateReason :: Lens' FunctionConfiguration (Maybe Text) Source #

The reason for the function's current state.

functionConfiguration_lastModified :: Lens' FunctionConfiguration (Maybe Text) Source #

The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).

functionConfiguration_codeSha256 :: Lens' FunctionConfiguration (Maybe Text) Source #

The SHA256 hash of the function's deployment package.

functionConfiguration_stateReasonCode :: Lens' FunctionConfiguration (Maybe StateReasonCode) Source #

The reason code for the function's current state. When the code is Creating, you can't invoke or modify the function.

functionConfiguration_lastUpdateStatusReasonCode :: Lens' FunctionConfiguration (Maybe LastUpdateStatusReasonCode) Source #

The reason code for the last update that was performed on the function.

functionConfiguration_revisionId :: Lens' FunctionConfiguration (Maybe Text) Source #

The latest updated revision of the function or alias.

functionConfiguration_masterArn :: Lens' FunctionConfiguration (Maybe Text) Source #

For Lambda@Edge functions, the ARN of the master function.