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 パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
backup
|
path | True |
string |
バックアップ インスタンスの名前。 |
resource
|
path | True |
string minLength: 1maxLength: 90 |
リソース グループの名前。 名前は大文字と小文字が区別されます。 |
subscription
|
path | True |
string (uuid) |
ターゲット サブスクリプションの ID。 値は UUID である必要があります。 |
vault
|
path | True |
string |
バックアップ コンテナーの名前。 |
api-version
|
query | True |
string minLength: 1 |
この操作に使用する API バージョン。 |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
restoreRequestObject | True | AzureBackupRestoreRequest: |
AzureBackupRestoreRequest |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
ジョブ ID などの追加情報が含まれています |
|
202 Accepted |
操作は非同期的に完了します。 ヘッダー
|
|
Other Status Codes |
操作が失敗した理由を説明するエラー応答。 |
セキュリティ
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"
}
定義
名前 | 説明 |
---|---|
Azure |
AzureBackupRecoveryPointBasedRestoreRequest |
Azure |
AzureBackupRecoveryTimeBasedRestoreRequest |
Azure |
AzureBackupRestoreWithRehydrationRequest |
Cloud |
クラウドエラー |
Datasource |
データソース |
Datasource |
データソースセット |
Default |
既定のソース プロパティ |
Error |
リソース管理エラー応答。 |
Error |
リソース管理エラーの追加情報。 |
Existing |
競合ポリシー プロパティを取得または設定します。 このプロパティは、復元中のリソースの競合中にポリシーを設定します。 |
Identity |
|
Item |
アイテム レベルの復元操作のターゲット情報を復元する |
Item |
復元中に使用するプレフィックス条件 |
Kubernetes |
復元操作の kubernetes クラスター バックアップ ターゲット情報 |
Kubernetes |
コンテナーからの復元操作のための kubernetes クラスター バックアップターゲット情報 |
Kubernetes |
復元操作の項目レベル kubernetes 永続ボリューム ターゲット情報 |
Kubernetes |
復元操作の項目レベル kubernetes ストレージ クラスのターゲット情報 |
Namespaced |
名前空間名リソース |
Operation |
OperationJobExtendedInfo (オペレーション ジョブ拡張情報) |
Persistent |
PV (永続ボリューム) 復元モード プロパティを取得または設定します。 このプロパティは、ボリュームを復元する必要があるかどうかを設定します。 |
Range |
復元操作の項目レベルのターゲット情報 |
Recovery |
復旧オプション |
Rehydration |
リハイドレートに使用する優先度。 値 High または Standard |
Restore |
ファイル ターゲット パラメーターとしての復元をカプセル化するクラス |
Restore |
復元ターゲット パラメーターをカプセル化するクラス |
Restore |
データが復元されるターゲットの場所、列挙型 {Microsoft.Internal.AzureBackup.DataProtection.Common.Interface.RestoreTargetLocationType} の文字列値を示します。 |
Secret |
シークレット ストア ベースの認証資格情報。 |
Secret |
シークレット ストア リソースを表すクラス。 |
Secret |
シークレット ストアの種類を取得または設定します。 |
Source |
ソース データ ストアの種類を取得または設定します。 |
Target |
ターゲットの詳細をカプセル化するクラス。変換先がデータソースではない場合に使用されます |
Validate |
ValidateRestoreRequestオブジェクト |
AzureBackupRecoveryPointBasedRestoreRequest
AzureBackupRecoveryPointBasedRestoreRequest
名前 | 型 | 説明 |
---|---|---|
identityDetails |
BI の ID の詳細の情報が含まれています。 null の場合、既定値はシステム割り当て済みと見なされます。 |
|
objectType | string: | |
recoveryPointId |
string |
|
resourceGuardOperationRequests |
string[] |
LAC チェックが実行される ResourceGuardOperationRequests |
restoreTargetInfo | RestoreTargetInfoBase: |
復元先の情報を取得または設定します。 |
sourceDataStoreType |
ソース データ ストアの種類を取得または設定します。 |
|
sourceResourceId |
string |
復旧中のデータソースの完全修飾 Azure Resource Manager ID。 |
AzureBackupRecoveryTimeBasedRestoreRequest
AzureBackupRecoveryTimeBasedRestoreRequest
名前 | 型 | 説明 |
---|---|---|
identityDetails |
BI の ID の詳細の情報が含まれています。 null の場合、既定値はシステム割り当て済みと見なされます。 |
|
objectType | string: | |
recoveryPointTime |
string |
ISO 8601 形式の復旧時間の例 - 2020-08-14T17:30:00.0000000Z。 |
resourceGuardOperationRequests |
string[] |
LAC チェックが実行される ResourceGuardOperationRequests |
restoreTargetInfo | RestoreTargetInfoBase: |
復元先の情報を取得または設定します。 |
sourceDataStoreType |
ソース データ ストアの種類を取得または設定します。 |
|
sourceResourceId |
string |
復旧中のデータソースの完全修飾 Azure Resource Manager ID。 |
AzureBackupRestoreWithRehydrationRequest
AzureBackupRestoreWithRehydrationRequest
名前 | 型 | 説明 |
---|---|---|
identityDetails |
BI の ID の詳細の情報が含まれています。 null の場合、既定値はシステム割り当て済みと見なされます。 |
|
objectType | string: | |
recoveryPointId |
string |
|
rehydrationPriority |
リハイドレートに使用する優先度。 値 High または Standard |
|
rehydrationRetentionDuration |
string |
ISO 8601 形式の保持期間 (P10D など)。 |
resourceGuardOperationRequests |
string[] |
LAC チェックが実行される ResourceGuardOperationRequests |
restoreTargetInfo | RestoreTargetInfoBase: |
復元先の情報を取得または設定します。 |
sourceDataStoreType |
ソース データ ストアの種類を取得または設定します。 |
|
sourceResourceId |
string |
復旧中のデータソースの完全修飾 Azure Resource Manager ID。 |
CloudError
クラウドエラー
名前 | 型 | 説明 |
---|---|---|
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: |
データ ソースに固有のプロパティ |
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: |
データ ソース セットに固有のプロパティ |
resourceType |
string |
データソースのリソースの種類。 |
resourceUri |
string |
リソースの URI。 |
DefaultResourceProperties
既定のソース プロパティ
名前 | 型 | 説明 |
---|---|---|
objectType | string: |
特定のオブジェクトの型 - 逆シリアル化に使用されます |
Error
リソース管理エラー応答。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
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: |
データ ソース プロバイダーでの認証に使用する資格情報。 |
datasourceInfo |
データソース |
|
datasourceSetInfo |
データソースセット |
|
objectType | string: |
右の継承型を初期化するために使用される Datasource オブジェクトの型 |
recoveryOption |
復旧オプション |
|
restoreCriteria | ItemLevelRestoreCriteria[]: |
復元条件 |
restoreLocation |
string |
ターゲット復元リージョン |
ItemPathBasedRestoreCriteria
復元中に使用するプレフィックス条件
名前 | 型 | 説明 |
---|---|---|
isPathRelativeToBackupItem |
boolean |
バックアップ項目または完全パスに対する相対パスを指定するフラグ |
itemPath |
string |
復元する項目のパス。 これは、項目の完全なパス、またはバックアップ項目に対する相対パスである可能性があります。 |
objectType | string: |
特定のオブジェクトの型 - 逆シリアル化に使用されます |
renameTo |
string |
復元するアイテムの名前を変更します。 戻り値が指定されている場合、itemPath の名前はこの新しい名前に変更され、それ以外の場合、itemPath は同じ名前として復元されます。 |
subItemPathPrefix |
string[] |
復元中にフィルター条件として使用されるプレフィックス文字列の一覧。 これらは、指定された項目パスに対する相対パスです。 |
KubernetesClusterRestoreCriteria
復元操作の kubernetes クラスター バックアップ ターゲット情報
名前 | 型 | 説明 |
---|---|---|
conflictPolicy |
競合ポリシー プロパティを取得または設定します。 このプロパティは、復元中のリソースの競合中にポリシーを設定します。 |
|
excludedNamespaces |
string[] |
名前空間の除外プロパティを取得または設定します。 このプロパティは、復元中に除外する名前空間を設定します。 |
excludedResourceTypes |
string[] |
リソースの種類の除外プロパティを取得または設定します。 このプロパティは、復元中に除外するリソースの種類を設定します。 |
includeClusterScopeResources |
boolean |
インクルード クラスター リソース プロパティを取得または設定します。 このプロパティを有効にすると、復元中にクラスター スコープ リソースが含まれます。 |
includedNamespaces |
string[] |
include 名前空間プロパティを取得または設定します。 このプロパティは、復元時に含める名前空間を設定します。 |
includedResourceTypes |
string[] |
インクルード リソースの種類プロパティを取得または設定します。 このプロパティは、復元時に含めるリソースの種類を設定します。 |
labelSelectors |
string[] |
LabelSelectors プロパティを取得または設定します。 このプロパティは、復元時に含めるラベル セレクターを含むリソースを設定します。 |
namespaceMappings |
object |
名前空間マッピング プロパティを取得または設定します。 このプロパティは、復元中に名前空間を変更する必要があるかどうかを設定します。 |
objectType | string: |
特定のオブジェクトの型 - 逆シリアル化に使用されます |
persistentVolumeRestoreMode |
PV (永続ボリューム) 復元モード プロパティを取得または設定します。 このプロパティは、ボリュームを復元する必要があるかどうかを設定します。 |
|
resourceModifierReference |
名前空間名リソース |
|
restoreHookReferences |
復元フック参照を取得または設定します。 このプロパティは、復元中に実行されるフック参照を設定します。 |
KubernetesClusterVaultTierRestoreCriteria
コンテナーからの復元操作のための kubernetes クラスター バックアップターゲット情報
名前 | 型 | 説明 |
---|---|---|
conflictPolicy |
競合ポリシー プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中にリソースの競合中にポリシーを設定します。 |
|
excludedNamespaces |
string[] |
名前空間の除外プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中に除外する名前空間を設定します。 |
excludedResourceTypes |
string[] |
リソースの種類の除外プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中に除外するリソースの種類を設定します。 |
includeClusterScopeResources |
boolean |
インクルード クラスター リソース プロパティを取得または設定します。 このプロパティを有効にすると、コンテナーからの復元中にクラスター スコープ リソースが含まれます。 |
includedNamespaces |
string[] |
include 名前空間プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中に含まれる名前空間を設定します。 |
includedResourceTypes |
string[] |
インクルード リソースの種類プロパティを取得または設定します。 このプロパティは、コンテナーからの復元時に含めるリソースの種類を設定します。 |
labelSelectors |
string[] |
LabelSelectors プロパティを取得または設定します。 このプロパティは、コンテナーからの復元時に含めるラベル セレクターを含むリソースを設定します。 |
namespaceMappings |
object |
名前空間マッピング プロパティを取得または設定します。 このプロパティは、コンテナーからの復元中に名前空間を変更する必要があるかどうかを設定します。 |
objectType | string: |
特定のオブジェクトの型 - 逆シリアル化に使用されます |
persistentVolumeRestoreMode |
PV (永続ボリューム) 復元モード プロパティを取得または設定します。 このプロパティは、ボリュームをコンテナーから復元する必要があるかどうかを設定します。 |
|
resourceModifierReference |
名前空間名リソース |
|
restoreHookReferences |
復元フック参照を取得または設定します。 このプロパティは、コンテナーからの復元中に実行されるフック参照を設定します。 |
|
stagingResourceGroupId |
string (arm-id) |
コンテナーからの復元中にステージング ディスクとスナップショットを作成するためのステージング RG ID を取得または設定します。 |
stagingStorageAccountId |
string (arm-id) |
コンテナーからの復元中にバックアップ拡張機能オブジェクト ストア データを作成するためのステージング ストレージ アカウント ID を取得または設定します。 |
KubernetesPVRestoreCriteria
復元操作の項目レベル kubernetes 永続ボリューム ターゲット情報
名前 | 型 | 説明 |
---|---|---|
name |
string |
選択された永続ボリューム要求名 |
objectType | string: |
特定のオブジェクトの型 - 逆シリアル化に使用されます |
storageClassName |
string |
復元操作用に選択されたストレージ クラス名 |
KubernetesStorageClassRestoreCriteria
復元操作の項目レベル kubernetes ストレージ クラスのターゲット情報
名前 | 型 | 説明 |
---|---|---|
objectType | string: |
特定のオブジェクトの型 - 逆シリアル化に使用されます |
provisioner |
string |
ストレージ クラスのプロビジョンタ |
selectedStorageClassName |
string |
選択したストレージ クラス名 |
NamespacedNameResource
名前空間名リソース
名前 | 型 | 説明 |
---|---|---|
name |
string |
リソースの名前 |
namespace |
string |
リソースが存在する名前空間 |
OperationJobExtendedInfo
OperationJobExtendedInfo (オペレーション ジョブ拡張情報)
名前 | 型 | 説明 |
---|---|---|
jobId |
string |
この操作用に作成されたジョブの名前または Arm ID。 |
objectType | string: |
このプロパティは、型のポリモーフィック チェーン内の特定の型を決定するための識別子として使用されます。 |
PersistentVolumeRestoreMode
PV (永続ボリューム) 復元モード プロパティを取得または設定します。 このプロパティは、ボリュームを復元する必要があるかどうかを設定します。
値 | 説明 |
---|---|
RestoreWithVolumeData | |
RestoreWithoutVolumeData |
RangeBasedItemLevelRestoreCriteria
復元操作の項目レベルのターゲット情報
名前 | 型 | 説明 |
---|---|---|
maxMatchingValue |
string |
範囲プレフィックスの一致の最大値 |
minMatchingValue |
string |
範囲プレフィックスの一致の最小値 |
objectType | string: |
特定のオブジェクトの型 - 逆シリアル化に使用されます |
RecoveryOption
復旧オプション
値 | 説明 |
---|---|
FailIfExists |
RehydrationPriority
リハイドレートに使用する優先度。 値 High または Standard
値 | 説明 |
---|---|
High | |
Invalid | |
Standard |
RestoreFilesTargetInfo
ファイル ターゲット パラメーターとしての復元をカプセル化するクラス
名前 | 型 | 説明 |
---|---|---|
objectType | string: |
右の継承型を初期化するために使用される Datasource オブジェクトの型 |
recoveryOption |
復旧オプション |
|
restoreLocation |
string |
ターゲット復元リージョン |
targetDetails |
RestoreAsFiles 操作の変換先 (変換先がデータソースでない場合) |
RestoreTargetInfo
復元ターゲット パラメーターをカプセル化するクラス
名前 | 型 | 説明 |
---|---|---|
datasourceAuthCredentials | AuthCredentials: |
データ ソース プロバイダーでの認証に使用する資格情報。 |
datasourceInfo |
データソース |
|
datasourceSetInfo |
データソースセット |
|
objectType | string: |
右の継承型を初期化するために使用される Datasource オブジェクトの型 |
recoveryOption |
復旧オプション |
|
restoreLocation |
string |
ターゲット復元リージョン |
RestoreTargetLocationType
データが復元されるターゲットの場所、列挙型 {Microsoft.Internal.AzureBackup.DataProtection.Common.Interface.RestoreTargetLocationType} の文字列値を示します。
値 | 説明 |
---|---|
AzureBlobs | |
AzureFiles | |
Invalid |
SecretStoreBasedAuthCredentials
シークレット ストア ベースの認証資格情報。
名前 | 型 | 説明 |
---|---|---|
objectType | string: |
特定のオブジェクトの型 - 逆シリアル化に使用されます |
secretStoreResource |
シークレット ストア リソース |
SecretStoreResource
シークレット ストア リソースを表すクラス。
名前 | 型 | 説明 |
---|---|---|
secretStoreType |
シークレット ストアの種類を取得または設定します。 |
|
uri |
string |
リソースに取得する URI |
value |
string |
シークレット ストア リソースに格納されている値を取得または設定します。 |
SecretStoreType
シークレット ストアの種類を取得または設定します。
値 | 説明 |
---|---|
AzureKeyVault | |
Invalid |
SourceDataStoreType
ソース データ ストアの種類を取得または設定します。
値 | 説明 |
---|---|
ArchiveStore | |
OperationalStore | |
SnapshotStore | |
VaultStore |
TargetDetails
ターゲットの詳細をカプセル化するクラス。変換先がデータソースではない場合に使用されます
名前 | 型 | 説明 |
---|---|---|
filePrefix |
string |
復元操作では、Url Below が指す場所に複数のファイルが作成される場合があります。これは、それらのすべてに共通のプレフィックスになります |
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 |