Restorable Time Ranges - Find

Service:: Data Protection

API バージョン:: 2026-07-01

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/findRestorableTimeRanges?api-version=2026-07-01

URI パラメーター

Name	/	必須	型	説明
backupInstanceName	path	True	string	BackupInstanceResource の名前
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前は大文字と小文字を区別しません。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
vaultName	path	True	string minLength: 2 maxLength: 50 pattern: ^[A-Za-z][-A-Za-z0-9]*[A-Za-z0-9]$	バックアップボールトの名前。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

Name	必須	型	説明
sourceDataStoreType	True	RestoreSourceDataStoreType	ソースデータストアの種類を取得または設定します。
endTime		string	リスト復元範囲要求の終了時刻。 ISO 8601 形式。
startTime		string	リスト復元範囲要求の開始時刻。 ISO 8601 形式。

応答

Name	型	説明
200 OK	AzureBackupFindRestorableTimeRangesResponseResource	Azureの運用は無事に完了しました。
Other Status Codes	CloudError	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

Name	説明
user_impersonation	あなたのユーザーアカウントになりすます

例

Find Restorable Time Ranges

要求のサンプル

POST https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/Blob-Backup/providers/Microsoft.DataProtection/backupVaults/ZBlobBackupVaultBVTD3/backupInstances/zblobbackuptestsa58/findRestorableTimeRanges?api-version=2026-07-01

{
  "endTime": "2021-02-24T00:35:17.6829685Z",
  "sourceDataStoreType": "OperationalStore",
  "startTime": "2020-10-17T23:28:17.6829685Z"
}


import com.azure.resourcemanager.dataprotection.models.AzureBackupFindRestorableTimeRangesRequest;
import com.azure.resourcemanager.dataprotection.models.RestoreSourceDataStoreType;

/**
 * Samples for RestorableTimeRanges Find.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-07-01/BackupInstanceOperations/FindRestorableTimeRanges.json
     */
    /**
     * Sample code: Find Restorable Time Ranges.
     * 
     * @param manager Entry point to DataProtectionManager.
     */
    public static void
        findRestorableTimeRanges(com.azure.resourcemanager.dataprotection.DataProtectionManager manager) {
        manager.restorableTimeRanges().findWithResponse("Blob-Backup", "ZBlobBackupVaultBVTD3", "zblobbackuptestsa58",
            new AzureBackupFindRestorableTimeRangesRequest()
                .withSourceDataStoreType(RestoreSourceDataStoreType.OPERATIONAL_STORE)
                .withStartTime("2020-10-17T23:28:17.6829685Z").withEndTime("2021-02-24T00:35:17.6829685Z"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { DataProtectionClient } = require("@azure/arm-dataprotection");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to
 *
 * @summary
 * x-ms-original-file: 2026-07-01/BackupInstanceOperations/FindRestorableTimeRanges.json
 */
async function findRestorableTimeRanges() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "04cf684a-d41f-4550-9f70-7708a3a2283b";
  const client = new DataProtectionClient(credential, subscriptionId);
  const result = await client.restorableTimeRanges.find(
    "Blob-Backup",
    "ZBlobBackupVaultBVTD3",
    "zblobbackuptestsa58",
    {
      endTime: "2021-02-24T00:35:17.6829685Z",
      sourceDataStoreType: "OperationalStore",
      startTime: "2020-10-17T23:28:17.6829685Z",
    },
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "type": "Microsoft.DataProtection/backupVaults/backupInstances/findRestorableTimeRanges",
  "id": "zblobbackuptestsa58",
  "properties": {
    "objectType": "AzureBackupFindRestorableTimeRangesResponse",
    "restorableTimeRanges": [
      {
        "endTime": "2021-02-24T00:35:17.0000000Z",
        "objectType": "RestorableTimeRange",
        "startTime": "2021-02-23T18:33:51.6349708Z"
      }
    ]
  }
}

定義

Name	説明
AzureBackupFindRestorableTimeRangesRequest	復元範囲の一覧表示要求
AzureBackupFindRestorableTimeRangesResponse	復元範囲の一覧表示の応答
AzureBackupFindRestorableTimeRangesResponseResource	復元範囲の一覧表示の応答
CloudError	Azure Backup からのエラー応答。
createdByType	リソースを作成した ID の種類。
Error	リソース管理エラー応答。
ErrorAdditionalInfo	リソース管理エラーの追加情報
RestorableTimeRange
RestoreSourceDataStoreType	ソースデータストアの種類を取得または設定します。
systemData	リソースの作成と最後の変更に関連するメタデータ。

AzureBackupFindRestorableTimeRangesRequest

Object

復元範囲の一覧表示要求

Name	型	説明
endTime	string	リスト復元範囲要求の終了時刻。 ISO 8601 形式。
sourceDataStoreType	RestoreSourceDataStoreType	ソースデータストアの種類を取得または設定します。
startTime	string	リスト復元範囲要求の開始時刻。 ISO 8601 形式。

AzureBackupFindRestorableTimeRangesResponse

Object

復元範囲の一覧表示の応答

Name	型	説明
objectType	string
restorableTimeRanges	RestorableTimeRange[]	バックアップインスタンスで使用できる復元範囲を返します。

AzureBackupFindRestorableTimeRangesResponseResource

Object

復元範囲の一覧表示の応答

Name	型	説明
id	string	リソース ID は、リソースへの完全なパスを表します。
name	string	リソースに関連付けられているリソース名。
properties	AzureBackupFindRestorableTimeRangesResponse	AzureBackupFindRestorableTimeRangesResponseResource プロパティ
systemData	systemData	リソースの作成と最後の変更に関連するメタデータ。
type	string	リソースの種類は、Namespace/ResourceType/ResourceType/..フォームの完全なパスを表します。

CloudError

Object

Azure Backup からのエラー応答。

Name	型	説明
error	Error	リソース管理エラー応答。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

Error

Object

リソース管理エラー応答。

Name	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーに関する追加情報。
code	string	エラーコード。
details	Error[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーの対象。

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報

Name	型	説明
info	object	追加情報。
type	string	追加情報の種類。

RestorableTimeRange

Object

Name	型	説明
endTime	string	使用可能な復元範囲の終了時刻
objectType	string
startTime	string	使用可能な復元範囲の開始時刻

RestoreSourceDataStoreType

列挙

ソースデータストアの種類を取得または設定します。

値	説明
OperationalStore
VaultStore
ArchiveStore

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

Name	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。