すべてのプロダクト
Search

このプロダクト

    Tair (Redis® OSS-Compatible):RestoreInstance

    ドキュメントセンター

    Tair (Redis® OSS-Compatible):RestoreInstance

    最終更新日:Mar 30, 2026

    バックアップファイル内のデータを、指定された Tair (Redis OSS-compatible) インスタンスに復元します。

    操作説明

    今すぐお試しください

    この 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 操作を呼び出して、バックアップファイルの ID をクエリできます。

    78241****
    RestoreType

    string

    任意

    復元モード。有効値：

    • 0 (デフォルト)：パラメーターは無効です。

    • 1：データを特定の時点に復元します。この値は、インスタンスで データフラッシュバック 機能が有効になっている場合にのみ指定できます。この値を指定する場合は、RestoreTime パラメーターも設定する必要があります。

    1
    RestoreTime

    string

    任意

    データを復元する時点。時間は yyyy-MM-ddTHH:mmZ 形式の ISO 8601 標準で指定します。時間は協定世界時 (UTC) である必要があります。

    説明

    この時点は、データフラッシュバック機能が有効になった時点より前にすることはできません。

    2021-07-06T07:25:57Z
    FilterKey

    string

    任意

    復元するキー。複数のキーを指定できます。複数のキーはコンマ (,) で区切ります。正規表現がサポートされています。

    • このパラメーターを指定しない場合、インスタンス全体が復元されます。

    • このパラメーターを指定した場合、関連するキーのみが復元されます。クラシックインスタンスのみがこの機能をサポートします。

    説明

    正規表現では、アスタリスク (*) は、その前にある部分式の 0 回以上の出現に一致します。たとえば、このパラメーターを h.*llo に設定すると、hllo や heeeello などの文字列が一致します。

    key:00000007198*
    TimeShift

    string

    任意

    クラシックインスタンスを復元する場合、すべてのデータまたは特定のキーのどちらを復元するかに関わらず、キーの有効期限にオフセットを適用できます。時間は yyyy-MM-ddTHH:mmZ 形式の ISO 8601 標準で指定します。時間は協定世界時 (UTC) である必要があります。キーは、有効期限オフセット時点に基づいてキーの残りの有効期間が経過した後に有効期限切れになります。

    説明

    • この機能はキーにのみ適用され、exHash のフィールドや TairTS の skey など、Tair の自己開発データ構造の要素には機能しません。

    • この時点は、指定されたフラッシュバック時点とデータ復元タスクの送信時間の間である必要があります。

    2021-07-06T08:25:57Z

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエストの ID。

    8D0C0AFC-E9CD-47A4-8395-5C31BF9B****

    例

    成功レスポンス

    JSONJSON

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

    エラーレスポンス

    JSONJSON

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

    エラーコード

    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.

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

    変更履歴

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