All Products
Search
Document Center

Cloud Backup:CreatePolicyBindings

Last Updated:Oct 26, 2026

Mengaitkan satu atau beberapa sumber data dengan kebijakan.

Deskripsi operasi

  • Setiap panggilan hanya mendukung pengikatan sumber data dengan tipe yang sama ke kebijakan yang sama.

  • Satu Instance ECS hanya dapat dikaitkan dengan satu kebijakan.

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:CreatePolicyBindings

create

*Semua Sumber daya.

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

PolicyId

string

No

ID kebijakan.

po-000************8ep

PolicyBindingList

array<object>

No

Daftar pengikatan kebijakan.

array<object>

No

Detail pengikatan kebijakan.

PolicyBindingDescription

string

No

Deskripsi pengikatan kebijakan.

This is a description of the policy binding

DataSourceId

string

No

ID sumber data. Maknanya bervariasi berdasarkan bidang SourceType:

  • UDM_ECS: ID Instance ECS.

  • OSS: Nama bucket OSS.

  • NAS: ID sistem file NAS Alibaba Cloud.

  • COMMON_NAS: ID Instans NAS on-premises.

  • ECS_FILE: ID Instance ECS.

  • File: ID klien Cloud Backup.

  • COMMON_FILE_SYSTEM: ID sumber data untuk CPFS (cadangan berbasis agen).

  • CPFS: ID sistem file CPFS (cadangan tanpa agen).

i-bp1************dl8

Disabled

string

No

Apakah kebijakan ditangguhkan untuk sumber data. Nilai valid:

  • true: Ditangguhkan.

  • false: Tidak ditangguhkan.

true

SourceType

string

No

Tipe sumber data. Nilai valid:

  • UDM_ECS: Cadangan Instance ECS.

  • OSS: Cadangan OSS.

  • NAS: Cadangan NAS Alibaba Cloud.

  • COMMON_NAS: Cadangan NAS on-premises.

  • ECS_FILE: Cadangan File ECS Edisi Standar.

  • File: Cadangan file on-premises.

  • COMMON_FILE_SYSTEM: Cadangan CPFS berbasis agen.

  • OTS: Cadangan Tablestore.

  • CPFS: Cadangan CPFS tanpa agen.

UDM_ECS

Source

string

No

Jalur sumber. Maknanya bervariasi berdasarkan nilai SourceType:

  • OSS: awalan yang akan dicadangkan. Jika Anda tidak menentukan parameter ini, direktori root seluruh bucket akan dicadangkan. Hanya satu awalan yang didukung. Untuk mencadangkan objek yang namanya dimulai dengan awalan data, masukkan data alih-alih /data.

  • ECS_FILE: direktori yang akan dicadangkan. Jika Anda tidak menentukan parameter ini, semua direktori akan dicadangkan. Anda dapat menentukan beberapa direktori sekaligus. Untuk mencadangkan file di direktori /a dan /b, masukkan ["/a", "/b"].

  • File: direktori yang akan dicadangkan. Jika Anda tidak menentukan parameter ini, semua direktori akan dicadangkan. Anda dapat menentukan beberapa direktori sekaligus. Untuk mencadangkan file di direktori /a dan /b, masukkan ["/a", "/b"].

  • COMMON_FILE_SYSTEM: wajib. Jalur yang akan dicadangkan. Anda dapat menentukan beberapa jalur sekaligus. Untuk mencadangkan jalur /a dan /b, masukkan ["/a", "/b"]. Untuk mencadangkan jalur root, masukkan ["/"].

  • COMMON_NAS: wajib. Jalur yang akan dicadangkan. Hanya satu jalur yang didukung. Untuk mencadangkan jalur /a, masukkan ["/a"]. Untuk mencadangkan jalur root, masukkan ["/"].

  • OTS: daftar tabel yang akan dicadangkan. Jika Anda tidak menentukan parameter ini, semua tabel akan dicadangkan. Anda dapat menentukan beberapa tabel sekaligus. Untuk mencadangkan Tabel a dan Tabel b, masukkan ["a", "b"].

  • CPFS: wajib. Jalur yang akan dicadangkan. Anda dapat menentukan beberapa jalur sekaligus. Untuk mencadangkan jalur /a dan /b, masukkan ["/a", "/b"]. Untuk mencadangkan jalur root, masukkan ["/"].

