查詢資料流動批量子任務。
介面說明
僅 CPFS 智算版 2.6.0 及以上版本支援。您可以在控制台檔案系統詳情頁面查看版本資訊。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
nas:DescribeDataFlowSubTasks |
list |
*DataFlow
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| FileSystemId |
string |
是 |
檔案系統 ID。 |
bmcpfs-370lx1ev9ss27o0**** |
| Filters |
array<object> |
否 |
查詢資料流動流式任務的篩選鍵。 |
|
|
object |
否 |
|||
| Key |
string |
否 |
篩選鍵的名稱。 取值：
|
DataFlowSubTaskIds |
| Value |
string |
否 |
篩選鍵的值。該參數不支援萬用字元。
|
subTaskId-370kyfmyknxcyzw**** |
| NextToken |
string |
否 |
當請求的返回結果被截斷時，您可以使用 NextToken 再次發起請求，擷取從當前截斷位置之後的內容。 |
iWk0AQAAAAAvY2FzZS8= |
| MaxResults |
integer |
否 |
每次查詢結果的個數限制。
|
20 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
98696EF0-1607-4E9D-B01D-F20930B6**** |
| NextToken |
string |
當請求的返回結果被截斷時，您可以使用 NextToken 再次發起請求，擷取從當前截斷位置之後的內容。 |
pUJaUwAAAABhdGUyNTk1MQ== |
| DataFlowSubTask |
object |
||
| DataFlowSubTask |
array<object> |
資料流動流式任務資訊合集。 |
|
|
array<object> |
|||
| FileSystemId |
string |
檔案系統 ID。 |
bmcpfs-370lx1ev9ss27o0**** |
| DataFlowId |
string |
資料流動 ID。 |
df-194433a5be31**** |
| DataFlowTaskId |
string |
資料流動任務 ID。 |
task-38aa8e890f45**** |
| DataFlowSubTaskId |
string |
資料流動流式任務 ID。 |
subTaskId-370kyfmyknxcyzw**** |
| SrcFilePath |
string |
源檔案路徑。 限制：
|
/test/file.png |
| DstFilePath |
string |
目標檔案路徑。 限制：
|
/mnt/file.png |
| Status |
string |
當前資料流動流式任務狀態。包括：
|
FAILED |
| Progress |
integer |
資料流動流式任務的執行進度。範圍：0~10000。 |
10000 |
| CreateTime |
string |
流式任務建立時間。 |
2024-07-01 19:59:29 |
| StartTime |
string |
流式任務開始執行時間。 |
2024-07-03 10:43:16 |
| EndTime |
string |
流式任務結束時間。 |
2024-07-04 11:14:22 |
| ErrorMsg |
string |
任務執行失敗訊息。 說明
當該欄位未返回或者返回為空白時，表示沒有錯誤資訊。 |
file does not exist |
| ProgressStats |
object |
資料流動流式進度資訊。 |
|
| BytesTotal |
integer |
源端掃描到資料量。單位：Byte。 |
68 |
| BytesDone |
integer |
已完成資料流動資料量（包括跳過資料）。單位：Byte。 |
68 |
| ActualBytes |
integer |
實際流動資料量。單位：Byte。 |
68 |
| AverageSpeed |
integer |
平均流動速度。單位：Byte/s。 |
34 |
| FileDetail |
object |
檔案資訊。 |
|
| ModifyTime |
integer |
檔案修改時間，unix 時間戳記。單位：ns。 |
1725897600000000000 |
| Size |
integer |
檔案大小。單位：Byte。 |
68 |
| Checksum |
string |
檔案校正碼。格式樣本：crc64:123456。 |
crc64:850309505450944**** |
樣本
正常返回樣本
JSON格式
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
"NextToken": "pUJaUwAAAABhdGUyNTk1MQ==",
"DataFlowSubTask": {
"DataFlowSubTask": [
{
"FileSystemId": "bmcpfs-370lx1ev9ss27o0****\n",
"DataFlowId": "df-194433a5be31****\n",
"DataFlowTaskId": "task-38aa8e890f45****",
"DataFlowSubTaskId": "subTaskId-370kyfmyknxcyzw****\n",
"SrcFilePath": "/test/file.png\n",
"DstFilePath": "/mnt/file.png\n",
"Status": "FAILED",
"Progress": 10000,
"CreateTime": "2024-07-01 19:59:29",
"StartTime": "2024-07-03 10:43:16",
"EndTime": "2024-07-04 11:14:22",
"ErrorMsg": "file does not exist",
"ProgressStats": {
"BytesTotal": 68,
"BytesDone": 68,
"ActualBytes": 68,
"AverageSpeed": 34
},
"FileDetail": {
"ModifyTime": 1725897600000000000,
"Size": 68,
"Checksum": "crc64:850309505450944****"
}
}
]
}
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | IllegalCharacters | The parameter contains illegal characters. | 參數非法。 |
| 400 | MissingFileSystemId | FileSystemId is mandatory for this action. | 未指定FileSystemId參數。 |
| 400 | InvalidFilesystemVersion.NotSupport | This Api does not support this fileSystem version. | 當前介面不支援該版本檔案系統。 |
| 403 | OperationDenied.DataFlowNotSupported | The operation is not supported. | 該檔案系統不支援資料流動。 |
| 404 | InvalidParameter.InvalidNextToken | The specified NextToken is invaild. | |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定的檔案系統不存在。 |
| 404 | InvalidDataFlow.NotFound | The specified data flow does not exist. | 指定的資料流動不存在。 |
| 404 | InvalidParameter.InvalidMaxResults | The specified MaxResults is invalid. | 指定的MaxResults非法。 |
| 404 | InvalidFilterParam | The specified Filter.N.Key is invalid. | 指定的Filter.N.Key參數非法。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。