創建對象存儲評估任務
更新時間 2025-06-11 14:55:31
最近更新時間: 2025-06-11 14:55:31
分享文章
接口功能介紹
創建對象存儲評估任務
接口約束
1、支持的線上資源池 ：華東1
2、單個用戶可創建最多5個任務
URI
POST /v4/zms/create-evaluation
路徑參數
無
Query參數
無
請求參數
請求頭header參數
無
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 資源池 ID | 332232eb-63aa-465e-9028-52e5123866f0 | |
| evaluationName | 是 | String | 任務名稱，必須為大小寫字母、數字、橫線或下劃線，長度在4-32個字符之間，且名稱不能重復 | mr-hcz | |
| sourceInfo | 是 | Array of Objects | 源端信息 | 參考表sourceInfo | |
| destinationInfo | 否 | Array of Objects | 目的端信息 | 參考表destinationInfo |
表 sourceInfo
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| sourceType | 否 | String | 評估遷移源類型，默認為S3，①S3：亞馬遜；②OSS：阿里云； ③COS：騰訊云；④ OBS：華為云；⑤ OOS：天翼云⑥ZOS：天翼云對象存儲 | S3 | |
| sourceEndpoint | 是 | String | 評估遷移資源池地址，支持輸入IP或域名，以//或//開頭。如需使用非默認端口，請輸入端口號 | //xxx:8888或//xxx | |
| sourceBucket | 是 | String | 評估遷移源桶，輸入限制不超過1024字符 | bucket-kpblz | |
| sourceAccessKey | 是 | String | 評估遷移源資源池ak，輸入限制不超過1024字符 | XXXXXX | |
| sourceSecretKey | 是 | String | 評估遷移源資源池sk，輸入限制不超過1024字符 | XXXXXX | |
| sourceBucketType | 否 | String | 評估源資源池遷移模式,默認為Bucket。①Bucket：整桶遷移；②Folder：文件夾遷移；③Prefix：前綴遷移 | Bucket | |
| evaluationFolder | 否 | String | 指定源資源池遷移的文件夾,僅當sourceBucketType為Folder時有效,當前僅支持指定單個文件夾，單個文件夾名輸入限制不超過1024字符 | folder1 | |
| evaluationPrefix | 否 | String | 指定源資源池遷移的前綴，僅當sourceBucketType為Prefix時有效,當前只支持指定單個前綴，單個前綴名輸入限制不超過1024字符 | prefix1 |
表 destinationInfo
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| destinationType | 否 | String | 目的端類型，目前默認且僅支持ZOS | ZOS |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 返回狀態碼(800為成功，900為處理中/失敗) | 800 | |
| message | String | 狀態描述 | SUCCESS | |
| returnObj | Object | 響應對象 | 參考表returnObj | |
| description | String | 狀態描述，一般為中文 | 成功 | |
| errorCode | String | 業務細分碼（僅失敗時具有此參數），為product.module.code三段式碼 | openapi.userPermission.accessFailed | |
| error | String | 業務細分碼（大駝峰形式，僅失敗時具有此參數），為 Product.Module.Code 三段式碼 | Openapi.UserPermission.AccessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| result | String | 任務結果 | success | |
| evaluationID | String | 評估任務ID，作為其他操作（詳情、開始、暫停、恢復、刪除）參數中的evaluationID傳入 | xxx |
枚舉參數
無
請求示例
請求url
無
請求頭header
無
請求體body
{
"regionID": "xxxxxxxxxxxxxxxxxxxx",
"evaluationName":"buyaosha",
"sourceInfo":[{
"sourceType":"ZOS",
"sourceEndpoint":"//xxxx",
"sourceBucket":"asdf",
"sourceAccessKey":"xxxxx",
"sourceSecretKey":"xxxxxxxxxxxx",
"sourceBucketType":"Bucket",
"evaluationFolder":"",
"evaluationPrefix":""
}],
"destinationInfo":[{
"destinationType":"ZOS"
}]
}
響應示例
{
"returnObj":
{
"result": "success",
"evaluationID": "222_eva_a0d60xxxxxxdbeb0213362217328"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
請參考
錯誤碼
請參考
