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
Parameter permintaan
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | CreateBackup | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateBackup. |
| DBInstanceId | String | Yes | rm-uf6wjk5**** | ID instans. |
| DBName | String | No | rds_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. |
| BackupStrategy | String | No | db | Kebijakan yang ingin Anda gunakan untuk file backup. Nilai yang valid:
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. |
| BackupMethod | String | No | Physical | Jenis backup yang ingin Anda lakukan. Nilai yang valid:
Nilai default: Physical. Catatan
|
| BackupType | String | No | Auto | Metode backup. Nilai yang valid:
Nilai default: Auto. Catatan
|
| ResourceGroupId | String | No | rg-acfmy***** | ID kelompok sumber daya. |
Parameter respons
| Parameter | Type | Example | Description |
| BackupJobId | String | 5073731 | ID task backup. |
| RequestId | String | 2C125605-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 HTTP | Kode kesalahan | Pesan kesalahan | Description |
| 403 | OperationDenied.ApiForbidden | operation not permitted. | Pesan kesalahan yang dikembalikan karena operasi saat ini tidak didukung. |
Untuk daftar kode kesalahan, kunjungi API Error Center.