AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::IoT::Dimension

CfnDimension

Use the `AWS::IoT::Dimension` to limit the scope of a metric used in a security profile for AWS IoT Device Defender . For example, using a `TOPIC_FILTER` dimension, you can narrow down the scope of the metric to only MQTT topics where the name matches the pattern specified in the dimension. For API reference, see [CreateDimension](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateDimension.html) and for general information, see [Scoping metrics in security profiles using dimensions](https://docs.aws.amazon.com/iot/latest/developerguide/scoping-security-behavior.html) .

Import

import { CfnDimension } from 'aws-cdk-lib/aws-iot';

Or use the module namespace:

import * as iot from 'aws-cdk-lib/aws-iot';
// iot.CfnDimension

Properties

Configuration passed to the constructor as CfnDimensionProps.

stringValuesRequired
string[]

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

typeRequired
string

Specifies the type of dimension. Supported types: `TOPIC_FILTER.`

nameOptional
string

A unique identifier for the dimension.

tagsOptional
CfnTag[]

Metadata that can be used to manage the dimension.

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

AWS::IoT::DimensionView in CloudFormation Explorer

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

LevelL1 (CloudFormation)
Moduleaws-iot
CFN TypeAWS::IoT::Dimension
Properties4

Related Constructs

Explore This Service

External Links