调用CreateFpShotDB提交新建DNA库作业。

使用说明

  • 本接口可以新建视频DNA库或文本DNA库(文本DNA库用于存储文本特征内容)。
  • 文本DNA相关接口目前仅支持华东2(上海)地域使用。
  • 视频DNA管道默认并发为10,超过可能会导致接口调用失败。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

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

系统规定参数。取值:CreateFpShotDB

Name String example name

DNA库名称。

ModelId Integer 11

DNA库模型ID。文本DNA Modelld为11,视频DNA ModelId为12,音频DNA ModelId为13,图片DNA ModelId为14

Config String null

指纹库配置。默认为空,做定制化配置。字符串类型,JSON格式。

Description String 这是一个文本DNA库

DNA库描述。

返回数据

名称 类型 示例值 描述
RequestId String 25818875-5F78-4A13-BEF6-D7393642CA58

请求ID。

FpShotDB Object

DNA库详细信息。

Description String 这是一个文本DNA库

DNA库描述。

State String offline

DNA库的状态。新建成功后默认为offline状态,待后台处理完成后会自动转换成active状态。

Name String example-name-****

DNA库名称。

FpDBId String 88c6ca184c0e47098a5b665e2a12****

DNA库ID。建议您保存此ID便于后续调用其他相关接口时使用。

ModelId Integer 11

DNA库模型ID。

Config String null

DNA库配置。

示例

请求示例

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=CreateFpShotDB
&Name=example name
&ModelId=11
&Config=null
&Description=这是一个文本DNA库
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateFpShotDBResponse>
    <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
    <FpShotDB>
        <Description>这是一个文本DNA库</Description>
        <State>offline</State>
        <Name>example-name-****</Name>
        <FpDBId>88c6ca184c0e47098a5b665e2a12****</FpDBId>
        <ModelId>11</ModelId>
        <Config>null</Config>
    </FpShotDB>
</CreateFpShotDBResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25818875-5F78-4A13-BEF6-D7393642CA58",
  "FpShotDB" : {
    "Description" : "这是一个文本DNA库",
    "State" : "offline",
    "Name" : "example-name-****",
    "FpDBId" : "88c6ca184c0e47098a5b665e2a12****",
    "ModelId" : 11,
    "Config" : "null"
  }
}

错误码

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