RestoreInstance - Tair (Redis® OSS-Compatible) - Alibaba Cloud Documentation Center

Deskripsi operasi

Jika instans Anda adalah instans berbasis DRAM atau instans yang dioptimalkan untuk memori persisten dan memiliki fitur data flashback yang diaktifkan, Anda dapat memanggil operasi ini untuk memulihkan seluruh instans atau kunci tertentu ke titik waktu tertentu dengan akurasi hingga detik. Pendekatan ini memungkinkan pemulihan data yang lebih detail halus.
Untuk jenis instans lainnya, disarankan untuk memanggil operasi CreateInstance atau CreateTairInstance guna memulihkan data backup ke instans baru.

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

kvstore:RestoreInstance

update

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans.	r-bp1zxszhcgatnx****
BackupId	string	No	ID file backup. Anda dapat memanggil operasi DescribeBackups untuk mengkueri ID file backup.	78241****
RestoreType	string	No	Mode pemulihan. Nilai yang valid: 0 (default): Parameter tidak valid. 1: memulihkan data ke titik waktu tertentu. Anda hanya dapat menentukan nilai ini jika fitur data flashback diaktifkan untuk instans tersebut. Jika Anda menentukan nilai ini, Anda juga perlu mengatur parameter RestoreTime.	1
RestoreTime	string	No	Titik waktu yang ingin Anda pulihkan datanya. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC. Catatan Titik waktu tidak boleh lebih awal daripada titik waktu saat fitur data flashback diaktifkan.	2021-07-06T07:25:57Z
FilterKey	string	No	Kunci yang ingin Anda pulihkan. Anda dapat menentukan multiple kunci. Pisahkan multiple kunci dengan koma (,). Ekspresi reguler didukung. Jika Anda tidak menentukan parameter ini, seluruh instans akan dipulihkan. Jika Anda menentukan parameter ini, hanya kunci yang terlibat yang akan dipulihkan. Hanya instans klasik yang mendukung fitur ini. Catatan Dalam ekspresi reguler, tanda bintang (``) mencocokkan nol atau lebih kemunculan subekspresi sebelumnya. Misalnya, jika Anda mengatur parameter ini menjadi `h.llo`, string seperti `hllo` dan `heeeello` akan sesuai.	key:00000007198*
TimeShift	string	No	Saat Anda memulihkan instans klasik, baik Anda memilih untuk memulihkan semua data maupun kunci tertentu, Anda dapat menerapkan offset pada waktu kedaluwarsa kunci. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC. Kunci akan kedaluwarsa setelah periode validitas tersisa kunci tersebut berakhir berdasarkan titik waktu offset kedaluwarsa. Catatan Fitur ini hanya berlaku untuk kunci dan tidak berfungsi pada elemen dalam struktur data buatan sendiri Tair, seperti bidang dalam exHash dan skeys dalam TairTS. Titik waktu ini harus berada di antara titik waktu flashback yang ditentukan dan waktu pengiriman tugas pemulihan data.	2021-07-06T08:25:57Z

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	8D0C0AFC-E9CD-47A4-8395-5C31BF9B****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "8D0C0AFC-E9CD-47A4-8395-5C31BF9B****"
}

Respons error

JSONformat

{
"RequestId" : "AFA391BF-808F-4DA6-80A2-A382108A0945"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	ServiceNotSupport	This service not supported.
400	MissingParameter	Missing Required Param: BackupId or RestoreTime or RestoreType.
400	ResroreParamNotMatch	restoreType is not match with backupId or restoreTime.
400	InvalidRestoreTime.Format	Specified restore time is not valid.
400	ZoneMigrationError.StillingRunning	Zone migration task is still running
400	InvalidBinlog.NotValid	The available binlog is not valid in recovery time.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.