/AWS1/CL_IOT=>CREATEDIMENSION()

About CreateDimension

Create a dimension that you can use to limit the scope of a metric used in a security profile for IoT Device Defender. For example, using a TOPIC_FILTER dimension, you can narrow down the scope of the metric only to MQTT topics whose name match the pattern specified in the dimension.

Requires permission to access the CreateDimension action.

Method Signature

IMPORTING

Required arguments:

IV_NAME TYPE /AWS1/IOTDIMENSIONNAME /AWS1/IOTDIMENSIONNAME

A unique identifier for the dimension. Choose something that describes the type and value to make it easy to remember what it does.

IV_TYPE TYPE /AWS1/IOTDIMENSIONTYPE /AWS1/IOTDIMENSIONTYPE

Specifies the type of dimension. Supported types: TOPIC_FILTER.

IT_STRINGVALUES TYPE /AWS1/CL_IOTDIMTRINGVALUES_W=>TT_DIMENSIONSTRINGVALUES TT_DIMENSIONSTRINGVALUES

Specifies the value or list of values for the dimension. For TOPIC_FILTER dimensions, this is a pattern used to match the MQTT topic (for example, "admin/#").

IV_CLIENTREQUESTTOKEN TYPE /AWS1/IOTCLIENTREQUESTTOKEN /AWS1/IOTCLIENTREQUESTTOKEN

Each dimension must have a unique client request token. If you try to create a new dimension with the same token as a dimension that already exists, an exception occurs. If you omit this value, Amazon Web Services SDKs will automatically generate a unique client request.

Optional arguments:

IT_TAGS TYPE /AWS1/CL_IOTTAG=>TT_TAGLIST TT_TAGLIST

Metadata that can be used to manage the dimension.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_IOTCREATEDIMENSIONRSP /AWS1/CL_IOTCREATEDIMENSIONRSP