Skip to content

/AWS1/IF_IOT=>REPLACETOPICRULE()

About ReplaceTopicRule

Replaces the rule. You must specify all parameters for the new rule. Creating rules is an administrator-level action. Any user who has permission to create rules will be able to access data processed by the rule.

Requires permission to access the ReplaceTopicRule action.

Method Signature

METHODS /AWS1/IF_IOT~REPLACETOPICRULE
  IMPORTING
    !IV_RULENAME TYPE /AWS1/IOTRULENAME OPTIONAL
    !IO_TOPICRULEPAYLOAD TYPE REF TO /AWS1/CL_IOTTOPICRULEPAYLOAD OPTIONAL
  RAISING
    /AWS1/CX_IOTCNFLCTRESRCUPDEX
    /AWS1/CX_IOTINTERNALEXCEPTION
    /AWS1/CX_IOTINVALIDREQUESTEX
    /AWS1/CX_IOTSERVICEUNAVAILEX
    /AWS1/CX_IOTSQLPARSEEXCEPTION
    /AWS1/CX_IOTUNAUTHORIZEDEX
    /AWS1/CX_IOTCLIENTEXC
    /AWS1/CX_IOTSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_rulename TYPE /AWS1/IOTRULENAME /AWS1/IOTRULENAME

The name of the rule.

io_topicrulepayload TYPE REF TO /AWS1/CL_IOTTOPICRULEPAYLOAD /AWS1/CL_IOTTOPICRULEPAYLOAD

The rule payload.

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.

