All Products
Search

This Product

    PolarDB:ModifyBackupPolicy

    Document Center

    PolarDB:ModifyBackupPolicy

    Last Updated:Jun 10, 2026

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

    Deskripsi operasi

    Catatan

    You can also modify the automatic backup policy for a PolarDB cluster in the console. For more information, see backup settings.

    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

    *dbcluster

    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 detail semua kluster di Wilayah tertentu, termasuk ID kluster.

    pc-bp13wz9586voc****
    PreferredBackupTime

    string

    No

    Pengatur waktu untuk cadangan otomatis. Tentukan waktu dalam UTC dan dalam format hh:mmZ-hh:mmZ. Pengatur waktu harus berupa periode satu jam yang dimulai tepat pada jam. Misalnya, 14:00Z-15:00Z.

    15:00Z-16:00Z
    PreferredBackupPeriod

    string

    No

    Siklus cadangan. Nilai valid:

    • Monday

    • Tuesday

    • Wednesday

    • Thursday

    • Friday

    • Saturday

    • Sunday

    Catatan

      • Anda harus memilih setidaknya dua hari. Pisahkan beberapa nilai dengan koma.

      • Parameter ini tidak didukung jika kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda berada di Wilayah yang mendukung fitur cadangan lintas wilayah. Untuk informasi selengkapnya tentang Wilayah yang mendukung cadangan lintas wilayah, lihat Tampilan Ikhtisar.

      • Setelah Anda mengaktifkan cadangan lanjutan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies dengan format yang sama sebagai gantinya.

    Monday,Tuesday
    DataLevel1BackupRetentionPeriod

    string

    No

    Periode retensi untuk cadangan level-1, dalam hari. Nilai valid: 3 hingga 14.

    Catatan

    • Setelah Anda mengaktifkan cadangan lanjutan, 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, dalam hari.

    • -1: Cadangan level-2 disimpan secara permanen.

    Catatan

      • Saat Anda membuat Kluster, nilai default adalah 0, yang menonaktifkan fitur cadangan level-2.

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

    0
    BackupRetentionPolicyOnClusterDeletion

    string

    No

    Apakah akan menyimpan cadangan saat Anda menghapus Kluster. Nilai valid:

    • ALL: Menyimpan semua cadangan secara permanen.

    • LATEST: Menyimpan cadangan terakhir secara permanen.

    • NONE: Tidak menyimpan set cadangan.

    Catatan

    Nilai default adalah NONE.

    NONE
    BackupFrequency

    string

    No

    Frekuensi cadangan. Nilai valid:

    • Normal (default): cadangan standar. Kluster dicadangkan sekali sehari.

    • 2/24H: cadangan Frekuensi tinggi. Kluster dicadangkan setiap 2 jam.

    • 3/24H: cadangan Frekuensi tinggi. Kluster dicadangkan setiap 3 jam.

    • 4/24H: cadangan Frekuensi tinggi. Kluster dicadangkan setiap 4 jam.

    Catatan

      • Jika Anda mengaktifkan cadangan Frekuensi tinggi, semua cadangan yang selesai dalam 24 jam terakhir akan disimpan. Untuk cadangan yang lebih lama dari 24 jam, sistem hanya menyimpan cadangan pertama yang selesai setelah pukul 00:00 setiap hari dan menghapus sisanya.

      • Jika Anda mengaktifkan cadangan Frekuensi tinggi, parameter PreferredBackupPeriod secara otomatis disetel ke semua hari dalam seminggu (dari Senin hingga Minggu).

      • Parameter ini tidak didukung jika kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda berada di Wilayah yang mendukung fitur cadangan lintas wilayah. Untuk informasi selengkapnya tentang Wilayah yang mendukung cadangan lintas wilayah, lihat Tampilan Ikhtisar.

      • Setelah Anda mengaktifkan cadangan lanjutan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies dengan format yang sama sebagai gantinya.

    Normal
    DataLevel1BackupFrequency

    string

    No

    Frekuensi cadangan. Nilai valid:

    • Normal (default): cadangan standar. Kluster dicadangkan sekali sehari.

    • 2/24H: cadangan Frekuensi tinggi. Kluster dicadangkan setiap 2 jam.

    • 3/24H: cadangan Frekuensi tinggi. Kluster dicadangkan setiap 3 jam.

    • 4/24H: cadangan Frekuensi tinggi. Kluster dicadangkan setiap 4 jam.

    Catatan

      • Parameter ini tidak didukung untuk PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Oracle-Compatible) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL.

      • Parameter ini tidak didukung jika kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda berada di Wilayah yang mendukung fitur cadangan lintas wilayah. Untuk informasi selengkapnya tentang Wilayah yang mendukung cadangan lintas wilayah, lihat Tampilan Ikhtisar.

      • Setelah Anda mengaktifkan cadangan lanjutan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies dengan format yang sama sebagai gantinya.

    Normal
    DataLevel1BackupTime

    string

    No

    Pengatur waktu untuk cadangan otomatis. Tentukan waktu dalam UTC dan dalam format hh:mmZ-hh:mmZ. Pengatur waktu harus berupa periode satu jam yang dimulai tepat pada jam. Misalnya, 14:00Z-15:00Z.

    Catatan

    • Parameter ini tidak didukung untuk PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Oracle-Compatible) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL.

    • Parameter ini tidak didukung jika kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda berada di Wilayah yang mendukung fitur cadangan lintas wilayah. Untuk informasi selengkapnya tentang Wilayah yang mendukung cadangan lintas wilayah, lihat Tampilan Ikhtisar.

    15:00Z-16:00Z
    DataLevel1BackupPeriod

    string

    No

    Siklus cadangan level-1. Nilai valid:

    • Monday

    • Tuesday

    • Wednesday

    • Thursday

    • Friday

    • Saturday

    • Sunday

    Catatan

      • Anda harus memilih setidaknya dua hari. Pisahkan beberapa nilai dengan koma.

      • Parameter ini tidak didukung untuk PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Oracle-Compatible) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL.

      • Parameter ini tidak didukung jika kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda berada di Wilayah yang mendukung fitur cadangan lintas wilayah. Untuk informasi selengkapnya tentang Wilayah yang mendukung cadangan lintas wilayah, lihat Tampilan Ikhtisar.

      • Setelah Anda mengaktifkan cadangan lanjutan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies dengan format yang sama sebagai gantinya.

    Monday,Tuesday
    DataLevel2BackupPeriod

    string

    No

    Siklus cadangan level-2. Nilai valid:

    • Monday

    • Tuesday

    • Wednesday

    • Thursday

    • Friday

    • Saturday

    • Sunday

    Catatan

      • Anda harus memilih setidaknya dua hari. Pisahkan beberapa nilai dengan koma.

      • Parameter ini tidak didukung untuk PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Oracle-Compatible) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL.

      • Parameter ini tidak didukung jika kluster PolarDB Basis Data Relasional Cloud-Native for MySQL Anda berada di Wilayah yang mendukung fitur cadangan lintas wilayah. Untuk informasi selengkapnya tentang Wilayah yang mendukung cadangan lintas wilayah, lihat Tampilan Ikhtisar.

      • Setelah Anda mengaktifkan cadangan lanjutan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies dengan format yang sama sebagai gantinya.

    Monday,Tuesday
    DataLevel2BackupAnotherRegionRegion

    string

    No

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

    Catatan

    • Setelah Anda mengaktifkan cadangan lanjutan, parameter ini tidak lagi berlaku. Gunakan parameter AdvancedDataPolicies dengan format yang sama sebagai gantinya.

    cn-hangzhou
    DataLevel2BackupAnotherRegionRetentionPeriod

    string

    No

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

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

    • 30 hingga 7300: Periode retensi cadangan level-2 lintas wilayah, dalam hari.

    • -1: Cadangan level-2 lintas wilayah disimpan secara permanen.

    Catatan

      • Saat Anda membuat Kluster, nilai default adalah 0, yang menonaktifkan fitur cadangan level-2 lintas wilayah.

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

    30
    BackupPolicyLevel

    string

    No

    Tingkat Kebijakan cadangan. Nilai valid:

    • Normal: cadangan standar

    • Advanced: cadangan lanjutan

    Catatan

      • Parameter ini tidak didukung untuk PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Oracle-Compatible) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL.

      • Setelah Anda mengaktifkan cadangan lanjutan, Anda tidak dapat beralih kembali ke cadangan standar.

    Normal
    AdvancedDataPolicies

    array<object>

    No

    Kebijakan cadangan lanjutan.

    Catatan

      • Parameter ini tidak didukung untuk PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Oracle-Compatible) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL.

      • Parameter ini hanya didukung untuk Kluster yang BackupPolicyLevel disetel ke Advanced.

    object

    No

    PolicyId

    string

    No

    The ID of the backup policy. You can call the DescribeBackupPolicy operation to view the ID.

    71930ac2e9f15e41615e10627c******

    ActionType

    string

    No

    The action type. Valid values:

    • CREATE: Create

    • UPDATE: Update

    • DELETE: Delete

    CREATE
    RetentionType

    string

    No

    The retention type for the backup set. Valid values:

    • never: Never expires.

    • delay: Expires after a specified number of days.

    delay
    RetentionValue

    string

    No

    The number of days to retain the backup.

    7
    FilterType

    string

    No

    The filter type for the advanced policy. Valid values:

    • crontab: Recurring schedule

    • event: Event-based schedule

    crontab
    FilterKey

    string

    No

    The scheduling type. Valid values:

    • dayOfWeek: Weekly schedule

    • dayOfMonth: Monthly schedule

    • dayOfYear: Yearly schedule

    • backupInterval: Fixed interval schedule

    Catatan

    This parameter is required only if FilterType is set to crontab.

    dayOfWeek
    FilterValue

    string

    No

    The backup cycle.

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

    string

    No

    The source region for the backup policy.

    cn-shanghai
    SrcType

    string

    No

    The source type for the backup policy. Valid values:

    • db: database cluster

    • level1: level-1 backup

    • level2: level-2 backup

    • level2Cross: cross-region level-2 backup

    level1
    DestRegion

    string

    No

    The destination region for the backup policy.

    cn-beijing
    DestType

    string

    No

    The destination type for the backup policy. Valid values:

    • level1: level-1 backup

    • level2: level-2 backup

    • level2Cross: cross-region level-2 backup

    level2
    OnlyPreserveOneEachHour

    boolean

    No

    The retention policy for hourly backups. Valid values:

    • true: Retains only the first backup set of each hour for backups that are more than one hour old.

    • false: Retains all backup sets.

    Catatan

    This parameter cannot be modified and is fixed to true.

    true
    AutoCreated

    boolean

    No

    Indicates whether the backup policy is automatically generated by the system.

    Catatan

    This value is automatically generated. You do not need to specify this parameter.

    false
    OnlyPreserveOneEachDay

    boolean

    No

    The retention policy for backups that are more than 24 hours old. Valid values:

    • true: Retains only the first backup set of the day.

    • false: Retains all backups.

    true
    DumpAction

    string

    No

    The method to convert a level-1 backup to a level-2 backup. Valid values:

    • copy: Copy

    copy
    BakType

    string

    No

    The backup type. Valid values:

    • F: full backup

    Catatan

    This parameter cannot be modified and is fixed to F.

    F
    StorageClass

    string

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The ID of the request.

    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.
    400 InvalidDataLevel2BackupRetentionPeriod.Malformed The specified parameter DataLevel2BackupRetentionPeriod is not valid.
    400 InvalidBackupRetentionPeriod.Malformed The specified parameter BackupRetentionPeriod is not valid.
    400 InvalidBackupFrequency.Malformed The specified parameter BackupFrequency is not valid.
    400 InvalidPreferredBackupPeriod.Malformed The specified parameter PreferredBackupPeriod is not valid.
    400 InvalidDataLevel2BackupPeriod.Malformed The specified parameter DataLevel2BackupPeriod is not valid.
    400 InvalidDataLevel1BackupPeriod.Malformed The specified parameter DataLevel1BackupPeriod is not valid.
    400 InvalidPreferredBackupTime.Malformed The specified parameter PreferredBackupTime is not valid.
    400 InvalidDataLevel1BackupTime.Malformed The specified parameter DataLevel1BackupTime is not valid.
    400 InvalidDataLevel1BackupFrequency.Malformed The specified parameter DataLevel1BackupFrequency is not valid.
    400 InvalidDataLevel2AnotherRegionRegion.NotFound The specified parameter DataLevel2BackupAnotherRegionRegion does not found.
    400 InvalidDataLevel2AnotherRegionBackupRetentionPeriod.Malformed The specified parameter DataLevel2BackupAnotherRegionRetentionPeriod is not valid.
    403 IncorrectBackupPolicy Current DB type does not support low frequency backupPolicy operation.
    404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records.
    404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records.
    404 InvalidParam new archiveBackup policy already exists. dumpretention parameter cannot used alone
    404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.