CREATELOOKUPTABLE()`¶

About CreateLookupTable¶

Creates a lookup table by uploading CSV data. You can use lookup tables to enrich log data in CloudWatch Logs Insights queries with reference data such as user details, application names, or error descriptions.

The table name must be unique within your account and Region. The CSV content must include a header row with column names, use UTF-8 encoding, and not exceed 10 MB.

Method Signature¶

METHODS /AWS1/IF_CWL~CREATELOOKUPTABLE
  IMPORTING
    !IV_LOOKUPTABLENAME TYPE /AWS1/CWLLOOKUPTABLENAME OPTIONAL
    !IV_DESCRIPTION TYPE /AWS1/CWLLOOKUPTABLEDESC OPTIONAL
    !IV_TABLEBODY TYPE /AWS1/CWLTABLEBODY OPTIONAL
    !IV_KMSKEYID TYPE /AWS1/CWLKMSKEYID OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_CWLTAGS_W=>TT_TAGS OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_cwlcrelookuptablersp
  RAISING
    /AWS1/CX_CWLACCESSDENIEDEX
    /AWS1/CX_CWLINVALIDPARAMETEREX
    /AWS1/CX_CWLLIMITEXCEEDEDEX
    /AWS1/CX_CWLRESRCALRDYEXISTSEX
    /AWS1/CX_CWLSERVICEUNAVAILEX
    /AWS1/CX_CWLVALIDATIONEX
    /AWS1/CX_CWLCLIENTEXC
    /AWS1/CX_CWLSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_lookuptablename` `TYPE /AWS1/CWLLOOKUPTABLENAME` `/AWS1/CWLLOOKUPTABLENAME`¶

The name of the lookup table. The name must be unique within your account and Region. The name can contain only alphanumeric characters and underscores, and can be up to 256 characters long.

`iv_tablebody` `TYPE /AWS1/CWLTABLEBODY` `/AWS1/CWLTABLEBODY`¶

The CSV content of the lookup table. The first row must be a header row with column names. The content must use UTF-8 encoding and not exceed 10 MB.

Optional arguments:¶

`iv_description` `TYPE /AWS1/CWLLOOKUPTABLEDESC` `/AWS1/CWLLOOKUPTABLEDESC`¶

A description of the lookup table. The description can be up to 1024 characters long.

`iv_kmskeyid` `TYPE /AWS1/CWLKMSKEYID` `/AWS1/CWLKMSKEYID`¶

The ARN of the KMS key to use to encrypt the lookup table data. If you don't specify a key, the data is encrypted with an Amazon Web Services-owned key.

`it_tags` `TYPE /AWS1/CL_CWLTAGS_W=>TT_TAGS` `TT_TAGS`¶

A list of key-value pairs to associate with the lookup table. You can associate as many as 50 tags with a lookup table. Tags can help you organize and categorize your resources.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_cwlcrelookuptablersp` `/AWS1/CL_CWLCRELOOKUPTABLERSP`¶

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->createlookuptable(
  it_tags = VALUE /aws1/cl_cwltags_w=>tt_tags(
    (
      VALUE /aws1/cl_cwltags_w=>ts_tags_maprow(
        key = |string|
        value = new /aws1/cl_cwltags_w( |string| )
      )
    )
  )
  iv_description = |string|
  iv_kmskeyid = |string|
  iv_lookuptablename = |string|
  iv_tablebody = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_arn = lo_result->get_lookuptablearn( ).
  lv_timestamp = lo_result->get_createdat( ).
ENDIF.

/AWS1/IF_CWL=>CREATELOOKUPTABLE()¶