Sign in

v1

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

Updates the definition for a dimension. You cannot change the type of a dimension after it is created (you can delete it and recreate it).

Requires permission to access the UpdateDimension action.

patch/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

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

Response

Success

namestring

A unique identifier for the dimension.

arnstring

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

type'TOPIC_FILTER'

The type of the dimension.

stringValuesDimensionStringValue[]

The value or list of values used to scope the dimension. For example, for topic filters, this is the pattern used to match the MQTT topic name.

creationDatestring date-time

The date and time, in milliseconds since epoch, when the dimension was initially created.

lastModifiedDatestring date-time

The date and time, in milliseconds since epoch, when the dimension was most recently updated.