/dimensions/{name}

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.

curl --location -g --request POST 'https://api.iotwireless.{region}.amazonaws.com/dimensions/' \ --header 'Content-Type: application/json' \ --data-raw '{ "type": "TOPIC_FILTER", "stringValues": [ "string" ], "tags": [ { "Key": "string", "Value": "string" } ], "clientRequestToken": "string" }'

Request

Path Params

name

string

required

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

Body Params application/json

type

enum<string>

required

Specifies the type of dimension. Supported types: TOPIC_FILTER.

Allowed value:

TOPIC_FILTER

stringValues

array[string]

required

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/#").

>= 1 items<= 100 items

Request

Responses