Backup Instances - Validate For Backup

Service:: Data Protection

Version d’API:: 2026-06-01

Vérifiez si la sauvegarde adhoc réussit ou non

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
vaultName	path	True	string	Le nom de BackupVaultResource
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
backupInstance	True	BackupInstance	Instance de sauvegarde

Réponses

Nom	Type	Description
200 OK	OperationJobExtendedInfo	Opération Azure terminée avec succès.
202 Accepted		Exploitation des ressources acceptée. En-têtes Azure-AsyncOperation: string Location: string
Other Status Codes	CloudError	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

OperationJobExtendedInfo

Opération Azure terminée avec succès.

202 Accepted

Exploitation des ressources acceptée.

En-têtes

Azure-AsyncOperation: string
Location: string

Other Status Codes

CloudError

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 d’Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Usurper l’identité de votre compte utilisateur

Exemples

Validate For Backup

Exemple de requête

HTTP

POST https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/validateForBackup?api-version=2026-06-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"
    }
  }
}

Exemple de réponse

Code d’état:: 200

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

Code d’état:: 202

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

Définitions

Nom	Description
AdlsBlobBackupDatasourceParameters	Paramètres à utiliser lors de la configuration de la sauvegarde des objets blob de comptes de stockage Azure Data Lake
AdlsBlobBackupDatasourceParametersForAutoProtection	Paramètres à utiliser lors de la configuration de la sauvegarde des blobs de comptes de stockage Azure Data Lake en utilisant les paramètres AutoProtection
AKSVolumeTypes
AzureOperationalStoreParameters	Paramètres du magasin de données Operational-Tier
BackupInstance	Instance de sauvegarde
BlobBackupAutoProtectionRule	Indique une règle de protection automatique contre la sauvegarde de blobs.
BlobBackupDatasourceParameters	Paramètres à utiliser lors de la configuration de la sauvegarde d’objets blob
BlobBackupDatasourceParametersForAutoProtection	Paramters à utiliser lors de la configuration de sauvegarde des blobs via les paramètres AutoProtection
BlobBackupPatternType	Type de patron. Seul le préfixe est pris en charge pour l’instant.
BlobBackupRuleBasedAutoProtectionSettings	Paramètres à utiliser pour les paramètres de protection automatique basée sur les règles de sauvegarde de blob.
BlobBackupRuleMode	Mode règle (Exclusif uniquement pris en charge pour l’instant).
CloudError	Réponse d’erreur de Sauvegarde Azure.
CurrentProtectionState	Spécifie l’état de protection actuel de la ressource
Datasource	Source de données à sauvegarder
DatasourceSet	Détails de DatasourceSet de la source de données à sauvegarder
DataStoreTypes	type de magasin de données ; Operational/Vault/Archive
DefaultResourceProperties	Propriétés sources par défaut
Error	Réponse d’erreur de gestion des ressources.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
GenericBackupDatasourceParameters	Paramètres génériques à utiliser lors de la configuration de la sauvegarde
IdentityDetails
InnerError	Erreur interne
KubernetesClusterBackupDatasourceParameters	Paramètres de la source de données de sauvegarde de cluster Kubernetes
NamespacedNameResource	Classe pour faire référence aux ressources qui contiennent l’espace de noms et le nom
OperationJobExtendedInfo	Informations étendues du travail d’opération
PolicyInfo	Informations de stratégie dans backupInstance
PolicyParameters	Paramètres dans la stratégie
ProtectionStatusDetails	Détails de l’état de la protection
ResourcePropertiesObjectType	Type de l’objet spécifique - utilisé pour la désérialisation
SecretStoreBasedAuthCredentials	Informations d’identification d’authentification basées sur le magasin de secrets.
SecretStoreResource	Classe représentant une ressource de magasin de secrets.
SecretStoreType	Obtient ou définit le type de magasin de secrets
Status	Spécifie l’état de protection de la ressource
UserFacingError	Objet d’erreur utilisé par les couches qui ont accès au contenu localisé et propagent celui-ci à l’utilisateur
ValidateForBackupRequest	Valider pour la demande de sauvegarde
ValidationType	Spécifie le type de validation. En cas de DeepValidation, toutes les validations de l’API /validateForBackup s’exécutent à nouveau.

AdlsBlobBackupDatasourceParameters

Objet

Paramètres à utiliser lors de la configuration de la sauvegarde des objets blob de comptes de stockage Azure Data Lake

