RestoreInstance - Tair (Redis® OSS-Compatible) - Alibaba Cloud ドキュメントセンター

操作説明

クラシックアーキテクチャを使用するメモリ強化型 Tair Enterprise Edition インスタンスの場合、指定したキーを秒単位の精度でポイントインタイムに復元し、きめ細かいデータ復旧が可能です。
他のすべてのインスタンスタイプでは、CreateInstance API または CreateTairInstance API を使用して、バックアップデータを新しいインスタンスに復元します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

kvstore:RestoreInstance

update

*DBInstance

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InstanceId	string	必須	インスタンスの ID。	r-bp1zxszhcgatnx****
BackupId	string	任意	バックアップファイルの ID。DescribeBackups API を呼び出すことで、バックアップファイルの ID を確認できます。	78241****
RestoreType	string	任意	復元方法。有効な値： 0 (デフォルト)：この値は非推奨です。 1：特定のポイントインタイムにデータを復元します。インスタンスでデータフラッシュバック機能が有効になっている場合にのみ、このパラメーターを 1 に設定できます。このパラメーターを 1 に設定する場合は、RestoreTime パラメーターも指定する必要があります。	1
RestoreTime	string	任意	復元するポイントインタイム。時間は yyyy-MM-ddTHH:mm:ssZ のフォーマット (UTC) で指定します。説明このポイントインタイムは、データフラッシュバック機能が有効になった時刻より前に設定できません。	2021-07-06T07:25:57Z
FilterKey	string	任意	復元するキー。正規表現として指定できます。複数のキーを指定するには、コンマ (,) で区切ります。このパラメーターを指定しない場合、インスタンス全体が復元されます。このパラメーターを指定した場合、指定されたキーのみが復元されます。この機能は、クラシックアーキテクチャを使用するインスタンスでのみ利用可能です。説明正規表現では、アスタリスク (``) は、直前の要素が 0 回以上出現する場合に一致します。たとえば、このパラメーターを `h.llo` に設定すると、`hllo` や `heeeello` などの文字列が一致します。	key:00000007198*
TimeShift	string	任意	クラシックアーキテクチャを使用するインスタンスの場合、復元されたキーの有効期限にオフセットを適用できます。これは、インスタンス全体を復元する場合でも、特定のキーのみを復元する場合でも適用されます。システムは、指定されたフラッシュバックポイントインタイムでキーの残りの有効期間 (TTL) を計算し、この TTL を `TimeShift` の値に加算して、キーの新しい有効期限を設定します。時間は yyyy-MM-ddTHH:mm:ssZ のフォーマット (UTC) で指定します。説明この機能はトップレベルキーの有効期限のみを調整します。exHash のフィールドや時系列 (TS) データ構造のセカンダリキー (Skeys) など、Tair 固有のデータ構造内の要素の有効期限には適用されません。指定する時間は、`RestoreTime` よりも後で、タスクの投入時間よりも前である必要があります。	2021-07-06T08:25:57Z

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスオブジェクト。
RequestId	string	リクエスト ID。	8D0C0AFC-E9CD-47A4-8395-5C31BF9B****

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。