Backup Instances - Validate For Backup

Service:: Data Protection

API-versie:: 2025-09-01

Controleer of een ad-hocback-up wel of niet lukt

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
vaultName	path	True	string	De naam van de BackupVaultResource
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
backupInstance	True	BackupInstance	Back-upexemplaren

Antwoorden

Name	Type	Description
200 OK	OperationJobExtendedInfo	De Azure-bewerking is voltooid.
202 Accepted		Resourcebewerking geaccepteerd. Kopteksten Azure-AsyncOperation: string Location: string
Other Status Codes	CloudError	Een onverwachte foutreactie.

Name

Type

Description

200 OK

OperationJobExtendedInfo

De Azure-bewerking is voltooid.

202 Accepted

Resourcebewerking geaccepteerd.

Kopteksten

Azure-AsyncOperation: string
Location: string

Other Status Codes

CloudError

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Validate For Backup

Voorbeeldaanvraag

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"
    }
  }
}

Voorbeeldrespons

Statuscode:: 200

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

Statuscode:: 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

Definities

Name	Description
AdlsBlobBackupDatasourceParameters	Parameters die moeten worden gebruikt tijdens de configuratie van de back-up van Azure Data Lake Storage-account-blobs
AKSVolumeTypes
AzureOperationalStoreParameters	Parameters voor Operational-Tier DataStore
BackupInstance	Back-upexemplaren
BlobBackupDatasourceParameters	Parameters die moeten worden gebruikt tijdens de configuratie van back-ups van blobs
CloudError	Een foutreactie van Azure Backup.
CurrentProtectionState	Hiermee geeft u de huidige beveiligingsstatus van de resource op
Datasource	Een back-up van de gegevensbron maken
DatasourceSet	DatasourceSet-details van de gegevensbron waarvan een back-up moet worden gemaakt
DataStoreTypes	type gegevensarchief; Operationeel/kluis/archief
DefaultResourceProperties	Standaardbroneigenschappen
Error	Het antwoord van het resourcebeheerfout.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
IdentityDetails
InnerError	Interne fout
KubernetesClusterBackupDatasourceParameters	Parameters voor Kubernetes-clusterback-upgegevensbron
NamespacedNameResource	Klasse om te verwijzen naar resources die naamruimte en naam bevatten
OperationJobExtendedInfo	Uitgebreide informatie over bewerkingstaak
PolicyInfo	Beleidsgegevens in backupInstance
PolicyParameters	Parameters in beleid
ProtectionStatusDetails	Details van beveiligingsstatus
ResourcePropertiesObjectType	Type van het specifieke object dat wordt gebruikt voor deserialisatie
SecretStoreBasedAuthCredentials	Verificatiereferenties op basis van geheimarchief.
SecretStoreResource	Klasse die een geheime archiefresource vertegenwoordigt.
SecretStoreType	Hiermee wordt het type geheimarchief opgehaald of ingesteld
Status	Hiermee geeft u de beveiligingsstatus van de resource
UserFacingError	Foutobject dat wordt gebruikt door lagen die toegang hebben tot gelokaliseerde inhoud en die doorgeven aan de gebruiker
ValidateForBackupRequest	Valideren voor back-upaanvraag
ValidationType	Hiermee geeft u het type validatie op. In het geval van DeepValidation worden alle validaties van /validateForBackup-API opnieuw uitgevoerd.

AdlsBlobBackupDatasourceParameters

Object

Parameters die moeten worden gebruikt tijdens de configuratie van de back-up van Azure Data Lake Storage-account-blobs

Name	Type	Description
containersList	string[]	Lijst met containers waarvan een back-up moet worden gemaakt tijdens de configuratie van back-ups van blobs
objectType	string: AdlsBlobBackupDatasourceParameters	Type van het specifieke object dat wordt gebruikt voor deserialisatie

AKSVolumeTypes

Inventarisatie

Waarde	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Object