/src

Include

string

No

Tipe file yang akan disertakan dalam cadangan. Parameter ini tersedia ketika SourceType diatur ke ECS_FILE, File, NAS, COMMON_NAS, COMMON_FILE_SYSTEM, atau CPFS. Semua file dengan tipe yang ditentukan akan dicadangkan. Nilai dapat memiliki panjang hingga 255 karakter.

[\"*.doc\",\"*.xltm\"]

Exclude

string

No

Tipe file yang akan dikecualikan dari cadangan. Parameter ini tersedia ketika SourceType diatur ke ECS_FILE, File, NAS, COMMON_NAS, COMMON_FILE_SYSTEM, atau CPFS. Tidak ada file dengan tipe yang ditentukan yang akan dicadangkan. Nilai dapat memiliki panjang hingga 255 karakter.

[\"*.doc\",\"*.xltm\"]

SpeedLimit

string

No

Pembatasan kecepatan trafik cadangan. Parameter ini wajib ketika SourceType diatur ke ECS_FILE atau File. Formatnya adalah {start}{end}{bandwidth}. Beberapa konfigurasi pembatasan kecepatan harus dipisahkan, dan periode pengatur waktunya tidak boleh tumpang tindih.

  • start: jam mulai.

  • end: jam berakhir.

  • bandwidth: batas bandwidth, dalam KB/s.

0:24:1024

AdvancedOptions

object

No

Opsi lanjutan.

UdmDetail

object

No

Opsi lanjutan untuk cadangan Instance ECS.

ExcludeDiskIdList

array

No

ID cloud disk yang tidak perlu dilindungi. Parameter ini diabaikan jika DiskIdList tidak kosong.

string

No

ID cloud disk yang tidak perlu dilindungi.

d-bp1************apo

DiskIdList

array

No

ID cloud disk yang akan dilindungi. Nilai ini kosong ketika semua cloud disk dilindungi.

string

No

ID cloud disk yang akan dilindungi.

d-bp1************apo

SnapshotGroup

boolean

No

Apakah akan membuat kelompok yang konsisten dengan snapshot. Kelompok yang konsisten dengan snapshot hanya dapat dibuat ketika semua cloud disk adalah ESSD.

true

AppConsistent

boolean

No

Apakah akan mengaktifkan konsistensi aplikasi. Snapshot yang konsisten dengan aplikasi hanya dapat dibuat ketika semua cloud disk adalah ESSD.

false

RamRoleName

string

No

Nama peran RAM yang dikonfigurasi untuk membuat snapshot yang konsisten dengan aplikasi. Parameter ini wajib ketika AppConsistent diatur ke true.

AliyunECSInstanceForHbrRole

PreScriptPath

string

No

Jalur skrip pra-membekukan yang akan dieksekusi sebelum membuat snapshot yang konsisten dengan aplikasi. Parameter ini wajib ketika AppConsistent diatur ke true.

/tmp/prescript.sh

PostScriptPath

string

No

Jalur skrip pasca-pencairan yang akan dieksekusi setelah membuat snapshot yang konsisten dengan aplikasi. Parameter ini wajib ketika AppConsistent diatur ke true.

/tmp/postscript.sh

EnableFsFreeze

boolean

No

Parameter ini hanya wajib ketika AppConsistent diatur ke true. Apakah akan menggunakan mekanisme Linux FsFreeze untuk memastikan konsistensi hanya-baca sistem file sebelum membuat snapshot yang konsisten dengan aplikasi. Nilai default: true.

true

TimeoutInSeconds

integer

No

Periode pengatur waktu tunggu membekukan I/O, dalam detik. Parameter ini wajib ketika AppConsistent diatur ke true. Nilai default: 30.

30

EnableWriters

boolean

No

Apakah akan mengonfigurasi snapshot yang konsisten dengan aplikasi. Parameter ini wajib ketika AppConsistent diatur ke true. Nilai valid:

  • true: membuat snapshot yang konsisten dengan aplikasi.

  • false: membuat snapshot yang konsisten dengan sistem file. Nilai default: true.

true

OssDetail

object

No

Opsi lanjutan untuk cadangan OSS.

InventoryId

string

No

Nama inventaris OSS. Jika nilai ini tidak kosong, inventaris OSS digunakan untuk penyetelan kinerja.

  • Kami menyarankan Anda menggunakan inventaris untuk meningkatkan kinerja cadangan inkremental saat mencadangkan lebih dari 100 juta objek OSS. Biaya penyimpanan yang dihasilkan oleh file inventaris ditagihkan secara terpisah oleh OSS.

  • Diperlukan pengatur waktu untuk menghasilkan file inventaris OSS. Cadangan dapat gagal sebelum file inventaris dihasilkan. Anda dapat menunggu siklus berikutnya untuk menjalankan cadangan.

oss-inventory-default

InventoryCleanupPolicy

string

No

Apakah akan menghapus file inventaris setelah cadangan. Parameter ini hanya valid ketika inventaris OSS digunakan. Nilai valid:

  • NO_CLEANUP: tidak menghapus file.

  • DELETE_CURRENT: menghapus file saat ini.

  • DELETE_CURRENT_AND_PREVIOUS: menghapus semua file.

NO_CLEANUP

IgnoreArchiveObject

boolean

No

Apakah akan mengabaikan objek arsip dalam statistik tugas dan daftar file gagal.

true

FileDetail

object

No

Opsi lanjutan untuk cadangan file.

UseVSS

boolean

No

Apakah akan mengaktifkan fitur Volume Shadow Copy Service (VSS) untuk Windows. Nilai valid:

  • true: mengaktifkan fitur.

  • false: menonaktifkan fitur.

true

AdvPolicy

boolean

No

Apakah akan menggunakan kebijakan lanjutan. Nilai valid:

  • true: menggunakan kebijakan lanjutan.

  • false: tidak menggunakan kebijakan lanjutan.

true

CommonNasDetail

object

No

Opsi lanjutan untuk cadangan NAS on-premises.

FullOnIncrementFail

boolean

No

Apakah akan beralih ke cadangan penuh ketika cadangan inkremental gagal. Nilai valid:

  • true: beralih ke cadangan penuh saat gagal.

  • false: tidak beralih ke cadangan penuh saat gagal.

true

FetchSliceSize

integer

No

Ukuran irisan sub-tugas, diukur berdasarkan jumlah file.

100000

ClusterId

string

No

ID kelompok klien cadangan. Untuk cadangan NAS on-premises, klien dipilih dari kelompok klien cadangan untuk melakukan cadangan.

cl-000**************ggu

CommonFileSystemDetail

object

No

Opsi lanjutan untuk cadangan CPFS.

FullOnIncrementFail

boolean

No

Apakah akan beralih ke cadangan penuh ketika cadangan inkremental gagal. Nilai valid:

  • true: beralih ke cadangan penuh saat gagal.

  • false: tidak beralih ke cadangan penuh saat gagal.

true

FetchSliceSize

integer

No

Ukuran irisan sub-tugas, diukur berdasarkan jumlah file.

100000

CrossAccountType

string

No

Tipe cadangan lintas akun. Nilai default: SELF_ACCOUNT. Nilai valid:

  • SELF_ACCOUNT: mencadangkan data dalam akun saat ini.

  • CROSS_ACCOUNT: mencadangkan data lintas akun.

SELF_ACCOUNT

CrossAccountUserId

integer

No

UID Alibaba Cloud dari akun sumber yang digunakan untuk cadangan lintas akun.

144**********732

CrossAccountRoleName

string

No

Nama peran RAM yang dibuat di akun sumber untuk cadangan lintas akun.

hbrcrossrole

Elemen respons

Element

Type

Description

Example

object

Data tanggapan.

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. Nilai successful menunjukkan keberhasilan, dan pesan error dikembalikan ketika terjadi error.

successful

RequestId

string

ID permintaan.

82CC5B6C-72F7-5D39-92F6-67887DF9AD46

Contoh

Respons sukses

JSONformat

{
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "82CC5B6C-72F7-5D39-92F6-67887DF9AD46"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 PolicyAlreadyBoundWithThisDataSource This datasource has already been bound with the policy, please use another one. Sumber data sudah terikat pada kebijakan ini. Coba ikatkan kebijakan baru.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.