次の方法で共有


Backup Instances - Validate For Restore

DataSource に対して復元をトリガーできるかどうかを検証します

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

URI パラメーター

名前 / 必須 説明
backupInstanceName
path True

string

バックアップ インスタンスの名前。

resourceGroupName
path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前は大文字と小文字が区別されます。

subscriptionId
path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

vaultName
path True

string

バックアップ コンテナーの名前。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

要求本文

名前 必須 説明
restoreRequestObject True AzureBackupRestoreRequest:

AzureBackupRestoreRequest
復元要求オブジェクトを取得または設定します。

応答

名前 説明
200 OK

OperationJobExtendedInfo

ジョブ ID などの追加情報が含まれています

202 Accepted

操作は非同期的に完了します。

ヘッダー

  • Location: string
  • Azure-AsyncOperation: string
  • Retry-After: integer
Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装します。

Validate Restore

要求のサンプル

POST https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/validateRestore?api-version=2025-07-01

{
  "restoreRequestObject": {
    "objectType": "AzureBackupRecoveryPointBasedRestoreRequest",
    "recoveryPointId": "hardcodedRP",
    "sourceDataStoreType": "VaultStore",
    "sourceResourceId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
    "restoreTargetInfo": {
      "objectType": "RestoreTargetInfo",
      "recoveryOption": "FailIfExists",
      "datasourceSetInfo": {
        "objectType": "DatasourceSet",
        "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
        "resourceName": "viveksipgtest",
        "resourceType": "Microsoft.DBforPostgreSQL/servers",
        "resourceUri": "",
        "resourceLocation": "",
        "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
      },
      "datasourceInfo": {
        "objectType": "Datasource",
        "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/targetdb",
        "resourceName": "targetdb",
        "resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
        "resourceUri": "",
        "resourceLocation": "",
        "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
      },
      "datasourceAuthCredentials": {
        "secretStoreResource": {
          "uri": "https://samplevault.vault.azure.net/secrets/credentials",
          "secretStoreType": "AzureKeyVault"
        },
        "objectType": "SecretStoreBasedAuthCredentials"
      },
      "restoreLocation": "southeastasia"
    },
    "identityDetails": {
      "useSystemAssignedIdentity": false,
      "userAssignedIdentityArmUrl": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourcegroups/rg-name/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testUami"
    }
  }
}

応答のサンプル

Location: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/operationResults/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-07-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-07-01
Retry-After: 60
{
  "jobId": "c60cb49-63e8-4b21-b9bd-26277b3fdfae",
  "objectType": "OperationJobExtendedInfo"
}

定義

名前 説明
AzureBackupRecoveryPointBasedRestoreRequest

AzureBackupRecoveryPointBasedRestoreRequest

AzureBackupRecoveryTimeBasedRestoreRequest

AzureBackupRecoveryTimeBasedRestoreRequest

AzureBackupRestoreWithRehydrationRequest

AzureBackupRestoreWithRehydrationRequest

CloudError

クラウドエラー

Datasource

データソース

DatasourceSet

データソースセット

DefaultResourceProperties

既定のソース プロパティ

Error

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

ErrorAdditionalInfo

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

ExistingResourcePolicy

競合ポリシー プロパティを取得または設定します。 このプロパティは、復元中のリソースの競合中にポリシーを設定します。

IdentityDetails
ItemLevelRestoreTargetInfo

アイテム レベルの復元操作のターゲット情報を復元する

ItemPathBasedRestoreCriteria

復元中に使用するプレフィックス条件

KubernetesClusterRestoreCriteria

復元操作の kubernetes クラスター バックアップ ターゲット情報

KubernetesClusterVaultTierRestoreCriteria

コンテナーからの復元操作のための kubernetes クラスター バックアップターゲット情報

KubernetesPVRestoreCriteria

復元操作の項目レベル kubernetes 永続ボリューム ターゲット情報

KubernetesStorageClassRestoreCriteria

復元操作の項目レベル kubernetes ストレージ クラスのターゲット情報

NamespacedNameResource

名前空間名リソース

OperationJobExtendedInfo

OperationJobExtendedInfo (オペレーション ジョブ拡張情報)

PersistentVolumeRestoreMode

PV (永続ボリューム) 復元モード プロパティを取得または設定します。 このプロパティは、ボリュームを復元する必要があるかどうかを設定します。

