All Products
Search

This Product

    Cloud Backup:CreatePolicyV2

    Document Center

    Cloud Backup:CreatePolicyV2

    Last Updated:Oct 29, 2026

    Membuat kebijakan.

    Deskripsi operasi

    Kebijakan cadangan menyimpan Catatan informasi yang diperlukan untuk cadangan. Setelah kebijakan cadangan dijalankan, pekerjaan cadangan dibuat untuk menyimpan Catatan progres dan hasil cadangan. Jika pekerjaan cadangan berhasil, snapshot cadangan dibuat. Anda dapat menggunakan snapshot cadangan untuk membuat pekerjaan pemulihan.

    • Kebijakan cadangan mendukung beberapa sumber data, termasuk cadangan NAS, cadangan OSS, cadangan Instance ECS, ECS File Backup Edisi Standar, cadangan file lokal, cadangan Tablestore, dan cadangan CPFS.

    • Kebijakan cadangan hanya mendukung satu kebijakan siklus cadangan dengan interval pengatur waktu tetap.

    • Kebijakan cadangan hanya dapat mencadangkan data ke satu penyimpanan 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:CreatePolicyV2

    create

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    PolicyName

    string

    No

    Nama kebijakan.

    Daily local backup + cross-region backup
    PolicyType

    string

    No

    Tipe kebijakan. Nilai valid:

    • STANDARD: kebijakan cadangan umum. Mendukung pencadangan sumber data selain Instance ECS.

    • UDM_ECS_ONLY: kebijakan cadangan Instance ECS. Mendukung pencadangan hanya Instance ECS.

    Jika Anda tidak menentukan tipe kebijakan, Cloud Backup secara otomatis mengatur tipe kebijakan berdasarkan apakah penyimpanan cadangan ditentukan dalam aturan kebijakan:

    • Jika penyimpanan cadangan ditentukan dalam aturan kebijakan: STANDARD.

    • Jika tidak ada penyimpanan cadangan yang ditentukan dalam aturan kebijakan: UDM_ECS_ONLY.

    STANDARD
    PolicyDescription

    string

    No

    Deskripsi kebijakan.

    Back up data at 10:00 AM every day and perform a cross-region backup to Shanghai.
    Rules

    array<object>

    No

    Daftar aturan kebijakan.

    array<object>

    No

    Aturan kebijakan.

    RuleType

    string

    Yes

    Tipe aturan. Setiap kebijakan harus memuat setidaknya satu aturan BACKUP dan tepat satu aturan TRANSITION. Nilai valid:

    • BACKUP: aturan cadangan.

    • TRANSITION: aturan siklus hidup.

    • REPLICATION: aturan replikasi.

    • TAG: aturan asosiasi Sumber daya berbasis tag.

    Valid values:

    • TRANSITION :

      Aturan siklus hidup.

    • BACKUP :

      Aturan cadangan.

    • REPLICATION :

      Aturan replikasi.

    • SECURITY :

      Aturan keamanan.

    • TAG :

      Aturan asosiasi Sumber daya berbasis tag.

    BACKUP
    Schedule

    string

    No

    Parameter ini hanya diperlukan ketika RuleType diatur ke BACKUP. Jadwal cadangan. Format valid:

    • I|{startTime}|{interval}: menjalankan pekerjaan cadangan dengan interval {interval} mulai dari {startTime}. Misalnya, I|1631685600|P1D menunjukkan bahwa pekerjaan cadangan dijalankan setiap hari mulai pukul 14:00:00 pada 15 September 2021.

      • startTime: pengatur waktu mulai cadangan. Nilainya adalah Stempel waktu UNIX dalam detik.

      • interval: interval pengatur waktu ISO 8601. Misalnya, PT1H menunjukkan interval satu jam, dan P1D menunjukkan interval satu hari.

    • C|{startTime}|{crontab}: menjalankan pekerjaan cadangan berdasarkan ekspresi {crontab} mulai dari {startTime}. Misalnya, C|1631685600|0 0 2 ? * 3,5,7 menunjukkan bahwa pekerjaan cadangan dijalankan pukul 02:00:00 setiap Selasa, Kamis, dan Sabtu mulai pukul 14:00:00 pada 15 September 2021.

      • startTime: pengatur waktu mulai cadangan. Nilainya adalah Stempel waktu UNIX dalam detik.

      • crontab: ekspresi crontab. Misalnya, 0 0 2 ? * 3,5,7 menunjukkan pukul 02:00:00 setiap Selasa, Kamis, dan Sabtu.

    Pekerjaan cadangan yang melewatkan pengatur waktu terjadwal tidak akan dikompensasi. Jika pekerjaan cadangan sebelumnya belum selesai, pekerjaan cadangan berikutnya tidak akan dipicu.

    I|1648647166|P1D
    BackupType

    string

    No

    Parameter ini hanya diperlukan ketika RuleType diatur ke BACKUP. Tipe cadangan. Nilai COMPLETE menunjukkan cadangan penuh.

    Valid values:

    • ARCHIVE_BY_SEARCH :

      Arsip berdasarkan hasil pencarian.

    • COMPLETE :

      Cadangan penuh.

    • LOG :

      Cadangan log.

    • ARCHIVE :

      Arsip.

    • DIFFERENTIAL :

      Cadangan diferensial.

    • INDEX :

      Indeks.

    • INCREMENTAL :

      Cadangan inkremental.

    COMPLETE
    Retention

    integer

    No

    Parameter ini hanya diperlukan ketika RuleType diatur ke BACKUP, TRANSITION, atau REPLICATION.

    • Jika RuleType diatur ke BACKUP: periode retensi cadangan. Prioritas parameter ini lebih rendah daripada parameter Retention dalam aturan di mana RuleType diatur ke TRANSITION. Nilai minimum: 1. Nilai maksimum: 364635. Unit: hari.

    • Jika RuleType diatur ke TRANSITION: periode retensi cadangan. Nilai minimum: 1. Nilai maksimum: 364635. Unit: hari.

    • Jika RuleType diatur ke REPLICATION: periode retensi cadangan lintas wilayah. Nilai minimum: 1. Nilai maksimum: 364635. Unit: hari.

    7
    ReplicationRegionId

    string

    No

    Parameter ini hanya diperlukan ketika RuleType diatur ke REPLICATION. ID wilayah tujuan untuk replikasi.

    cn-shanghai
    ArchiveDays

    integer

    No

    Parameter ini hanya diperlukan ketika RuleType diatur ke TRANSITION. Jumlah hari setelah cadangan secara otomatis ditransisikan ke tier arsip. Cadangan harus dipertahankan di tier standar selama minimal 30 hari dan di tier arsip selama minimal 60 hari setelah transisi. Unit: hari.

    90
    RetentionRules

    array<object>

    No

    Parameter ini hanya diperlukan ketika RuleType diatur ke TRANSITION. Aturan retensi khusus.

    object

    No

    Aturan retensi khusus.

    AdvancedRetentionType

    string

    No

    Tipe aturan retensi khusus. Nilai valid:

    • DAILY: cadangan harian.

    • WEEKLY: cadangan mingguan.

    • MONTHLY: cadangan bulanan.

    • YEARLY: cadangan tahunan.

    YEARLY
    WhichSnapshot

    integer

    No

    Nomor urut cadangan yang berlaku untuk aturan ini. Saat ini, hanya cadangan pertama yang didukung. Atur nilai ke 1.

    1
    Retention

    integer

    No

    Periode retensi khusus cadangan. Nilai minimum: 1. Unit: hari.

    730
    VaultId

    string

    No

    Parameter ini hanya diperlukan ketika RuleType diatur ke BACKUP. ID penyimpanan cadangan.

    v-0001************aseg
    KeepLatestSnapshots

    integer

    No

    Apakah akan mempertahankan setidaknya satu versi cadangan. Nilai valid:

    • 0: Tidak mempertahankan.

    • 1: Mempertahankan.

    1
    Immutable

    boolean

    No

    Parameter ini hanya diperlukan ketika PolicyType diatur ke UDM_ECS_ONLY dan RuleType diatur ke SECURITY. Apakah akan mengaktifkan kunci cadangan.

    true
    DataSourceFilters

    array<object>

    No

    Parameter ini hanya diperlukan ketika RuleType diatur ke TAG. Aturan penyaringan sumber data.

    array<object>

    No

    SourceType

    string

    No

    Tipe sumber data. Nilai valid:

    • UDM_ECS: Cadangan Instance ECS. Tipe sumber data ini hanya didukung ketika PolicyType diatur ke UDM_ECS_ONLY.

    • OSS: Cadangan OSS. Tipe sumber data ini hanya didukung ketika PolicyType diatur ke STANDARD.

    • NAS: Cadangan Alibaba Cloud NAS. Tipe sumber data ini hanya didukung ketika PolicyType diatur ke STANDARD.

    • ECS_FILE: ECS File Backup Edisi Standar. Tipe sumber data ini hanya didukung ketika PolicyType diatur ke STANDARD.

    • OTS: Cadangan Tablestore. Tipe sumber data ini hanya didukung ketika PolicyType diatur ke STANDARD.

    UDM_ECS
    DataSourceIds deprecated

    array

    No

    [Tidak digunakan lagi]

    deprecated

    string

    No

    [Tidak digunakan lagi]

    **[Deprecated]**
    AccountScope

    string

    No

    Cakupan (dalam OAuth) akun tempat kebijakan berlaku.

    SPECIFIED_ACCOUNT
    Accounts

    array<object>

    No

    Daftar informasi akun dalam kondisi penyaringan sumber data.

    object

    No

    CrossAccountType

    string

    No

    Tipe asosiasi akun, yang digunakan untuk membedakan antara skenario akun saat ini dan lintas akun.

    CROSS_ACCOUNT_BY_RD
    CrossAccountUserId

    integer

    No

    ID akun Alibaba Cloud dari akun yang memiliki Sumber daya yang akan dicadangkan.

    1234567890123456
    CrossAccountRoleName

    string

    No

    Nama peran RAM yang dibuat di akun yang memiliki Sumber daya yang akan dicadangkan.

    hbrcrossrole
    TagFilters

    array<object>

    No

    Parameter ini hanya diperlukan ketika RuleType diatur ke TAG. Aturan penyaringan tag Sumber daya.

    object

    No

    Key

    string

    No

    Kunci tag.

    env
    Value

    string

    No

    Nilai tag. Nilai kosong menunjukkan nilai apa pun.

    prod
    Operator

    string

    No

    Aturan pencocokan tag. Nilai valid:

    • EQUAL: mencocokkan kunci tag dan nilai tag.

    • NOT: mencocokkan kunci tag tetapi bukan nilai tag.

    EQUAL

    Elemen respons

    Element

    Type

    Description

    Example

    object

    CreatePolicyResponse.

    Success

    boolean

    Apakah permintaan berhasil. Nilai valid:

    • true: Permintaan berhasil.

    • false: Permintaan gagal.

    true
    Code

    string

    Kode pengembalian. Nilai 200 menunjukkan keberhasilan.

    200
    Message

    string

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

    successful
    RequestId

    string

    ID permintaan.

    EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F
    PolicyId

    string

    ID kebijakan.

    po-000000zemnuyx2li3y9y

    Contoh

    Respons sukses

    JSONformat

    {
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F",
  "PolicyId": "po-000000zemnuyx2li3y9y"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.