Skip to content

/AWS1/IF_R5R=>ASSOCIATEFIREWALLRULEGROUP()

About AssociateFirewallRuleGroup

Associates a FirewallRuleGroup with a VPC, to provide DNS filtering for the VPC.

Method Signature

METHODS /AWS1/IF_R5R~ASSOCIATEFIREWALLRULEGROUP
  IMPORTING
    !IV_CREATORREQUESTID TYPE /AWS1/R5RCREATORREQUESTID OPTIONAL
    !IV_FIREWALLRULEGROUPID TYPE /AWS1/R5RRESOURCEID OPTIONAL
    !IV_VPCID TYPE /AWS1/R5RRESOURCEID OPTIONAL
    !IV_PRIORITY TYPE /AWS1/R5RPRIORITY OPTIONAL
    !IV_NAME TYPE /AWS1/R5RNAME OPTIONAL
    !IV_MUTATIONPROTECTION TYPE /AWS1/R5RMUTATIONPROTECTIONS00 OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_R5RTAG=>TT_TAGLIST OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_r5rascfirewallrlgrrsp
  RAISING
    /AWS1/CX_R5RACCESSDENIEDEX
    /AWS1/CX_R5RCONFLICTEXCEPTION
    /AWS1/CX_R5RINTERNALSVCERROREX
    /AWS1/CX_R5RLIMITEXCEEDEDEX
    /AWS1/CX_R5RRESOURCENOTFOUNDEX
    /AWS1/CX_R5RTHROTTLINGEX
    /AWS1/CX_R5RVALIDATIONEX
    /AWS1/CX_R5RCLIENTEXC
    /AWS1/CX_R5RSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_creatorrequestid TYPE /AWS1/R5RCREATORREQUESTID /AWS1/R5RCREATORREQUESTID

A unique string that identifies the request and that allows failed requests to be retried without the risk of running the operation twice. CreatorRequestId can be any unique string, for example, a date/time stamp.

iv_firewallrulegroupid TYPE /AWS1/R5RRESOURCEID /AWS1/R5RRESOURCEID

The unique identifier of the firewall rule group.

iv_vpcid TYPE /AWS1/R5RRESOURCEID /AWS1/R5RRESOURCEID

The unique identifier of the VPC that you want to associate with the rule group.

iv_priority TYPE /AWS1/R5RPRIORITY /AWS1/R5RPRIORITY

The setting that determines the processing order of the rule group among the rule groups that you associate with the specified VPC. DNS Firewall filters VPC traffic starting from the rule group with the lowest numeric priority setting.

You must specify a unique priority for each rule group that you associate with a single VPC. To make it easier to insert rule groups later, leave space between the numbers, for example, use 101, 200, and so on. You can change the priority setting for a rule group association after you create it.

The allowed values for Priority are between 100 and 9900.

iv_name TYPE /AWS1/R5RNAME /AWS1/R5RNAME

A name that lets you identify the association, to manage and use it.

Optional arguments:

iv_mutationprotection TYPE /AWS1/R5RMUTATIONPROTECTIONS00 /AWS1/R5RMUTATIONPROTECTIONS00

If enabled, this setting disallows modification or removal of the association, to help prevent against accidentally altering DNS firewall protections. When you create the association, the default setting is DISABLED.

it_tags TYPE /AWS1/CL_R5RTAG=>TT_TAGLIST TT_TAGLIST

A list of the tag keys and values that you want to associate with the rule group association.

RETURNING

oo_output TYPE REF TO /aws1/cl_r5rascfirewallrlgrrsp /AWS1/CL_R5RASCFIREWALLRLGRRSP

Domain /AWS1/RT_ACCOUNT_ID
Primitive Type NUMC

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->associatefirewallrulegroup(
  it_tags = VALUE /aws1/cl_r5rtag=>tt_taglist(
    (
      new /aws1/cl_r5rtag(
        iv_key = |string|
        iv_value = |string|
      )
    )
  )
  iv_creatorrequestid = |string|
  iv_firewallrulegroupid = |string|
  iv_mutationprotection = |string|
  iv_name = |string|
  iv_priority = 123
  iv_vpcid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_firewallrulegroupassoci = lo_result->get_firewallrlgrpassociation( ).
  IF lo_firewallrulegroupassoci IS NOT INITIAL.
    lv_resourceid = lo_firewallrulegroupassoci->get_id( ).
    lv_arn = lo_firewallrulegroupassoci->get_arn( ).
    lv_resourceid = lo_firewallrulegroupassoci->get_firewallrulegroupid( ).
    lv_resourceid = lo_firewallrulegroupassoci->get_vpcid( ).
    lv_name = lo_firewallrulegroupassoci->get_name( ).
    lv_priority = lo_firewallrulegroupassoci->get_priority( ).
    lv_mutationprotectionstatu = lo_firewallrulegroupassoci->get_mutationprotection( ).
    lv_serviceprinciple = lo_firewallrulegroupassoci->get_managedownername( ).
    lv_firewallrulegroupassoci_1 = lo_firewallrulegroupassoci->get_status( ).
    lv_statusmessage = lo_firewallrulegroupassoci->get_statusmessage( ).
    lv_creatorrequestid = lo_firewallrulegroupassoci->get_creatorrequestid( ).
    lv_rfc3339timestring = lo_firewallrulegroupassoci->get_creationtime( ).
    lv_rfc3339timestring = lo_firewallrulegroupassoci->get_modificationtime( ).
  ENDIF.
ENDIF.