v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14109645376.3 KB

Creates a new destination that maps a device message to an AWS IoT rule.

post/destinations

Request body

Namestring required

The name of the new resource.

ExpressionType'RuleName' | 'MqttTopic' required

The type of value in <code>Expression</code>.

Expressionstring required

The rule name or topic rule to send messages to.

Descriptionstring

The description of the new resource.

RoleArnstring required

The ARN of the IAM Role that authorizes the destination.

ClientRequestTokenstring

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

Response

Success

Arnstring

The Amazon Resource Name of the new resource.

Namestring

The name of the new resource.