Nom	Type	Description
containersList	string[]	Liste des conteneurs à sauvegarder lors de la configuration de la sauvegarde des objets blob
objectType	string: AdlsBlobBackupDatasourceParameters	Type de l’objet spécifique - utilisé pour la désérialisation

AdlsBlobBackupDatasourceParametersForAutoProtection

Objet

Paramètres à utiliser lors de la configuration de la sauvegarde des blobs de comptes de stockage Azure Data Lake en utilisant les paramètres AutoProtection

Nom	Type	Description
autoProtectionSettings	BlobBackupRuleBasedAutoProtectionSettings	Paramètres d’Autoprotection
objectType	string: AdlsBlobBackupDatasourceParametersForAutoProtection	Type de l’objet spécifique - utilisé pour la désérialisation

AKSVolumeTypes

Énumération

Valeur	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Objet

Paramètres du magasin de données Operational-Tier

Nom	Type	Description
dataStoreType	DataStoreTypes	type de magasin de données ; Operational/Vault/Archive
objectType	string: AzureOperationalStoreParameters	Type de l’objet spécifique - utilisé pour la désérialisation
resourceGroupId	string	Obtient ou définit l’URI du groupe de ressources d’instantané.

BackupInstance

Objet

Instance de sauvegarde

Nom	Type	Description
currentProtectionState	CurrentProtectionState	Spécifie l’état de protection actuel de la ressource
dataSourceInfo	Datasource	Obtient ou définit les informations de source de données.
dataSourceSetInfo	DatasourceSet	Obtient ou définit les informations du jeu de sources de données.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Informations d’identification à utiliser pour s’authentifier auprès du fournisseur de source de données.
friendlyName	string	Obtient ou définit le nom convivial de l’instance de sauvegarde.
identityDetails	IdentityDetails	Contient des informations sur les détails de l’identité pour le décisionnel. S’il s’agit de null, la valeur par défaut est considérée comme affectée par le système.
objectType	string
policyInfo	PolicyInfo	Obtient ou définit les informations de stratégie.
protectionErrorDetails	UserFacingError	Spécifie l’erreur de protection de la ressource
protectionStatus	ProtectionStatusDetails	Spécifie l’état de protection de la ressource
provisioningState	string	Spécifie l’état d’approvisionnement de la ressource, c’est-à-dire l’approvisionnement/la mise à jour/Succeeded/Failed
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests sur laquelle la vérification LAC sera effectuée
validationType	ValidationType	Spécifie le type de validation. En cas de DeepValidation, toutes les validations de l’API /validateForBackup s’exécutent à nouveau.

BlobBackupAutoProtectionRule

Objet

Indique une règle de protection automatique contre la sauvegarde de blobs.

Nom	Type	Description
mode	BlobBackupRuleMode	Exclure supprime les candidats (après inclusion)
objectType	string	Type de l’objet spécifique - utilisé pour la désérialisation
pattern	string	Le motif de chaîne à évaluer par rapport aux noms de conteneurs. Pour l’instant, cela n’accepte que les chaînes littérales (pas de jokers ni de régulation).
type	BlobBackupPatternType	Type de patron : Préfixe, seul le type de patron est pris en charge pour l’instant.

BlobBackupDatasourceParameters

Objet

Paramètres à utiliser lors de la configuration de la sauvegarde d’objets blob

Nom	Type	Description
containersList	string[]	Liste des conteneurs à sauvegarder lors de la configuration de la sauvegarde des objets blob
objectType	string: BlobBackupDatasourceParameters	Type de l’objet spécifique - utilisé pour la désérialisation

BlobBackupDatasourceParametersForAutoProtection

Objet

Paramters à utiliser lors de la configuration de sauvegarde des blobs via les paramètres AutoProtection

Nom	Type	Description
autoProtectionSettings	BlobBackupRuleBasedAutoProtectionSettings	Paramètres d’Autoprotection
objectType	string: BlobBackupDatasourceParametersForAutoProtection	Type de l’objet spécifique - utilisé pour la désérialisation

BlobBackupPatternType

Énumération

Type de patron. Seul le préfixe est pris en charge pour l’instant.

Valeur	Description
Prefix

BlobBackupRuleBasedAutoProtectionSettings

Objet

Paramètres à utiliser pour les paramètres de protection automatique basée sur les règles de sauvegarde de blob.

