Kueri file cadangan data cross-region - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi DescribeCrossRegionBackups untuk mengkueri file cadangan data cross-region suatu instance.

Untuk informasi lebih lanjut tentang cara mengkueri file cadangan log cross-region instance RDS, lihat DescribeCrossRegionLogBackupFiles.

Sebelum memanggil operasi ini, pastikan instance menjalankan salah satu engine database berikut:

MySQL. Untuk informasi lebih lanjut, lihat Back up an ApsaraDB RDS for MySQL instance across regions.
SQL Server. Untuk informasi lebih lanjut, lihat Back up an ApsaraDB RDS for SQL Server instance across regions.
PostgreSQL. Untuk informasi lebih lanjut, lihat Back up an ApsaraDB RDS for PostgreSQL instance across regions.

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 ini untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeCrossRegionBackups	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeCrossRegionBackups.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxxxxx	ID instans.
RegionId	String	Yes	cn-hangzhou	ID wilayah instans.
CrossBackupRegion	String	No	cn-shanghai	ID wilayah tujuan tempat file cadangan data cross-region disimpan.
CrossBackupId	Integer	No	14562	ID file cadangan data cross-region. Catatan Anda harus menentukan parameter CrossBackupId. Atau, Anda harus menentukan parameter StartTime dan EndTime.
StartTime	String	No	2019-05-30T12:10:00Z	Awal rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.
EndTime	String	No	2019-06-15T12:10:00Z	Akhir rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.
PageSize	Integer	No	30	Jumlah entri yang ditampilkan per halaman. Nilai yang valid: 30 50 100 Nilai default: 30.
PageNumber	Integer	No	1	Nomor halaman yang ditampilkan. Nilai yang valid: bilangan bulat positif bukan nol apa pun. Nilai default: 1.
BackupId	Integer	No	603524***	ID file cadangan data cross-region.
ResourceGroupId	String	No	rg-acfmy*****	ID kelompok sumber daya.

Parameter respons

Parameter	Type	Example	Description
EndTime	String	2019-06-15T12:10:00Z	Akhir rentang waktu yang dikueri.
StartTime	String	2019-05-30T12:10:00Z	Awal rentang waktu yang dikueri.
RequestId	String	60912B41-7579-4B5D-B289-8856030F0A6A	ID permintaan.
PageRecordCount	Integer	30	Jumlah file cadangan data cross-region pada halaman saat ini.
TotalRecordCount	Integer	100	Total jumlah entri yang dikembalikan.
PageNumber	Integer	1	Nomor halaman yang dikembalikan. Nilai yang valid: bilangan bulat positif bukan nol apa pun. Nilai default: 1.
RegionId	String	cn-hangzhou	ID wilayah instans.
Items	Array of Item		Array yang berisi detail file cadangan data cross-region.
Item
ConsistentTime	String	2019-06-12T05:44:46Z	Titik waktu yang ditunjukkan oleh data dalam file cadangan data cross-region.
DBInstanceStorageType	String	ssd	Jenis penyimpanan. Nilai yang valid: local_ssd: SSD lokal. Ini adalah jenis penyimpanan yang direkomendasikan. cloud_ssd: SSD standar. cloud_essd: enhanced SSD (ESSD).
CrossBackupId	Integer	14377	ID file cadangan data cross-region.
BackupType	String	F	Jenis cadangan data cross-region. Nilai yang valid: F: cadangan data penuh I: cadangan data inkremental
BackupStartTime	String	2019-05-30T12:10:00Z	Waktu mulai cadangan data cross-region.
CrossBackupSetLocation	String	oss	Lokasi tempat file cadangan data cross-region disimpan.
InstanceId	Integer	8161055	ID instans. Parameter ini digunakan untuk menentukan apakah instans yang menghasilkan file cadangan data cross-region merupakan instans primary atau secondary.
CrossBackupDownloadLink	String	http://rdsddrbak-shanghai.oss-cn-shanghai.aliyuncs.com/xxxxx	URL eksternal tempat Anda dapat mengunduh file cadangan data cross-region.
BackupEndTime	String	2019-06-15T12:10:00Z	Waktu saat file cadangan data cross-region dihasilkan.
EngineVersion	String	5.6	Versi engine database.
BackupSetStatus	Integer	0	Status cadangan data cross-region. Nilai yang valid: 0: Cadangan data cross-region berhasil. 1: Cadangan data cross-region gagal.
CrossBackupSetFile	String	cn-hangzhou_rm-xxxxx_hins81xxx_data_20190612134426_qp.xb	Nama paket terkompresi yang berisi file cadangan data cross-region.
BackupSetScale	Integer	0	Tingkat pembuatan file cadangan data cross-region. 0: cadangan tingkat instans 1: cadangan tingkat database
CrossBackupSetSize	Long	5312836	Ukuran file cadangan data cross-region. Satuan: byte.
CrossBackupRegion	String	cn-shanghai	ID wilayah tujuan tempat file cadangan data cross-region instans disimpan.
Category	String	HighAvailability	Edisi RDS instans. Nilai yang valid: Basic: Edisi Dasar. HighAvailability: Edisi Ketersediaan Tinggi. Finance: Edisi Perusahaan. Edisi ini hanya didukung oleh situs Tiongkok (aliyun.com).
Engine	String	mysql	Engine database.
BackupMethod	String	P	Metode yang digunakan untuk menghasilkan file cadangan data cross-region. Nilai yang valid: L: cadangan logis P: cadangan fisik
RestoreRegions	Array of String	"cn-hangzhou", "cn-shanghai"	Array yang berisi wilayah tempat file cadangan data cross-region dapat dipulihkan.