RangeBasedItemLevelRestoreCriteria

復元操作の項目レベルのターゲット情報

RecoveryOption

復旧オプション

RehydrationPriority

リハイドレートに使用する優先度。 値 High または Standard

RestoreFilesTargetInfo

ファイル ターゲット パラメーターとしての復元をカプセル化するクラス

RestoreTargetInfo

復元ターゲット パラメーターをカプセル化するクラス

RestoreTargetLocationType

データが復元されるターゲットの場所、列挙型 {Microsoft.Internal.AzureBackup.DataProtection.Common.Interface.RestoreTargetLocationType} の文字列値を示します。

SecretStoreBasedAuthCredentials

シークレット ストア ベースの認証資格情報。

SecretStoreResource

シークレット ストア リソースを表すクラス。

SecretStoreType

シークレット ストアの種類を取得または設定します。

SourceDataStoreType

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

TargetDetails

ターゲットの詳細をカプセル化するクラス。変換先がデータソースではない場合に使用されます

ValidateRestoreRequestObject

ValidateRestoreRequestオブジェクト

AzureBackupRecoveryPointBasedRestoreRequest

AzureBackupRecoveryPointBasedRestoreRequest

名前 説明
identityDetails

IdentityDetails

BI の ID の詳細の情報が含まれています。 null の場合、既定値はシステム割り当て済みと見なされます。

objectType string:

AzureBackupRecoveryPointBasedRestoreRequest

recoveryPointId

string

resourceGuardOperationRequests

string[]

LAC チェックが実行される ResourceGuardOperationRequests

restoreTargetInfo RestoreTargetInfoBase:

復元先の情報を取得または設定します。

sourceDataStoreType

SourceDataStoreType

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

sourceResourceId

string

復旧中のデータソースの完全修飾 Azure Resource Manager ID。

AzureBackupRecoveryTimeBasedRestoreRequest

AzureBackupRecoveryTimeBasedRestoreRequest

名前 説明
identityDetails

IdentityDetails

BI の ID の詳細の情報が含まれています。 null の場合、既定値はシステム割り当て済みと見なされます。

objectType string:

AzureBackupRecoveryTimeBasedRestoreRequest

recoveryPointTime

string

ISO 8601 形式の復旧時間の例 - 2020-08-14T17:30:00.0000000Z。

resourceGuardOperationRequests

string[]

LAC チェックが実行される ResourceGuardOperationRequests

restoreTargetInfo RestoreTargetInfoBase:

復元先の情報を取得または設定します。

sourceDataStoreType

SourceDataStoreType

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

sourceResourceId

string

復旧中のデータソースの完全修飾 Azure Resource Manager ID。

AzureBackupRestoreWithRehydrationRequest

AzureBackupRestoreWithRehydrationRequest

名前 説明
identityDetails

IdentityDetails

BI の ID の詳細の情報が含まれています。 null の場合、既定値はシステム割り当て済みと見なされます。

objectType string:

AzureBackupRestoreWithRehydrationRequest

recoveryPointId

string

rehydrationPriority

RehydrationPriority

リハイドレートに使用する優先度。 値 High または Standard

rehydrationRetentionDuration

string

ISO 8601 形式の保持期間 (P10D など)。

resourceGuardOperationRequests

string[]

LAC チェックが実行される ResourceGuardOperationRequests

restoreTargetInfo RestoreTargetInfoBase:

復元先の情報を取得または設定します。

sourceDataStoreType

SourceDataStoreType

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

sourceResourceId

string

復旧中のデータソースの完全修飾 Azure Resource Manager ID。

CloudError

クラウドエラー

名前 説明
error

Error

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

Datasource

データソース

名前 説明
datasourceType

string

リソースの DatasourceType。

objectType

string

右の継承型を初期化するために使用される Datasource オブジェクトの型

resourceID

string

リソースの完全な ARM ID。 Azure リソースの場合、これは ARM ID です。 Azure 以外のリソースの場合、これは Fabric/Vault を介してバックアップ サービスによって作成された ID になります。

resourceLocation

string

データソースの場所。

resourceName

string

親のコンテキストにおけるリソースの一意識別子。

resourceProperties BaseResourceProperties:

DefaultResourceProperties

データ ソースに固有のプロパティ