Nom	Type	Description
enabled	boolean	Marquez pour activer la protection auto.
objectType	string: BlobBackupRuleBasedAutoProtectionSettings	Type de l’objet spécifique - utilisé pour la désérialisation
rules	BlobBackupAutoProtectionRule[]	Les règles sont évaluées dans l’ordre fourni. L’inclusion ajoute des candidats ; L’exclusion élimine les candidats. Si aucune règle n’est présente, tous les conteneurs sont considérés comme éligibles lorsqu’activé = vrai.

BlobBackupRuleMode

Énumération

Mode règle (Exclusif uniquement pris en charge pour l’instant).

Valeur	Description
Exclude

CloudError

Objet

Réponse d’erreur de Sauvegarde Azure.

Nom	Type	Description
error	Error	Réponse d’erreur de gestion des ressources.

CurrentProtectionState

Énumération

Spécifie l’état de protection actuel de la ressource

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

Datasource

Objet

Source de données à sauvegarder

Nom	Type	Description
datasourceType	string	DatasourceType de la ressource.
objectType	string	Type d’objet Datasource, utilisé pour initialiser le type hérité droit
resourceID	string	ID ARM complet de la ressource. Pour les ressources Azure, il s’agit de l’ID ARM. Pour les ressources non Azure, ce sera l’ID créé par le service de sauvegarde via Fabric/Vault.
resourceLocation	string	Emplacement de la source de données.
resourceName	string	Identificateur unique de la ressource dans le contexte du parent.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Propriétés spécifiques à la source de données
resourceType	string	Type de ressource de la source de données.
resourceUri	string	Uri de la ressource.

DatasourceSet

Objet

Détails de DatasourceSet de la source de données à sauvegarder

Nom	Type	Description
datasourceType	string	DatasourceType de la ressource.
objectType	string	Type d’objet Datasource, utilisé pour initialiser le type hérité droit
resourceID	string	ID ARM complet de la ressource. Pour les ressources Azure, il s’agit de l’ID ARM. Pour les ressources non Azure, ce sera l’ID créé par le service de sauvegarde via Fabric/Vault.
resourceLocation	string	Emplacement de la source de données.
resourceName	string	Identificateur unique de la ressource dans le contexte du parent.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Propriétés propres au jeu de sources de données
resourceType	string	Type de ressource de la source de données.
resourceUri	string	Uri de la ressource.

DataStoreTypes

Énumération

type de magasin de données ; Operational/Vault/Archive

Valeur	Description
OperationalStore
VaultStore
ArchiveStore

DefaultResourceProperties

Objet

Propriétés sources par défaut

Nom	Type	Description
objectType	string: DefaultResourceProperties	Type de l’objet spécifique - utilisé pour la désérialisation

Error

Objet

