Skip to content

/AWS1/CL_IOT=>CREATETHING()

About CreateThing

Creates a thing record in the registry. If this call is made multiple times using the same thing name and configuration, the call will succeed. If this call is made with the same thing name but different configuration a ResourceAlreadyExistsException is thrown.

This is a control plane operation. See Authorization for information about authorizing control plane actions.

Requires permission to access the CreateThing action.

Method Signature

IMPORTING

Required arguments:

IV_THINGNAME TYPE /AWS1/IOTTHINGNAME /AWS1/IOTTHINGNAME

The name of the thing to create.

You can't change a thing's name after you create it. To change a thing's name, you must create a new thing, give it the new name, and then delete the old thing.

Optional arguments:

IV_THINGTYPENAME TYPE /AWS1/IOTTHINGTYPENAME /AWS1/IOTTHINGTYPENAME

The name of the thing type associated with the new thing.

IO_ATTRIBUTEPAYLOAD TYPE REF TO /AWS1/CL_IOTATTRIBUTEPAYLOAD /AWS1/CL_IOTATTRIBUTEPAYLOAD

The attribute payload, which consists of up to three name/value pairs in a JSON document. For example:

{\"attributes\":{\"string1\":\"string2\"}}

IV_BILLINGGROUPNAME TYPE /AWS1/IOTBILLINGGROUPNAME /AWS1/IOTBILLINGGROUPNAME

The name of the billing group the thing will be added to.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_IOTCREATETHINGRSP /AWS1/CL_IOTCREATETHINGRSP