Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1435160115.2 KB

Searches for things associated with the specified entity. You can search by both device and device model.

For example, if two different devices, camera1 and camera2, implement the camera device model, the user can associate thing1 to camera1 and thing2 to camera2. SearchThings(camera2) will return only thing2, but SearchThings(camera) will return both thing1 and thing2.

This action searches for exact matches and doesn't perform partial text matching.

post/#X-Amz-Target=IotThingsGraphFrontEndService.SearchThings

Query parameters

maxResultsstring

Pagination limit

nextTokenstring

Pagination token

Headers

X-Amz-Target'IotThingsGraphFrontEndService.SearchThings' required

Request body

entityIdstring required
<p>The ID of the entity to which the things are associated.</p> <p>The IDs should be in the following format.</p> <p> <code>urn:tdm:REGION/ACCOUNT ID/default:device:DEVICENAME</code> </p>
nextTokenstring

The string that specifies the next page of results. Use this when you're paginating results.

maxResultsinteger

The maximum number of results to return in the response.

namespaceVersioninteger

The version of the user's namespace. Defaults to the latest version of the user's namespace.

Response

Success

nextTokenstring

The string to specify as <code>nextToken</code> when you request the next page of results.