resourceType

string

データソースのリソースの種類。

resourceUri

string

リソースの URI。

DatasourceSet

データソースセット

名前 説明
datasourceType

string

リソースの DatasourceType。

objectType

string

右の継承型を初期化するために使用される Datasource オブジェクトの型

resourceID

string

リソースの完全な ARM ID。 Azure リソースの場合、これは ARM ID です。 Azure 以外のリソースの場合、これは Fabric/Vault を介してバックアップ サービスによって作成された ID になります。

resourceLocation

string

データソースの場所。

resourceName

string

親のコンテキストにおけるリソースの一意識別子。

resourceProperties BaseResourceProperties:

DefaultResourceProperties

データ ソース セットに固有のプロパティ

resourceType

string

データソースのリソースの種類。

resourceUri

string

リソースの URI。

DefaultResourceProperties

既定のソース プロパティ

名前 説明
objectType string:

DefaultResourceProperties

特定のオブジェクトの型 - 逆シリアル化に使用されます

Error

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

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

Error[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorAdditionalInfo

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

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ExistingResourcePolicy

競合ポリシー プロパティを取得または設定します。 このプロパティは、復元中のリソースの競合中にポリシーを設定します。

説明
Patch
Skip

IdentityDetails

名前 説明
useSystemAssignedIdentity

boolean

BI がシステム ID によって保護されているかどうかを指定します。

userAssignedIdentityArmUrl

string

ユーザー割り当て ID の ARM URL。

ItemLevelRestoreTargetInfo

アイテム レベルの復元操作のターゲット情報を復元する

名前 説明
datasourceAuthCredentials AuthCredentials:

SecretStoreBasedAuthCredentials

データ ソース プロバイダーでの認証に使用する資格情報。

datasourceInfo

Datasource

データソース
ターゲット DS の情報

datasourceSetInfo

DatasourceSet

データソースセット
ターゲット DS セットの情報

objectType string:

ItemLevelRestoreTargetInfo

右の継承型を初期化するために使用される Datasource オブジェクトの型

recoveryOption

RecoveryOption

復旧オプション

restoreCriteria ItemLevelRestoreCriteria[]:

復元条件

restoreLocation

string

ターゲット復元リージョン

ItemPathBasedRestoreCriteria

復元中に使用するプレフィックス条件

名前 説明
isPathRelativeToBackupItem

boolean

バックアップ項目または完全パスに対する相対パスを指定するフラグ

itemPath

string

復元する項目のパス。 これは、項目の完全なパス、またはバックアップ項目に対する相対パスである可能性があります。

objectType string:

ItemPathBasedRestoreCriteria

特定のオブジェクトの型 - 逆シリアル化に使用されます

renameTo

string

復元するアイテムの名前を変更します。 戻り値が指定されている場合、itemPath の名前はこの新しい名前に変更され、それ以外の場合、itemPath は同じ名前として復元されます。

subItemPathPrefix

string[]

復元中にフィルター条件として使用されるプレフィックス文字列の一覧。 これらは、指定された項目パスに対する相対パスです。

KubernetesClusterRestoreCriteria

復元操作の kubernetes クラスター バックアップ ターゲット情報

名前 説明
conflictPolicy

ExistingResourcePolicy

競合ポリシー プロパティを取得または設定します。 このプロパティは、復元中のリソースの競合中にポリシーを設定します。

excludedNamespaces

string[]

名前空間の除外プロパティを取得または設定します。 このプロパティは、復元中に除外する名前空間を設定します。

excludedResourceTypes

string[]

リソースの種類の除外プロパティを取得または設定します。 このプロパティは、復元中に除外するリソースの種類を設定します。

includeClusterScopeResources

boolean

インクルード クラスター リソース プロパティを取得または設定します。 このプロパティを有効にすると、復元中にクラスター スコープ リソースが含まれます。

includedNamespaces

string[]

include 名前空間プロパティを取得または設定します。 このプロパティは、復元時に含める名前空間を設定します。

includedResourceTypes

string[]

インクルード リソースの種類プロパティを取得または設定します。 このプロパティは、復元時に含めるリソースの種類を設定します。

labelSelectors

string[]

LabelSelectors プロパティを取得または設定します。 このプロパティは、復元時に含めるラベル セレクターを含むリソースを設定します。

namespaceMappings

object

名前空間マッピング プロパティを取得または設定します。 このプロパティは、復元中に名前空間を変更する必要があるかどうかを設定します。

objectType string:

KubernetesClusterRestoreCriteria

特定のオブジェクトの型 - 逆シリアル化に使用されます

persistentVolumeRestoreMode

PersistentVolumeRestoreMode

PV (永続ボリューム) 復元モード プロパティを取得または設定します。 このプロパティは、ボリュームを復元する必要があるかどうかを設定します。

resourceModifierReference

NamespacedNameResource

名前空間名リソース
リソース修飾子参照を取得または設定します。 このプロパティは、復元中のリソース修飾子の参照を設定します。

restoreHookReferences

NamespacedNameResource[]

復元フック参照を取得または設定します。 このプロパティは、復元中に実行されるフック参照を設定します。

KubernetesClusterVaultTierRestoreCriteria

コンテナーからの復元操作のための kubernetes クラスター バックアップターゲット情報

名前 説明
conflictPolicy

ExistingResourcePolicy

競合ポリシー プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中にリソースの競合中にポリシーを設定します。

excludedNamespaces

string[]

名前空間の除外プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中に除外する名前空間を設定します。

excludedResourceTypes

string[]

リソースの種類の除外プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中に除外するリソースの種類を設定します。

includeClusterScopeResources

boolean

インクルード クラスター リソース プロパティを取得または設定します。 このプロパティを有効にすると、コンテナーからの復元中にクラスター スコープ リソースが含まれます。

includedNamespaces

string[]

include 名前空間プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中に含まれる名前空間を設定します。

includedResourceTypes

string[]

インクルード リソースの種類プロパティを取得または設定します。 このプロパティは、コンテナーからの復元時に含めるリソースの種類を設定します。

labelSelectors

string[]

LabelSelectors プロパティを取得または設定します。 このプロパティは、コンテナーからの復元時に含めるラベル セレクターを含むリソースを設定します。

namespaceMappings

object

名前空間マッピング プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中に名前空間を変更する必要があるかどうかを設定します。

objectType string:

KubernetesClusterVaultTierRestoreCriteria

特定のオブジェクトの型 - 逆シリアル化に使用されます

persistentVolumeRestoreMode

PersistentVolumeRestoreMode

PV (永続ボリューム) 復元モード プロパティを取得または設定します。 このプロパティは、ボリュームをコンテナーから復元する必要があるかどうかを設定します。

resourceModifierReference

NamespacedNameResource

名前空間名リソース
リソース修飾子参照を取得または設定します。 このプロパティは、復元中のリソース修飾子の参照を設定します。

restoreHookReferences

NamespacedNameResource[]

復元フック参照を取得または設定します。 このプロパティは、コンテナーからの復元中に実行されるフック参照を設定します。

stagingResourceGroupId

string (arm-id)

コンテナーからの復元中にステージング ディスクとスナップショットを作成するためのステージング RG ID を取得または設定します。

stagingStorageAccountId

string (arm-id)

コンテナーからの復元中にバックアップ拡張機能オブジェクト ストア データを作成するためのステージング ストレージ アカウント ID を取得または設定します。

KubernetesPVRestoreCriteria

復元操作の項目レベル kubernetes 永続ボリューム ターゲット情報

名前 説明
name

string

選択された永続ボリューム要求名

objectType string:

KubernetesPVRestoreCriteria

特定のオブジェクトの型 - 逆シリアル化に使用されます

storageClassName

string

復元操作用に選択されたストレージ クラス名

KubernetesStorageClassRestoreCriteria

復元操作の項目レベル kubernetes ストレージ クラスのターゲット情報

名前 説明
objectType string:

KubernetesStorageClassRestoreCriteria

特定のオブジェクトの型 - 逆シリアル化に使用されます

provisioner

string

ストレージ クラスのプロビジョンタ

selectedStorageClassName

string

選択したストレージ クラス名

NamespacedNameResource

名前空間名リソース

名前 説明
name

string

リソースの名前

namespace

string

リソースが存在する名前空間

OperationJobExtendedInfo

OperationJobExtendedInfo (オペレーション ジョブ拡張情報)

名前 説明
jobId

string

この操作用に作成されたジョブの名前または Arm ID。

objectType string:

OperationJobExtendedInfo

このプロパティは、型のポリモーフィック チェーン内の特定の型を決定するための識別子として使用されます。

PersistentVolumeRestoreMode

PV (永続ボリューム) 復元モード プロパティを取得または設定します。 このプロパティは、ボリュームを復元する必要があるかどうかを設定します。

説明
RestoreWithVolumeData
RestoreWithoutVolumeData

RangeBasedItemLevelRestoreCriteria

復元操作の項目レベルのターゲット情報

名前 説明
maxMatchingValue

string

範囲プレフィックスの一致の最大値

minMatchingValue

string

範囲プレフィックスの一致の最小値

objectType string:

RangeBasedItemLevelRestoreCriteria

特定のオブジェクトの型 - 逆シリアル化に使用されます

RecoveryOption

復旧オプション

説明
FailIfExists

RehydrationPriority

リハイドレートに使用する優先度。 値 High または Standard

説明
High
Invalid
Standard

RestoreFilesTargetInfo

ファイル ターゲット パラメーターとしての復元をカプセル化するクラス

名前 説明
objectType string:

RestoreFilesTargetInfo

右の継承型を初期化するために使用される Datasource オブジェクトの型

recoveryOption

RecoveryOption

復旧オプション

restoreLocation

string

ターゲット復元リージョン

targetDetails

TargetDetails

RestoreAsFiles 操作の変換先 (変換先がデータソースでない場合)

RestoreTargetInfo

復元ターゲット パラメーターをカプセル化するクラス

名前 説明
datasourceAuthCredentials AuthCredentials:

SecretStoreBasedAuthCredentials

データ ソース プロバイダーでの認証に使用する資格情報。

datasourceInfo

Datasource

データソース
ターゲット DS の情報

datasourceSetInfo

DatasourceSet

データソースセット
ターゲット DS セットの情報

objectType string:

RestoreTargetInfo

右の継承型を初期化するために使用される Datasource オブジェクトの型

recoveryOption

RecoveryOption

復旧オプション

restoreLocation

string

ターゲット復元リージョン

RestoreTargetLocationType

データが復元されるターゲットの場所、列挙型 {Microsoft.Internal.AzureBackup.DataProtection.Common.Interface.RestoreTargetLocationType} の文字列値を示します。

説明
AzureBlobs
AzureFiles
Invalid

SecretStoreBasedAuthCredentials

シークレット ストア ベースの認証資格情報。

名前 説明
objectType string:

SecretStoreBasedAuthCredentials

特定のオブジェクトの型 - 逆シリアル化に使用されます

secretStoreResource

SecretStoreResource

シークレット ストア リソース

SecretStoreResource

シークレット ストア リソースを表すクラス。

名前 説明
secretStoreType

SecretStoreType

シークレット ストアの種類を取得または設定します。

uri

string

リソースに取得する URI

value

string

シークレット ストア リソースに格納されている値を取得または設定します。

SecretStoreType

シークレット ストアの種類を取得または設定します。

説明
AzureKeyVault
Invalid

SourceDataStoreType

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

説明
ArchiveStore
OperationalStore
SnapshotStore
VaultStore

TargetDetails

ターゲットの詳細をカプセル化するクラス。変換先がデータソースではない場合に使用されます

名前 説明
filePrefix

string

復元操作では、Url Below が指す場所に複数のファイルが作成される場合があります。これは、それらのすべてに共通のプレフィックスになります

restoreTargetLocationType

RestoreTargetLocationType

データが復元されるターゲットの場所、列挙型 {Microsoft.Internal.AzureBackup.DataProtection.Common.Interface.RestoreTargetLocationType} の文字列値を示します。

targetResourceArmId

string

復元先を示す完全な ARM ID。 これは、コンテナー/ファイル共有を指す ARM ID です。これは、ターゲット サブスクリプションを URL フィールドで識別できる場合は省略可能です。 そうでない場合は、BackupVault の CrossSubscriptionRestore フィールドが無効な状態の場合に必要です

url

string

復元先を示す URL。 コンテナー/ファイル共有などを指すことができます

ValidateRestoreRequestObject

ValidateRestoreRequestオブジェクト

名前 説明
restoreRequestObject AzureBackupRestoreRequest:

AzureBackupRestoreRequest
復元要求オブジェクトを取得または設定します。