Adds, updates, or deletes group tags.
Limits
- Each group can have a maximum of 100 tags.
-
Each Alibaba Cloud account can run a maximum of 50 queries per second (QPS).Note Resource Access Management (RAM) users of an Alibaba Cloud account share the quota of the account.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | SetDeviceGroupTags |
The operation that you want to perform. Set the value to SetDeviceGroupTags. |
GroupId | String | Yes | W16X8Tvdosec**** |
The ID of the group. The ID is the globally unique identifier (GUID) for the group. |
IotInstanceId | String | No | iot_instc_pu****_c*-v64******** |
The instance ID. This parameter is not required for public instances. However, the parameter is required for the instances that you have purchased. |
TagString | String | No | [{"tagKey":"h1","tagValue":"rr"},{"tagKey":"7h","tagValue":"rr"}] |
The tag data in the JSON format. The TagString parameter consists of a set of key-value pairs. Each tag consists of a tagKey and tagValue. You must specify the tagKey and tagValue parameters for each tag.
Separate multiple tags with commas (,), for example, If you need to update an existing tag, specify a new value for the tag. The new value overwrites the previous value. If you need to delete a tag, do not specify a key or value for the tag. |
In addition to the preceding operation-specific request parameters, you must specify common request parameters when you call this API operation. For more information, see Common request parameters.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Code | String | iot.system.SystemException |
The error code returned if the call fails. For more information, see Error codes. |
ErrorMessage | String | A system exception occurred. |
The error message returned if the call fails. |
RequestId | String | 12CFDAF1-99D9-42E0-8C2F-F281DA5E8953 |
The ID of the request. |
Success | Boolean | true |
Indicates whether the call succeeds.
|
Examples
Sample requests
https://iot.cn-shanghai.aliyuncs.com/?Action=SetDeviceGroupTags
&GroupId=W16X8Tvdosec****
&TagString=[{"tagKey":"h1","tagValue":"rr"},{"tagKey":"7h","tagValue":"rr"}]
&<Common request parameters>
Sample success responses
XML
format
<SetDeviceGroupTagsResponse>
<RequestId>12CFDAF1-99D9-42E0-8C2F-F281DA5E8953</RequestId>
<Success>true</Success>
</SetDeviceGroupTagsResponse>
JSON
format
{
"RequestId":"12CFDAF1-99D9-42E0-8C2F-F281DA5E8953",
"Success":true
}
Error codes
For a list of error codes, visit the API Error Center.