Network.AWS.Lambda.PublishVersion

Publishes a version of your function from the current snapshot of $LATEST. That is, AWS Lambda takes a snapshot of the function code and configuration information from $LATEST and publishes a new version. The code and configuration cannot be modified after publication. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases .

Creating a Request

publishVersion

Arguments

:: Text

pvFunctionName

-> PublishVersion

Creates a value of PublishVersion with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• pvCodeSha256 - The SHA256 hash of the deployment package you want to publish. This provides validation on the code you are publishing. If you provide this parameter, the value must match the SHA256 of the $LATEST version for the publication to succeed. You can use the DryRun parameter of UpdateFunctionCode to verify the hash value that will be returned before publishing your new version.
• pvDescription - The description for the version you are publishing. If not provided, AWS Lambda copies the description from the $LATEST version.
• pvRevisionId - An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .
• pvFunctionName - The Lambda function name. You can specify a function name (for example, Thumbnail ) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail ). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail ). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

data PublishVersion

See: publishVersion smart constructor.

Instances

Eq PublishVersion

Methods

(==) :: PublishVersion -> PublishVersion -> Bool

(/=) :: PublishVersion -> PublishVersion -> Bool

Data PublishVersion

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> PublishVersion -> c PublishVersion

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c PublishVersion

toConstr :: PublishVersion -> Constr

dataTypeOf :: PublishVersion -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c PublishVersion)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c PublishVersion)

gmapT :: (forall b. Data b => b -> b) -> PublishVersion -> PublishVersion

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> PublishVersion -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> PublishVersion -> r

gmapQ :: (forall d. Data d => d -> u) -> PublishVersion -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> PublishVersion -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> PublishVersion -> m PublishVersion

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> PublishVersion -> m PublishVersion

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> PublishVersion -> m PublishVersion

Read PublishVersion

Methods

readsPrec :: Int -> ReadS PublishVersion

readList :: ReadS [PublishVersion]

readPrec :: ReadPrec PublishVersion

readListPrec :: ReadPrec [PublishVersion]

Show PublishVersion

Methods

showsPrec :: Int -> PublishVersion -> ShowS

show :: PublishVersion -> String

showList :: [PublishVersion] -> ShowS

Generic PublishVersion

Associated Types

type Rep PublishVersion :: * -> *

Methods

from :: PublishVersion -> Rep PublishVersion x

to :: Rep PublishVersion x -> PublishVersion

Hashable PublishVersion

Methods

hashWithSalt :: Int -> PublishVersion -> Int

hash :: PublishVersion -> Int

ToJSON PublishVersion

Methods

toJSON :: PublishVersion -> Value

toEncoding :: PublishVersion -> Encoding

toJSONList :: [PublishVersion] -> Value

toEncodingList :: [PublishVersion] -> Encoding

NFData PublishVersion

Methods

rnf :: PublishVersion -> ()

AWSRequest PublishVersion

Associated Types

type Rs PublishVersion :: *

Methods

request :: PublishVersion -> Request PublishVersion

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy * PublishVersion -> ClientResponse -> m (Response PublishVersion)

ToHeaders PublishVersion

Methods

toHeaders :: PublishVersion -> [Header]

ToPath PublishVersion

Methods

toPath :: PublishVersion -> ByteString

ToQuery PublishVersion

Methods

toQuery :: PublishVersion -> QueryString

type Rep PublishVersion

