Network.AWS.Lambda.UpdateAlias

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

Methods

(==) :: UpdateAlias -> UpdateAlias -> Bool

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

Data 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

Methods

readsPrec :: Int -> ReadS UpdateAlias

readList :: ReadS [UpdateAlias]

readPrec :: ReadPrec UpdateAlias

readListPrec :: ReadPrec [UpdateAlias]

Show UpdateAlias

Methods

showsPrec :: Int -> UpdateAlias -> ShowS

show :: UpdateAlias -> String

showList :: [UpdateAlias] -> ShowS

Generic UpdateAlias

Associated Types

type Rep UpdateAlias :: * -> *

Methods

from :: UpdateAlias -> Rep UpdateAlias x

to :: Rep UpdateAlias x -> UpdateAlias

Hashable UpdateAlias

Methods

hashWithSalt :: Int -> UpdateAlias -> Int

hash :: UpdateAlias -> Int

ToJSON UpdateAlias

Methods

toJSON :: UpdateAlias -> Value

toEncoding :: UpdateAlias -> Encoding

toJSONList :: [UpdateAlias] -> Value

toEncodingList :: [UpdateAlias] -> Encoding

NFData UpdateAlias

Methods

rnf :: UpdateAlias -> ()

AWSRequest 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

Methods

toHeaders :: UpdateAlias -> [Header]

ToPath UpdateAlias

Methods

toPath :: UpdateAlias -> ByteString

ToQuery UpdateAlias

Methods

toQuery :: UpdateAlias -> QueryString

type Rep UpdateAlias

type Rep UpdateAlias = D1 * (MetaData "UpdateAlias" "Network.AWS.Lambda.UpdateAlias" "amazonka-lambda-1.6.0-BCoVnxAqk5DEBm6Teqtlxw" False) (C1 * (MetaCons "UpdateAlias'" PrefixI True) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_uaRoutingConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe AliasRoutingConfiguration))) ((:*:) * (S1 * (MetaSel (Just Symbol "_uaFunctionVersion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_uaDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))))) ((:*:) * (S1 * (MetaSel (Just Symbol "_uaRevisionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_uaFunctionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)) (S1 * (MetaSel (Just Symbol "_uaName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text))))))

type Rs 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

Methods

(==) :: AliasConfiguration -> AliasConfiguration -> Bool

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

Data AliasConfiguration

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

Methods

readsPrec :: Int -> ReadS AliasConfiguration

readList :: ReadS [AliasConfiguration]

readPrec :: ReadPrec AliasConfiguration

readListPrec :: ReadPrec [AliasConfiguration]

Show AliasConfiguration

Methods

showsPrec :: Int -> AliasConfiguration -> ShowS

show :: AliasConfiguration -> String

showList :: [AliasConfiguration] -> ShowS

Generic AliasConfiguration

Associated Types

type Rep AliasConfiguration :: * -> *

Methods

from :: AliasConfiguration -> Rep AliasConfiguration x

to :: Rep AliasConfiguration x -> AliasConfiguration

Hashable AliasConfiguration

Methods

hashWithSalt :: Int -> AliasConfiguration -> Int

hash :: AliasConfiguration -> Int

FromJSON AliasConfiguration

Methods

parseJSON :: Value -> Parser AliasConfiguration

parseJSONList :: Value -> Parser [AliasConfiguration]

NFData AliasConfiguration

Methods

rnf :: AliasConfiguration -> ()

type Rep AliasConfiguration

type Rep AliasConfiguration = D1 * (MetaData "AliasConfiguration" "Network.AWS.Lambda.Types.Product" "amazonka-lambda-1.6.0-BCoVnxAqk5DEBm6Teqtlxw" False) (C1 * (MetaCons "AliasConfiguration'" PrefixI True) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_acRoutingConfig") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe AliasRoutingConfiguration))) ((:*:) * (S1 * (MetaSel (Just Symbol "_acName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_acFunctionVersion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))))) ((:*:) * (S1 * (MetaSel (Just Symbol "_acAliasARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_acDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_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.