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

Deskripsi operasi

Jika instance Anda adalah instance berbasis DRAM Tair (Enterprise Edition) dengan arsitektur klasik, Anda dapat memanggil operasi ini untuk memulihkan kunci tertentu dalam instance saat ini ke titik waktu yang akurat hingga detik, sehingga memungkinkan pemulihan data yang lebih granular.
Untuk jenis instance lainnya, kami menyarankan Anda memanggil operasi CreateInstance atau CreateTairInstance untuk memulihkan data pencadangan ke instance 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 instance.	r-bp1zxszhcgatnx****
BackupId	string	No	ID file pencadangan instance. Anda dapat memanggil operasi DescribeBackups untuk mengkueri ID.	78241****
RestoreType	string	No	Jenis pemulihan. Nilai yang valid: 0 (default): Nilai ini tidak valid. 1: memulihkan data ke titik waktu yang ditentukan. Anda dapat menentukan nilai ini hanya jika fitur data flashback diaktifkan untuk instance. Jika Anda menentukan nilai ini, Anda juga harus menentukan parameter RestoreTime.	1
RestoreTime	string	No	Titik waktu yang ingin Anda gunakan untuk memulihkan data. Tentukan nilainya dalam format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC. Catatan Titik waktu tidak boleh lebih awal dari titik waktu saat fitur data flashback diaktifkan.	2021-07-06T07:25:57Z
FilterKey	string	No	Kunci yang ingin Anda pulihkan. Ekspresi reguler didukung. Pisahkan beberapa nilai dengan koma (,). Jika Anda tidak menentukan parameter ini, seluruh instance dipulihkan. Jika Anda menentukan parameter ini, hanya kunci yang ditentukan yang dipulihkan. Fitur ini hanya didukung oleh instance edisi klasik. Catatan Sebagai contoh, dalam ekspresi reguler, tanda bintang (``) menunjukkan bahwa subekspresi sebelumnya dicocokkan beberapa kali. Jika Anda menentukan `h.llo` untuk parameter ini, sistem mencocokkan string seperti `hllo` dan `heeeello`.	key:00000007198*
TimeShift	string	No	Saat Anda memulihkan instance edisi klasik, Anda dapat menggeser waktu kedaluwarsa kunci terlepas dari apakah Anda memilih untuk memulihkan seluruh kumpulan data atau kunci tertentu. Tentukan nilainya dalam format yyyy-MM-ddTHH:mmZ. Waktu harus dalam UTC. Instance menggeser sisa durasi kedaluwarsa kunci pada titik waktu flashback yang ditentukan agar mulai dihitung dari titik waktu pergeseran kedaluwarsa yang ditentukan. Catatan Fitur ini hanya mendukung pergeseran waktu kedaluwarsa pada tingkat kunci. Fitur ini tidak mendukung pergeseran waktu kedaluwarsa internal di dalam kunci struktur data khusus Tair, seperti Field exHash atau Skey TS. Titik waktu tidak boleh lebih awal dari titik waktu flashback yang ditentukan dan tidak boleh lebih lambat dari titik waktu saat tugas pemulihan dikirimkan.	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.