Skip to content

/AWS1/CL_VL=>CREATERULE()

About CreateRule

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.

Method Signature

IMPORTING

Required arguments:

IV_SERVICEIDENTIFIER TYPE /AWS1/VL_SERVICEIDENTIFIER /AWS1/VL_SERVICEIDENTIFIER

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

IV_LISTENERIDENTIFIER TYPE /AWS1/VL_LISTENERIDENTIFIER /AWS1/VL_LISTENERIDENTIFIER

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

IV_NAME TYPE /AWS1/VL_RULENAME /AWS1/VL_RULENAME

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.

IO_MATCH TYPE REF TO /AWS1/CL_VL_RULEMATCH /AWS1/CL_VL_RULEMATCH

The rule match.

IV_PRIORITY TYPE /AWS1/VL_RULEPRIORITY /AWS1/VL_RULEPRIORITY

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.

IO_ACTION TYPE REF TO /AWS1/CL_VL_RULEACTION /AWS1/CL_VL_RULEACTION

The action for the default rule.

Optional arguments:

IV_CLIENTTOKEN TYPE /AWS1/VL_CLIENTTOKEN /AWS1/VL_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.

IT_TAGS TYPE /AWS1/CL_VL_TAGMAP_W=>TT_TAGMAP TT_TAGMAP

The tags for the rule.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_VL_CREATERULERESPONSE /AWS1/CL_VL_CREATERULERESPONSE