调用该接口查询MNS或AMQP服务端订阅。
QPS限制
单个阿里云账号调用该接口的每秒请求数(QPS)最大限制为5。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | QuerySubscribeRelation | 系统规定参数。取值:QuerySubscribeRelation。 |
ProductKey | String | 是 | a1fyXVF**** | 该订阅中的产品的ProductKey。 |
Type | String | 是 | AMQP | 订阅类型:
|
IotInstanceId | String | 否 | iot-cn-0pp1n8t**** | 实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID。
实例的更多信息,请参见实例概述。 |
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 |
描述 |
queueName |
消息服务中用来接收信息的队列名称。 |
regionName |
目标消息服务所在的阿里云地域代码,例如cn-shanghai。 |
role |
授权角色信息。通过授予物联网平台指定的系统服务角色,您可以授权物联网平台访问您的消息服务。授权角色信息如下:
请将
|
示例:
{
"queueName": "mns-test-topic1",
"regionName": "cn-shanghai",
"role": {
"roleArn": "acs:ram::5645***:role/aliyuniotaccessingmnsrole",
"roleName": "AliyunIOTAccessingMNSRole"
}
}
示例
请求示例
https://iot.cn-shanghai.aliyuncs.com/?Action=QuerySubscribeRelation
&ProductKey=a1Zkii7****
&Type=AMQP
&<公共请求参数>
正常返回示例
XML
格式
<QuerySubscribeRelationResponse>
<DeviceLifeCycleFlag>false</DeviceLifeCycleFlag>
<RequestId>73B9DF43-7780-47DE-8BED-077729D28BD2</RequestId>
<DeviceDataFlag>true</DeviceDataFlag>
<DeviceTopoLifeCycleFlag>false</DeviceTopoLifeCycleFlag>
<DeviceStatusChangeFlag>false</DeviceStatusChangeFlag>
<ConsumerGroupIds>Xs95KifeaSKbi8tKkcoD00****</ConsumerGroupIds>
<Success>true</Success>
<ThingHistoryFlag>false</ThingHistoryFlag>
<Type>AMQP</Type>
<FoundDeviceListFlag>false</FoundDeviceListFlag>
<OtaEventFlag>false</OtaEventFlag>
<SubscribeFlags>{ "jt808DeviceDataFlag": true }</SubscribeFlags>
<ProductKey>a1Zkii7****</ProductKey>
</QuerySubscribeRelationResponse>
JSON
格式
{
"DeviceLifeCycleFlag": false,
"RequestId": "73B9DF43-7780-47DE-8BED-077729D28BD2",
"DeviceDataFlag": true,
"DeviceTopoLifeCycleFlag": false,
"DeviceStatusChangeFlag": false,
"ConsumerGroupIds": [
"Xs95KifeaSKbi8tKkcoD00****"
],
"Success": true,
"ThingHistoryFlag": false,
"Type": "AMQP",
"FoundDeviceListFlag": false,
"OtaEventFlag": false,
"SubscribeFlags": "{ \"jt808DeviceDataFlag\": true }",
"ProductKey": "a1Zkii7****"
}
- 本页导读 (1)
- QPS限制
- 调试
- 请求参数
- 返回数据
- 示例