type Rep PublishVersion = D1 * (MetaData "PublishVersion" "Network.AWS.Lambda.PublishVersion" "amazonka-lambda-1.6.0-BCoVnxAqk5DEBm6Teqtlxw" False) (C1 * (MetaCons "PublishVersion'" PrefixI True) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_pvCodeSha256") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_pvDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_pvRevisionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_pvFunctionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)))))

type Rs PublishVersion

type Rs PublishVersion = FunctionConfiguration

Request Lenses

pvCodeSha256 :: Lens' PublishVersion (Maybe Text)

The SHA256 hash of the deployment package you want to publish. This provides validation on the code you are publishing. If you provide this parameter, the value must match the SHA256 of the $LATEST version for the publication to succeed. You can use the DryRun parameter of UpdateFunctionCode to verify the hash value that will be returned before publishing your new version.

pvDescription :: Lens' PublishVersion (Maybe Text)

The description for the version you are publishing. If not provided, AWS Lambda copies the description from the $LATEST version.

pvRevisionId :: Lens' PublishVersion (Maybe Text)

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

pvFunctionName :: Lens' PublishVersion Text

The Lambda function name. You can specify a function name (for example, Thumbnail ) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail ). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail ). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

Destructuring the Response

functionConfiguration :: FunctionConfiguration

Creates a value of FunctionConfiguration with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• fcMemorySize - The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.
• fcRuntime - The runtime environment for the Lambda function.
• fcFunctionARN - The Amazon Resource Name (ARN) assigned to the function.
• fcKMSKeyARN - The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If empty, it means you are using the AWS Lambda default service key.
• fcEnvironment - The parent object that contains your environment's configuration settings.
• fcDeadLetterConfig - The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq .
• fcRole - The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.
• fcVPCConfig - VPC configuration associated with your Lambda function.
• fcVersion - The version of the Lambda function.
• fcFunctionName - The name of the function. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.
• fcCodeSize - The size, in bytes, of the function .zip file you uploaded.
• fcHandler - The function Lambda calls to begin executing your function.
• fcTimeout - The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.
• fcLastModified - The time stamp of the last time you updated the function. The time stamp is conveyed as a string complying with ISO-8601 in this way YYYY-MM-DDThh:mm:ssTZD (e.g., 1997-07-16T19:20:30+01:00). For more information, see Date and Time Formats .
• fcCodeSha256 - It is the SHA256 hash of your function deployment package.
• fcTracingConfig - The parent object that contains your function's tracing settings.
• fcDescription - The user-provided description.
• fcRevisionId - Represents the latest updated revision of the function or alias.
• fcMasterARN - Returns the ARN (Amazon Resource Name) of the master function.

data FunctionConfiguration

A complex type that describes function metadata.

See: functionConfiguration smart constructor.

Instances

Eq FunctionConfiguration

Methods

(==) :: FunctionConfiguration -> FunctionConfiguration -> Bool

(/=) :: FunctionConfiguration -> FunctionConfiguration -> Bool

Data FunctionConfiguration

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> FunctionConfiguration -> c FunctionConfiguration

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c FunctionConfiguration

toConstr :: FunctionConfiguration -> Constr

dataTypeOf :: FunctionConfiguration -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c FunctionConfiguration)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c FunctionConfiguration)

gmapT :: (forall b. Data b => b -> b) -> FunctionConfiguration -> FunctionConfiguration

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> FunctionConfiguration -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> FunctionConfiguration -> r

gmapQ :: (forall d. Data d => d -> u) -> FunctionConfiguration -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> FunctionConfiguration -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> FunctionConfiguration -> m FunctionConfiguration

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> FunctionConfiguration -> m FunctionConfiguration

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> FunctionConfiguration -> m FunctionConfiguration

Show FunctionConfiguration

Methods

showsPrec :: Int -> FunctionConfiguration -> ShowS

show :: FunctionConfiguration -> String

showList :: [FunctionConfiguration] -> ShowS

Generic FunctionConfiguration

Associated Types

type Rep FunctionConfiguration :: * -> *

Methods

from :: FunctionConfiguration -> Rep FunctionConfiguration x

to :: Rep FunctionConfiguration x -> FunctionConfiguration

Hashable FunctionConfiguration

Methods

hashWithSalt :: Int -> FunctionConfiguration -> Int

hash :: FunctionConfiguration -> Int

FromJSON FunctionConfiguration

Methods