Contoh

Contoh permintaan

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

Contoh respons sukses

XML format

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

<DescribeCrossRegionBackupsResponse>
<Items>
		<Item>
			<CrossBackupSetFile>cn-hangzhou_rm-bpxxxxx_hins798xxxx_data_20190611125201.tar.gz</CrossBackupSetFile>
			<BackupSetScale>0</BackupSetScale>
			<BackupType>F</BackupType>
			<InstanceId>7980000</InstanceId>
			<CrossBackupId>14358</CrossBackupId>
			<BackupEndTime>2019-06-11T04:55:02Z</BackupEndTime>
			<BackupMethod>P</BackupMethod>
			<CrossBackupSetLocation>oss</CrossBackupSetLocation>
			<CrossBackupSetSize>2179643</CrossBackupSetSize>
			<Engine>mysql</Engine>
			<BackupStartTime>2019-06-11T04:52:46Z</BackupStartTime>
			<CrossBackupDownloadLink>http://rdsddrbak-zb.oss-cn-zhangjiakou.aliyuncs.com/cn-hangzhou_rm-bpxxxxx_hins7986073_data_20190611125201.tar.gz?OSSAccessKeyId=LTAxxxxx&amp;Expires=1560501641&amp;Signature=laK0kxxxxx%3D</CrossBackupDownloadLink>
			<Category>HighAvailability</Category>
			<CrossBackupRegion>cn-zhangjiakou</CrossBackupRegion>
			<RestoreRegions>
				<RestoreRegion>cn-hangzhou</RestoreRegion>
				<RestoreRegion>cn-zhangjiakou</RestoreRegion>
			</RestoreRegions>
			<EngineVersion>5.7</EngineVersion>
			<DBInstanceStorageType>ssd</DBInstanceStorageType>
		</Item>
	</Items>
	<TotalRecordCount>1</TotalRecordCount>
	<PageNumber>1</PageNumber>
	<RequestId>60912B41-7579-4B5D-B289-8856030F0A6A</RequestId>
	<RegionId>cn-hangzhou</RegionId>
	<EndTime>2019-06-11T08:00:00Z</EndTime>
	<StartTime>2019-06-10T00:00:00Z</StartTime>
	<PageRecordCount>30</PageRecordCount>
    </DescribeCrossRegionBackupsResponse>

JSON format

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

{
  "Items" : {
    "Item" : [ {
      "CrossBackupSetFile" : "cn-hangzhou_rm-bpxxxxx_hins798xxxx_data_20190611125201.tar.gz",
      "BackupSetScale" : 0,
      "BackupType" : "F",
      "InstanceId" : 7980000,
      "CrossBackupId" : 14358,
      "BackupEndTime" : "2019-06-11T04:55:02Z",
      "BackupMethod" : "P",
      "CrossBackupSetLocation" : "oss",
      "CrossBackupSetSize" : 2179643,
      "Engine" : "mysql",
      "BackupStartTime" : "2019-06-11T04:52:46Z",
      "CrossBackupDownloadLink" : "http://rdsddrbak-zb.oss-cn-zhangjiakou.aliyuncs.com/cn-hangzhou_rm-bpxxxxx_hins7986073_data_20190611125201.tar.gz?OSSAccessKeyId=LTAxxxxx&Expires=1560501641&Signature=laK0kxxxxx%3D",
      "Category" : "HighAvailability",
      "CrossBackupRegion" : "cn-zhangjiakou",
      "RestoreRegions" : {
        "RestoreRegion" : [ "cn-hangzhou", "cn-zhangjiakou" ]
      },
      "EngineVersion" : "5.7",
      "DBInstanceStorageType" : "ssd"
    } ]
  },
  "TotalRecordCount" : 1,
  "PageNumber" : 1,
  "RequestId" : "60912B41-7579-4B5D-B289-8856030F0A6A",
  "RegionId" : "cn-hangzhou",
  "EndTime" : "2019-06-11T08:00:00Z",
  "StartTime" : "2019-06-10T00:00:00Z",
  "PageRecordCount" : 30
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidRegion.Format	Specified Region is not valid.	Pesan kesalahan yang dikembalikan karena wilayah yang ditentukan tidak valid.
400	InvalidStartTime.Format	Specified start time is not valid.	Pesan kesalahan yang dikembalikan karena waktu mulai yang ditentukan tidak valid.
400	InvalidEndTime.Format	Specified end time is not valid.	Pesan kesalahan yang dikembalikan karena waktu akhir yang ditentukan tidak valid. Tentukan nilai yang valid dan coba lagi.
400	InvalidTime.Format	Specified time is not valid.	Pesan kesalahan yang dikembalikan karena format waktu tidak valid.
403	CrossBackupNotSupport	Specified region not support cross region backup.	Pesan kesalahan yang dikembalikan karena wilayah yang ditentukan tidak mendukung fitur cadangan cross-region.
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 ini.

Untuk daftar kode kesalahan, kunjungi API Error Center.