創(chuàng)建數(shù)據(jù)庫導(dǎo)入任務(wù)。
接口說明
創(chuàng)建導(dǎo)入任務(wù)成功后,將會返回任務(wù) ID、上傳文件的地址和鑒權(quán)信息。您需要在要求的時間內(nèi)向給定的地址上傳需要導(dǎo)入的文件。上傳文件成功之后,您需要調(diào)用 QueryDBImportTaskStatus 接口來觸發(fā)運行導(dǎo)入任務(wù),并查詢數(shù)據(jù)導(dǎo)入狀態(tài)。
上傳文件時,請求方法請使用 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}'
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
mpserverless:CreateDBImportTask |
|
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
SpaceId | string | 是 | 服務(wù)空間 ID。 | 0e16bb12-14af-4635-b24c-5ac1a9a***** |
Collection | string | 是 | 集合名稱。 | test |
FileType | string | 是 | 導(dǎo)入文件類型,可選值為:
| CSV |
Mode | string | 是 | 沖突處理模式,可選值為:
| UPSERT |
返回參數(shù)
示例
正常返回示例
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的權(quán)限。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|
暫無變更歷史