All Products
Search

This Product

    Cloud Backup:UpdateBackupPlan

    Document Center

    Cloud Backup:UpdateBackupPlan

    Last Updated:Oct 26, 2026

    Memperbarui rencana cadangan.

    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:UpdateBackupPlan

    update

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    PlanId

    string

    Yes

    ID rencana cadangan.

    plan-20211***735
    PlanName

    string

    No

    Nama rencana cadangan.

    planname
    Schedule

    string

    No

    Kebijakan cadangan. Format valid: I|{startTime}|{interval}. Format ini menentukan bahwa pekerjaan cadangan dijalankan dengan interval {interval} mulai dari {startTime}. Pekerjaan cadangan untuk waktu yang lalu tidak dikompensasi. Jika pekerjaan cadangan sebelumnya belum selesai, pekerjaan cadangan berikutnya tidak akan dipicu. Misalnya, I|1631685600|P1D menentukan bahwa cadangan dilakukan setiap hari mulai dari 2021-09-15 14:00:00.

    • startTime: Waktu mulai cadangan. Nilainya adalah stempel waktu UNIX dalam detik.

    • interval: Interval waktu ISO 8601. Misalnya, PT1H menentukan interval satu jam. P1D menentukan interval satu hari.

    I|1602673264|P1D
    Retention

    integer

    No

    Periode retensi cadangan dalam hari. Nilai minimum adalah 1.

    7
    Prefix

    string

    No

    Awalan cadangan. Parameter ini hanya diperlukan ketika SourceType diatur ke OSS. Setelah parameter ini ditentukan, hanya objek yang namanya cocok dengan awalan yang akan dicadangkan.

    oss-prefix
    VaultId

    string

    No

    ID penyimpanan cadangan.

    v-0006******q
    Detail

    object

    No

    Detail cadangan Instance ECS. Nilainya adalah string JSON.

    • snapshotGroup: Apakah akan menggunakan kelompok snapshot yang konsisten. Ini hanya valid ketika semua cloud disk Instans adalah ESSD.

    • appConsistent: Apakah akan menggunakan konsistensi aplikasi. Parameter ini harus digunakan bersama dengan parameter preScriptPath dan postScriptPath.

    • preScriptPath: Jalur skrip pra-membekukan.

    • postScriptPath: Jalur skrip pasca-pencairan.

    {\"EnableFsFreeze\":true,\"appConsistent\":false,\"postScriptPath\":\"\",\"preScriptPath\":\"\",\"snapshotGroup\":true,\"timeoutInSeconds\":60}
    SourceType

    string

    No

    Tipe sumber data. Nilai valid:

    • ECS_FILE: File ECS.

    • OSS: Alibaba Cloud OSS.

    • NAS: Alibaba Cloud NAS.

    • OTS: Alibaba Cloud Tablestore.

    • UDM_ECS: Instance ECS.

    ECS_FILE
    SpeedLimit

    string

    No

    Pembatasan kecepatan untuk trafik cadangan. Parameter ini hanya diperlukan ketika SourceType diatur ke ECS_FILE. Pembatasan kecepatan membantu Anda mengontrol trafik file cadangan selama jam sibuk untuk mencegah dampak pada bisnis normal. Formatnya adalah {start}|{end}|{bandwidth}. Beberapa konfigurasi pembatasan kecepatan dipisahkan oleh garis vertikal (|), dan periode waktu yang dikonfigurasi tidak boleh tumpang tindih.

    • start: Jam mulai.

    • end: Jam selesai.

    • bandwidth: Batas bandwidth dalam KB/s.

    0:24:5120
    Include

    string

    No

    Jalur yang akan dicadangkan. Semua file di jalur yang ditentukan akan dicadangkan. Parameter ini hanya diperlukan ketika SourceType diatur ke ECS_FILE. Panjang nilai dapat mencapai 255 karakter.

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

    string

    No

    Jalur yang akan dikecualikan dari cadangan. Semua file di jalur yang ditentukan tidak akan dicadangkan. Parameter ini hanya diperlukan ketika SourceType diatur ke ECS_FILE. Panjang nilai dapat mencapai 255 karakter.

    ["/var", "/proc"]
    Options

    string

    No

    Apakah akan menggunakan Volume Shadow Copy Service (VSS) untuk menentukan jalur cadangan untuk Windows. Parameter ini hanya diperlukan ketika SourceType diatur ke ECS_FILE.

    • Fitur ini hanya didukung untuk Instance ECS Windows.

    • Jika data di sumber cadangan berubah dan Anda perlu memastikan konsistensi antara data cadangan dan data sumber, atur parameter ini ke ["UseVSS":true].

    • Jika Anda menggunakan VSS, Anda tidak dapat mencadangkan beberapa folder file pada waktu yang sama.

    {"UseVSS":false}
    UpdatePaths

    boolean

    No

    Apakah akan memperbarui jalur sumber ketika jalur sumber kosong. Nilai valid:

    • true: memperbarui jalur sumber berdasarkan jalur yang ditentukan dalam operasi ini.

    • false: tidak memperbarui jalur sumber. Cadangan berlanjut berdasarkan jalur yang ditentukan saat rencana cadangan dibuat.

    false
    Path

    array

    No

    Jalur cadangan.

    string

    No

    Jalur sumber. Panjang nilai dapat mencapai 65.536 karakter. Jalur sumber harus memenuhi aturan berikut:

    • Jika tidak ada wildcard (*) yang digunakan, Anda dapat memasukkan hingga 20 baris jalur.

    • Jika wildcard (*) digunakan, Anda hanya dapat memasukkan satu baris jalur. Wildcard seperti /*/* didukung.

    • Hanya jalur absolut yang didukung di setiap baris.

    • Jika VSS digunakan, beberapa jalur, jalur UNC, wildcard, dan file yang dikecualikan tidak didukung.

    • Jika UNC digunakan, VSS, wildcard, dan file yang dikecualikan tidak didukung. Jika sumber cadangan berisi jalur UNC, ACL Windows tidak akan dicadangkan.

    ["/home"]
    Rule

    array<object>

    No

    Aturan rencana cadangan.

    object

    No

    DestinationRetention

    integer

    No

    Periode retensi cadangan geo-redundan dalam hari.

    7
    Schedule

    string

    No

    Kebijakan cadangan. Format valid: I|{startTime}|{interval}. Format ini menentukan bahwa pekerjaan cadangan dijalankan dengan interval {interval} mulai dari {startTime}. Pekerjaan cadangan untuk waktu yang lalu tidak dijalankan. Jika pekerjaan cadangan sebelumnya belum selesai, pekerjaan cadangan berikutnya tidak akan dipicu. Misalnya, I|1631685600|P1D menentukan bahwa cadangan dilakukan setiap hari mulai dari 2021-09-15 14:00:00.

    startTime: Waktu mulai cadangan. Nilainya adalah stempel waktu UNIX dalam detik. interval: Interval waktu ISO 8601. Misalnya, PT1H menentukan interval satu jam. P1D menentukan interval satu hari.

    I|1631685600|P1D
    Disabled

    boolean

    No

    Apakah kebijakan dinonaktifkan.

    false
    Retention

    integer

    No

    Periode retensi cadangan dalam hari. Nilai minimum adalah 1.

    7
    DoCopy

    boolean

    No

    Apakah akan mengaktifkan replikasi lintas wilayah.

    false
    DestinationRegionId

    string

    No

    ID wilayah tujuan untuk cadangan geo-redundan.

    cn-shanghai
    RuleName

    string

    No

    Nama kebijakan.

    rule-test-name
    BackupType

    string

    No

    Tipe cadangan. Nilai valid: COMPLETE, yang menentukan cadangan penuh.

    COMPLETE
    OtsDetail OtsDetail

    No

    Detail Instans Tablestore.

    KeepLatestSnapshots

    integer

    No

    Apakah akan mempertahankan setidaknya satu versi cadangan. Nilai valid:

    • 0: tidak mempertahankan.

    • 1: mempertahankan.

    1
    ChangeListPath

    string

    No

    Konfigurasi daftar sinkronisasi file inkremental. Parameter ini hanya diperlukan untuk sinkronisasi.

    {"dataSourceId": "ds-123456789", "path": "/changelist"}
    Edition

    string

    No

    Tipe edisi. Nilai valid: BASIC dan STANDARD. Nilai default: STANDARD.

    STANDARD

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Code

    string

    Kode status HTTP. Nilai 200 menunjukkan bahwa permintaan berhasil.

    200
    Message

    string

    Paket yang dikembalikan. Jika permintaan berhasil, "successful" dikembalikan. Jika terjadi error, pesan error yang sesuai dikembalikan.

    successful
    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    Success

    boolean

    Menunjukkan apakah permintaan berhasil. Nilai valid:

    • true: Permintaan berhasil.

    • false: Permintaan gagal.

    true

    Contoh

    Respons sukses

    JSONformat

    {
  "Code": "200",
  "Message": "successful",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Success": true
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.