日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

CreateDataFlowTask - 創建數據流動任務

更新時間:

創建一個數據流動任務。

接口說明

  • 僅 CPFS 2.2.0 及以上版本、CPFS 智算版 2.4.0 及以上版本支持數據流動。您可以在控制臺文件系統詳情頁面查看版本信息。

  • 僅支持在 Running(正常)狀態的數據流動上創建數據流動任務。

  • 數據流動任務是異步執行的,您可通過 DescribeDataFlowTasks 查詢任務執行狀態。任務的耗時取決于需要導入、導出的數據量。如果是大量數據,建議拆分成多個任務執行。

  • 手動執行數據流動任務時,該數據流動的自動數據更新任務會被中斷并等待。

  • 當創建導出任務時,需要確保 CPFS 和智算 CPFS 待導出的文件絕對路徑總長度不能超過 1023 個字符。

  • CPFS 智算版支持批式任務和流式任務兩種任務類型。更多信息,請參見任務類型介紹

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀?。≧ead)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
nas:CreateDataFlowTaskcreate
*DataFlow
acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

請求參數

名稱類型必填描述示例值
FileSystemIdstring

文件系統 ID。

  • CPFS:必須以cpfs-開頭,例如 cpfs-125487****。

  • CPFS 智算版:必須以bmcpfs-開頭,例如 bmcpfs-0015****。

說明 國際站不支持 CPFS。
cpfs-099394bd928c****
DataFlowIdstring

數據流動 ID。

df-194433a5be31****
SrcTaskIdstring

當指定 SrcTaskId 時,需填寫數據流動任務 ID。系統將從目標數據流動任務中復制 TaskAction、DataType 和 EntryList 參數信息,您無需單獨指定這些內容。

說明 不支持數據流動流式任務。
task-29ee8e890f45****
TaskActionstring

數據流動任務類型。

取值:

  • Import:從源端存儲將指定的數據導入至 CPFS。
  • Export:將 CPFS 上指定的數據導出至源端存儲。
  • StreamImport:從源端存儲將指定的數據批量導入至 CPFS。
  • StreamExport:將 CPFS 上指定的數據批量導出至源端存儲。
  • Evict:釋放 CPFS 上文件的數據塊,釋放后文件在 CPFS 上只保留元數據,您仍能查詢該文件,但文件數據塊已清除,不占用 CPFS 上的存儲容量。當訪問該文件數據時,將再從源端存儲按需加載。
  • Inventory:獲取 CPFS 上數據流動管理的文件清單,可提供文件在數據流動中的緩存狀態。
說明 目前 CPFS 智算版只支持 Import、Export、StreamImport 和 StreamExport。StreamImport 和 StreamExport 僅 CPFS 智算版 2.6.0 版本及以上版本支持。
Import
DataTypestring

數據流動任務操作的數據類型。

取值:

  • Metadata:文件的元數據,包括文件的 timestamp、 ownership、permission 等屬性信息。選擇 Metadata,只會導入文件的元數據,用戶只能看到該文件,但訪問該文件數據時,數據從源端存儲按需加載。
  • Data:文件的數據塊。
  • MetaAndData:文件的元數據和數據塊。
Metadata
Directorystring

數據的源目錄。

限制:

  • 長度為 1~1023 個字符。
  • 使用 UTF-8 編碼。
  • 必須以正斜線(/)開頭和結尾。
  • 一次只能列舉一個目錄。
  • 當 TaskAction 為 Export 時,該目錄必須是 FileSystemPath 內的相對路徑。
  • 當 TaskAction 為 Import 時,該目錄必須是 SourceStoragePath 內的相對路徑。
  • 當 TaskAction 為 StreamExport 時,該目錄必須是 FileSystemPath 內的相對路徑。
  • 當 TaskAction 為 StreamImport 時,該目錄必須是 SourceStoragePath 內的相對路徑。
說明 StreamImport 和 StreamExport 僅 CPFS 智算版 2.6.0 版本及以上版本支持。
/path_in_cpfs/
EntryListstring

數據流動任務執行的文件列表。

限制:

  • 使用 UTF-8 編碼。
  • 文件列表總長度小于 64KB。
  • 文件列表采用 JSON 格式。
  • 單個文件路徑長度為 1~1023 個字符,且必須以正斜線(/)開頭。
  • 當 TaskAction 為 Import 時,列表中每個元素代表一個 OSS Object 名稱。
  • 當 TaskAction 為 Export 時,列表中每個元素代表一個 CPFS 文件路徑。
["/path_in_cpfs/file1", "/path_in_cpfs/file2"]
DryRunboolean

是否對此次創建請求執行預檢。

