全部产品
Search

搜索本产品

    ApsaraDB for MongoDB：ModifyBackupPolicy

    文档中心

    ApsaraDB for MongoDB：ModifyBackupPolicy

    更新时间：Jan 26, 2026

    Memodifikasi kebijakan backup untuk instance MongoDB.

    Deskripsi operasi

    Geo-redundansi hanya tersedia untuk instance replica set dan instance kluster sharded yang menggunakan cloud disk.

    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

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

    Catatan

    Rentang waktu harus 1 jam.

    03:00Z-04:00Z
    PreferredBackupPeriod

    string

    No

    Siklus backup. Nilai yang valid:

    • Monday

    • Tuesday

    • Wednesday

    • Thursday

    • Friday

    • Saturday

    • Sunday

    Penting

    Untuk memastikan keamanan data, lakukan backup instans MongoDB minimal dua kali seminggu.

    Catatan

    Untuk menentukan beberapa siklus backup, 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

    Menentukan apakah akan mengaktifkan cadangan log. Nilai yang valid:

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

    • 1: Aktifkan 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 yang valid: 7 hingga 730.

    7
    SnapshotBackupType

    string

    No

    Tipe cadangan snapshot. Nilai yang valid:

    • Flash: backup tingkat detik.

    • Standard: backup konvensional. Ini adalah nilai default.

    Standard
    BackupInterval

    string

    No

    Frekuensi backup berfrekuensi tinggi. Nilai yang valid:

    • -1: Backup berfrekuensi 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 mengatur SnapshotBackupType ke Standard, nilai parameter ini adalah -1.

    • Backup berfrekuensi tinggi hanya berlaku jika Anda mengatur SnapshotBackupType ke Flash dan mengatur parameter ini ke nilai lebih besar dari 0.

    -1
    HighFrequencyBackupRetention

    integer

    No

    Jumlah hari untuk menyimpan backup berfrekuensi tinggi. Sebelum menentukan parameter ini, Anda harus mengatur parameter BackupInterval terlebih dahulu. Periode retensi default adalah 1 hari.

    1
    BackupRetentionPolicyOnClusterDeletion

    integer

    No

    Kebijakan penyimpanan backup saat Anda melepas instans.

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

    • 1: Cadangan otomatis dilakukan saat instans dilepas, dan cadangan ini disimpan dalam jangka panjang.

    • 2: Cadangan otomatis dilakukan saat instans dilepas, dan semua set cadangan instans disimpan dalam jangka panjang.

    Untuk informasi selengkapnya, lihat Long-term backup retention.

    2
    CrossBackupType

    string

    No

    Kebijakan untuk backup geo-redundan. Nilai yang valid:

    • update: Memodifikasi kebijakan geo-redundansi.

    • delete: Menghapus kebijakan geo-redundansi.

    Catatan

    Parameter ini wajib jika Anda mengaktifkan geo-redundansi.

    update
    SrcRegion

    string

    No

    ID wilayah instans.

    Catatan

    • Parameter ini wajib jika Anda memulihkan instans yang telah dihapus.

    • Parameter ini wajib jika Anda mengaktifkan geo-redundansi.

    cn-beijing
    DestRegion

    string

    No

    ID wilayah backup geo-redundan.

    Catatan

    Parameter ini wajib jika Anda mengaktifkan geo-redundansi.

    cn-hangzhou
    CrossRetentionType

    string

    No

    Kebijakan retensi untuk backup geo-redundan. Nilai yang valid:

    • delay: Simpan backup selama periode tertentu.

    • never: Simpan backup secara permanen.

    Catatan

    Parameter ini wajib jika Anda mengaktifkan geo-redundansi.

    delay
    CrossRetentionValue

    integer

    No

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

    Catatan

    • Parameter ini wajib jika Anda mengaktifkan geo-redundansi.

    • Parameter ini wajib jika Anda mengatur CrossRetentionType ke delay.

    7
    CrossBackupPeriod

    string

    No

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

    1. Monday

    2. Tuesday

    3. Wednesday

    4. Thursday

    5. Friday

    6. Saturday

    7. Sunday

    Catatan

    Parameter ini wajib jika Anda mengaktifkan geo-redundansi.

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

    • Jika Anda mengatur metode backup ke backup 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

    Menentukan apakah akan mengaktifkan cadangan log cross-region. Nilai yang valid:

    Catatan

    Parameter ini wajib jika Anda mengaktifkan geo-redundansi.

    • 1: Aktifkan cadangan log cross-region. Nilai ini wajib untuk instans kluster sharded. Nilai ini juga wajib untuk instans set replika jika Anda ingin mengaktifkan pemulihan pada titik waktu geo-redundan.

    • 0: Nonaktifkan cadangan log cross-region.

    1
    CrossLogRetentionType

    string

    No

    Kebijakan retensi untuk cadangan log cross-region. Nilai yang valid:

    • delay: Simpan backup selama periode tertentu.

    • never: Simpan backup secara permanen.

    Catatan

    Parameter ini wajib jika Anda mengaktifkan geo-redundansi.

    delay
    CrossLogRetentionValue

    integer

    No

    Jumlah hari untuk menyimpan cadangan log cross-region. Nilai yang valid: 3 hingga 1825. Nilai ini harus kurang dari atau sama dengan nilai CrossRetentionValue.

    Catatan

    Parameter ini wajib jika Anda mengaktifkan geo-redundansi.

    3
    InstanceType

    string

    No

    Tipe instans. Nilai yang valid:

    • replicate

    • sharding

    Catatan

    • Parameter ini wajib saat Anda memulihkan instans yang telah dihapus.

    • Parameter ini wajib saat Anda mengkloning instans dari backup geo-redundan.

    replicate
    PreserveOneEachHour

    boolean

    No

    Menentukan apakah akan mengaktifkan cadangan jarang per jam. Nilai yang valid:

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

    • false: Semua snapshot disimpan dalam periode retensi backup berfrekuensi tinggi.

    true

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    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.