Skip to content

/AWS1/CL_IOT=>LISTTHINGS()

About ListThings

Lists your things. Use the attributeName and attributeValue parameters to filter your things. For example, calling ListThings with attributeName=Color and attributeValue=Red retrieves all things in the registry that contain an attribute Color with the value Red. For more information, see List Things from the Amazon Web Services IoT Core Developer Guide.

Requires permission to access the ListThings action.

You will not be charged for calling this API if an Access denied error is returned. You will also not be charged if no attributes or pagination token was provided in request and no pagination token and no results were returned.

Method Signature

IMPORTING

Optional arguments:

IV_NEXTTOKEN TYPE /AWS1/IOTNEXTTOKEN /AWS1/IOTNEXTTOKEN

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

IV_MAXRESULTS TYPE /AWS1/IOTREGISTRYMAXRESULTS /AWS1/IOTREGISTRYMAXRESULTS

The maximum number of results to return in this operation.

IV_ATTRIBUTENAME TYPE /AWS1/IOTATTRIBUTENAME /AWS1/IOTATTRIBUTENAME

The attribute name used to search for things.

IV_ATTRIBUTEVALUE TYPE /AWS1/IOTATTRIBUTEVALUE /AWS1/IOTATTRIBUTEVALUE

The attribute value used to search for things.

IV_THINGTYPENAME TYPE /AWS1/IOTTHINGTYPENAME /AWS1/IOTTHINGTYPENAME

The name of the thing type used to search for things.

IV_USEPREFIXATTRIBUTEVALUE TYPE /AWS1/IOTUSEPREFIXATTRVALUE /AWS1/IOTUSEPREFIXATTRVALUE

When true, the action returns the thing resources with attribute values that start with the attributeValue provided.

When false, or not present, the action returns only the thing resources with attribute values that match the entire attributeValue provided.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_IOTLISTTHINGSRESPONSE /AWS1/CL_IOTLISTTHINGSRESPONSE