Réponse d’erreur de gestion des ressources.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations complémentaires sur l’erreur.
code	string	Code d’erreur.
details	Error[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Le type d’informations supplémentaires.

GenericBackupDatasourceParameters

Objet

Paramètres génériques à utiliser lors de la configuration de la sauvegarde

Nom	Type	Description
objectType	string: GenericBackupDatasourceParameters	Type de l’objet spécifique - utilisé pour la désérialisation
resourceSelectors	string[]	Liste des sélecteurs de ressources à sauvegarder lors de la configuration de la sauvegarde

IdentityDetails

Objet

Nom	Type	Description
useSystemAssignedIdentity	boolean	Spécifie si la bi est protégée par l’identité système.
userAssignedIdentityArmUrl	string	URL ARM pour l’identité affectée par l’utilisateur.

InnerError

Objet

Erreur interne

Nom	Type	Description
additionalInfo	object	Toutes les paires clé-valeur qui peuvent être fournies au client pour obtenir des informations détaillées supplémentaires.
code	string	Code unique pour cette erreur
embeddedInnerError	InnerError	Erreur interne enfant pour autoriser l’imbrication.

KubernetesClusterBackupDatasourceParameters

Objet

Paramètres de la source de données de sauvegarde de cluster Kubernetes

Nom	Type	Description
backupHookReferences	NamespacedNameResource[]	Obtient ou définit les références de hook de sauvegarde. Cette propriété définit la référence de hook à exécuter pendant la sauvegarde.
excludedNamespaces	string[]	Obtient ou définit la propriété exclure des espaces de noms. Cette propriété définit les espaces de noms à exclure pendant la sauvegarde.
excludedResourceTypes	string[]	Obtient ou définit la propriété exclure les types de ressources. Cette propriété définit les types de ressources à exclure pendant la sauvegarde.
includeClusterScopeResources	boolean	Obtient ou définit la propriété des ressources de cluster include. Cette propriété s’il est activé inclut des ressources d’étendue de cluster pendant la sauvegarde.
includedNamespaces	string[]	Obtient ou définit la propriété include namespaces. Cette propriété définit les espaces de noms à inclure pendant la sauvegarde.
includedResourceTypes	string[]	Obtient ou définit la propriété include resource types. Cette propriété définit les types de ressources à inclure pendant la sauvegarde.
includedVolumeTypes	AKSVolumeTypes[]	Obtient ou définit la propriété des types de volumes include. Cette propriété définit les types de volumes à inclure pendant la sauvegarde.
labelSelectors	string[]	Obtient ou définit la propriété LabelSelectors. Cette propriété définit la ressource avec ces sélecteurs d’étiquettes à inclure pendant la sauvegarde.
objectType	string: KubernetesClusterBackupDatasourceParameters	Type de l’objet spécifique - utilisé pour la désérialisation
snapshotVolumes	boolean	Obtient ou définit la propriété d’instantané de volume. Cette propriété si activée prend des instantanés de volume lors de la sauvegarde.

NamespacedNameResource

Objet

Classe pour faire référence aux ressources qui contiennent l’espace de noms et le nom

Nom	Type	Description
name	string	Nom de la ressource
namespace	string	Espace de noms dans lequel la ressource existe

OperationJobExtendedInfo

Objet

Informations étendues du travail d’opération

Nom	Type	Description
jobId	string	Nom ou ID d’arm du travail créé pour cette opération.
objectType	string: OperationJobExtendedInfo	Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.

PolicyInfo

Objet

Informations de stratégie dans backupInstance

Nom	Type	Description
policyId	string
policyParameters	PolicyParameters	Paramètres de stratégie pour l’instance de sauvegarde
policyVersion	string

PolicyParameters

Objet

Paramètres dans la stratégie

Nom	Type	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: AdlsBlobBackupDatasourceParameters[] AdlsBlobBackupDatasourceParametersForAutoProtection[] BlobBackupDatasourceParameters[] BlobBackupDatasourceParametersForAutoProtection[] GenericBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Obtient ou définit les paramètres de la source de données de sauvegarde
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Obtient ou définit les paramètres du Magasin de données

ProtectionStatusDetails

Objet

Détails de l’état de la protection

Nom	Type	Description
errorDetails	UserFacingError	Spécifie l’erreur d’état de protection de la ressource
status	Status	Spécifie l’état de protection de la ressource

ResourcePropertiesObjectType

Énumération

Type de l’objet spécifique - utilisé pour la désérialisation

Valeur	Description
DefaultResourceProperties

SecretStoreBasedAuthCredentials

Objet

Informations d’identification d’authentification basées sur le magasin de secrets.

Nom	Type	Description
objectType	string: SecretStoreBasedAuthCredentials	Type de l’objet spécifique - utilisé pour la désérialisation
secretStoreResource	SecretStoreResource	Ressource du magasin de secrets

SecretStoreResource

Objet

Classe représentant une ressource de magasin de secrets.

Nom	Type	Description
secretStoreType	SecretStoreType	Obtient ou définit le type de magasin de secrets
uri	string	URI pour accéder à la ressource
value	string	Obtient ou définit la valeur stockée dans la ressource de magasin de secrets

SecretStoreType

Énumération

Obtient ou définit le type de magasin de secrets

Valeur	Description
Invalid
AzureKeyVault

Status

Énumération

Spécifie l’état de protection de la ressource

Valeur	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

UserFacingError

Objet

Objet d’erreur utilisé par les couches qui ont accès au contenu localisé et propagent celui-ci à l’utilisateur

Nom	Type	Description
code	string	Code unique pour cette erreur
details	UserFacingError[]	Erreurs connexes supplémentaires
innerError	InnerError	Erreur interne
isRetryable	boolean	Indique si l’opération sera retenable ou non
isUserError	boolean	Indique si l’opération est due à une erreur utilisateur ou à une erreur de service
message	string
properties	object	Toutes les paires clé-valeur qui peuvent être injectées à l’intérieur de l’objet d’erreur
recommendedAction	string[]	RecommendedAction localisé.
target	string	Cible de l’erreur.

ValidateForBackupRequest

Objet

Valider pour la demande de sauvegarde

Nom	Type	Description
backupInstance	BackupInstance	Instance de sauvegarde

ValidationType

Énumération

Spécifie le type de validation. En cas de DeepValidation, toutes les validations de l’API /validateForBackup s’exécutent à nouveau.

Valeur	Description
ShallowValidation
DeepValidation