UPDATELOGGINGCONFIGURATION()`¶

About UpdateLoggingConfiguration¶

Sets the logging configuration for the specified firewall.

To change the logging configuration, retrieve the LoggingConfiguration by calling DescribeLoggingConfiguration, then change it and provide the modified object to this update call. You must change the logging configuration one LogDestinationConfig at a time inside the retrieved LoggingConfiguration object.

You can perform only one of the following actions in any call to UpdateLoggingConfiguration:

Create a new log destination object by adding a single LogDestinationConfig array element to LogDestinationConfigs.
Delete a log destination object by removing a single LogDestinationConfig array element from LogDestinationConfigs.
Change the LogDestination setting in a single LogDestinationConfig array element.

You can't change the LogDestinationType or LogType in a LogDestinationConfig. To change these settings, delete the existing LogDestinationConfig object and create a new one, using two separate calls to this update operation.

Method Signature¶

METHODS /AWS1/IF_NWF~UPDATELOGGINGCONFIGURATION
  IMPORTING
    !IV_FIREWALLARN TYPE /AWS1/NWFRESOURCEARN OPTIONAL
    !IV_FIREWALLNAME TYPE /AWS1/NWFRESOURCENAME OPTIONAL
    !IO_LOGGINGCONFIGURATION TYPE REF TO /AWS1/CL_NWFLOGGINGCONF OPTIONAL
    !IV_ENABLEMONITORINGDASHBOARD TYPE /AWS1/NWFENABLEMONDASHBOARD OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_nwfupdatelogconfrsp
  RAISING
    /AWS1/CX_NWFINTERNALSERVERERR
    /AWS1/CX_NWFINVALIDREQUESTEX
    /AWS1/CX_NWFINVALIDTOKENEX
    /AWS1/CX_NWFLOGDSTPERMEX
    /AWS1/CX_NWFRESOURCENOTFOUNDEX
    /AWS1/CX_NWFTHROTTLINGEX
    /AWS1/CX_NWFCLIENTEXC
    /AWS1/CX_NWFSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Optional arguments:¶

`iv_firewallarn` `TYPE /AWS1/NWFRESOURCEARN` `/AWS1/NWFRESOURCEARN`¶

The Amazon Resource Name (ARN) of the firewall.

You must specify the ARN or the name, and you can specify both.

`iv_firewallname` `TYPE /AWS1/NWFRESOURCENAME` `/AWS1/NWFRESOURCENAME`¶

The descriptive name of the firewall. You can't change the name of a firewall after you create it.

You must specify the ARN or the name, and you can specify both.

`io_loggingconfiguration` `TYPE REF TO /AWS1/CL_NWFLOGGINGCONF` `/AWS1/CL_NWFLOGGINGCONF`¶

Defines how Network Firewall performs logging for a firewall. If you omit this setting, Network Firewall disables logging for the firewall.

`iv_enablemonitoringdashboard` `TYPE /AWS1/NWFENABLEMONDASHBOARD` `/AWS1/NWFENABLEMONDASHBOARD`¶

A boolean that lets you enable or disable the detailed firewall monitoring dashboard on the firewall.

The monitoring dashboard provides comprehensive visibility into your firewall's flow logs and alert logs. After you enable detailed monitoring, you can access these dashboards directly from the Monitoring page of the Network Firewall console.

Specify TRUE to enable the the detailed monitoring dashboard on the firewall. Specify FALSE to disable the the detailed monitoring dashboard on the firewall.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_nwfupdatelogconfrsp` `/AWS1/CL_NWFUPDATELOGCONFRSP`¶

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->updateloggingconfiguration(
  io_loggingconfiguration = new /aws1/cl_nwfloggingconf(
    it_logdestinationconfigs = VALUE /aws1/cl_nwflogdstconfig=>tt_logdestinationconfigs(
      (
        new /aws1/cl_nwflogdstconfig(
          it_logdestination = VALUE /aws1/cl_nwflogdstmap_w=>tt_logdestinationmap(
            (
              VALUE /aws1/cl_nwflogdstmap_w=>ts_logdestinationmap_maprow(
                key = |string|
                value = new /aws1/cl_nwflogdstmap_w( |string| )
              )
            )
          )
          iv_logdestinationtype = |string|
          iv_logtype = |string|
        )
      )
    )
  )
  iv_enablemonitoringdashboard = ABAP_TRUE
  iv_firewallarn = |string|
  iv_firewallname = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_resourcearn = lo_result->get_firewallarn( ).
  lv_resourcename = lo_result->get_firewallname( ).
  lo_loggingconfiguration = lo_result->get_loggingconfiguration( ).
  IF lo_loggingconfiguration IS NOT INITIAL.
    LOOP AT lo_loggingconfiguration->get_logdestinationconfigs( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_logtype = lo_row_1->get_logtype( ).
        lv_logdestinationtype = lo_row_1->get_logdestinationtype( ).
        LOOP AT lo_row_1->get_logdestination( ) into ls_row_2.
          lv_key = ls_row_2-key.
          lo_value = ls_row_2-value.
          IF lo_value IS NOT INITIAL.
            lv_hashmapvalue = lo_value->get_value( ).
          ENDIF.
        ENDLOOP.
      ENDIF.
    ENDLOOP.
  ENDIF.
  lv_enablemonitoringdashboa = lo_result->get_enablemondashboard( ).
ENDIF.

/AWS1/IF_NWF=>UPDATELOGGINGCONFIGURATION()¶