Conditional Parameter

Conditional parameters is a lono concept. It encapsulates a common pattern with the usage of parameter, condition and ref.

Let’s say you would like to have an “optional” parameter on an EC2 instance resource. You can try this.

parameter("KeyName", Default: "")
resource("Instance", "AWS::EC2::Instance",
  KeyName: ref("KeyName")
)

However, this does not work because the KeyName is an empty string. The KeyName actually needs to exists.

What’s needed is for the KeyName: ref("KeyName") assignment to be conditional. When a KeyName parameter is blank string , the assignment should be KeyName: ref("AWS::NoValue").

Condition to the Rescue

One way to achieve an “optional” parameter is with a condition. Example:

parameter("KeyName", Default: "")
condition("HasKeyName", not!(equals("KeyName", "")))
resource("Instance", "AWS::EC2::Instance",
  KeyName: if!("HasKeyName", ref("KeyName"), ref("AWS::NoValue"))
)

This is what a lono conditional parameter is all about.

Lono Conditional Parameters

Lono conditional parameters encapsulates the parameter, condition, and ref pattern. Here’s an example.

parameter("KeyName", Conditional: true)
resource("Instance", "AWS::EC2::Instance",
  KeyName: ref("KeyName", Conditional: true)
)

The Conditional: true on the parameter method results in automatically creating a condition:

condition("HasKeyName", not!(equals("KeyName", "")))

The Conditional: true on the ref method results in automatically adding the if method with HasKeyName as the condition and ref("AWS::NoValue") as the else value.

For a lot of parameters, using the conditional parameter pattern can really help DRY up your code.

Back to DSL Extras List Docs.

Pro tip: Use the <- and -> arrow keys to move back and forward.

Edit this page

See a typo or an error? You can improve this page. This website is available on GitHub and contributions are encouraged and welcomed. We love pull requests from you!