Ubah pengaturan cadangan cross-region instans ApsaraDB RDS -

Anda dapat memanggil operasi ModifyInstanceCrossBackupPolicy untuk mengubah pengaturan cadangan cross-region instans ApsaraDB RDS.

Sebelum memanggil operasi ini, pastikan instans sumber menjalankan salah satu mesin database berikut:

MySQL. Untuk informasi selengkapnya, lihat Aktifkan cadangan cross-region untuk instans ApsaraDB RDS for MySQL.
SQL Server. Untuk informasi selengkapnya, lihat Aktifkan cadangan cross-region untuk instans ApsaraDB RDS for SQL Server.
PostgreSQL. Untuk informasi selengkapnya, lihat Aktifkan cadangan cross-region untuk instans ApsaraDB RDS for PostgreSQL.

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

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyInstanceCrossBackupPolicy	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyInstanceCrossBackupPolicy.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxxxxx	ID instans.
RegionId	String	Yes	cn-hangzhou	ID wilayah tempat instans sumber berada. Anda dapat memanggil operasi DescribeRegions untuk menampilkan daftar wilayah terbaru.
CrossBackupType	String	No	1	Kebijakan yang digunakan untuk menyimpan file backup cross-region instans. Tetapkan nilainya ke 1. Nilai 1 menunjukkan bahwa semua file backup cross-region disimpan.
LogBackupEnabled	String	No	1	Status fitur cadangan log cross-region pada instans. Nilai yang valid: 0: menonaktifkan fitur. 1: mengaktifkan fitur. Catatan Anda hanya dapat mengaktifkan fitur cadangan log cross-region jika fitur cadangan cross-region telah diaktifkan.
BackupEnabled	String	No	1	Status fitur cadangan cross-region pada instans. Parameter ini menentukan apakah Anda dapat melakukan backup data dan log. Nilai yang valid: 0: menonaktifkan fitur. 1: mengaktifkan fitur. Catatan Sebelum mengaktifkan fitur cadangan cross-region, Anda harus mengonfigurasi parameter CrossBackupRegion.
CrossBackupRegion	String	No	cn-shanghai	ID wilayah tujuan tempat file backup cross-region instans disimpan.
RetentType	Integer	No	1	Kebijakan yang digunakan untuk menyimpan file backup cross-region instans. Tetapkan nilainya ke 1. Nilai 1 menunjukkan bahwa file backup cross-region instans disimpan sesuai periode retensi yang ditentukan.
Retention	Integer	No	7	Jumlah hari penyimpanan file backup cross-region instans. Nilai yang valid: 7 hingga 1825.

Parameter respons

Parameter	Type	Example	Description
BackupEnabled	String	Enable	Status fitur cadangan cross-region pada instans. Nilai yang valid: Disable Enable
RegionId	String	cn-hangzhou	ID wilayah tempat instans sumber berada. Anda dapat memanggil operasi DescribeRegions untuk menampilkan daftar wilayah terbaru.
LogBackupEnabled	String	Enable	Status fitur cadangan log cross-region pada instans. Nilai yang valid: Disable Enable
RequestId	String	50A6059D-6DBB-46C6-A851-1EE93C9013CF	ID permintaan.
RetentType	Integer	1	Kebijakan yang digunakan untuk menyimpan file backup cross-region instans. Nilai default: 1. Nilai 1 menunjukkan bahwa file backup cross-region instans disimpan sesuai periode retensi yang ditentukan.
CrossBackupRegion	String	cn-shanghai	ID wilayah tujuan tempat file backup cross-region instans disimpan.
CrossBackupType	String	1	Kebijakan yang digunakan untuk menyimpan file backup cross-region instans. Nilai default: 1. Nilai 1 menunjukkan bahwa semua file backup cross-region disimpan.
Retention	Integer	15	Jumlah hari penyimpanan file backup cross-region instans. Nilai yang valid: 7 hingga 1825.
DBInstanceId	String	rm-uf6wjk5xxxxxxxxxx	ID instans.

Contoh

Permintaan Contoh

http(s)://rds.aliyuncs.com/?Action=ModifyInstanceCrossBackupPolicy
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&RegionId=cn-hangzhou
&<Common request parameters>

Respons Sukses Contoh

XML format

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

<ModifyInstanceCrossBackupPolicyResponse>
<CrossBackupType>1</CrossBackupType>
    <LogBackupEnabled>Enable</LogBackupEnabled>
    <BackupEnabled>Enable</BackupEnabled>
    <CrossBackupRegion>cn-shanghai</CrossBackupRegion>
    <RetentType>1</RetentType>
    <RequestId>50A6059D-6DBB-46C6-A851-1EE93C9013CF</RequestId>
    <DBInstanceId>rm-bpxxxxx</DBInstanceId>
    <RegionId>cn-hangzhou</RegionId>
    <StorageType>oss</StorageType>
    <Endpoint></Endpoint>
    <Retention>15</Retention>
</ModifyInstanceCrossBackupPolicyResponse>

JSON format

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

{
  "CrossBackupType" : "1",
  "LogBackupEnabled" : "Enable",
  "BackupEnabled" : "Enable",
  "CrossBackupRegion" : "cn-shanghai",
  "RetentType" : 1,
  "RequestId" : "50A6059D-6DBB-46C6-A851-1EE93C9013CF",
  "DBInstanceId" : "rm-bpxxxxx",
  "RegionId" : "cn-hangzhou",
  "StorageType" : "oss",
  "Endpoint" : "",
  "Retention" : 15
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	ParameterLeastAssociate	Must input at least one optional parameter.	Pesan kesalahan yang dikembalikan karena parameter restoreTime dan parameter BackupId instans tidak boleh kosong secara bersamaan. Anda harus mengonfigurasi setidaknya salah satu parameter tersebut dan mencoba lagi.
400	InvalidRegion.Format	Specified Region is not valid.	Pesan kesalahan yang dikembalikan karena wilayah yang ditentukan tidak valid.
400	OperationDenied.SwitchToCrossRegionBackup	Snapshot backup does not support cross region backup storage at present.	Pesan kesalahan yang dikembalikan karena backup dan penyimpanan cross-region tidak didukung untuk cadangan snapshot.
400	OperationDenied.SwitchToSnapshot	Snapshot backup does not support cross region storage at present. Please turn off cross region backup before switching to snapshot backup mode.	Pesan kesalahan yang dikembalikan karena file cadangan snapshot tidak dapat disimpan di wilayah yang berbeda dari wilayah tempat instans berada. Sebelum mengaktifkan fitur cadangan snapshot, Anda harus menonaktifkan fitur cadangan cross-region.
400	OperationDenied.SwitchSnapshotToPhysical	Only physical backup to snapshot backup is supported.	Pesan kesalahan yang dikembalikan karena operasi ini hanya mendukung perubahan dari metode backup fisik ke metode backup snapshot.
403	IncorrectEngineVersion	Current engine version does not support operations.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk versi mesin database yang dijalankan oleh instans.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instans berada dalam kondisi saat ini.
403	IncorrectDBInstanceEngine	Current DB Instance engine does not support this operation.	Pesan kesalahan yang dikembalikan karena mesin database instans tidak mendukung operasi ini.
403	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	Pesan kesalahan yang dikembalikan karena instans terkunci.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instans berada dalam kondisi saat ini.
404	InvalidDBInstance.NotFound	Specified instance does not exist or not support.	Pesan kesalahan yang dikembalikan karena instans tidak ditemukan, telah dihapus, atau tidak mendukung operasi tersebut.

Untuk daftar kode kesalahan, kunjungi API Error Center.