All Products
Search

This Product

    PolarDB:ModifyBackupPolicy

    Document Center

    PolarDB:ModifyBackupPolicy

    Last Updated:Sep 09, 2026

    Mengubah kebijakan cadangan otomatis kluster PolarDB Basis Data Relasional Cloud-Native.

    Deskripsi operasi

    Catatan

    Anda juga dapat mengubah kebijakan cadangan otomatis kluster PolarDB Basis Data Relasional Cloud-Native di Konsol. Untuk informasi selengkapnya, lihat Pengaturan 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

    polardb:ModifyBackupPolicy

    update

    *Kluster.

    acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DBClusterId

    string

    Yes

    ID kluster.

    Catatan

    Anda dapat memanggil operasi DescribeDBClusters untuk mengkueri informasi tentang semua kluster di wilayah tertentu, termasuk ID kluster.

    pc-bp13wz9586voc****
    PreferredBackupTime

    string

    No

    Periode pengatur waktu saat cadangan otomatis dilakukan. Tentukan periode dalam format hh:mmZ-hh:mmZ dalam UTC. Nilai harus tepat pada jam dengan interval 1 jam, seperti 14:00Z-15:00Z.

    15:00Z-16:00Z
    PreferredBackupPeriod

    string

    No

    Siklus cadangan. Nilai valid:

    • Monday

    • Tuesday

    • Wednesday

    • Thursday

    • Friday

    • Saturday

    • Sunday

    Catatan

      • Pilih setidaknya 2 hari. Pisahkan beberapa nilai dengan koma (,).

      • Jika wilayah kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda mendukung fitur cadangan lintas wilayah, parameter ini tidak didukung. Untuk wilayah yang mendukung cadangan lintas wilayah, lihat Ikhtisar.

      • Setelah cadangan lanjutan diaktifkan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies sebagai gantinya.

    Monday,Tuesday
    DataLevel1BackupRetentionPeriod

    string

    No

    Periode retensi cadangan level-1. Nilai valid: 3 hingga 14. Unit: hari.

    Catatan

    • Setelah cadangan lanjutan diaktifkan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies sebagai gantinya.

    3
    DataLevel2BackupRetentionPeriod

    string

    No

    Periode retensi cadangan level-2. Nilai valid:

    • 0: Menonaktifkan fitur cadangan level-2.

    • 30 hingga 7300: Periode retensi cadangan level-2. Unit: hari.

    • -1: Retensi jangka panjang (LTR) cadangan level-2.

    Catatan

      • Saat kluster dibuat, nilai default adalah 0, yang berarti fitur cadangan level-2 dinonaktifkan.

      • Setelah cadangan lanjutan diaktifkan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies sebagai gantinya.

    0
    BackupRetentionPolicyOnClusterDeletion

    string

    No

    Apakah akan mempertahankan cadangan saat kluster dihapus. Nilai valid:

    • ALL: Retensi jangka panjang (LTR) semua cadangan.

    • LATEST: Retensi jangka panjang (LTR) hanya cadangan terakhir.

    • NONE: Tidak mempertahankan cadangan apa pun.

    Catatan

    Nilai default: NONE.

    NONE
    BackupFrequency

    string

    No

    Frekuensi cadangan. Nilai valid:

    • Normal (default): cadangan reguler. Cadangan otomatis dilakukan sekali sehari pada pengatur waktu yang dijadwalkan.

    • 2/24H: cadangan frekuensi tinggi. Cadangan dilakukan setiap 2 jam.

    • 3/24H: cadangan frekuensi tinggi. Cadangan dilakukan setiap 3 jam.

    • 4/24H: cadangan frekuensi tinggi. Cadangan dilakukan setiap 4 jam.

    Catatan

      • Setelah cadangan frekuensi tinggi diaktifkan, semua cadangan yang selesai dalam 24 jam akan dipertahankan. Untuk cadangan yang lebih lama dari 24 jam, hanya cadangan pertama yang selesai setelah pukul 00:00 setiap hari yang dipertahankan, dan yang lainnya dihapus.

      • Setelah cadangan frekuensi tinggi diaktifkan, parameter siklus cadangan PreferredBackupPeriod secara default mencakup semua hari dalam seminggu (Senin hingga Minggu).

      • Jika wilayah kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda mendukung fitur cadangan lintas wilayah, parameter ini tidak didukung. Untuk wilayah yang mendukung cadangan lintas wilayah, lihat Ikhtisar.

      • Setelah cadangan lanjutan diaktifkan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies sebagai gantinya.

    Normal
    DataLevel1BackupFrequency

    string

    No

    Frekuensi cadangan. Nilai valid:

    • Normal (default): cadangan reguler. Cadangan otomatis dilakukan sekali sehari pada pengatur waktu yang dijadwalkan.

    • 2/24H: cadangan frekuensi tinggi. Cadangan dilakukan setiap 2 jam.

    • 3/24H: cadangan frekuensi tinggi. Cadangan dilakukan setiap 3 jam.

    • 4/24H: cadangan frekuensi tinggi. Cadangan dilakukan setiap 4 jam.

    Catatan

      • PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) dan PolarDB Basis Data Relasional Cloud-Native for PostgreSQL tidak mendukung parameter ini.

      • Jika wilayah kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda tidak mendukung fitur cadangan lintas wilayah, parameter ini tidak didukung. Untuk wilayah yang mendukung cadangan lintas wilayah, lihat Ikhtisar.

      • Setelah cadangan lanjutan diaktifkan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies sebagai gantinya.

    Normal
    DataLevel1BackupTime

    string

    No

    Periode pengatur waktu saat cadangan otomatis dilakukan. Tentukan periode dalam format hh:mmZ-hh:mmZ dalam UTC. Nilai harus tepat pada jam dengan interval 1 jam, seperti 14:00Z-15:00Z.

    Catatan

    • PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) dan PolarDB Basis Data Relasional Cloud-Native for PostgreSQL tidak mendukung parameter ini.

    • Jika wilayah kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda tidak mendukung fitur cadangan lintas wilayah, parameter ini tidak didukung. Untuk wilayah yang mendukung cadangan lintas wilayah, lihat Ikhtisar.

    15:00Z-16:00Z
    DataLevel1BackupPeriod

    string

    No

    Siklus cadangan level-1. Nilai valid:

    • Monday

    • Tuesday

    • Wednesday

    • Thursday

    • Friday

    • Saturday

    • Sunday

    Catatan

      • Pilih setidaknya 2 hari. Pisahkan beberapa nilai dengan koma (,).

      • PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) dan PolarDB Basis Data Relasional Cloud-Native for PostgreSQL tidak mendukung parameter ini.

      • Jika wilayah kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda tidak mendukung fitur cadangan lintas wilayah, parameter ini tidak didukung. Untuk wilayah yang mendukung cadangan lintas wilayah, lihat Ikhtisar.

      • Setelah cadangan lanjutan diaktifkan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies sebagai gantinya.

    Monday,Tuesday
    DataLevel2BackupPeriod

    string

    No

    Siklus cadangan level-2. Nilai valid:

    • Monday

    • Tuesday

    • Wednesday

    • Thursday

    • Friday

    • Saturday

    • Sunday

    Catatan

      • Pilih setidaknya 2 hari. Pisahkan beberapa nilai dengan koma (,).

      • PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) dan PolarDB Basis Data Relasional Cloud-Native for PostgreSQL tidak mendukung parameter ini.

      • Jika wilayah kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda tidak mendukung fitur cadangan lintas wilayah, parameter ini tidak didukung. Untuk wilayah yang mendukung cadangan lintas wilayah, lihat Ikhtisar.

      • Setelah cadangan lanjutan diaktifkan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies sebagai gantinya.

    Monday,Tuesday
    DataLevel2BackupAnotherRegionRegion

    string

    No

    Wilayah tujuan untuk cadangan level-2 lintas wilayah. Untuk wilayah yang mendukung cadangan lintas wilayah, lihat Ikhtisar.

    Catatan

    • Setelah cadangan lanjutan diaktifkan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies sebagai gantinya.

    cn-hangzhou
    DataLevel2BackupAnotherRegionRetentionPeriod

    string

    No

    Periode retensi cadangan lintas wilayah untuk cadangan level-2. Nilai valid:

    • 0: Menonaktifkan fitur cadangan lintas wilayah level-2.

    • 30 hingga 7300: Periode retensi cadangan level-2. Unit: hari.

    • -1: Retensi jangka panjang (LTR) cadangan level-2.

    Catatan

      • Saat kluster dibuat, nilai default adalah 0, yang berarti fitur cadangan lintas wilayah level-2 dinonaktifkan.

      • Setelah cadangan lanjutan diaktifkan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies sebagai gantinya.

    30
    BackupPolicyLevel

    string

    No

    Tingkat kebijakan cadangan. Nilai valid:

    • Normal: cadangan reguler.

    • Advanced: cadangan lanjutan.

    Catatan

      • PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) dan PolarDB Basis Data Relasional Cloud-Native for PostgreSQL tidak mendukung parameter ini.

      • Anda dapat memeriksa parameter respons AdvancedPolicyOption dari operasi DescribeBackupPolicy untuk menentukan apakah kluster mendukung cadangan lanjutan. Jika kluster mendukung cadangan lanjutan, Anda dapat mengajukan permohonan untuk menggunakan fitur ini melalui Pengaturan cadangan lanjutan.

      • Setelah cadangan lanjutan diaktifkan, pengembalian ke cadangan reguler tidak didukung.

    Normal
    AdvancedDataPolicies

    array<object>

    No

    Kebijakan cadangan lanjutan.

    Catatan

      • PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) dan PolarDB Basis Data Relasional Cloud-Native for PostgreSQL tidak mendukung parameter ini.

      • Hanya kluster dengan BackupPolicyLevel yang diatur ke Advanced yang mendukung parameter ini.

    object

    No

    ActionType

    string

    No

    Jenis aksi. Nilai valid:

    • CREATE: membuat

    • UPDATE: memperbarui

    • DELETE: menghapus

    CREATE
    AutoCreated

    boolean

    No

    Apakah kebijakan cadangan dibuat secara otomatis oleh sistem.

    Catatan

    Nilai parameter ini dibuat secara otomatis. Anda tidak perlu menentukannya.

    false
    BakType

    string

    No

    Jenis cadangan. Nilai valid:

    • F: cadangan penuh.

    Catatan

    Parameter ini tidak dapat dimodifikasi dan tetap F.

    F
    DestRegion

    string

    No

    Wilayah tujuan kebijakan cadangan.

    cn-beijing
    DestType

    string

    No

    Jenis tujuan kebijakan cadangan. Nilai valid:

    • level1: cadangan level-1

    • level2: cadangan level-2

    • level2Cross: cadangan level-2 lintas wilayah

    level2
    DumpAction

    string

    No

    Metode untuk mengonversi cadangan level-1 ke cadangan level-2. Nilai valid:

    • copy: menyalin

    copy
    FilterKey

    string

    No

    Jenis penjadwalan. Nilai valid:

    • dayOfWeek: dijadwalkan per minggu

    • dayOfMonth: dijadwalkan per bulan

    • dayOfYear: dijadwalkan per tahun

    • backupInterval: dijadwalkan pada interval tetap

    Catatan

    Parameter ini hanya diperlukan saat FilterType diatur ke crontab.

    dayOfWeek
    FilterType

    string

    No

    Jenis filter kebijakan lanjutan. Nilai valid:

    • crontab: penjadwalan periode

    • event: penjadwalan berbasis event

    crontab
    FilterValue

    string

    No

    Siklus cadangan.

    1,2,3,4,5,6,7
    OnlyPreserveOneEachDay

    boolean

    No

    Kebijakan retensi data cadangan 24 jam. Nilai valid:

    • true: Hanya set cadangan pertama hari itu yang dipertahankan untuk cadangan yang lebih lama dari 24 jam.

    • false: Semua set cadangan dipertahankan.

    true
    OnlyPreserveOneEachHour

    boolean

    No

    Kebijakan retensi data cadangan per jam. Nilai valid:

    • true: Hanya set cadangan paling awal dalam setiap jam yang dipertahankan untuk cadangan yang lebih lama dari 1 jam.

    • false: Semua set cadangan dipertahankan.

    Catatan

    Parameter ini tidak dapat dimodifikasi dan tetap true.

    true
    PolicyId

    string

    No

    ID kebijakan cadangan. Anda dapat memanggil operasi DescribeBackupPolicy untuk mengkueri ID kebijakan cadangan.

    71930ac2e9f15e41615e10627c******

    RetentionType

    string

    No

    Jenis retensi set cadangan. Nilai valid:

    • never: tidak pernah kedaluwarsa

    • delay: kedaluwarsa setelah jumlah hari tertentu

    delay
    RetentionValue

    string

    No

    Jumlah hari untuk mempertahankan cadangan.

    7
    SrcRegion

    string

    No

    Wilayah sumber kebijakan cadangan.

    cn-shanghai
    SrcType

    string

    No

    Jenis sumber kebijakan cadangan. Nilai valid:

    • db: kluster database

    • level1: cadangan level-1

    • level2: cadangan level-2

    • level2Cross: cadangan level-2 lintas wilayah

    level1
    StorageClass

    string

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    C5A5DF0E-5968-4DC1-882E-AC2FE7******

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "C5A5DF0E-5968-4DC1-882E-AC2FE7******"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidDataLevel1BackupRetentionPeriod.Malformed The specified parameter DataLevel1BackupRetentionPeriod is not valid. Operasi gagal karena parameter epoch retensi cadangan level-1 (DataLevel1BackupRetentionPeriod) tidak valid.
    400 InvalidDataLevel2BackupRetentionPeriod.Malformed The specified parameter DataLevel2BackupRetentionPeriod is not valid. Operasi gagal karena parameter epoch retensi cadangan level-2 (DataLevel2BackupRetentionPeriod) tidak valid.
    400 InvalidBackupRetentionPeriod.Malformed The specified parameter BackupRetentionPeriod is not valid. Operasi gagal. Parameter BackupRetentionPeriod tidak valid.
    400 InvalidBackupFrequency.Malformed The specified parameter BackupFrequency is not valid. Operasi gagal. Parameter frekuensi cadangan (BackupFrequency) tidak valid.
    400 InvalidPreferredBackupPeriod.Malformed The specified parameter PreferredBackupPeriod is not valid. Operasi gagal. Siklus cadangan data yang ditentukan (PreferredBackupPeriod) tidak valid.
    400 InvalidDataLevel2BackupPeriod.Malformed The specified parameter DataLevel2BackupPeriod is not valid. Parameter DataLevel2BackupPeriod yang ditentukan tidak valid.
    400 InvalidDataLevel1BackupPeriod.Malformed The specified parameter DataLevel1BackupPeriod is not valid. Parameter DataLevel1BackupPeriod yang ditentukan tidak valid.
    400 InvalidPreferredBackupTime.Malformed The specified parameter PreferredBackupTime is not valid. Operasi gagal. Periode pengatur waktu cadangan otomatis yang ditentukan (PreferredBackupTime) tidak valid.
    400 InvalidDataLevel1BackupTime.Malformed The specified parameter DataLevel1BackupTime is not valid. Parameter DataLevel1BackupTime yang ditentukan tidak valid.
    400 InvalidDataLevel1BackupFrequency.Malformed The specified parameter DataLevel1BackupFrequency is not valid. Parameter DataLevel1BackupFrequency yang ditentukan tidak valid.
    400 InvalidDataLevel2AnotherRegionRegion.NotFound The specified parameter DataLevel2BackupAnotherRegionRegion does not found. Parameter DataLevel2BackupAnotherRegionRegion yang ditentukan tidak dapat ditemukan.
    400 InvalidDataLevel2AnotherRegionBackupRetentionPeriod.Malformed The specified parameter DataLevel2BackupAnotherRegionRetentionPeriod is not valid. Parameter DataLevel2BackupAnotherRegionRetentionPeriod yang ditentukan tidak valid.
    403 IncorrectBackupPolicy Current DB type does not support low frequency backupPolicy operation. Jenis database saat ini tidak mendukung operasi cadangan jarang.
    404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. Operasi gagal karena ID instans kluster yang ditentukan tidak ada.
    404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records. DBClusterId yang diberikan tidak ada dalam catatan saat ini.
    404 InvalidParam new archiveBackup policy already exists. dumpretention parameter cannot used alone Operasi gagal karena format parameter input salah.
    404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid. DBClusterId yang diberikan tidak ada dalam catatan kami.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.