CREATETHINGGROUP()`¶

About CreateThingGroup¶

Create a thing group.

This is a control plane operation. See Authorization for information about authorizing control plane actions.

If the ThingGroup that you create has the exact same attributes as an existing ThingGroup, you will get a 200 success response.

Requires permission to access the CreateThingGroup action.

Method Signature¶

METHODS /AWS1/IF_IOT~CREATETHINGGROUP
  IMPORTING
    !IV_THINGGROUPNAME TYPE /AWS1/IOTTHINGGROUPNAME OPTIONAL
    !IV_PARENTGROUPNAME TYPE /AWS1/IOTTHINGGROUPNAME OPTIONAL
    !IO_THINGGROUPPROPERTIES TYPE REF TO /AWS1/CL_IOTTHINGGROUPPRPS OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_IOTTAG=>TT_TAGLIST OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_iotcrethinggrouprsp
  RAISING
    /AWS1/CX_IOTINTERNALFAILUREEX
    /AWS1/CX_IOTINVALIDREQUESTEX
    /AWS1/CX_IOTRESRCALRDYEXISTSEX
    /AWS1/CX_IOTTHROTTLINGEX
    /AWS1/CX_IOTCLIENTEXC
    /AWS1/CX_IOTSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_thinggroupname` `TYPE /AWS1/IOTTHINGGROUPNAME` `/AWS1/IOTTHINGGROUPNAME`¶

The thing group name to create.

Optional arguments:¶

`iv_parentgroupname` `TYPE /AWS1/IOTTHINGGROUPNAME` `/AWS1/IOTTHINGGROUPNAME`¶

The name of the parent thing group.

`io_thinggroupproperties` `TYPE REF TO /AWS1/CL_IOTTHINGGROUPPRPS` `/AWS1/CL_IOTTHINGGROUPPRPS`¶

The thing group properties.

`it_tags` `TYPE /AWS1/CL_IOTTAG=>TT_TAGLIST` `TT_TAGLIST`¶

Metadata which can be used to manage the thing group.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_iotcrethinggrouprsp` `/AWS1/CL_IOTCRETHINGGROUPRSP`¶

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->createthinggroup(
  io_thinggroupproperties = new /aws1/cl_iotthinggroupprps(
    io_attributepayload = new /aws1/cl_iotattributepayload(
      it_attributes = VALUE /aws1/cl_iotattributes_w=>tt_attributes(
        (
          VALUE /aws1/cl_iotattributes_w=>ts_attributes_maprow(
            key = |string|
            value = new /aws1/cl_iotattributes_w( |string| )
          )
        )
      )
      iv_merge = ABAP_TRUE
    )
    iv_thinggroupdescription = |string|
  )
  it_tags = VALUE /aws1/cl_iottag=>tt_taglist(
    (
      new /aws1/cl_iottag(
        iv_key = |string|
        iv_value = |string|
      )
    )
  )
  iv_parentgroupname = |string|
  iv_thinggroupname = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_thinggroupname = lo_result->get_thinggroupname( ).
  lv_thinggrouparn = lo_result->get_thinggrouparn( ).
  lv_thinggroupid = lo_result->get_thinggroupid( ).
ENDIF.

/AWS1/IF_IOT=>CREATETHINGGROUP()¶