调用CreateDBImportTask创建数据库导入任务_移动研发平台(EMAS)-阿里云帮助中心

创建数据库导入任务。

接口说明

创建导入任务成功后，将会返回任务 ID、上传文件的地址和鉴权信息。您需要在要求的时间内向给定的地址上传需要导入的文件。上传文件成功之后，您需要调用 QueryDBImportTaskStatus 接口来触发运行导入任务，并查询数据导入状态。
上传文件时，请求方法请使用 POST 方法，Content-Type 指定为multipart/form-data。下面是使用 curl 命令上传文件的一个示例。

curl -X POST \
-H 'Content-Type: multipart/form-data' \
-F 'key=${FileKey}' \
-F 'policy=${Policy}' \
-F 'OSSAccessKeyId=${AccessKeyId}' \
-F 'Signature=${Signature}' \
-F 'file=@${FilePath}' \
'${Host}'

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
mpserverless:CreateDBImportTask		全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
SpaceId	string	是	服务空间 ID。	0e16bb12-14af-4635-b24c-5ac1a9a*****
Collection	string	是	集合名称。	test
FileType	string	是	导入文件类型，可选值为： JSON CSV	CSV
Mode	string	是	冲突处理模式，可选值为： INSERT（默认）：导入出现冲突则忽略。 UPSERT：导入出现冲突则使用文件中的内容更新。	UPSERT

返回参数

名称	类型	描述	示例值
	object
Host	string	上传文件使用的 Host。注意该接口返回的文件上传 Host 站点配有跨域限制规则，仅允许官方 console.aliyun.com 网站直传文件。不可用于三方网站文件直传。不影响非网页端文件上传。	https://mps-zjk-share.oss-cn-zhangjiakou.aliyuncs.com
ExpireTime	string	上传文件的过期时间。	2020-07-20T05:32:03Z
FileKey	string	上传文件使用的 FileKey。	mongo/import/0e16bb12-14af-4635-b24c-5ac1a9***/20200720130203_973820af-966d-42ec-9fab-17dfe4a****.csv
AccessKeyId	string	上传文件使用的 AccessKeyId。	LTAIupaslTlU*****
Signature	string	上传文件使用的 Signature。	*****luWDvbmhqwwy9pm/Mso++pk=
RequestId	string	唯一请求 ID。	692DCFEF-46DD-4EBB-B1DB-338E687DC260
Policy	string	上传文件使用的 Policy。	eyJleHBpcmF0aW9uIjjoiMjAyMC0wNy0yMFQwNTozMjowMy40NDVaIiwiY29uZGl0aW9ucyI*****Y29udGVudC1sZW5ndoiMjAyMC==
TaskId	string	任务 ID。	973820af-966d-42ec-9fab-17dfe4a*****

示例

正常返回示例

JSON格式

{
  "Host": "https://mps-zjk-share.oss-cn-zhangjiakou.aliyuncs.com",
  "ExpireTime": "2020-07-20T05:32:03Z",
  "FileKey": "mongo/import/0e16bb12-14af-4635-b24c-5ac1a9*****/20200720130203_973820af-966d-42ec-9fab-17dfe4a******.csv",
  "AccessKeyId": "LTAIupaslTlU*****",
  "Signature": "*****luWDvbmhqwwy9pm/Mso++pk=",
  "RequestId": "692DCFEF-46DD-4EBB-B1DB-338E687DC260",
  "Policy": "eyJleHBpcmF0aW9uIjjoiMjAyMC0wNy0yMFQwNTozMjowMy40NDVaIiwiY29uZGl0aW9ucyI*****Y29udGVudC1sZW5ndoiMjAyMC==",
  "TaskId": "973820af-966d-42ec-9fab-17dfe4a*****"
}

错误码

HTTP status code	错误码	错误信息	描述
400	AccessDenied	You are not authorized to access this space.	没有访问该Space的权限。

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史