全部產品
Search
文件中心

Cloud Backup:AddDataSource - 建立資料來源

更新時間:Mar 31, 2026

建立資料來源。

介面說明

  • 對於本地 NAS 備份功能,支援資料來源類型:本地 NAS(COMMON_NAS)。

  • 對於 CPFS 備份功能,支援資料來源類型:檔案儲存體 CPFS(CPFS),CPFS 智算版(BMCPFS),其他大規模檔案系統(COMMON_FILE_SYSTEM)

  • 對于歸檔功能,支援資料來源類型:本地 NAS(COMMON_NAS),HDFS(HDFS),S3(S3)

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

DataSourceType

string

資料來源類型。

COMMON_NAS

DataSourceName

string

資料來源名稱。

MyLocalNas

Credential

string

資料來源訪問憑證。對於 SMB 協議的本地 NAS 資料來源、OSS 協議相容資料來源和 S3 協議相容資料來源按需填寫。樣本:

  • 本地 NAS 資料來源(SMB 協議): { "mountUsername": "*****", "mountPassword": "*****" }

  • OSS 協議相容資料來源/S3 協議相容資料來源: { "accessKeyId": "*****", "accessKeySecret": "*****" }

{ "mountUsername": "*****", "mountPassword": "*****" }

ConnectionInfo

string

資料來源串連資訊,描述如何訪問這個資料來源。填寫樣本:

  • 本地 NAS 資料來源: { "dataServerAddresses": [ { "host": "123.123.123.123", "port": "8080" } ], "sharePath": "/share", "mountOptions": "vers=3", "fileSystemType": "nfs" }

  • 智算 CPFS 資料來源: {"vpcMountTarget":"cpfs-010wn***wy-vpc-ta***8.cn-shanghai.cpfs.aliyuncs.com","sharePath":"/"}

  • 其他大規模檔案系統資料來源: {"path":"/mnt"}

{ "dataServerAddresses": [ { "host": "123.123.123.123", "port": "8080" } ], "sharePath": "/share", "mountOptions": "vers=3", "fileSystemType": "nfs" }

IndexLevel

string

索引層級。僅用于歸檔功能中的資料來源分析,其他情境請勿使用。

  • OFF:不建立索引

  • META:中繼資料索引

  • ALL:全文索引(已廢棄)

META

ClusterId

string

訪問資料來源使用的用戶端組 ID。

cl-0004i0nlngorvgjpl7ck

Schedule

string

執行循環。僅用于歸檔功能中的資料來源分析,其他情境請勿使用。 格式:I{startTime}{interval}。表示從{startTime}開始每隔{interval}的時間執行一次任務。startTime:起始時間,UNIX 時間,單位為秒。 interval: ISO8601 時間間隔。例如:PT1H 表示間隔一小時。P1D 表示間隔一天。

I|1729493847|P1D

SpeedLimit

string

限流。僅用于歸檔功能中的資料來源分析,其他情境請勿使用。

6:21:10240

Options

string

資料來源分析選項。僅用于歸檔功能中的資料來源分析,其他情境請勿使用。

{}

Include

string

用於描述包含哪些檔案的過濾器。僅用于歸檔功能中的資料來源分析,其他情境請勿使用。

["/home/alice", "/home/bob"]

Exclude

string

用於描述排除哪些檔案的過濾器。僅用于歸檔功能中的資料來源分析,其他情境請勿使用。

["/home/alice/log"]

Path

array

資料來源分析的路徑列表。僅用于歸檔功能中的資料來源分析,其他情境請勿使用。

string

資料來源分析的路徑。僅用于歸檔功能中的資料來源分析,其他情境請勿使用。

/home

返回參數

名稱

類型

描述

樣本值

object

Code

string

錯誤碼。

200

Message

string

添加資料來源返回訊息

successful

RequestId

string

請求 id。

53167AD3-****-****-92C7-CF69A000BA45

Success

boolean

請求是否成功。

true

DataSourceId

string

資料來源 id。

ds-000*******xzj

樣本

正常返回樣本

JSON格式

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "53167AD3-****-****-92C7-CF69A000BA45",
  "Success": true,
  "DataSourceId": "ds-000*******xzj"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情