lo_client->replacetopicrule(
  io_topicrulepayload = new /aws1/cl_iottopicrulepayload(
    io_erroraction = new /aws1/cl_iotaction(
      io_cloudwatchalarm = new /aws1/cl_iotcloudwatchalarmact(
        iv_alarmname = |string|
        iv_rolearn = |string|
        iv_statereason = |string|
        iv_statevalue = |string|
      )
      io_cloudwatchlogs = new /aws1/cl_iotcloudwatchlogsact(
        iv_batchmode = ABAP_TRUE
        iv_loggroupname = |string|
        iv_rolearn = |string|
      )
      io_cloudwatchmetric = new /aws1/cl_iotcloudwatchmetric00(
        iv_metricname = |string|
        iv_metricnamespace = |string|
        iv_metrictimestamp = |string|
        iv_metricunit = |string|
        iv_metricvalue = |string|
        iv_rolearn = |string|
      )
      io_dynamodb = new /aws1/cl_iotdynamodbaction(
        iv_hashkeyfield = |string|
        iv_hashkeytype = |string|
        iv_hashkeyvalue = |string|
        iv_operation = |string|
        iv_payloadfield = |string|
        iv_rangekeyfield = |string|
        iv_rangekeytype = |string|
        iv_rangekeyvalue = |string|
        iv_rolearn = |string|
        iv_tablename = |string|
      )
      io_dynamodbv2 = new /aws1/cl_iotdynamodbv2action(
        io_putitem = new /aws1/cl_iotputiteminput( |string| )
        iv_rolearn = |string|
      )
      io_elasticsearch = new /aws1/cl_iotelasticsrchaction(
        iv_endpoint = |string|
        iv_id = |string|
        iv_index = |string|
        iv_rolearn = |string|
        iv_type = |string|
      )
      io_firehose = new /aws1/cl_iotfirehoseaction(
        iv_batchmode = ABAP_TRUE
        iv_deliverystreamname = |string|
        iv_rolearn = |string|
        iv_separator = |string|
      )
      io_http = new /aws1/cl_iothttpaction(
        io_auth = new /aws1/cl_iothttpauthorization(
          io_sigv4 = new /aws1/cl_iotsigv4authorization(
            iv_rolearn = |string|
            iv_servicename = |string|
            iv_signingregion = |string|
          )
        )
        io_batchconfig = new /aws1/cl_iotbatchconfig(
          iv_maxbatchopenms = 123
          iv_maxbatchsize = 123
          iv_maxbatchsizebytes = 123
        )
        it_headers = VALUE /aws1/cl_iothttpactionheader=>tt_headerlist(
          (
            new /aws1/cl_iothttpactionheader(
              iv_key = |string|
              iv_value = |string|
            )
          )
        )
        iv_confirmationurl = |string|
        iv_enablebatching = ABAP_TRUE
        iv_url = |string|
      )
      io_iotanalytics = new /aws1/cl_iotiotanalyticsaction(
        iv_batchmode = ABAP_TRUE
        iv_channelarn = |string|
        iv_channelname = |string|
        iv_rolearn = |string|
      )
      io_iotevents = new /aws1/cl_iotioteventsaction(
        iv_batchmode = ABAP_TRUE
        iv_inputname = |string|
        iv_messageid = |string|
        iv_rolearn = |string|
      )
      io_iotsitewise = new /aws1/cl_iotiotsitewiseaction(
        it_putassetprpvalueentries = VALUE /aws1/cl_iotputastprpvalueentr=>tt_putassetprpvalueentrylist(
          (
            new /aws1/cl_iotputastprpvalueentr(
              it_propertyvalues = VALUE /aws1/cl_iotassetpropertyvalue=>tt_assetpropertyvaluelist(
                (
                  new /aws1/cl_iotassetpropertyvalue(
                    io_timestamp = new /aws1/cl_iotassetpropertytsmp(
                      iv_offsetinnanos = |string|
                      iv_timeinseconds = |string|
                    )
                    io_value = new /aws1/cl_iotassetprpvariant(
                      iv_booleanvalue = |string|
                      iv_doublevalue = |string|
                      iv_integervalue = |string|
                      iv_stringvalue = |string|
                    )
                    iv_quality = |string|
                  )
                )
              )
              iv_assetid = |string|
              iv_entryid = |string|
              iv_propertyalias = |string|
              iv_propertyid = |string|
            )
          )
        )
        iv_rolearn = |string|
      )
      io_kafka = new /aws1/cl_iotkafkaaction(
        it_clientproperties = VALUE /aws1/cl_iotclientproperties_w=>tt_clientproperties(
          (
            VALUE /aws1/cl_iotclientproperties_w=>ts_clientproperties_maprow(
              key = |string|
              value = new /aws1/cl_iotclientproperties_w( |string| )
            )
          )
        )
        it_headers = VALUE /aws1/cl_iotkafkaactionheader=>tt_kafkaheaders(
          (
            new /aws1/cl_iotkafkaactionheader(
              iv_key = |string|
              iv_value = |string|
            )
          )
        )
        iv_destinationarn = |string|
        iv_key = |string|
        iv_partition = |string|
        iv_topic = |string|
      )
      io_kinesis = new /aws1/cl_iotkinesisaction(
        iv_partitionkey = |string|
        iv_rolearn = |string|
        iv_streamname = |string|
      )
      io_lambda = new /aws1/cl_iotlambdaaction( |string| )
      io_location = new /aws1/cl_iotlocationaction(
        io_timestamp = new /aws1/cl_iotlocationtimestamp(
          iv_unit = |string|
          iv_value = |string|
        )
        iv_deviceid = |string|
        iv_latitude = |string|
        iv_longitude = |string|
        iv_rolearn = |string|
        iv_trackername = |string|
      )
      io_opensearch = new /aws1/cl_iotopensearchaction(
        iv_endpoint = |string|
        iv_id = |string|
        iv_index = |string|
        iv_rolearn = |string|
        iv_type = |string|
      )
      io_republish = new /aws1/cl_iotrepublishaction(
        io_headers = new /aws1/cl_iotmqttheaders(
          it_userproperties = VALUE /aws1/cl_iotuserproperty=>tt_userproperties(
            (
              new /aws1/cl_iotuserproperty(
                iv_key = |string|
                iv_value = |string|
              )
            )
          )
          iv_contenttype = |string|
          iv_correlationdata = |string|
          iv_messageexpiry = |string|
          iv_payloadformatindicator = |string|
          iv_responsetopic = |string|
        )
        iv_qos = 123
        iv_rolearn = |string|
        iv_topic = |string|
      )
      io_s3 = new /aws1/cl_iots3action(
        iv_bucketname = |string|
        iv_cannedacl = |string|
        iv_key = |string|
        iv_rolearn = |string|
      )
      io_salesforce = new /aws1/cl_iotsalesforceaction(
        iv_token = |string|
        iv_url = |string|
      )
      io_sns = new /aws1/cl_iotsnsaction(
        iv_messageformat = |string|
        iv_rolearn = |string|
        iv_targetarn = |string|
      )
      io_sqs = new /aws1/cl_iotsqsaction(
        iv_queueurl = |string|
        iv_rolearn = |string|
        iv_usebase64 = ABAP_TRUE
      )
      io_stepfunctions = new /aws1/cl_iotstepfuncsaction(
        iv_executionnameprefix = |string|
        iv_rolearn = |string|
        iv_statemachinename = |string|
      )
      io_timestream = new /aws1/cl_iottimestreamaction(
        io_timestamp = new /aws1/cl_iottsrtimestamp(
          iv_unit = |string|
          iv_value = |string|
        )
        it_dimensions = VALUE /aws1/cl_iottsrdimension=>tt_timestreamdimensionlist(
          (
            new /aws1/cl_iottsrdimension(
              iv_name = |string|
              iv_value = |string|
            )
          )
        )
        iv_databasename = |string|
        iv_rolearn = |string|
        iv_tablename = |string|
      )
    )
    it_actions = VALUE /aws1/cl_iotaction=>tt_actionlist(
      (
        new /aws1/cl_iotaction(
          io_cloudwatchalarm = new /aws1/cl_iotcloudwatchalarmact(
            iv_alarmname = |string|
            iv_rolearn = |string|
            iv_statereason = |string|
            iv_statevalue = |string|
          )
          io_cloudwatchlogs = new /aws1/cl_iotcloudwatchlogsact(
            iv_batchmode = ABAP_TRUE
            iv_loggroupname = |string|
            iv_rolearn = |string|
          )
          io_cloudwatchmetric = new /aws1/cl_iotcloudwatchmetric00(
            iv_metricname = |string|
            iv_metricnamespace = |string|
            iv_metrictimestamp = |string|
            iv_metricunit = |string|
            iv_metricvalue = |string|
            iv_rolearn = |string|
          )
          io_dynamodb = new /aws1/cl_iotdynamodbaction(
            iv_hashkeyfield = |string|
            iv_hashkeytype = |string|
            iv_hashkeyvalue = |string|
            iv_operation = |string|
            iv_payloadfield = |string|
            iv_rangekeyfield = |string|
            iv_rangekeytype = |string|
            iv_rangekeyvalue = |string|
            iv_rolearn = |string|
            iv_tablename = |string|
          )
          io_dynamodbv2 = new /aws1/cl_iotdynamodbv2action(
            io_putitem = new /aws1/cl_iotputiteminput( |string| )
            iv_rolearn = |string|
          )
          io_elasticsearch = new /aws1/cl_iotelasticsrchaction(
            iv_endpoint = |string|
            iv_id = |string|
            iv_index = |string|
            iv_rolearn = |string|
            iv_type = |string|
          )
          io_firehose = new /aws1/cl_iotfirehoseaction(
            iv_batchmode = ABAP_TRUE
            iv_deliverystreamname = |string|
            iv_rolearn = |string|
            iv_separator = |string|
          )
          io_http = new /aws1/cl_iothttpaction(
            io_auth = new /aws1/cl_iothttpauthorization(
              io_sigv4 = new /aws1/cl_iotsigv4authorization(
                iv_rolearn = |string|
                iv_servicename = |string|
                iv_signingregion = |string|
              )
            )
            io_batchconfig = new /aws1/cl_iotbatchconfig(
              iv_maxbatchopenms = 123
              iv_maxbatchsize = 123
              iv_maxbatchsizebytes = 123
            )
            it_headers = VALUE /aws1/cl_iothttpactionheader=>tt_headerlist(
              (
                new /aws1/cl_iothttpactionheader(
                  iv_key = |string|
                  iv_value = |string|
                )
              )
            )
            iv_confirmationurl = |string|
            iv_enablebatching = ABAP_TRUE
            iv_url = |string|
          )
          io_iotanalytics = new /aws1/cl_iotiotanalyticsaction(
            iv_batchmode = ABAP_TRUE
            iv_channelarn = |string|
            iv_channelname = |string|
            iv_rolearn = |string|
          )
          io_iotevents = new /aws1/cl_iotioteventsaction(
            iv_batchmode = ABAP_TRUE
            iv_inputname = |string|
            iv_messageid = |string|
            iv_rolearn = |string|
          )
          io_iotsitewise = new /aws1/cl_iotiotsitewiseaction(
            it_putassetprpvalueentries = VALUE /aws1/cl_iotputastprpvalueentr=>tt_putassetprpvalueentrylist(
              (
                new /aws1/cl_iotputastprpvalueentr(
                  it_propertyvalues = VALUE /aws1/cl_iotassetpropertyvalue=>tt_assetpropertyvaluelist(
                    (
                      new /aws1/cl_iotassetpropertyvalue(
                        io_timestamp = new /aws1/cl_iotassetpropertytsmp(
                          iv_offsetinnanos = |string|
                          iv_timeinseconds = |string|
                        )
                        io_value = new /aws1/cl_iotassetprpvariant(
                          iv_booleanvalue = |string|
                          iv_doublevalue = |string|
                          iv_integervalue = |string|
                          iv_stringvalue = |string|
                        )
                        iv_quality = |string|
                      )
                    )
                  )
                  iv_assetid = |string|
                  iv_entryid = |string|
                  iv_propertyalias = |string|
                  iv_propertyid = |string|
                )
              )
            )
            iv_rolearn = |string|
          )
          io_kafka = new /aws1/cl_iotkafkaaction(
            it_clientproperties = VALUE /aws1/cl_iotclientproperties_w=>tt_clientproperties(
              (
                VALUE /aws1/cl_iotclientproperties_w=>ts_clientproperties_maprow(
                  key = |string|
                  value = new /aws1/cl_iotclientproperties_w( |string| )
                )
              )
            )
            it_headers = VALUE /aws1/cl_iotkafkaactionheader=>tt_kafkaheaders(
              (
                new /aws1/cl_iotkafkaactionheader(
                  iv_key = |string|
                  iv_value = |string|
                )
              )
            )
            iv_destinationarn = |string|
            iv_key = |string|
            iv_partition = |string|
            iv_topic = |string|
          )
          io_kinesis = new /aws1/cl_iotkinesisaction(
            iv_partitionkey = |string|
            iv_rolearn = |string|
            iv_streamname = |string|
          )
          io_lambda = new /aws1/cl_iotlambdaaction( |string| )
          io_location = new /aws1/cl_iotlocationaction(
            io_timestamp = new /aws1/cl_iotlocationtimestamp(
              iv_unit = |string|
              iv_value = |string|
            )
            iv_deviceid = |string|
            iv_latitude = |string|
            iv_longitude = |string|
            iv_rolearn = |string|
            iv_trackername = |string|
          )
          io_opensearch = new /aws1/cl_iotopensearchaction(
            iv_endpoint = |string|
            iv_id = |string|
            iv_index = |string|
            iv_rolearn = |string|
            iv_type = |string|
          )
          io_republish = new /aws1/cl_iotrepublishaction(
            io_headers = new /aws1/cl_iotmqttheaders(
              it_userproperties = VALUE /aws1/cl_iotuserproperty=>tt_userproperties(
                (
                  new /aws1/cl_iotuserproperty(
                    iv_key = |string|
                    iv_value = |string|
                  )
                )
              )
              iv_contenttype = |string|
              iv_correlationdata = |string|
              iv_messageexpiry = |string|
              iv_payloadformatindicator = |string|
              iv_responsetopic = |string|
            )
            iv_qos = 123
            iv_rolearn = |string|
            iv_topic = |string|
          )
          io_s3 = new /aws1/cl_iots3action(
            iv_bucketname = |string|
            iv_cannedacl = |string|
            iv_key = |string|
            iv_rolearn = |string|
          )
          io_salesforce = new /aws1/cl_iotsalesforceaction(
            iv_token = |string|
            iv_url = |string|
          )
          io_sns = new /aws1/cl_iotsnsaction(
            iv_messageformat = |string|
            iv_rolearn = |string|
            iv_targetarn = |string|
          )
          io_sqs = new /aws1/cl_iotsqsaction(
            iv_queueurl = |string|
            iv_rolearn = |string|
            iv_usebase64 = ABAP_TRUE
          )
          io_stepfunctions = new /aws1/cl_iotstepfuncsaction(
            iv_executionnameprefix = |string|
            iv_rolearn = |string|
            iv_statemachinename = |string|
          )
          io_timestream = new /aws1/cl_iottimestreamaction(
            io_timestamp = new /aws1/cl_iottsrtimestamp(
              iv_unit = |string|
              iv_value = |string|
            )
            it_dimensions = VALUE /aws1/cl_iottsrdimension=>tt_timestreamdimensionlist(
              (
                new /aws1/cl_iottsrdimension(
                  iv_name = |string|
                  iv_value = |string|
                )
              )
            )
            iv_databasename = |string|
            iv_rolearn = |string|
            iv_tablename = |string|
          )
        )
      )
    )
    iv_awsiotsqlversion = |string|
    iv_description = |string|
    iv_ruledisabled = ABAP_TRUE
    iv_sql = |string|
  )
  iv_rulename = |string|
).