parseJSON :: Value -> Parser FunctionConfiguration

parseJSONList :: Value -> Parser [FunctionConfiguration]

NFData FunctionConfiguration

Methods

rnf :: FunctionConfiguration -> ()

type Rep FunctionConfiguration

type Rep FunctionConfiguration = D1 * (MetaData "FunctionConfiguration" "Network.AWS.Lambda.Types.Product" "amazonka-lambda-1.6.0-BCoVnxAqk5DEBm6Teqtlxw" False) (C1 * (MetaCons "FunctionConfiguration'" PrefixI True) ((:*:) * ((:*:) * ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_fcMemorySize") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Nat))) (S1 * (MetaSel (Just Symbol "_fcRuntime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Runtime)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_fcFunctionARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_fcKMSKeyARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_fcEnvironment") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe EnvironmentResponse))) (S1 * (MetaSel (Just Symbol "_fcDeadLetterConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe DeadLetterConfig)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_fcRole") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_fcVPCConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe VPCConfigResponse))) (S1 * (MetaSel (Just Symbol "_fcVersion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))))))) ((:*:) * ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_fcFunctionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_fcCodeSize") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Integer)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_fcHandler") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_fcTimeout") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Nat))) (S1 * (MetaSel (Just Symbol "_fcLastModified") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text)))))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_fcCodeSha256") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_fcTracingConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe TracingConfigResponse)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_fcDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_fcRevisionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_fcMasterARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text)))))))))

Response Lenses

fcMemorySize :: Lens' FunctionConfiguration (Maybe Natural)

The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.

fcRuntime :: Lens' FunctionConfiguration (Maybe Runtime)

The runtime environment for the Lambda function.

fcFunctionARN :: Lens' FunctionConfiguration (Maybe Text)

The Amazon Resource Name (ARN) assigned to the function.

fcKMSKeyARN :: Lens' FunctionConfiguration (Maybe Text)

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If empty, it means you are using the AWS Lambda default service key.

fcEnvironment :: Lens' FunctionConfiguration (Maybe EnvironmentResponse)

The parent object that contains your environment's configuration settings.

fcDeadLetterConfig :: Lens' FunctionConfiguration (Maybe DeadLetterConfig)

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq .

fcRole :: Lens' FunctionConfiguration (Maybe Text)

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.

fcVPCConfig :: Lens' FunctionConfiguration (Maybe VPCConfigResponse)

VPC configuration associated with your Lambda function.

fcVersion :: Lens' FunctionConfiguration (Maybe Text)

The version of the Lambda function.

fcFunctionName :: Lens' FunctionConfiguration (Maybe Text)

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

fcCodeSize :: Lens' FunctionConfiguration (Maybe Integer)

The size, in bytes, of the function .zip file you uploaded.

fcHandler :: Lens' FunctionConfiguration (Maybe Text)

The function Lambda calls to begin executing your function.

fcTimeout :: Lens' FunctionConfiguration (Maybe Natural)

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

fcLastModified :: Lens' FunctionConfiguration (Maybe Text)

The time stamp of the last time you updated the function. The time stamp is conveyed as a string complying with ISO-8601 in this way YYYY-MM-DDThh:mm:ssTZD (e.g., 1997-07-16T19:20:30+01:00). For more information, see Date and Time Formats .

fcCodeSha256 :: Lens' FunctionConfiguration (Maybe Text)

It is the SHA256 hash of your function deployment package.

fcTracingConfig :: Lens' FunctionConfiguration (Maybe TracingConfigResponse)

The parent object that contains your function's tracing settings.

fcDescription :: Lens' FunctionConfiguration (Maybe Text)

The user-provided description.

fcRevisionId :: Lens' FunctionConfiguration (Maybe Text)

Represents the latest updated revision of the function or alias.

fcMasterARN :: Lens' FunctionConfiguration (Maybe Text)

Returns the ARN (Amazon Resource Name) of the master function.