调用ImportFpShotJob提交文本导库任务_媒体处理-阿里云帮助中心

提交文本导库任务。

接口说明

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

当前API暂无授权信息透出。

名称	类型	必填	描述	示例值
Input	string	是	导库⽂件的OSS地址，JSON对象。例如：`{"Bucket":"example-bucket","Location":"oss-cn-shanghai","Object":"example.txt"}`。说明OSS的地域需要与当前MPS所在地域保持一致。	{"Bucket":"example-bucket","Location":"oss-cn-shanghai","Object":"example.txt"}
PipelineId	string	否	管道ID，可以通过MPS控制台 > 全局设置 > 管道获取。⽤于区分业务，绑定消息通知。若不传，则使⽤默认管道，不绑定消息通知。	ae687c02fe944327ba9631e50da2****
FpImportConfig	string	是	导库配置，JSON对象。例如：`{"SaveType":"onlysave"}`。其中`SaveType`表示存储类型，取值包括： save：去重入库。 onlysave：仅入库。	{"SaveType":"onlysave"}
UserData	string	否	用户自定义数据，支持中英文、数字、特殊符号。最大长度128字节。	{"Chapter":"平凡的**/平凡的**第⼆部/第⼆部第47章.txt"}
FpDBId	string	是	DNA库ID，⽤于批量导⼊⽂本特征，⼀个库只能并⾏处理⼀个导库任务。可以从提交新建DNA库的返回参数中获取。	88c6ca184c0e47098a5b665e2a12****

其中，输入文件内容为所有待导入的文件信息，一行一条信息结构体，JSON结构，包含如下参数：

名称	类型	是否必选	描述
PrimaryKey	String	是	唯⼀的⽂本主键，唯⼀性由⽤户保证。
Bucket	String	是	⽂本⽂件所在OSS Bucket，遵守OSS Bucket定义，详情请参见术语表Bucket。
Location	String	是	⽂本⽂件OSS Bucket所在数据中⼼（OSSLocation），遵守OSS Location定义。详情请参见术语表Location。目前仅支持oss-cn-shanghai。
Object	String	是	⽂本⽂件（OSSObject），遵循RFC 2396（UTF-8编码，并进行URLEncode。更多信息，请参见URLEncode说明），遵守OSSObject定义，更多信息请参见术语表Object。
UserData	String	否	⽤户⾃定义数据，JSON格式，可以设置底库书名+章节名，如：{"Chapter":"平凡的**/平凡的**第⼆部/第⼆部第47章.txt"}；最⼤⻓度128个字节。

名称	类型	描述	示例值
	object	返回参数。
RequestId	string	请求ID。	25818875-5F78-4A13-BEF6-D7393642CA58
JobId	string	批量导库作业ID。建议您保存此ID便于后续调用其他接口时使用。	c074b118ace44395a02063a5ab94****

正常返回示例

JSON格式

{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId": "c074b118ace44395a02063a5ab94****"
}

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