获取人脸库列表

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListFaceGroups

系统规定参数。取值:ListFaceGroups。

PageNumber Integer 1

页码。

PageSize Integer 10

每页数量。

RegionId String cn-beijing

地域ID。

返回数据

名称 类型 示例值 描述
FaceGroups Array

人脸库

Description String 人脸库描述

人脸库描述。

FaceGroupId Long 1

人脸库ID。

FaceGroupName String 人脸库名称

人脸库名称。

ImageCount Long 1

图片数量。

PersonCount Long 1

人物数量。

Templates Array

模板。

Id String 1

模板ID。

Name String 模板名称

模板名称。

PageNumber Integer 1

页码。

PageSize Integer 10

每页数量

RequestId String 580e8ce3-3b80-44c5-9f3f-36ac3cc5bdd5

请求唯一ID,具有唯一性。

TotalCount Long 1

总数量。

示例

请求示例


http(s)://[Endpoint]/?Action=ListFaceGroups
&PageNumber=1
&PageSize=10
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>580e8ce3-3b80-44c5-9f3f-36ac3cc5bdd5</RequestId>
<Code>OK</Code>
<FaceGroups>
    <FaceGroupId>1</FaceGroupId>
    <FaceGroupName>人脸库名称</FaceGroupName>
    <Description>人脸库描述</Description>
    <PersonCount>1</PersonCount>
    <ImageCount>1</ImageCount>
    <Templates>
        <Id>1</Id>
        <Name>aaa</Name>
    </Templates>
</FaceGroups>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<TotalCount>1</TotalCount>

JSON 格式

{
	"PageNumber":1,
	"FaceGroups":[
		{
			"FaceGroupId":1,
			"ImageCount":1,
			"Description":"人脸库描述",
			"PersonCount":1,
			"FaceGroupName":"人脸库名称",
			"Templates":{
				"Name":"aaa",
				"Id":1
			}
		}
	],
	"TotalCount":1,
	"PageSize":10,
	"RequestId":"580e8ce3-3b80-44c5-9f3f-36ac3cc5bdd5",
	"Code":"OK"
}

错误码

HttpCode 错误码 错误信息 描述
200 OK Success 成功
500 InternalError An error occurred while processing your request. 内部错误
404 InvalidApiNotFound The specified API operation does not exist. Please check the URL and method. API不存在,请检查url和method
400 InvalidParameter The specified parameter %s is invalid. 参数非法,请检查参数%s
400 InvalidTimeStamp The specified TimeStamp is invalid. Please check parameter %s. 时间格式非法,请检查参数%s
400 MissingParameter You must specify the parameter %s. 缺少必要参数,请检查参数%s是否正确
404 ResourceNotFound The requested resource does not exist. Please check the parameter %s. 请求资源不存在,请检查参数%s是否正确
500 ServiceUnavailable An error occurred while processing your request. 内部服务不可用
500 UnknownError An error occurred while processing your request. 未知错误
401 Unauthorized You are not authorized to perform the operation. 该用户没有权限
406 ServiceNotSelected The service is not activated. 未开启此服务
401 ServiceNotOpened You have not purchased the service. 未购买此服务
401 BalanceNotEnough The account balance is insufficient and you cannot perform the request. 余额不足,无法操作此请求
406 FaceImageCountLimit The maximum number of face images is exceeded. 人脸数量达到限制
406 ApplicationCountLimit The maximum number of applications is exceeded. 应用数量达到限制
406 FileUploadCountLimit The maximum number of file upload is exceeded. 上传文件数量达到限制
406 FileContentInvalid The specified file content is invalid. 文件内容格式不正确
406 ExistParameter The specified parameter %s exists. 参数%s已存在
406 ExistTemplateRelationship The associated template already exists. 存在关联模板

访问错误中心查看更多错误码。