All Downloads are FREE. Search and download functionalities are using the official Maven repository.

cloudshift.awscdk.dsl.services.waf.regional.CfnRateBasedRulePropsDsl.kt Maven / Gradle / Ivy

There is a newer version: 0.7.0
Show newest version
@file:Suppress("RedundantVisibilityModifier","RedundantUnitReturnType","RemoveRedundantQualifierName","unused","UnusedImport","ClassName","REDUNDANT_PROJECTION","DEPRECATION")

package cloudshift.awscdk.dsl.services.waf.regional

import cloudshift.awscdk.common.CdkDslMarker
import kotlin.Any
import kotlin.Number
import kotlin.String
import kotlin.collections.Collection
import kotlin.collections.MutableList
import software.amazon.awscdk.IResolvable
import software.amazon.awscdk.services.waf.regional.CfnRateBasedRuleProps

/**
 * Properties for defining a `CfnRateBasedRule`.
 *
 * Example:
 *
 * ```
 * // The code below shows an example of how to instantiate this type.
 * // The values are placeholders you should change.
 * import software.amazon.awscdk.services.waf.regional.*;
 * CfnRateBasedRuleProps cfnRateBasedRuleProps = CfnRateBasedRuleProps.builder()
 * .metricName("metricName")
 * .name("name")
 * .rateKey("rateKey")
 * .rateLimit(123)
 * // the properties below are optional
 * .matchPredicates(List.of(PredicateProperty.builder()
 * .dataId("dataId")
 * .negated(false)
 * .type("type")
 * .build()))
 * .build();
 * ```
 *
 * [Documentation](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-wafregional-ratebasedrule.html)
 */
@CdkDslMarker
public class CfnRateBasedRulePropsDsl {
  private val cdkBuilder: CfnRateBasedRuleProps.Builder = CfnRateBasedRuleProps.builder()

  private val _matchPredicates: MutableList = mutableListOf()

  /**
   * @param matchPredicates The `Predicates` object contains one `Predicate` element for each
   * `ByteMatchSet` , `IPSet` , or `SqlInjectionMatchSet>` object that you want to include in a
   * `RateBasedRule` .
   */
  public fun matchPredicates(vararg matchPredicates: Any) {
    _matchPredicates.addAll(listOf(*matchPredicates))
  }

  /**
   * @param matchPredicates The `Predicates` object contains one `Predicate` element for each
   * `ByteMatchSet` , `IPSet` , or `SqlInjectionMatchSet>` object that you want to include in a
   * `RateBasedRule` .
   */
  public fun matchPredicates(matchPredicates: Collection) {
    _matchPredicates.addAll(matchPredicates)
  }

  /**
   * @param matchPredicates The `Predicates` object contains one `Predicate` element for each
   * `ByteMatchSet` , `IPSet` , or `SqlInjectionMatchSet>` object that you want to include in a
   * `RateBasedRule` .
   */
  public fun matchPredicates(matchPredicates: IResolvable) {
    cdkBuilder.matchPredicates(matchPredicates)
  }

  /**
   * @param metricName A name for the metrics for a `RateBasedRule` . 
   * The name can contain only alphanumeric characters (A-Z, a-z, 0-9), with maximum length 128 and
   * minimum length one. It can't contain whitespace or metric names reserved for AWS WAF , including
   * "All" and "Default_Action." You can't change the name of the metric after you create the
   * `RateBasedRule` .
   */
  public fun metricName(metricName: String) {
    cdkBuilder.metricName(metricName)
  }

  /**
   * @param name A friendly name or description for a `RateBasedRule` . 
   * You can't change the name of a `RateBasedRule` after you create it.
   */
  public fun name(name: String) {
    cdkBuilder.name(name)
  }

  /**
   * @param rateKey The field that AWS WAF uses to determine if requests are likely arriving from
   * single source and thus subject to rate monitoring. 
   * The only valid value for `RateKey` is `IP` . `IP` indicates that requests arriving from the
   * same IP address are subject to the `RateLimit` that is specified in the `RateBasedRule` .
   */
  public fun rateKey(rateKey: String) {
    cdkBuilder.rateKey(rateKey)
  }

  /**
   * @param rateLimit The maximum number of requests, which have an identical value in the field
   * specified by the `RateKey` , allowed in a five-minute period. 
   * If the number of requests exceeds the `RateLimit` and the other predicates specified in the
   * rule are also met, AWS WAF triggers the action that is specified for this rule.
   */
  public fun rateLimit(rateLimit: Number) {
    cdkBuilder.rateLimit(rateLimit)
  }

  public fun build(): CfnRateBasedRuleProps {
    if(_matchPredicates.isNotEmpty()) cdkBuilder.matchPredicates(_matchPredicates)
    return cdkBuilder.build()
  }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy