Skip to content

/AWS1/IF_DSR=>REGISTEREVENTTOPIC()

About RegisterEventTopic

Associates a directory with an Amazon SNS topic. This establishes the directory as a publisher to the specified Amazon SNS topic. You can then receive email or text (SMS) messages when the status of your directory changes. You get notified if your directory goes from an Active status to an Impaired or Inoperable status. You also receive a notification when the directory returns to an Active status.

Method Signature

METHODS /AWS1/IF_DSR~REGISTEREVENTTOPIC
  IMPORTING
    !IV_DIRECTORYID TYPE /AWS1/DSRDIRECTORYID OPTIONAL
    !IV_TOPICNAME TYPE /AWS1/DSRTOPICNAME OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_dsrregeventtopicrslt
  RAISING
    /AWS1/CX_DSRCLIENTEXCEPTION
    /AWS1/CX_DSRENTDOESNOTEXISTEX
    /AWS1/CX_DSRINVALIDPARAMETEREX
    /AWS1/CX_DSRSERVICEEXCEPTION
    /AWS1/CX_DSRCLIENTEXC
    /AWS1/CX_DSRSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_directoryid TYPE /AWS1/DSRDIRECTORYID /AWS1/DSRDIRECTORYID

The Directory ID that will publish status messages to the Amazon SNS topic.

iv_topicname TYPE /AWS1/DSRTOPICNAME /AWS1/DSRTOPICNAME

The Amazon SNS topic name to which the directory will publish status messages. This Amazon SNS topic must be in the same region as the specified Directory ID.

RETURNING

oo_output TYPE REF TO /aws1/cl_dsrregeventtopicrslt /AWS1/CL_DSRREGEVENTTOPICRSLT

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->registereventtopic(
  iv_directoryid = |string|
  iv_topicname = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
ENDIF.

To register an event topic

The following example associates a directory with an SNS topic.

DATA(lo_result) = lo_client->registereventtopic(
  iv_directoryid = |d-92654abfed|
  iv_topicname = |snstopicexample|
).