Copyright	(c) 2013-2018 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None
Language	Haskell2010

Network.AWS.Lambda.UpdateAlias

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Using this API you can update the function version to which the alias points and the alias description. For more information, see Introduction to AWS Lambda Aliases .

This requires permission for the lambda:UpdateAlias action.

Creating a Request

updateAlias #

Arguments

:: Text	`uaFunctionName`
-> Text	`uaName`
-> UpdateAlias

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

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

uaRoutingConfig - Specifies an additional version your alias can point to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see 'lambda-traffic-shifting-using-aliases' .
uaFunctionVersion - Using this parameter you can change the Lambda function version to which the alias points.
uaDescription - You can change the description of the alias using this parameter.
uaRevisionId - 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 .
uaFunctionName - The function name for which the alias is created. 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.
uaName - The alias name.

data UpdateAlias #

See: updateAlias smart constructor.

Instances

Eq UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods (==) :: UpdateAlias -> UpdateAlias -> Bool # (/=) :: UpdateAlias -> UpdateAlias -> Bool #
Data UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> UpdateAlias -> c UpdateAlias # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c UpdateAlias # toConstr :: UpdateAlias -> Constr # dataTypeOf :: UpdateAlias -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c UpdateAlias) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c UpdateAlias) # gmapT :: (forall b. Data b => b -> b) -> UpdateAlias -> UpdateAlias # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> UpdateAlias -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> UpdateAlias -> r # gmapQ :: (forall d. Data d => d -> u) -> UpdateAlias -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> UpdateAlias -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> UpdateAlias -> m UpdateAlias # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateAlias -> m UpdateAlias # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateAlias -> m UpdateAlias #
Read UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods readsPrec :: Int -> ReadS UpdateAlias # readList :: ReadS [UpdateAlias] # readPrec :: ReadPrec UpdateAlias # readListPrec :: ReadPrec [UpdateAlias] #
Show UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods showsPrec :: Int -> UpdateAlias -> ShowS # show :: UpdateAlias -> String # showList :: [UpdateAlias] -> ShowS #
Generic UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Associated Types type Rep UpdateAlias :: * -> * # Methods from :: UpdateAlias -> Rep UpdateAlias x # to :: Rep UpdateAlias x -> UpdateAlias #
Hashable UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods hashWithSalt :: Int -> UpdateAlias -> Int # hash :: UpdateAlias -> Int #
ToJSON UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods toJSON :: UpdateAlias -> Value # toEncoding :: UpdateAlias -> Encoding # toJSONList :: [UpdateAlias] -> Value # toEncodingList :: [UpdateAlias] -> Encoding #
AWSRequest UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Associated Types type Rs UpdateAlias :: * # Methods request :: UpdateAlias -> Request UpdateAlias # response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy UpdateAlias -> ClientResponse -> m (Response UpdateAlias) #
ToHeaders UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods toHeaders :: UpdateAlias -> [Header] #
ToPath UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods toPath :: UpdateAlias -> ByteString #
ToQuery UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods toQuery :: UpdateAlias -> QueryString #
NFData UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias Methods rnf :: UpdateAlias -> () #
type Rep UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias type Rep UpdateAlias = D1 (MetaData "UpdateAlias" "Network.AWS.Lambda.UpdateAlias" "amazonka-lambda-1.6.0-I1aObtlwuUAs80dunSvhq" False) (C1 (MetaCons "UpdateAlias'" PrefixI True) ((S1 (MetaSel (Just "_uaRoutingConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe AliasRoutingConfiguration)) :: (S1 (MetaSel (Just "_uaFunctionVersion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: S1 (MetaSel (Just "_uaDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) :: (S1 (MetaSel (Just "_uaRevisionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: (S1 (MetaSel (Just "_uaFunctionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_uaName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))
type Rs UpdateAlias #
Instance details Defined in Network.AWS.Lambda.UpdateAlias type Rs UpdateAlias = AliasConfiguration

Request Lenses

uaRoutingConfig :: Lens' UpdateAlias (Maybe AliasRoutingConfiguration) #

Specifies an additional version your alias can point to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see 'lambda-traffic-shifting-using-aliases' .

uaFunctionVersion :: Lens' UpdateAlias (Maybe Text) #

Using this parameter you can change the Lambda function version to which the alias points.

uaDescription :: Lens' UpdateAlias (Maybe Text) #

You can change the description of the alias using this parameter.

uaRevisionId :: Lens' UpdateAlias (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 .

uaFunctionName :: Lens' UpdateAlias Text #

The function name for which the alias is created. 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.

uaName :: Lens' UpdateAlias Text #

The alias name.

Destructuring the Response

aliasConfiguration :: AliasConfiguration #

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

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

acRoutingConfig - Specifies an additional function versions the alias points to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see 'lambda-traffic-shifting-using-aliases' .
acName - Alias name.
acFunctionVersion - Function version to which the alias points.
acAliasARN - Lambda function ARN that is qualified using the alias name as the suffix. For example, if you create an alias called BETA that points to a helloworld function version, the ARN is arn:aws:lambda:aws-regions:acct-id:function:helloworld:BETA .
acDescription - Alias description.
acRevisionId - Represents the latest updated revision of the function or alias.

data AliasConfiguration #

Provides configuration information about a Lambda function version alias.

See: aliasConfiguration smart constructor.

Instances

Eq AliasConfiguration #
Instance details Defined in Network.AWS.Lambda.Types.Product Methods (==) :: AliasConfiguration -> AliasConfiguration -> Bool # (/=) :: AliasConfiguration -> AliasConfiguration -> Bool #
Data AliasConfiguration #
Instance details Defined in Network.AWS.Lambda.Types.Product Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> AliasConfiguration -> c AliasConfiguration # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c AliasConfiguration # toConstr :: AliasConfiguration -> Constr # dataTypeOf :: AliasConfiguration -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c AliasConfiguration) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c AliasConfiguration) # gmapT :: (forall b. Data b => b -> b) -> AliasConfiguration -> AliasConfiguration # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> AliasConfiguration -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> AliasConfiguration -> r # gmapQ :: (forall d. Data d => d -> u) -> AliasConfiguration -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> AliasConfiguration -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> AliasConfiguration -> m AliasConfiguration # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> AliasConfiguration -> m AliasConfiguration # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> AliasConfiguration -> m AliasConfiguration #
Read AliasConfiguration #
Instance details Defined in Network.AWS.Lambda.Types.Product Methods readsPrec :: Int -> ReadS AliasConfiguration # readList :: ReadS [AliasConfiguration] # readPrec :: ReadPrec AliasConfiguration # readListPrec :: ReadPrec [AliasConfiguration] #
Show AliasConfiguration #
Instance details Defined in Network.AWS.Lambda.Types.Product Methods showsPrec :: Int -> AliasConfiguration -> ShowS # show :: AliasConfiguration -> String # showList :: [AliasConfiguration] -> ShowS #
Generic AliasConfiguration #
Instance details Defined in Network.AWS.Lambda.Types.Product Associated Types type Rep AliasConfiguration :: * -> * # Methods from :: AliasConfiguration -> Rep AliasConfiguration x # to :: Rep AliasConfiguration x -> AliasConfiguration #
Hashable AliasConfiguration #
Instance details Defined in Network.AWS.Lambda.Types.Product Methods hashWithSalt :: Int -> AliasConfiguration -> Int # hash :: AliasConfiguration -> Int #
FromJSON AliasConfiguration #
Instance details Defined in Network.AWS.Lambda.Types.Product Methods parseJSON :: Value -> Parser AliasConfiguration # parseJSONList :: Value -> Parser [AliasConfiguration] #
NFData AliasConfiguration #
Instance details Defined in Network.AWS.Lambda.Types.Product Methods rnf :: AliasConfiguration -> () #
type Rep AliasConfiguration #
Instance details Defined in Network.AWS.Lambda.Types.Product type Rep AliasConfiguration = D1 (MetaData "AliasConfiguration" "Network.AWS.Lambda.Types.Product" "amazonka-lambda-1.6.0-I1aObtlwuUAs80dunSvhq" False) (C1 (MetaCons "AliasConfiguration'" PrefixI True) ((S1 (MetaSel (Just "_acRoutingConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe AliasRoutingConfiguration)) :: (S1 (MetaSel (Just "_acName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: S1 (MetaSel (Just "_acFunctionVersion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) :: (S1 (MetaSel (Just "_acAliasARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: (S1 (MetaSel (Just "_acDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_acRevisionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))))

Response Lenses

acRoutingConfig :: Lens' AliasConfiguration (Maybe AliasRoutingConfiguration) #

Specifies an additional function versions the alias points to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see 'lambda-traffic-shifting-using-aliases' .

acName :: Lens' AliasConfiguration (Maybe Text) #

Alias name.

acFunctionVersion :: Lens' AliasConfiguration (Maybe Text) #

Function version to which the alias points.

acAliasARN :: Lens' AliasConfiguration (Maybe Text) #

Lambda function ARN that is qualified using the alias name as the suffix. For example, if you create an alias called BETA that points to a helloworld function version, the ARN is arn:aws:lambda:aws-regions:acct-id:function:helloworld:BETA .

acDescription :: Lens' AliasConfiguration (Maybe Text) #

Alias description.

acRevisionId :: Lens' AliasConfiguration (Maybe Text) #

Represents the latest updated revision of the function or alias.