/things/{thingName} - AWS IoT Wireless

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.

Requires permission to access the CreateThing action.

curl --location -g --request POST 'https://api.iotwireless.{region}.amazonaws.com/things/' \ --header 'Content-Type: application/json' \ --data-raw '{ "thingTypeName": "string", "attributePayload": { "attributes": { "property1": "string", "property2": "string" }, "merge": true }, "billingGroupName": "string" }'

Request

Path Params

thingName

string

required

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.

Body Params application/json

thingTypeName

string

optional

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

>= 1 characters<= 128 characters

Match pattern:

[a-zA-Z0-9:_-]+

attributePayload

object

optional

The attribute payload.

attributes

object

optional

A JSON string containing up to three key-value pair in JSON format. For example:

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

merge

boolean

optional

Specifies whether the list of attributes provided in the AttributePayload is merged with the attributes stored in the registry, instead of overwriting them.

To remove an attribute, call UpdateThing with an empty attribute value.

billingGroupName

string

optional

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

>= 1 characters<= 128 characters

Match pattern:

[a-zA-Z0-9:_-]+

Examples

Responses

🟢200Success

application/json

Body

The output of the CreateThing operation.

thingName

string

optional

The name of the new thing.

thingArn

string

optional

The ARN of the new thing.

thingId

string

optional

The thing ID.

🟠480InvalidRequestException

🟠481ThrottlingException

🟠482UnauthorizedException

🟠483ServiceUnavailableException

🟠484InternalFailureException

🟠485ResourceAlreadyExistsException

🟠486ResourceNotFoundException