Skip to content

Create Rule

vpclattice_create_rule R Documentation

Creates a listener rule

Description

Creates a listener rule. Each listener has a default rule for checking connection requests, but you can define additional rules. Each rule consists of a priority, one or more actions, and one or more conditions. For more information, see Listener rules in the Amazon VPC Lattice User Guide.

Usage

vpclattice_create_rule(action, clientToken, listenerIdentifier, match,
  name, priority, serviceIdentifier, tags)

Arguments

action

[required] The action for the default rule.

clientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you retry a request that completed successfully using the same client token and parameters, the retry succeeds without performing any actions. If the parameters aren't identical, the retry fails.

listenerIdentifier

[required] The ID or Amazon Resource Name (ARN) of the listener.

match

[required] The rule match.

name

[required] The name of the rule. The name must be unique within the listener. The valid characters are a-z, 0-9, and hyphens (-). You can't use a hyphen as the first or last character, or immediately after another hyphen.

priority

[required] The priority assigned to the rule. Each rule for a specific listener must have a unique priority. The lower the priority number the higher the priority.

serviceIdentifier

[required] The ID or Amazon Resource Name (ARN) of the service.

tags

The tags for the rule.

Value

A list with the following syntax:

list(
  action = list(
    fixedResponse = list(
      statusCode = 123
    ),
    forward = list(
      targetGroups = list(
        list(
          targetGroupIdentifier = "string",
          weight = 123
        )
      )
    )
  ),
  arn = "string",
  id = "string",
  match = list(
    httpMatch = list(
      headerMatches = list(
        list(
          caseSensitive = TRUE|FALSE,
          match = list(
            contains = "string",
            exact = "string",
            prefix = "string"
          ),
          name = "string"
        )
      ),
      method = "string",
      pathMatch = list(
        caseSensitive = TRUE|FALSE,
        match = list(
          exact = "string",
          prefix = "string"
        )
      )
    )
  ),
  name = "string",
  priority = 123
)

Request syntax

svc$create_rule(
  action = list(
    fixedResponse = list(
      statusCode = 123
    ),
    forward = list(
      targetGroups = list(
        list(
          targetGroupIdentifier = "string",
          weight = 123
        )
      )
    )
  ),
  clientToken = "string",
  listenerIdentifier = "string",
  match = list(
    httpMatch = list(
      headerMatches = list(
        list(
          caseSensitive = TRUE|FALSE,
          match = list(
            contains = "string",
            exact = "string",
            prefix = "string"
          ),
          name = "string"
        )
      ),
      method = "string",
      pathMatch = list(
        caseSensitive = TRUE|FALSE,
        match = list(
          exact = "string",
          prefix = "string"
        )
      )
    )
  ),
  name = "string",
  priority = 123,
  serviceIdentifier = "string",
  tags = list(
    "string"
  )
)