Parameters voor Operational-Tier DataStore

Name	Type	Description
dataStoreType	DataStoreTypes	type gegevensarchief; Operationeel/kluis/archief
objectType	string: AzureOperationalStoreParameters	Type van het specifieke object dat wordt gebruikt voor deserialisatie
resourceGroupId	string	Hiermee haalt u de URI van de momentopnameresourcegroep op of stelt u deze in.

BackupInstance

Object

Back-upexemplaren

Name	Type	Description
currentProtectionState	CurrentProtectionState	Hiermee geeft u de huidige beveiligingsstatus van de resource op
dataSourceInfo	Datasource	Hiermee haalt u de gegevensbrongegevens op of stelt u deze in.
dataSourceSetInfo	DatasourceSet	Hiermee haalt u de gegevenssetgegevens op of stelt u deze in.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Referenties die moeten worden gebruikt voor verificatie bij de gegevensbronprovider.
friendlyName	string	Hiermee haalt u de beschrijvende naam van het back-upexemplaren op of stelt u deze in.
identityDetails	IdentityDetails	Bevat informatie over de identiteitsdetails voor de BI. Als het null is, wordt de standaardwaarde beschouwd als Systeem toegewezen.
objectType	string
policyInfo	PolicyInfo	Hiermee haalt u de beleidsinformatie op of stelt u deze in.
protectionErrorDetails	UserFacingError	Hiermee geeft u de beveiligingsfout van de resource
protectionStatus	ProtectionStatusDetails	Hiermee geeft u de beveiligingsstatus van de resource
provisioningState	string	Hiermee geeft u de inrichtingsstatus van de resource, d.w.w.: inrichten/bijwerken/Geslaagd/Mislukt
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests waarop lac-controle wordt uitgevoerd
validationType	ValidationType	Hiermee geeft u het type validatie op. In het geval van DeepValidation worden alle validaties van /validateForBackup-API opnieuw uitgevoerd.

BlobBackupDatasourceParameters

Object

Parameters die moeten worden gebruikt tijdens de configuratie van back-ups van blobs

Name	Type	Description
containersList	string[]	Lijst met containers waarvan een back-up moet worden gemaakt tijdens de configuratie van back-ups van blobs
objectType	string: BlobBackupDatasourceParameters	Type van het specifieke object dat wordt gebruikt voor deserialisatie

CloudError

Object

Een foutreactie van Azure Backup.

Name	Type	Description
error	Error	Het antwoord van het resourcebeheerfout.

CurrentProtectionState

Inventarisatie

Hiermee geeft u de huidige beveiligingsstatus van de resource op

Waarde	Description
Invalid
NotProtected
ConfiguringProtection
ProtectionConfigured
BackupSchedulesSuspended
RetentionSchedulesSuspended
ProtectionStopped
ProtectionError
ConfiguringProtectionFailed
SoftDeleting
SoftDeleted
UpdatingProtection

Datasource

Object

Een back-up van de gegevensbron maken

Name	Type	Description
datasourceType	string	DatasourceType van de resource.
objectType	string	Type gegevensbronobject, gebruikt om het overgenomen type te initialiseren
resourceID	string	Volledige ARM-id van de resource. Voor Azure-resources is dit ARM-id. Voor niet-Azure-resources is dit de id die is gemaakt door de back-upservice via Fabric/Vault.
resourceLocation	string	Locatie van gegevensbron.
resourceName	string	De unieke id van de resource in de context van het bovenliggende item.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Eigenschappen die specifiek zijn voor gegevensbron
resourceType	string	Resourcetype van gegevensbron.
resourceUri	string	Uri van de resource.

DatasourceSet

Object

DatasourceSet-details van de gegevensbron waarvan een back-up moet worden gemaakt

