Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142381,278956.3 KB

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.

post/dimensions/{name}

Path parameters

namestring required

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

Request body

type'TOPIC_FILTER' required

Specifies the type of dimension. Supported types: <code>TOPIC_FILTER.</code>

stringValuesDimensionStringValue[] required

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

clientRequestTokenstring required

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.

Response

Success

namestring

A unique identifier for the dimension.

arnstring

The Amazon Resource Name (ARN) of the created dimension.