Backup Instances - Validate For Backup

Szolgáltatás:: Data Protection

API-verzió:: 2025-09-01

Annak ellenőrzése, hogy az adhoc biztonsági mentése sikeres lesz-e vagy sem

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
vaultName	path	True	string	A BackupVaultResource neve
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
backupInstance	True	BackupInstance	Biztonsági mentési példány

Válaszok

Name	Típus	Description
200 OK	OperationJobExtendedInfo	Az Azure-művelet sikeresen befejeződött.
202 Accepted		Az erőforrásművelet elfogadott. Fejlécek Azure-AsyncOperation: string Location: string
Other Status Codes	CloudError	Váratlan hibaválasz.

Name

Típus

Description

200 OK

OperationJobExtendedInfo

Az Azure-művelet sikeresen befejeződött.

202 Accepted

Az erőforrásművelet elfogadott.

Fejlécek

Azure-AsyncOperation: string
Location: string

Other Status Codes

CloudError

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Validate For Backup

Mintakérelem

HTTP

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

{
  "backupInstance": {
    "dataSourceInfo": {
      "datasourceType": "OssDB",
      "objectType": "Datasource",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceLocation": "",
      "resourceName": "testdb",
      "resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
      "resourceUri": ""
    },
    "dataSourceSetInfo": {
      "datasourceType": "OssDB",
      "objectType": "DatasourceSet",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceLocation": "",
      "resourceName": "viveksipgtest",
      "resourceType": "Microsoft.DBforPostgreSQL/servers",
      "resourceUri": ""
    },
    "datasourceAuthCredentials": {
      "objectType": "SecretStoreBasedAuthCredentials",
      "secretStoreResource": {
        "secretStoreType": "AzureKeyVault",
        "uri": "https://samplevault.vault.azure.net/secrets/credentials"
      }
    },
    "friendlyName": "harshitbi2",
    "identityDetails": {
      "useSystemAssignedIdentity": false,
      "userAssignedIdentityArmUrl": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourcegroups/rg-name/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testUami"
    },
    "objectType": "BackupInstance",
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1"
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "jobId": "c60cb49-63e8-4b21-b9bd-26277b3fdfae",
  "objectType": "OperationJobExtendedInfo"
}

Állapotkód:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-09-01
Location: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/operationResults/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-09-01
Retry-After: 60

Definíciók

Name	Description
AdlsBlobBackupDatasourceParameters	Az Azure Data Lake Storage-fiókblobok biztonsági mentésének konfigurálása során használandó paraméterek
AKSVolumeTypes
AzureOperationalStoreParameters	A Operational-Tier DataStore paraméterei
BackupInstance	Biztonsági mentési példány
BlobBackupDatasourceParameters	A blobok biztonsági mentésének konfigurálása során használandó paraméterek
CloudError	Hibaválasz az Azure Backuptól.
CurrentProtectionState	Az erőforrás aktuális védelmi állapotát adja meg
Datasource	Biztonsági másolatot készítendő adatforrás
DatasourceSet	A biztonsági másolatot készítendő adatforrás datasourceSet részletei
DataStoreTypes	az adattár típusa; Operational/Vault/Archive
DefaultResourceProperties	Alapértelmezett forrástulajdonságok
Error	Az erőforrás-kezelési hibaválasz.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
IdentityDetails
InnerError	Belső hiba
KubernetesClusterBackupDatasourceParameters	A Kubernetes-fürt biztonsági mentési adatforrásának paraméterei
NamespacedNameResource	Névteret és nevet tartalmazó erőforrásokra hivatkozó osztály
OperationJobExtendedInfo	A műveleti feladat bővített adatai
PolicyInfo	Szabályzatadatok a backupInstance-ben
PolicyParameters	Paraméterek a Szabályzatban
ProtectionStatusDetails	Védelmi állapot részletei
ResourcePropertiesObjectType	Az adott objektum típusa – a deszerializáláshoz használatos
SecretStoreBasedAuthCredentials	Titkos tár alapú hitelesítési hitelesítő adatok.
SecretStoreResource	Titkos tár erőforrását képviselő osztály.
SecretStoreType	Lekéri vagy beállítja a titkos tár típusát
Status	Az erőforrás védelmi állapotát adja meg
UserFacingError	A honosított tartalomhoz hozzáféréssel rendelkező rétegek által használt hibaobjektumok propagálása a felhasználó számára
ValidateForBackupRequest	Biztonsági mentési kérelem ellenőrzése
ValidationType	Az ellenőrzés típusát adja meg. DeepValidation esetén a /validateForBackup API összes érvényesítése újra lefut.

AdlsBlobBackupDatasourceParameters

Objektum

Az Azure Data Lake Storage-fiókblobok biztonsági mentésének konfigurálása során használandó paraméterek

Name	Típus	Description
containersList	string[]	A blobok biztonsági mentésének konfigurálása során biztonsági másolatot készítendő tárolók listája
objectType	string: AdlsBlobBackupDatasourceParameters	Az adott objektum típusa – a deszerializáláshoz használatos

AKSVolumeTypes

Enumerálás

Érték	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Objektum

A Operational-Tier DataStore paraméterei

Name	Típus	Description
dataStoreType	DataStoreTypes	az adattár típusa; Operational/Vault/Archive
objectType	string: AzureOperationalStoreParameters	Az adott objektum típusa – a deszerializáláshoz használatos
resourceGroupId	string	Lekéri vagy beállítja a pillanatkép-erőforráscsoport URI-ját.

BackupInstance

Objektum

Biztonsági mentési példány

Name	Típus	Description
currentProtectionState	CurrentProtectionState	Az erőforrás aktuális védelmi állapotát adja meg
dataSourceInfo	Datasource	Lekéri vagy beállítja az adatforrás adatait.
dataSourceSetInfo	DatasourceSet	Lekéri vagy beállítja az adatforráskészlet adatait.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Az adatforrás-szolgáltatóval való hitelesítéshez használandó hitelesítő adatok.
friendlyName	string	Lekéri vagy beállítja a Backup-példány rövid nevét.
identityDetails	IdentityDetails	A BI identitásadatainak adatait tartalmazza. Null érték esetén az alapértelmezett érték a rendszer által hozzárendelt rendszernek minősül.
objectType	string
policyInfo	PolicyInfo	Lekéri vagy beállítja a szabályzat adatait.
protectionErrorDetails	UserFacingError	Megadja az erőforrás védelmi hibáját
protectionStatus	ProtectionStatusDetails	Az erőforrás védelmi állapotát adja meg
provisioningState	string	Az erőforrás kiépítési állapotát adja meg, azaz kiépítés/frissítés/Sikeres/Sikertelen
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests, amelyen a LAC-ellenőrzés végrehajtása történik
validationType	ValidationType	Az ellenőrzés típusát adja meg. DeepValidation esetén a /validateForBackup API összes érvényesítése újra lefut.

BlobBackupDatasourceParameters

Objektum

A blobok biztonsági mentésének konfigurálása során használandó paraméterek

Name	Típus	Description
containersList	string[]	A blobok biztonsági mentésének konfigurálása során biztonsági másolatot készítendő tárolók listája
objectType	string: BlobBackupDatasourceParameters	Az adott objektum típusa – a deszerializáláshoz használatos

CloudError

Objektum

Hibaválasz az Azure Backuptól.

Name	Típus	Description
error	Error	Az erőforrás-kezelési hibaválasz.

CurrentProtectionState

Enumerálás

Az erőforrás aktuális védelmi állapotát adja meg

Érték	Description
Invalid
NotProtected
ConfiguringProtection
ProtectionConfigured
BackupSchedulesSuspended
RetentionSchedulesSuspended
ProtectionStopped
ProtectionError
ConfiguringProtectionFailed
SoftDeleting
SoftDeleted
UpdatingProtection

Datasource

Objektum

Biztonsági másolatot készítendő adatforrás

Name	Típus	Description
datasourceType	string	Az erőforrás adatforrástípusa.
objectType	string	A megfelelő öröklődő típus inicializálásához használt adatforrás-objektum típusa
resourceID	string	Az erőforrás teljes ARM-azonosítója. Az Azure-erőforrások esetében ez ARM-azonosító. Nem Azure-erőforrások esetén ez lesz a Biztonsági mentési szolgáltatás által a Fabric/Vaulton keresztül létrehozott azonosító.
resourceLocation	string	Az adatforrás helye.
resourceName	string	Az erőforrás egyedi azonosítója a szülő kontextusában.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Az adatforrásra jellemző tulajdonságok
resourceType	string	Az adatforrás erőforrástípusa.
resourceUri	string	Az erőforrás URI-ja.

DatasourceSet

Objektum

A biztonsági másolatot készítendő adatforrás datasourceSet részletei

Name	Típus	Description
datasourceType	string	Az erőforrás adatforrástípusa.
objectType	string	A megfelelő öröklődő típus inicializálásához használt adatforrás-objektum típusa
resourceID	string	Az erőforrás teljes ARM-azonosítója. Az Azure-erőforrások esetében ez ARM-azonosító. Nem Azure-erőforrások esetén ez lesz a Biztonsági mentési szolgáltatás által a Fabric/Vaulton keresztül létrehozott azonosító.
resourceLocation	string	Az adatforrás helye.
resourceName	string	Az erőforrás egyedi azonosítója a szülő kontextusában.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Az adatforráskészletre jellemző tulajdonságok
resourceType	string	Az adatforrás erőforrástípusa.
resourceUri	string	Az erőforrás URI-ja.

DataStoreTypes

Enumerálás

az adattár típusa; Operational/Vault/Archive

Érték	Description
OperationalStore
VaultStore
ArchiveStore

DefaultResourceProperties

Objektum

Alapértelmezett forrástulajdonságok

Name	Típus	Description
objectType	string: DefaultResourceProperties	Az adott objektum típusa – a deszerializáláshoz használatos

Error

Objektum

Az erőforrás-kezelési hibaválasz.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	Error[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

IdentityDetails

Objektum

Name	Típus	Description
useSystemAssignedIdentity	boolean	Megadja, hogy a bi-t rendszeridentitás védi-e.
userAssignedIdentityArmUrl	string	ARM URL-cím a felhasználó által hozzárendelt identitáshoz.

InnerError

Objektum

Belső hiba

Name	Típus	Description
additionalInfo	object	Bármely kulcsértékpár, amely további részletes információkért adható meg az ügyfélnek.
code	string	A hiba egyedi kódja
embeddedInnerError	InnerError	Gyermek belső hibája a beágyazás engedélyezéséhez.

KubernetesClusterBackupDatasourceParameters

Objektum

A Kubernetes-fürt biztonsági mentési adatforrásának paraméterei

Name	Típus	Description
backupHookReferences	NamespacedNameResource[]	Lekéri vagy beállítja a biztonsági mentési horog hivatkozásait. Ez a tulajdonság beállítja a biztonsági mentés során végrehajtandó horoghivatkozást.
excludedNamespaces	string[]	Lekéri vagy beállítja a névterek kizárási tulajdonságát. Ez a tulajdonság beállítja, hogy a névterek ne legyenek kizárva a biztonsági mentés során.
excludedResourceTypes	string[]	Lekéri vagy beállítja a kizárási erőforrástípusok tulajdonságot. Ez a tulajdonság a biztonsági mentés során kizárandó erőforrástípusokat állítja be.
includeClusterScopeResources	boolean	Lekéri vagy beállítja a belefoglalási fürterőforrás-tulajdonságot. Ha engedélyezve van, ez a tulajdonság a fürt hatókörének erőforrásait is tartalmazza a biztonsági mentés során.
includedNamespaces	string[]	Lekéri vagy beállítja a include namespaces tulajdonságot. Ez a tulajdonság beállítja a biztonsági mentés során belefoglalandó névtereket.
includedResourceTypes	string[]	Lekéri vagy beállítja a include resource types tulajdonságot. Ez a tulajdonság beállítja azokat az erőforrástípusokat, amelyek a biztonsági mentés során szerepelni fognak.
includedVolumeTypes	AKSVolumeTypes[]	Lekéri vagy beállítja a belefoglalási kötettípusok tulajdonságot. Ez a tulajdonság beállítja a biztonsági mentés során figyelembe vehető kötettípusokat.
labelSelectors	string[]	Lekéri vagy beállítja a LabelSelectors tulajdonságot. Ez a tulajdonság beállítja az erőforrást olyan címkeválasztókkal, hogy a biztonsági mentés során szerepeljenek.
objectType	string: KubernetesClusterBackupDatasourceParameters	Az adott objektum típusa – a deszerializáláshoz használatos
snapshotVolumes	boolean	Lekéri vagy beállítja a kötet pillanatkép tulajdonságát. Ez a tulajdonság, ha engedélyezve van, a biztonsági mentés során mennyiségi pillanatképeket készít.

NamespacedNameResource

Objektum

Névteret és nevet tartalmazó erőforrásokra hivatkozó osztály

Name	Típus	Description
name	string	Az erőforrás neve
namespace	string	Névtér, amelyben az erőforrás létezik

OperationJobExtendedInfo

Objektum

A műveleti feladat bővített adatai

Name	Típus	Description
jobId	string	A művelethez létrehozott feladat neve vagy arm-azonosítója.
objectType	string: OperationJobExtendedInfo	A rendszer ezt a tulajdonságot használja diszkriminatívként a polimorfikus típusok bizonyos típusainak eldöntéséhez.

PolicyInfo

Objektum

Szabályzatadatok a backupInstance-ben

Name	Típus	Description
policyId	string
policyParameters	PolicyParameters	A biztonsági mentési példány házirendparaméterei
policyVersion	string

PolicyParameters

Objektum

Paraméterek a Szabályzatban

Name	Típus	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: AdlsBlobBackupDatasourceParameters[] BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Lekéri vagy beállítja a biztonsági mentési adatforrás paramétereit
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Lekéri vagy beállítja a DataStore-paramétereket

ProtectionStatusDetails

Objektum

Védelmi állapot részletei

Name	Típus	Description
errorDetails	UserFacingError	Megadja az erőforrás védelmi állapotának hibáját
status	Status	Az erőforrás védelmi állapotát adja meg

ResourcePropertiesObjectType

Enumerálás

Az adott objektum típusa – a deszerializáláshoz használatos

Érték	Description
DefaultResourceProperties

SecretStoreBasedAuthCredentials

Objektum

Titkos tár alapú hitelesítési hitelesítő adatok.

Name	Típus	Description
objectType	string: SecretStoreBasedAuthCredentials	Az adott objektum típusa – a deszerializáláshoz használatos
secretStoreResource	SecretStoreResource	Titkos tár erőforrása

SecretStoreResource

Objektum

Titkos tár erőforrását képviselő osztály.

Name	Típus	Description
secretStoreType	SecretStoreType	Lekéri vagy beállítja a titkos tár típusát
uri	string	Uri az erőforrás eléréséhez
value	string	Titkos tár erőforrásában tárolt érték lekérése vagy beállítása

SecretStoreType

Enumerálás

Lekéri vagy beállítja a titkos tár típusát

Érték	Description
Invalid
AzureKeyVault

Status

Enumerálás

Az erőforrás védelmi állapotát adja meg

Érték	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

UserFacingError

Objektum

A honosított tartalomhoz hozzáféréssel rendelkező rétegek által használt hibaobjektumok propagálása a felhasználó számára

Name	Típus	Description
code	string	A hiba egyedi kódja
details	UserFacingError[]	További kapcsolódó hibák
innerError	InnerError	Belső hiba
isRetryable	boolean	A művelet újrapróbálkozható-e vagy sem
isUserError	boolean	Felhasználói hiba vagy szolgáltatáshiba miatt történt-e a művelet
message	string
properties	object	A hibaobjektumba injektálható kulcsértékpárok
recommendedAction	string[]	AjánlottAction honosított.
target	string	A hiba célja.

ValidateForBackupRequest

Objektum

Biztonsági mentési kérelem ellenőrzése

Name	Típus	Description
backupInstance	BackupInstance	Biztonsági mentési példány

ValidationType

Enumerálás

Az ellenőrzés típusát adja meg. DeepValidation esetén a /validateForBackup API összes érvényesítése újra lefut.

Érték	Description
ShallowValidation
DeepValidation

Megosztás a következőn keresztül:

Backup Instances - Validate For Backup

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

Validate For Backup

Mintakérelem

Mintaválasz

Definíciók

AdlsBlobBackupDatasourceParameters

AKSVolumeTypes

AzureOperationalStoreParameters

BackupInstance

BlobBackupDatasourceParameters

CloudError

CurrentProtectionState

Datasource

DatasourceSet

DataStoreTypes

DefaultResourceProperties

Error

ErrorAdditionalInfo

IdentityDetails

InnerError

KubernetesClusterBackupDatasourceParameters

NamespacedNameResource

OperationJobExtendedInfo

PolicyInfo

PolicyParameters

ProtectionStatusDetails

ResourcePropertiesObjectType

SecretStoreBasedAuthCredentials

SecretStoreResource

SecretStoreType

Status

UserFacingError

ValidateForBackupRequest

ValidationType