すべてのプロダクト
Search

このプロダクト

    Security Center:DescribeRestoreJobs

    ドキュメントセンター

    Security Center:DescribeRestoreJobs

    最終更新日:Mar 21, 2026

    復元タスクの詳細を照会します。

    操作説明

    サーバー上のデータがランサムウェアによって暗号化された場合、復元タスクを作成して、Security Center のバックアップデータを使用してサーバー上のデータを復元できます。

    説明

    ランサムウェア対策ポリシーを有効にすると、サーバー上のデータがポリシーに基づいてバックアップされます。ランサムウェア対策ポリシーの詳細については、「保護ポリシーの管理」をご参照ください。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    yundun-sas:DescribeRestoreJobs

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Status

    string

    任意

    復元タスクのステータス。有効な値：

    • RUNNING：タスクは実行中です。

    • COMPLETE：タスクは完了しました。

    • FAILED：タスクは失敗しました。

    • CANCELING：タスクはキャンセル中です。

    • CANCELED：タスクはキャンセルされました。

    • PARTIAL_COMPLETE：タスクは部分的に成功しました。

    • CREATED：タスクは作成されましたが、実行されていません。

    • EXPIRED：タスクは更新されていません。

    • QUEUED：タスクは実行を待機しています。

    • CLIENT_DELETED：ランサムウェア対策エージェントがアンインストールされたため、タスクは失敗しました。

    RUNNING
    MachineRemark

    string

    任意

    復元タスクが実行されるサーバーの一意の識別子。たとえば、サーバーの IP アドレスまたは名前を使用できます。

    1.1.XX.XX
    PageSize

    integer

    必須

    各ページで返すエントリ数。デフォルト値：10。

    10
    CurrentPage

    integer

    必須

    返すページ番号。デフォルト値：1。

    1

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。問題の特定やトラブルシューティングに使用されます。

    0ED92280-4363-57D3-A4D3-4D3FBC99B29F
    PageInfo

    object

    ページネーション情報。

    CurrentPage

    integer

    返されたページのページ番号。

    1
    PageSize

    integer

    ページごとに返されるエントリ数。デフォルト値：10。

    10
    TotalCount

    integer

    返された復元タスクの総数。

    69
    Count

    integer

    現在のページで返された復元タスクの数。

    2
    RestoreJobs

    array<object>

    復元タスクの詳細。

    object

    Status

    string

    復元タスクのステータス。有効な値：

    • RUNNING：タスクは実行中です。

    • COMPLETE：タスクは完了しました。

    • FAILED：タスクは失敗しました。

    • CANCELING：タスクはキャンセル中です。

    • CANCELED：タスクはキャンセルされました。

    • PARTIAL_COMPLETE：タスクは部分的に成功しました。

    • CREATED：タスクは作成されましたが、実行されていません。

    • EXPIRED：タスクは更新されていません。

    • QUEUED：タスクは実行を待機しています。

    • CLIENT_DELETED：ランサムウェア対策エージェントがアンインストールされたため、タスクは失敗しました。

    COMPLETE
    SnapshotHash

    string

    データがバックアップされたときにバックアップデータを保存するスナップショットのハッシュ値。

    a3992de83f529b844135fe795d949181735a7d20e0ac8539485c61b7983e618f
    SourceClientId

    string

    データのバックアップに使用されるランサムウェア対策エージェントの ID。

    c-000gmcypy5dyf9ey3uv7
    ErrorFileUrl

    string

    CSV ファイルをダウンロードするための URL。CSV ファイルには、復元に失敗したファイルが含まれています。

    ["/home/user"]
    Includes

    string

    復元されたファイルが保存されるディレクトリ。この値は、ランサムウェア対策ポリシーを作成するときに保護対象として指定したディレクトリです。

    ["/root/disk-uuid-test","/root/install.sh"]
    RestoreName

    string

    復元タスクの名前。

    Restore
    InternetIp

    string

    データを復元するサーバーのパブリック IP アドレス。

    1.1.XX.XX
    VaultId

    string

    バックアップデータが保存されているバックアップボールトの ID。

    v-000b0v0jqzmse2yz06zw
    ActualBytes

    integer

    バックアップデータのサイズ。単位：バイト。

    20
    Message

    string

    エラーメッセージ。

    successful
    Percentage

    integer

    復元タスクの進行状況 (パーセンテージ)。

    100
    GmtModified

    string

    復元タスクが更新された時刻。

    2021-04-25T19:11Z
    RestoreType

    string

    復元されるファイルのタイプ。有効な値：

    • ECS_FILE：Elastic Compute Service (ECS) インスタンス上のファイル

    • FILE：データセンター内のサーバー上のファイル

    ECS_FILE
    ExitCode

    string

    復元タスクの戻り値。

    0
    ClientId

    string

    復元タスクの実行に使用されるランサムウェア対策エージェントの ID。

    c-000frxwusjauhp9ajpu6
    ItemsDone

    integer

    復元されたファイルの数。

    0
    BytesTotal

    integer

    復元するデータの合計サイズ。単位：バイト。

    20
    RequestId

    string

    リクエスト ID。

    0ED92280-4363-57D3-A4D3-4D3FBC99B29F
    InstanceName

    string

    データを復元するサーバーの名前。

    win2012-01
    CompleteTime

    integer

    復元タスクが完了したときのタイムスタンプ。単位：ミリ秒。

    1583289054000
    ErrorType

    string

    復元タスクに対して返されるエラーコード。

    NONE
    SnapshotVersion

    string

    バックアップデータのバージョン。

    2020-03-03 18:00
    Target

    string

    バックアップデータが復元されるフォルダ。復元タスクを作成すると、バックアップデータは指定されたフォルダに復元されます。

    /home
    CreatedTime

    integer

    復元タスクが作成されたときのタイムスタンプ。単位：ミリ秒。

    1583289052000
    InstanceId

    string

    データを復元するサーバーの ID。

    i-bp12xnvdax6307gw****
    Source

    string

    復元されたコンテンツ。

    ["/home/admin","\\\\servername\\sharename"]
    IntranetIp

    string

    データを復元するサーバーの内部 IP アドレス。

    2.1.XX.XX
    ErrorFile

    string

    CSV ファイルの名前。CSV ファイルには、復元に失敗したファイルが含まれています。

    s-000f4wxm8f7gur6g2otm.csv
    Uuid

    string

    データを復元するサーバーの UUID。

    6E3DABB6-3F6A-40DB-9492-2C8B59C****
    Excludes

    string

    ランサムウェア対策ポリシーから除外されたディレクトリ。この値は、ランサムウェア対策ポリシーを作成するときに保護をスキップするように指定したディレクトリです。

    ["/home/user"]
    Speed

    integer

    データが復元される速度。単位：バイト/秒。

    25766558
    SnapshotId

    string

    データがバックアップされたときにバックアップデータを保存するスナップショットのハッシュ値 ID。

    s-000gmcypy5dy54e39yny
    UpdatedTime

    integer

    復元タスクが最後に更新されたときのタイムスタンプ。単位：ミリ秒。

    1583289054000
    RestoreId

    string

    復元タスクの ID。

    r-000gmcypy5dyf9ey3uv7
    GmtCreate

    string

    復元タスクが作成された時刻。

    2021-04-25T19:11Z
    Eta

    integer

    進行中の復元タスクが完了すると予想されるタイムスタンプ。単位：秒。

    1583299054
    Duration

    integer

    復元タスクの持続時間。単位：秒。

    100
    ErrorCount

    integer

    エラーが発生した復元タスクの数。

    0
    ItemsTotal

    integer

    復元する必要があるファイルの総数。

    0
    BytesDone

    integer

    復元されたデータの合計サイズ。単位：バイト。

    20
    VaultRegionId

    string

    バックアップボールトが存在するリージョンの ID。

    cn-hangzhou

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "0ED92280-4363-57D3-A4D3-4D3FBC99B29F",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 10,
    "TotalCount": 69,
    "Count": 2
  },
  "RestoreJobs": [
    {
      "Status": "COMPLETE",
      "SnapshotHash": "a3992de83f529b844135fe795d949181735a7d20e0ac8539485c61b7983e618f",
      "SourceClientId": "c-000gmcypy5dyf9ey3uv7",
      "ErrorFileUrl": "[\"/home/user\"]",
      "Includes": "[\"/root/disk-uuid-test\",\"/root/install.sh\"]",
      "RestoreName": "Restore",
      "InternetIp": "1.1.XX.XX",
      "VaultId": "v-000b0v0jqzmse2yz06zw",
      "ActualBytes": 20,
      "Message": "successful",
      "Percentage": 100,
      "GmtModified": "2021-04-25T19:11Z",
      "RestoreType": "ECS_FILE",
      "ExitCode": "0",
      "ClientId": "c-000frxwusjauhp9ajpu6",
      "ItemsDone": 0,
      "BytesTotal": 20,
      "RequestId": "0ED92280-4363-57D3-A4D3-4D3FBC99B29F",
      "InstanceName": "win2012-01",
      "CompleteTime": 1583289054000,
      "ErrorType": "NONE",
      "SnapshotVersion": "2020-03-03 18:00",
      "Target": "/home",
      "CreatedTime": 1583289052000,
      "InstanceId": "i-bp12xnvdax6307gw****",
      "Source": "[\"/home/admin\",\"\\\\\\\\servername\\\\sharename\"]",
      "IntranetIp": "2.1.XX.XX",
      "ErrorFile": "s-000f4wxm8f7gur6g2otm.csv",
      "Uuid": "6E3DABB6-3F6A-40DB-9492-2C8B59C****",
      "Excludes": "[\"/home/user\"]",
      "Speed": 25766558,
      "SnapshotId": "s-000gmcypy5dy54e39yny",
      "UpdatedTime": 1583289054000,
      "RestoreId": "r-000gmcypy5dyf9ey3uv7",
      "GmtCreate": "2021-04-25T19:11Z",
      "Eta": 1583299054,
      "Duration": 100,
      "ErrorCount": 0,
      "ItemsTotal": 0,
      "BytesDone": 20,
      "VaultRegionId": "cn-hangzhou"
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    500 ServerError ServerError
    403 NoPermission caller has no permission

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

    変更履歴

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