Skip to content

/AWS1/IF_CWO=>CREATEDATASETINTEGRATION()

About CreateDatasetIntegration

Creates a dataset integration for the caller's account in the current region and returns its ARN.

To use this operation, you must have permission to access the dataset integration resources through the IAM role specified in the RoleArn parameter.

If a dataset integration already exists for the account, this operation fails with a ConflictException.

Method Signature

METHODS /AWS1/IF_CWO~CREATEDATASETINTEGRATION
  IMPORTING
    !IV_ROLEARN TYPE /AWS1/CWORESOURCEARN OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_CWOTAGMAPINPUT_W=>TT_TAGMAPINPUT OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_cwocreatedsintgoutput
  RAISING
    /AWS1/CX_CWOACCESSDENIEDEX
    /AWS1/CX_CWOCONFLICTEXCEPTION
    /AWS1/CX_CWOINTERNALSERVEREX
    /AWS1/CX_CWOTOOMANYREQUESTSEX
    /AWS1/CX_CWOVALIDATIONEX
    /AWS1/CX_CWOCLIENTEXC
    /AWS1/CX_CWOSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_rolearn TYPE /AWS1/CWORESOURCEARN /AWS1/CWORESOURCEARN

The Amazon Resource Name (ARN) of the IAM role that grants Amazon CloudWatch permission to access the resources needed for the dataset integration.

Optional arguments:

it_tags TYPE /AWS1/CL_CWOTAGMAPINPUT_W=>TT_TAGMAPINPUT TT_TAGMAPINPUT

The key-value pairs to associate with the dataset integration resource for categorization and management purposes.

RETURNING

oo_output TYPE REF TO /aws1/cl_cwocreatedsintgoutput /AWS1/CL_CWOCREATEDSINTGOUTPUT

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->createdatasetintegration(
  it_tags = VALUE /aws1/cl_cwotagmapinput_w=>tt_tagmapinput(
    (
      VALUE /aws1/cl_cwotagmapinput_w=>ts_tagmapinput_maprow(
        key = |string|
        value = new /aws1/cl_cwotagmapinput_w( |string| )
      )
    )
  )
  iv_rolearn = |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_arn( ).
  lv_resourcearn = lo_result->get_rolearn( ).
  lv_timestamp = lo_result->get_createdat( ).
  lv_timestamp = lo_result->get_updatedat( ).
ENDIF.