/things/{thingName}/thing-groups

The AWS IoT Wireless multi-region endpoint

https://api.iotwireless.{region}.amazonaws.com

GET

List the thing groups to which the specified thing belongs.

Requires permission to access the ListThingGroupsForThing action.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.iotwireless.{region}.amazonaws.com/things//thing-groups'

Response Example

200 - Example 1

{
    "thingGroups": [],
    "nextToken": "string"
}

Request

Path Params

thingName

string

required

The thing name.

Query Params

nextToken

string

optional

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

maxResults

integer

optional

The maximum number of results to return at one time.

Responses

🟢200Success

application/json

Body

thingGroups

array[object (GroupNameAndArn) {2}]

optional

The thing groups.

groupName

string

optional

The group name.

>= 1 characters<= 128 characters

Match pattern:

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

groupArn

string

optional

The group ARN.

nextToken

string

optional

The token to use to get the next set of results, or null if there are no additional results.

<= 4096 characters

🟠480InvalidRequestException

🟠481InternalFailureException

🟠482ResourceNotFoundException

🟠483ThrottlingException

Modified at 2022-09-10 23:12:18

/thing-groups

/things/{thingName}/principals