Name	Type	Description
datasourceType	string	DatasourceType van de resource.
objectType	string	Type gegevensbronobject, gebruikt om het overgenomen type te initialiseren
resourceID	string	Volledige ARM-id van de resource. Voor Azure-resources is dit ARM-id. Voor niet-Azure-resources is dit de id die is gemaakt door de back-upservice via Fabric/Vault.
resourceLocation	string	Locatie van gegevensbron.
resourceName	string	De unieke id van de resource in de context van het bovenliggende item.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Eigenschappen die specifiek zijn voor gegevensbronset
resourceType	string	Resourcetype van gegevensbron.
resourceUri	string	Uri van de resource.

DataStoreTypes

Inventarisatie

type gegevensarchief; Operationeel/kluis/archief

Waarde	Description
OperationalStore
VaultStore
ArchiveStore

DefaultResourceProperties

Object

Standaardbroneigenschappen

Name	Type	Description
objectType	string: DefaultResourceProperties	Type van het specifieke object dat wordt gebruikt voor deserialisatie

Error

Object

Het antwoord van het resourcebeheerfout.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	Error[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

IdentityDetails

Object

Name	Type	Description
useSystemAssignedIdentity	boolean	Hiermee geeft u op of de BI wordt beveiligd door systeemidentiteit.
userAssignedIdentityArmUrl	string	ARM-URL voor door de gebruiker toegewezen identiteit.

InnerError

Object

Interne fout

Name	Type	Description
additionalInfo	object	Alle sleutel-waardeparen die aan de client kunnen worden verstrekt voor aanvullende uitgebreide informatie.
code	string	Unieke code voor deze fout
embeddedInnerError	InnerError	Onderliggende interne fout, om nesten toe te staan.

KubernetesClusterBackupDatasourceParameters

Object

Parameters voor Kubernetes-clusterback-upgegevensbron

Name	Type	Description
backupHookReferences	NamespacedNameResource[]	Hiermee haalt u de back-uphookverwijzingen op of stelt u deze in. Met deze eigenschap wordt de hook-verwijzing ingesteld die tijdens de back-up moet worden uitgevoerd.
excludedNamespaces	string[]	Hiermee haalt u de eigenschap van de uitgesloten naamruimten op of stelt u deze in. Met deze eigenschap worden de naamruimten ingesteld die tijdens de back-up moeten worden uitgesloten.
excludedResourceTypes	string[]	Hiermee haalt u de eigenschap resourcetypen uitsluiten op of stelt u deze in. Met deze eigenschap worden de resourcetypen ingesteld die tijdens de back-up moeten worden uitgesloten.
includeClusterScopeResources	boolean	Hiermee haalt u de eigenschap Include-clusterbronnen op of stelt u deze in. Deze eigenschap, indien ingeschakeld, bevat clusterbereikbronnen tijdens de back-up.
includedNamespaces	string[]	Hiermee haalt u de eigenschap include namespaces op of stelt u deze in. Met deze eigenschap worden de naamruimten ingesteld die moeten worden opgenomen tijdens de back-up.
includedResourceTypes	string[]	Hiermee haalt u de eigenschap include-resourcetypen op of stelt u deze in. Met deze eigenschap worden de resourcetypen ingesteld die moeten worden opgenomen tijdens de back-up.
includedVolumeTypes	AKSVolumeTypes[]	Hiermee haalt u de eigenschap include volumetypen op of stelt u deze in. Met deze eigenschap worden de volumetypen ingesteld die tijdens de back-up moeten worden opgenomen.
labelSelectors	string[]	Hiermee haalt u de eigenschap LabelSelectors op of stelt u deze in. Met deze eigenschap wordt de resource ingesteld met dergelijke labelkiezers die tijdens de back-up moeten worden opgenomen.
objectType	string: KubernetesClusterBackupDatasourceParameters	Type van het specifieke object dat wordt gebruikt voor deserialisatie
snapshotVolumes	boolean	Hiermee haalt u de eigenschap voor de momentopname van het volume op of stelt u deze in. Met deze eigenschap, indien ingeschakeld, worden momentopnamen van volumes gemaakt tijdens de back-up.

NamespacedNameResource

Object

Klasse om te verwijzen naar resources die naamruimte en naam bevatten

Name	Type	Description
name	string	Naam van de resource
namespace	string	Naamruimte waarin de resource bestaat

OperationJobExtendedInfo

Object

Uitgebreide informatie over bewerkingstaak

Name	Type	Description
jobId	string	Naam of Arm-id van de taak die voor deze bewerking is gemaakt.
objectType	string: OperationJobExtendedInfo	Deze eigenschap wordt gebruikt als de discriminator voor het bepalen van de specifieke typen in de polymorfische keten van typen.

PolicyInfo

Object

Beleidsgegevens in backupInstance

Name	Type	Description
policyId	string
policyParameters	PolicyParameters	Beleidsparameters voor het back-upexemplaren
policyVersion	string

PolicyParameters

Object

Parameters in beleid

Name	Type	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: AdlsBlobBackupDatasourceParameters[] BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Hiermee haalt u de parameters voor de back-upgegevensbron op of stelt u deze in
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Hiermee haalt u de datastoreparameters op of stelt u deze in

ProtectionStatusDetails

Object

Details van beveiligingsstatus

Name	Type	Description
errorDetails	UserFacingError	Hiermee geeft u de beveiligingsstatusfout van de resource op
status	Status	Hiermee geeft u de beveiligingsstatus van de resource

ResourcePropertiesObjectType

Inventarisatie

Type van het specifieke object dat wordt gebruikt voor deserialisatie

Waarde	Description
DefaultResourceProperties

SecretStoreBasedAuthCredentials

Object

Verificatiereferenties op basis van geheimarchief.

Name	Type	Description
objectType	string: SecretStoreBasedAuthCredentials	Type van het specifieke object dat wordt gebruikt voor deserialisatie
secretStoreResource	SecretStoreResource	Resource voor geheimarchief

SecretStoreResource

Object

Klasse die een geheime archiefresource vertegenwoordigt.

Name	Type	Description
secretStoreType	SecretStoreType	Hiermee wordt het type geheimarchief opgehaald of ingesteld
uri	string	Uri om naar de resource te gaan
value	string	Haalt de waarde op die is opgeslagen in een geheime archiefresource of stelt deze in

SecretStoreType

Inventarisatie

Hiermee wordt het type geheimarchief opgehaald of ingesteld

Waarde	Description
Invalid
AzureKeyVault

Status

Inventarisatie

Hiermee geeft u de beveiligingsstatus van de resource

Waarde	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

UserFacingError

Object

Foutobject dat wordt gebruikt door lagen die toegang hebben tot gelokaliseerde inhoud en die doorgeven aan de gebruiker

Name	Type	Description
code	string	Unieke code voor deze fout
details	UserFacingError[]	Aanvullende gerelateerde fouten
innerError	InnerError	Interne fout
isRetryable	boolean	Of de bewerking opnieuw kan worden geprobeerd of niet
isUserError	boolean	Of de bewerking wordt veroorzaakt door een gebruikersfout of servicefout
message	string
properties	object	Sleutel-waardeparen die kunnen worden geïnjecteerd in foutobject
recommendedAction	string[]	RecommendedAction gelokaliseerd.
target	string	Doel van de fout.

ValidateForBackupRequest

Object

Valideren voor back-upaanvraag

Name	Type	Description
backupInstance	BackupInstance	Back-upexemplaren

ValidationType

Inventarisatie

Hiermee geeft u het type validatie op. In het geval van DeepValidation worden alle validaties van /validateForBackup-API opnieuw uitgevoerd.

Waarde	Description
ShallowValidation
DeepValidation

Delen via

Backup Instances - Validate For Backup

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Validate For Backup

Voorbeeldaanvraag

Voorbeeldrespons

Definities

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