預檢操作會幫助您檢查參數有效性、校驗庫存等,并不會實際創建實例,也不會產生費用。

取值:

  • true:發送檢查請求,不會創建實例。檢查項包括是否填寫了必需參數、請求格式、業務限制和 NAS 庫存。如果檢查不通過,則返回對應錯誤。如果檢查通過,則返回 200 HttpCode,但 TaskId 為空。
  • false(默認值):發送正常請求,通過檢查后直接創建實例。
false
ClientTokenstring

保證請求冪等性,從您的客戶端生成一個參數值,確保不同請求間該參數值唯一。

ClientToken 只支持 ASCII 字符,且不能超過 64 個字符。更多信息,請參見如何保證冪等性。

說明 若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。
123e4567-e89b-12d3-a456-42665544****
ConflictPolicystring

同名文件沖突策略。 取值:

  • SKIP_THE_FILE:跳過同名文件。
  • KEEP_LATEST:比較更新時間,保留最新版本。
  • OVERWRITE_EXISTING:強制覆蓋同名文件。
說明 當文件系統類型為 cpfs 智算版時,該參數必填。
SKIP_THE_FILE
DstDirectorystring

數據流動任務映射目標目錄。 限制:

  • 必須以正斜線(/)開頭和結尾,不支持/../。
  • 長度為 1~1023 個字符。
  • 使用 UTF-8 編碼。
  • 一次只能列舉一個目錄。
  • 當 TaskAction 為 Export 時,該目錄必須是 SourceStoragePath 內的相對路徑。
  • 當 TaskAction 為 Import 時,該目錄必須是 FileSystemPath 內的相對路徑。
  • 當 TaskAction 為 StreamExport 時,該目錄必須是 SourceStoragePath 內的相對路徑。
  • 當 TaskAction 為 StreamImport 時,該目錄必須是 FileSystemPath 內的相對路徑。
說明 StreamImport 和 StreamExport 僅 CPFS 智算版 2.6.0 版本及以上版本支持。
/path_in_cpfs/
CreateDirIfNotExistboolean

目錄不存在時,自動創建目錄。 取值:

  • true:自動創建目錄。
  • false(默認值):不自動創建目錄。
說明
  • TaskAction = Import 時,該參數生效。
  • 僅 CPFS 智算版 2.6.0 版本及以上版本支持。
  • false

    返回參數

    名稱類型描述示例值
    object
    RequestIdstring

    請求 ID。

    2D69A58F-345C-4FDE-88E4-BF518948****
    TaskIdstring

    數據流動任務 ID。

    task-38aa8e890f45****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****",
      "TaskId": "task-38aa8e890f45****"
    }

    錯誤碼

    HTTP status code錯誤碼錯誤信息描述
    400IllegalCharactersThe parameter contains illegal characters.參數非法。
    400MissingFileSystemIdFileSystemId is mandatory for this action.未指定FileSystemId參數。
    400MissingDataFlowIdDataFlowId is mandatory for this action.未指定DataFlowId參數。
    400InvalidFilesystemVersion.NotSupportThis Api does not support this fileSystem version.當前接口不支持該版本文件系統。
    403OperationDenied.InvalidStateThe operation is not permitted when the status is processing.狀態處理中不允許此操作。
    403OperationDenied.DependencyViolationThe operation is denied due to dependancy violation.進行該操作的條件不滿足。
    403OperationDenied.DataFlowNotSupportedThe operation is not supported.該文件系統不支持數據流動。
    404InvalidParameter.InvalidFormatThe EntryList format is invalid.指定的EntryList的格式不符合要求。
    404InvalidParameter.SizeTooLargeThe specified EntryList size exceeds 64 KB.指定的EntryList的大小超過64 KB。
    404InvalidDataFlow.NotFoundThe specified data flow does not exist.指定的數據流動不存在。
    404InvalidTaskAction.NotSupportedThe task action is not supported.指定的任務類型不支持。
    404InvalidTaskAction.PermissionDeniedThe task action is not allowed.指定的任務類型不允許,例如復制系統。
    404InvalidSrcTaskId.NotFoundThe SrcTaskId is not found.指定的 SrcTaskId 不存在。
    404InvalidDataType.NotSupportedThe data type is not supported.指定的數據類型不支持。
    404InvalidSrcTaskId.TaskIdInvalidSource task ID is invalid.指定的需要復制的任務 ID 非法
    404InvalidSrcTaskId.TaskIdNotFoundSource task ID is not found.指定的需要復制的任務 ID 不存在。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    變更時間變更內容概要操作
    2024-09-09OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更查看變更詳情
    2024-02-29OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更查看變更詳情