All Products
Search

This Product

    Cloud Backup:CreateBackupJob

    Document Center

    Cloud Backup:CreateBackupJob

    Last Updated:Jun 11, 2026

    Membuat tugas pencadangan.

    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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    JobName

    string

    No

    Nama tugas pencadangan.

    k8s-backup-infra-20220131150046-hbr
    SourceType

    string

    Yes

    Tipe sumber data. Nilai yang valid:

    • UDM_ECS: instans Elastic Compute Service (ECS)

    Valid values:

    • UDM_ECS :

    CONTAINER
    Retention

    integer

    No

    Periode retensi data cadangan. Satuan: hari.

    15
    InstanceId

    string

    No

    Parameter ini wajib hanya jika Anda menetapkan parameter SourceType ke UDM_ECS. Parameter ini menentukan ID instans ECS.

    i-bp1xxxxxxxxxxxxxxysm
    Detail

    object

    No

    Parameter ini wajib hanya jika Anda menetapkan parameter SourceType ke UDM_ECS. Nilainya adalah string JSON. Nilai yang valid:

    • doCopy: menentukan apakah akan mengaktifkan replikasi jarak jauh.

    • destinationRegionId: region tujuan untuk replikasi jarak jauh.

    • destinationRetention: periode retensi titik cadangan untuk replikasi jarak jauh.

    • diskIdList: ID disk yang akan dicadangkan. Jika parameter ini dikosongkan, semua disk akan dicadangkan.

    • snapshotGroup: menentukan apakah akan menggunakan grup snapshot yang konsisten. Parameter ini hanya valid jika semua disk instans ECS adalah Enterprise SSD (ESSD).

    • appConsistent: menentukan apakah akan menggunakan fitur pencadangan konsisten aplikasi. Parameter ini harus digunakan bersama parameter preScriptPath dan postScriptPath.

    • preScriptPath: jalur ke skrip pre-freeze.

    • postScriptPath: jalur ke skrip post-thaw.

    • enableWriters: Parameter ini wajib hanya jika Anda menetapkan parameter AppConsistent ke true. Parameter ini menentukan apakah akan membuat snapshot konsisten aplikasi.

      • true: membuat snapshot konsisten aplikasi.

      • false: membuat snapshot konsisten sistem file.

    • enableFsFreeze: Parameter ini wajib hanya jika Anda menetapkan parameter AppConsistent ke true. Parameter ini menentukan apakah akan mengaktifkan Linux fsfreeze untuk menempatkan sistem file ke status read-only sebelum snapshot konsisten aplikasi dibuat. Nilai default: true.

    • timeoutSeconds: Parameter ini wajib hanya jika Anda menetapkan parameter AppConsistent ke true. Parameter ini menentukan periode batas waktu pembekuan I/O. Nilai default: 30. Satuan: detik.

    { "doCopy": false, "destinationRegionId": "", "destinationRetention": null, "diskIdList": [], "snapshotGroup": false, "appConsistent": false, "enableWriters": true, "preScriptPath": "", "postScriptPath": "", "enableFsFreeze": true, "timeoutInSeconds": 60 }
    BackupType

    string

    No

    Tipe pencadangan. Parameter ini wajib hanya jika Anda menetapkan parameter SourceType ke UDM_ECS.

    • COMPLETE: pencadangan penuh

    Valid values:

    • COMPLETE :

    INCREMENTAL
    VaultId

    string

    No

    ID vault cadangan. Parameter ini tidak wajib jika Anda menetapkan parameter SourceType ke UDM_ECS.

    v-000xxxxxxxxxxxxxxy1v
    SpeedLimit

    string

    No

    Parameter ini tidak berlaku jika Anda menetapkan parameter SourceType ke UDM_ECS. Parameter ini menentukan aturan throttling. Format: {start}|{end}|{bandwidth}. Pisahkan beberapa aturan throttling dengan garis vertikal (|). Rentang waktu yang ditentukan tidak boleh tumpang tindih dengan rentang waktu lainnya.

    • start: jam mulai.

    • end: jam akhir.

    • bandwidth: bandwidth. Satuan: KB/s.

    0:24:NaN
    Options

    string

    No

    Anda tidak perlu menentukan parameter ini.

    {"UseVSS":false}
    Include

    string

    No

    Parameter ini tidak berlaku jika Anda menetapkan parameter SourceType ke UDM_ECS. Parameter ini menentukan jalur ke file yang dicadangkan. Nilainya dapat memiliki panjang hingga 255 karakter.

    ["/home/alice/*.pdf", "/home/bob/*.txt"]
    Exclude

    string

    No

    Parameter ini tidak berlaku jika Anda menetapkan parameter SourceType ke UDM_ECS. Parameter ini menentukan jalur ke file yang dikecualikan dari tugas pencadangan. Nilainya dapat memiliki panjang hingga 255 karakter.

    ["/var", "/proc"]
    ClusterId

    string

    No

    Anda tidak perlu menentukan parameter ini.

    cl-00068btz******oku
    ContainerResources

    string

    No

    Anda tidak perlu menentukan parameter ini.

    [{\"resourceType\":\"PV\",\"backupMethod\":\"FILE\",\"resourceId\":\"674dac6d-74cd-47e9-a675-09e2f10d2c45\",\"resourceInfo\":\"{\\\"pv_name\\\":\\\"nas-650dac6d-74cd-47e9-a675-09e2f10d2c45\\\",\\\"pv_size\\\":\\\"8Gi\\\",\\\"storage_class\\\":\\\"alibabacloud-cnfs-nas\\\",\\\"pvc_name\\\":\\\"data-postgresql-default-0\\\",\\\"namespace\\\":\\\"database\\\"}\",\"host\":\"cn-huhehaote.192.168.13.133\",\"hostPrefix\":\"6f5e758e-8d35-4584-b9ce-8333adfc7547/volumes/kubernetes.io~csi/nas-670dac6d-74cd-47e9-a675-09e2f10d2c45/mount\",\"pvPath\":\"/\"}]
    InitiatedByAck

    boolean

    No

    false atau dikosongkan

    false
    ContainerClusterId

    string

    No

    Anda tidak perlu menentukan parameter ini.

    cc-000xxxxxxxxxxxxxxi00
    CrossAccountType

    string

    No

    Menentukan apakah data dicadangkan dalam akun Alibaba Cloud yang sama atau lintas akun Alibaba Cloud. Nilai yang valid:

    • SELF_ACCOUNT: Data dicadangkan dalam akun Alibaba Cloud yang sama.

    • CROSS_ACCOUNT: Data dicadangkan lintas akun Alibaba Cloud.

    SELF_ACCOUNT
    CrossAccountUserId

    integer

    No

    ID akun Alibaba Cloud sumber yang memberikan otorisasi kepada akun Alibaba Cloud saat ini untuk mencadangkan data lintas akun Alibaba Cloud.

    158975xxxxxx4625
    CrossAccountRoleName

    string

    No

    Nama peran RAM yang dibuat dalam akun Alibaba Cloud sumber dan ditetapkan ke akun Alibaba Cloud saat ini untuk memberikan otorisasi kepada akun Alibaba Cloud saat ini untuk mencadangkan data lintas akun Alibaba Cloud.

    BackupRole

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Code

    string

    Kode status HTTP. Kode status 200 menunjukkan bahwa permintaan berhasil.

    200
    Message

    string

    Pesan yang dikembalikan. Jika permintaan berhasil, "successful" akan dikembalikan. Jika permintaan gagal, pesan kesalahan akan dikembalikan.

    successful
    RequestId

    string

    ID permintaan.

    25F49E7B-7E39-542E-83AD-62E6E7F73786
    Success

    boolean

    Menunjukkan apakah permintaan berhasil. Nilai yang valid:

    • true

    • false

    true
    JobId

    string

    ID tugas pencadangan.

    job-000csy09q50a2jdcbwbo

    Contoh

    Respons sukses

    JSONformat

    {
  "Code": "200",
  "Message": "successful",
  "RequestId": "25F49E7B-7E39-542E-83AD-62E6E7F73786",
  "Success": true,
  "JobId": "job-000csy09q50a2jdcbwbo"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.