All Products
Search

This Product

    ApsaraDB for MongoDB:ModifyBackupPolicy

    Document Center

    ApsaraDB for MongoDB:ModifyBackupPolicy

    Last Updated:Jun 10, 2026

    Mengubah kebijakan cadangan instans MongoDB.

    Deskripsi operasi

    Geo-redundancy is available only for replica set instances and sharded cluster instances that use cloud disks.

    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

    dds:ModifyBackupPolicy

    update

    *Instance

    acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DBInstanceId

    string

    Yes

    ID instans.

    dds-bp16cb162771****
    PreferredBackupTime

    string

    No

    Pengatur waktu untuk melakukan cadangan. Tentukan waktu dalam format HH:mmZ-HH:mmZ. Waktu ditampilkan dalam Coordinated Universal Time (UTC).

    Catatan

    Pengatur waktu harus 1 jam.

    03:00Z-04:00Z
    PreferredBackupPeriod

    string

    No

    Siklus cadangan. Nilai valid:

    • Monday

    • Tuesday

    • Wednesday

    • Thursday

    • Friday

    • Saturday

    • Sunday

    Penting

    Untuk memastikan keamanan data, cadangkan instans MongoDB setidaknya dua kali seminggu.

    Catatan

    Untuk menentukan beberapa siklus cadangan, pisahkan dengan koma (,).

    Monday,Wednesday,Friday,Sunday
    BackupRetentionPeriod

    integer

    No

    Jumlah hari untuk menyimpan cadangan penuh.

    Catatan

    • Untuk instans yang dibuat sebelum 10 September 2021, periode retensi default adalah 7 hari.

    • Untuk instans yang dibuat setelah 10 September 2021, periode retensi default adalah 30 hari.

    30
    EnableBackupLog

    integer

    No

    Apakah akan mengaktifkan cadangan log. Nilai valid:

    • 0: Menonaktifkan cadangan log. Ini adalah nilai default.

    • 1: Mengaktifkan cadangan log.

    Penting

    Anda tidak dapat menonaktifkan cadangan log untuk instans kluster sharded.

    .

    0
    LogBackupRetentionPeriod

    integer

    No

    Jumlah hari untuk menyimpan cadangan log. Nilai default: 7.

    Nilai valid: 7 hingga 730.

    7
    SnapshotBackupType

    string

    No

    Tipe Cadangan snapshot. Nilai valid:

    • Flash: cadangan tingkat detik.

    • Jenis Penyimpanan Standar: cadangan konvensional. Ini adalah nilai default.

    Standard
    BackupInterval

    string

    No

    Frekuensi cadangan Frekuensi tinggi. Nilai valid:

    • -1: Cadangan frekuensi tinggi dinonaktifkan.

    • 30: setiap 30 menit.

    • 60: setiap 1 jam.

    • 120: setiap 2 jam.

    • 180: setiap 3 jam.

    • 240: setiap 4 jam.

    • 360: setiap 6 jam.

    • 480: setiap 8 jam.

    • 720: setiap 12 jam.

    Catatan

    • Jika Anda menetapkan SnapshotBackupType ke Jenis Penyimpanan Standar, nilai parameter ini adalah -1.

    • Cadangan frekuensi tinggi hanya berlaku jika Anda menetapkan SnapshotBackupType ke Flash dan menetapkan parameter ini ke nilai yang lebih besar dari 0.

    -1
    HighFrequencyBackupRetention

    integer

    No

    Jumlah hari untuk menyimpan cadangan frekuensi tinggi. Sebelum menentukan parameter ini, Anda harus menetapkan parameter BackupInterval. Periode retensi default adalah 1 hari.

    1
    BackupRetentionPolicyOnClusterDeletion

    integer

    No

    Kebijakan untuk menyimpan cadangan saat Anda merilis instans.

    • 0: Semua set cadangan instans dihapus saat instans dirilis.

    • 1: Cadangan Otomatis dilakukan saat instans dirilis, dan cadangan ini disimpan dalam Kata kunci jangka panjang.

    • 2: Cadangan Otomatis dilakukan saat instans dirilis, dan semua set cadangan instans disimpan dalam Kata kunci jangka panjang.

    Untuk informasi lebih lanjut, lihat Retensi cadangan jangka panjang.

    2
    CrossBackupType

    string

    No

    Kebijakan untuk cadangan geo-redundan. Nilai valid:

    • update: Mengubah kebijakan geo-redundansi.

    • delete: Menghapus kebijakan geo-redundansi.

    Catatan

    Parameter ini diperlukan jika Anda mengaktifkan geo-redundansi.

    update
    SrcRegion

    string

    No

    ID Wilayah Instans.

    Catatan

    • Parameter ini diperlukan jika Anda memulihkan Instans yang dihapus.

    • Parameter ini diperlukan jika Anda mengaktifkan geo-redundansi.

    cn-beijing
    DestRegion

    string

    No

    ID Wilayah cadangan geo-redundan.

    Catatan

    Parameter ini diperlukan jika Anda mengaktifkan geo-redundansi.

    cn-hangzhou
    CrossRetentionType

    string

    No

    Kebijakan retensi untuk cadangan geo-redundan. Nilai valid:

    • delay: Menyimpan cadangan untuk periode tertentu.

    • never: Menyimpan cadangan secara permanen.

    Catatan

    Parameter ini diperlukan jika Anda mengaktifkan geo-redundansi.

    delay
    CrossRetentionValue

    integer

    No

    Jumlah hari untuk menyimpan cadangan geo-redundan. Nilai valid: 3 hingga 1825.

    Catatan

    • Parameter ini diperlukan jika Anda mengaktifkan geo-redundansi.

    • Parameter ini diperlukan jika Anda menetapkan CrossRetentionType ke delay.

    7
    CrossBackupPeriod

    string

    No

    Hari dalam seminggu untuk melakukan cadangan geo-redundan. Nilai valid:

    1. Monday

    2. Tuesday

    3. Wednesday

    4. Thursday

    5. Friday

    6. Saturday

    7. Sunday

    Catatan

    Parameter ini diperlukan jika Anda mengaktifkan geo-redundansi.

    • Untuk menentukan beberapa hari, pisahkan dengan koma (,).

    • Jika Anda menetapkan metode cadangan ke cadangan konvensional, hari dalam seminggu yang ditentukan oleh parameter ini harus merupakan subset dari hari dalam seminggu yang ditentukan oleh PreferredBackupPeriod.

    Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday
    EnableCrossLogBackup

    integer

    No

    Apakah akan mengaktifkan cadangan log lintas wilayah. Nilai valid:

    Catatan

    Parameter ini diperlukan jika Anda mengaktifkan geo-redundansi.

    • 1: Mengaktifkan cadangan log lintas wilayah. Nilai ini diperlukan untuk instans kluster sharded. Nilai ini juga diperlukan untuk instans replica set jika Anda ingin mengaktifkan pemulihan point-in-pengatur waktu geo-redundan.

    • 0: Menonaktifkan cadangan log lintas wilayah.

    1
    CrossLogRetentionType

    string

    No

    Kebijakan retensi untuk cadangan log lintas wilayah. Nilai valid:

    • delay: Menyimpan cadangan untuk periode tertentu.

    • never: Menyimpan cadangan secara permanen.

    Catatan

    Parameter ini diperlukan jika Anda mengaktifkan geo-redundansi.

    delay
    CrossLogRetentionValue

    integer

    No

    Jumlah hari untuk menyimpan cadangan log lintas wilayah. Nilai valid: 3 hingga 1825. Nilai harus kurang dari atau sama dengan nilai CrossRetentionValue.

    Catatan

    Parameter ini diperlukan jika Anda mengaktifkan geo-redundansi.

    3
    InstanceType

    string

    No

    Tipe instans. Nilai valid:

    • replicate

    • sharding

    Catatan

    • Parameter ini diperlukan saat Anda memulihkan instans yang dihapus.

    • Parameter ini diperlukan saat Anda mengkloning instans dari cadangan geo-redundan.

    replicate
    PreserveOneEachHour

    boolean

    No

    Apakah akan mengaktifkan cadangan jarang per jam. Nilai valid:

    • true: Jika frekuensi cadangan dalam menit, semua Snapshot yang dihasilkan dalam satu jam terakhir akan disimpan. Untuk Snapshot yang dihasilkan lebih dari 1 jam yang lalu tetapi kurang dari 24 jam yang lalu, hanya Snapshot pertama yang dihasilkan setelah setiap jam penuh yang disimpan.

    • false: Semua Snapshot disimpan dalam periode retensi cadangan frekuensi tinggi.

    true

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    644A359C-B871-4DD3-97B5-ED91EF5809C2

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "644A359C-B871-4DD3-97B5-ED91EF5809C2"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidPreferredBackupPeriod.Malformed Specified parameter PreferredBackupPeriod is not valid.
    400 InvalidPreferredBackupTime.Malformed Specified parameter PreferredBackupTime is not valid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.