All Products
Search

This Product

    Cloud Backup:AddDataSource

    Document Center

    Cloud Backup:AddDataSource

    Last Updated:Oct 26, 2026

    Membuat sumber data.

    Deskripsi operasi

    • Untuk fitur pencadangan NAS lokal, tipe sumber data yang didukung adalah NAS lokal (COMMON_NAS).

    • Untuk fitur pencadangan CPFS, tipe sumber data yang didukung adalah Cloud Parallel File Storage (CPFS), CPFS for AI (BMCPFS), dan sistem file skala Tingkat Tinggi lainnya (COMMON_FILE_SYSTEM).

    • Untuk fitur pengarsipan, tipe sumber data yang didukung adalah NAS lokal (COMMON_NAS), HDFS (HDFS), dan S3 (S3).

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    hbr:AddDataSource

    create

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DataSourceType

    string

    Yes

    Tipe sumber data.

    COMMON_NAS
    DataSourceName

    string

    Yes

    Nama sumber data.

    MyLocalNas
    Credential

    string

    No

    Kredensial akses untuk sumber data. Tentukan parameter ini sesuai kebutuhan untuk sumber data NAS lokal yang menggunakan protokol SMB, sumber data yang kompatibel dengan protokol OSS, dan sumber data yang kompatibel dengan protokol S3. Contoh:

    • Sumber data NAS lokal (protokol SMB): { "mountUsername": "*****", "mountPassword": "*****" }

    • Sumber data yang kompatibel dengan protokol OSS atau sumber data yang kompatibel dengan protokol S3: { "accessKeyId": "*****", "accessKeySecret": "*****" }

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

    string

    No

    Informasi koneksi sumber data, yang menjelaskan cara mengakses sumber data. Contoh:

    • Sumber data NAS lokal: { "dataServerAddresses": [ { "host": "123.123.123.123", "Port": "8080" } ], "sharePath": "/share", "mountOptions": "vers=3", "fileSystemType": "nfs" }

    • Sumber data CPFS for AI: {"vpcMountTarget":"cpfs-010wn***wy-vpc-ta***8.cn-shanghai.cpfs.aliyuncs.com","sharePath":"/"}

    • Sumber data sistem file skala Tingkat Tinggi lainnya: {"path":"/mnt"}

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

    string

    No

    Tingkat indeks. Parameter ini hanya digunakan untuk analisis sumber data dalam fitur pengarsipan. Jangan gunakan parameter ini di skenario lain. Nilai valid:

    • OFF: tidak ada indeks yang dibuat

    • META: indeks metadata

    • ALL: indeks teks lengkap ([Deprecated])

    META
    ClusterId

    string

    No

    ID kelompok Klien yang digunakan untuk mengakses sumber data.

    cl-0004i0nlngorvgjpl7ck
    Schedule

    string

    No

    Siklus eksekusi. Parameter ini hanya digunakan untuk analisis sumber data dalam fitur pengarsipan. Jangan gunakan parameter ini di skenario lain. Format: I{startTime}{interval}. Ini menunjukkan bahwa Tugas dijalankan dengan interval {interval} mulai dari {startTime}. startTime: Waktu mulai, yang merupakan Stempel waktu UNIX dalam detik. interval: interval pengatur waktu ISO 8601. Misalnya, PT1H menunjukkan interval satu jam, dan P1D menunjukkan interval satu hari.

    I|1729493847|P1D
    SpeedLimit

    string

    No

    Batas Pembatasan kecepatan. Parameter ini hanya digunakan untuk analisis sumber data dalam fitur pengarsipan. Jangan gunakan parameter ini di skenario lain.

    6:21:10240
    Options

    string

    No

    Opsi analisis sumber data. Parameter ini hanya digunakan untuk analisis sumber data dalam fitur pengarsipan. Jangan gunakan parameter ini di skenario lain.

    {}
    Include

    string

    No

    Filter yang menentukan file yang akan disertakan. Parameter ini hanya digunakan untuk analisis sumber data dalam fitur pengarsipan. Jangan gunakan parameter ini di skenario lain.

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

    string

    No

    Filter yang menentukan file yang akan dikecualikan. Parameter ini hanya digunakan untuk analisis sumber data dalam fitur pengarsipan. Jangan gunakan parameter ini di skenario lain.

    ["/home/alice/log"]
    Path

    array

    No

    Daftar jalur untuk analisis sumber data. Parameter ini hanya digunakan untuk analisis sumber data dalam fitur pengarsipan. Jangan gunakan parameter ini di skenario lain.

    string

    No

    Jalur untuk analisis sumber data. Parameter ini hanya digunakan untuk analisis sumber data dalam fitur pengarsipan. Jangan gunakan parameter ini di skenario lain.

    /home

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Code

    string

    Kode kesalahan.

    200
    Message

    string

    Paket yang dikembalikan saat sumber data ditambahkan.

    successful
    RequestId

    string

    ID permintaan.

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

    boolean

    Apakah permintaan berhasil.

    true
    DataSourceId

    string

    ID sumber data.

    ds-000*******xzj

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.