All Products
Search
Document Center

:Buat file backup

Last Updated:May 26, 2026

Anda dapat memanggil operasi CreateBackup untuk membuat file backup suatu instans.

Operasi ini menggunakan fitur backup ApsaraDB RDS untuk membuat file backup. Anda juga dapat menggunakan Database Backup (DBS) untuk membuat file backup.

Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:

  • Instans berada dalam status Running.
  • Instans tidak memiliki task backup yang sedang berjalan.
  • Jumlah file backup yang dibuat per hari untuk suatu instans tidak boleh melebihi 20.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

ParameterTypeRequiredExampleDescription
ActionStringYesCreateBackup

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateBackup.

DBInstanceIdStringYesrm-uf6wjk5****

ID instans.

DBNameStringNords_mysql

Nama database yang datanya ingin Anda backup. Pisahkan nama database dengan koma (,).

Catatan Anda dapat menentukan parameter ini saat melakukan cadangan logis pada database individual dari instans ApsaraDB RDS for MySQL. Anda juga dapat menentukan parameter ini saat melakukan cadangan fisik penuh pada database individual dari instans ApsaraDB RDS for SQL Server.
BackupStrategyStringNodb

Kebijakan yang ingin Anda gunakan untuk file backup. Nilai yang valid:

  • db: backup tingkat database.
  • instance: backup tingkat instans.
Catatan Anda dapat menentukan parameter ini saat melakukan cadangan logis pada instans ApsaraDB RDS for MySQL. Anda juga dapat menentukan parameter ini saat melakukan cadangan fisik penuh pada instans ApsaraDB RDS for SQL Server.
BackupMethodStringNoPhysical

Jenis backup yang ingin Anda lakukan. Nilai yang valid:

  • Logical: cadangan logis
  • Physical: cadangan fisik
  • Snapshot: cadangan snapshot

Nilai default: Physical.

Catatan
  • Anda hanya dapat melakukan cadangan logis jika database telah dibuat pada instans tersebut.
  • Saat melakukan cadangan snapshot pada instans ApsaraDB RDS for MariaDB, Anda harus menetapkan parameter ini ke Physical.
  • Untuk informasi lebih lanjut tentang jenis backup yang didukung, lihat Backup instans ApsaraDB RDS for MySQL.
  • Saat melakukan cadangan snapshot pada instans ApsaraDB RDS for SQL Server yang menggunakan SSD standar atau enhanced SSD (ESSD), Anda harus menetapkan parameter ini ke Snapshot.
BackupTypeStringNoAuto

Metode backup. Nilai yang valid:

  • Auto: Sistem menentukan apakah akan melakukan cadangan penuh atau inkremental
  • FullBackup: cadangan penuh.

Nilai default: Auto.

Catatan
  • Anda hanya perlu menetapkan parameter ini jika instans menjalankan mesin database SQL Server.
  • Parameter ini hanya berlaku jika parameter BackupMethod ditetapkan ke Physical.
ResourceGroupIdStringNorg-acfmy*****

ID kelompok sumber daya.

Parameter respons

ParameterTypeExampleDescription
BackupJobIdString5073731

ID task backup.

RequestIdString2C125605-266F-41CA-8AC5-3A643D4F42C5

ID permintaan.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=CreateBackup
&DBInstanceId=rm-uf6wjk5****
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<CreateBackupResponse>
    <RequestId>2C125605-266F-41CA-8AC5-3A643D4F42C5</RequestId>
    <BackupJobId>5073731</BackupJobId>
</CreateBackupResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2C125605-266F-41CA-8AC5-3A643D4F42C5",
  "BackupJobId" : "5073731"
}

Kode kesalahan

Kode status HTTPKode kesalahanPesan kesalahanDescription
403OperationDenied.ApiForbiddenoperation not permitted.Pesan kesalahan yang dikembalikan karena operasi saat ini tidak didukung.

Untuk daftar kode kesalahan, kunjungi API Error Center.