调用该接口,查询指定业务隔离ID下所有已添加人脸同步关系的用户组和设备组。
限制条件
单个阿里云账号调用该接口的每秒请求数(QPS)最大限制为100。
说明 RAM用户共享阿里云账号配额。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryFaceAllUserGroupAndDeviceGroupRelation |
系统规定参数。取值:QueryFaceAllUserGroupAndDeviceGroupRelation。 |
IsolationId | String | 是 | ZheJiangHZ |
业务隔离ID。 |
PageNo | Integer | 是 | 1 |
指定从返回结果中的第几页开始显示。最小取值为1。 |
PageSize | Integer | 是 | 20 |
返回结果中,每页显示的记录数量。最大取值100,最小取值1,默认取值为20。 |
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 |
接口返回码:
|
Data | Struct |
调用成功时,返回的数据。 |
|
List | Array of List |
用户组和设备组的人脸同步关系列表。 |
|
ControlId | String | qcb2yea4ha4d**** |
用户组与设备组同步关系控制ID。 |
ControlType | String | SYNC_INFO_PICTURE |
人脸同步关系。当前仅支持SYNC_INFO_PICTURE,表示同步用户照片和用户信息。 |
DeviceGroupId | String | jykv**** |
设备组ID。 |
ModifiedTime | String | 2020-05-12 17:12:37 |
最后一次更新用户组与设备组之间的人脸同步关系时间。 |
UserGroupId | String | kvjy**** |
用户组ID。 |
Page | Integer | 1 |
当前页码。 |
PageSize | Integer | 20 |
返回结果中,每页显示的记录数量。 |
Total | Integer | 2 |
人脸同步关系总数。例如用户组A和设备组a,用户组B和设备组b,分别有人脸同步关系,则Total参数值为2。 |
ErrorMessage | String | request parameter error |
调用失败时,返回的出错信息。 |
RequestId | String | 0A13279A-5640-45E7-87AA-83750541AD0E |
阿里云为该请求生成的唯一标识符。 |
Success | Boolean | true |
是否调用成功:
|
示例
请求示例
http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=QueryFaceAllUserGroupAndDeviceGroupRelation
&IsolationId=ZheJiangHZ
&PageNo=1
&PageSize=20
&<公共请求参数>
正常返回示例
XML
格式
<QueryFaceAllUserGroupAndDeviceGroupRelationResponse>
<RequestId>0A13279A-5640-45E7-87AA-83750541AD0E</RequestId>
<Data>
<PageSize>20</PageSize>
<Total>2</Total>
<Page>1</Page>
<List>
<ModifiedTime>2020-05-12 17:12:37</ModifiedTime>
<DeviceGroupId>jykv****</DeviceGroupId>
<UserGroupId>kvjy****</UserGroupId>
<ControlType>SYNC_INFO_PICTURE</ControlType>
<ControlId>qcb2yea4ha4d****</ControlId>
</List>
<List>
<ModifiedTime>2020-06-10 17:12:37</ModifiedTime>
<DeviceGroupId>scvf****</DeviceGroupId>
<UserGroupId>ijgf****</UserGroupId>
<ControlType>SYNC_INFO_PICTURE</ControlType>
<ControlId>dbf3fh4ha4d****</ControlId>
</List>
</Data>
<Code>200</Code>
<Success>true</Success>
</QueryFaceAllUserGroupAndDeviceGroupRelationResponse>
JSON
格式
{
"RequestId": "0A13279A-5640-45E7-87AA-83750541AD0E",
"Data": {
"PageSize": "20",
"Total": "2",
"Page": "1",
"List": [
{
"ModifiedTime": "2020-05-12 17:12:37",
"DeviceGroupId": "jykv****",
"UserGroupId": "kvjy****",
"ControlType": "SYNC_INFO_PICTURE",
"ControlId": "qcb2yea4ha4d****"
},
{
"ModifiedTime": "2020-06-10 17:12:37",
"DeviceGroupId": "scvf****",
"UserGroupId": "ijgf****",
"ControlType": "SYNC_INFO_PICTURE",
"ControlId": "dbf3fh4ha4d****"
}
]
},
"Code": "200",
"Success": true
}