Backup Instances - Validate For Backup

Servicio:: Data Protection

Versión de la API:: 2025-09-01

Validar si la copia de seguridad adhoc se realizará correctamente o no

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
vaultName	path	True	string	El nombre de BackupVaultResource
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
backupInstance	True	BackupInstance	Instancia de copia de seguridad

Respuestas

Nombre	Tipo	Description
200 OK	OperationJobExtendedInfo	La operación de Azure se completó correctamente.
202 Accepted		Operación de recursos aceptada. Encabezados Azure-AsyncOperation: string Location: string
Other Status Codes	CloudError	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

OperationJobExtendedInfo

La operación de Azure se completó correctamente.

202 Accepted

Operación de recursos aceptada.

Encabezados

Azure-AsyncOperation: string
Location: string

Other Status Codes

CloudError

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Validate For Backup

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 200

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

status code:: 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

Definiciones

Nombre	Description
AdlsBlobBackupDatasourceParameters	Parámetros que se van a usar durante la configuración de la copia de seguridad de los blobs de la cuenta de Azure Data Lake Storage
AKSVolumeTypes
AzureOperationalStoreParameters	Parámetros para Operational-Tier DataStore
BackupInstance	Instancia de copia de seguridad
BlobBackupDatasourceParameters	Parámetros que se usarán durante la configuración de la copia de seguridad de blobs
CloudError	Respuesta de error de Azure Backup.
CurrentProtectionState	Especifica el estado de protección actual del recurso.
Datasource	Origen de datos del que se va a realizar una copia de seguridad
DatasourceSet	DatasourceSet detalles del origen de datos de los que se va a realizar una copia de seguridad
DataStoreTypes	tipo de almacén de datos; Operational/Vault/Archive
DefaultResourceProperties	Propiedades de origen predeterminadas
Error	Respuesta de error de administración de recursos.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
IdentityDetails
InnerError	Error interno
KubernetesClusterBackupDatasourceParameters	Parámetros para el origen de datos de copia de seguridad del clúster de Kubernetes
NamespacedNameResource	Clase para hacer referencia a los recursos que contienen el espacio de nombres y el nombre
OperationJobExtendedInfo	Información extendida del trabajo de operación
PolicyInfo	Información de directiva en backupInstance
PolicyParameters	Parámetros en la directiva
ProtectionStatusDetails	Detalles del estado de protección
ResourcePropertiesObjectType	Tipo del objeto específico: se usa para deserializar
SecretStoreBasedAuthCredentials	Credenciales de autenticación basadas en el almacén de secretos.
SecretStoreResource	Clase que representa un recurso de almacén de secretos.
SecretStoreType	Obtiene o establece el tipo de almacén de secretos.
Status	Especifica el estado de protección del recurso.
UserFacingError	Objeto de error usado por capas que tienen acceso al contenido localizado y propagar el objeto al usuario
ValidateForBackupRequest	Validación de la solicitud de copia de seguridad
ValidationType	Especifica el tipo de validación. En el caso de DeepValidation, todas las validaciones de /validateForBackup API se ejecutarán de nuevo.

AdlsBlobBackupDatasourceParameters

Object

Parámetros que se van a usar durante la configuración de la copia de seguridad de los blobs de la cuenta de Azure Data Lake Storage

Nombre	Tipo	Description
containersList	string[]	Lista de contenedores de los que se va a realizar una copia de seguridad durante la configuración de la copia de seguridad de blobs
objectType	string: AdlsBlobBackupDatasourceParameters	Tipo del objeto específico: se usa para deserializar

AKSVolumeTypes

Enumeración

Valor	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Object

Parámetros para Operational-Tier DataStore

Nombre	Tipo	Description
dataStoreType	DataStoreTypes	tipo de almacén de datos; Operational/Vault/Archive
objectType	string: AzureOperationalStoreParameters	Tipo del objeto específico: se usa para deserializar
resourceGroupId	string	Obtiene o establece el URI del grupo de recursos de instantáneas.

BackupInstance

Object

Instancia de copia de seguridad

Nombre	Tipo	Description
currentProtectionState	CurrentProtectionState	Especifica el estado de protección actual del recurso.
dataSourceInfo	Datasource	Obtiene o establece la información del origen de datos.
dataSourceSetInfo	DatasourceSet	Obtiene o establece la información del conjunto de orígenes de datos.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Credenciales que se usarán para autenticarse con el proveedor de origen de datos.
friendlyName	string	Obtiene o establece el nombre descriptivo de la instancia de copia de seguridad.
identityDetails	IdentityDetails	Contiene información de los detalles de identidad de la BI. Si es null, el valor predeterminado se considerará asignado por el sistema.
objectType	string
policyInfo	PolicyInfo	Obtiene o establece la información de directiva.
protectionErrorDetails	UserFacingError	Especifica el error de protección del recurso.
protectionStatus	ProtectionStatusDetails	Especifica el estado de protección del recurso.
provisioningState	string	Especifica el estado de aprovisionamiento del recurso, es decir, provisioning/updating/Succeeded/Failed
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests en los que se realizará la comprobación de LAC
validationType	ValidationType	Especifica el tipo de validación. En el caso de DeepValidation, todas las validaciones de /validateForBackup API se ejecutarán de nuevo.

BlobBackupDatasourceParameters

Object

Parámetros que se usarán durante la configuración de la copia de seguridad de blobs

Nombre	Tipo	Description
containersList	string[]	Lista de contenedores de los que se va a realizar una copia de seguridad durante la configuración de la copia de seguridad de blobs
objectType	string: BlobBackupDatasourceParameters	Tipo del objeto específico: se usa para deserializar

CloudError

Object

Respuesta de error de Azure Backup.

Nombre	Tipo	Description
error	Error	Respuesta de error de administración de recursos.

CurrentProtectionState

Enumeración

Especifica el estado de protección actual del recurso.

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

Datasource

Object

Origen de datos del que se va a realizar una copia de seguridad

Nombre	Tipo	Description
datasourceType	string	DatasourceType del recurso.
objectType	string	Tipo de objeto Datasource, usado para inicializar el tipo heredado correcto
resourceID	string	Id. de ARM completo del recurso. En el caso de los recursos de Azure, este es el identificador de ARM. En el caso de los recursos que no son de Azure, este será el identificador creado por el servicio de copia de seguridad a través de Fabric/Vault.
resourceLocation	string	Ubicación del origen de datos.
resourceName	string	Identificador único del recurso en el contexto del elemento primario.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Propiedades específicas del origen de datos
resourceType	string	Tipo de recurso de origen de datos.
resourceUri	string	Uri del recurso.

DatasourceSet

Object

DatasourceSet detalles del origen de datos de los que se va a realizar una copia de seguridad

Nombre	Tipo	Description
datasourceType	string	DatasourceType del recurso.
objectType	string	Tipo de objeto Datasource, usado para inicializar el tipo heredado correcto
resourceID	string	Id. de ARM completo del recurso. En el caso de los recursos de Azure, este es el identificador de ARM. En el caso de los recursos que no son de Azure, este será el identificador creado por el servicio de copia de seguridad a través de Fabric/Vault.
resourceLocation	string	Ubicación del origen de datos.
resourceName	string	Identificador único del recurso en el contexto del elemento primario.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Propiedades específicas del conjunto de orígenes de datos
resourceType	string	Tipo de recurso de origen de datos.
resourceUri	string	Uri del recurso.

DataStoreTypes

Enumeración

tipo de almacén de datos; Operational/Vault/Archive

Valor	Description
OperationalStore
VaultStore
ArchiveStore

DefaultResourceProperties

Object

Propiedades de origen predeterminadas

Nombre	Tipo	Description
objectType	string: DefaultResourceProperties	Tipo del objeto específico: se usa para deserializar

Error

Object

Respuesta de error de administración de recursos.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	Error[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

IdentityDetails

Object

Nombre	Tipo	Description
useSystemAssignedIdentity	boolean	Especifica si la BI está protegida por la identidad del sistema.
userAssignedIdentityArmUrl	string	Dirección URL de ARM para la identidad asignada por el usuario.

InnerError

Object

Error interno

Nombre	Tipo	Description
additionalInfo	object	Cualquier par clave de valor que se pueda proporcionar al cliente para obtener información detallada adicional.
code	string	Código único para este error
embeddedInnerError	InnerError	Error interno secundario para permitir el anidamiento.

KubernetesClusterBackupDatasourceParameters

Object

Parámetros para el origen de datos de copia de seguridad del clúster de Kubernetes

Nombre	Tipo	Description
backupHookReferences	NamespacedNameResource[]	Obtiene o establece las referencias de enlace de copia de seguridad. Esta propiedad establece la referencia de enlace que se va a ejecutar durante la copia de seguridad.
excludedNamespaces	string[]	Obtiene o establece la propiedad exclude namespaces. Esta propiedad establece los espacios de nombres que se excluirán durante la copia de seguridad.
excludedResourceTypes	string[]	Obtiene o establece la propiedad exclude resource types . Esta propiedad establece los tipos de recursos que se excluirán durante la copia de seguridad.
includeClusterScopeResources	boolean	Obtiene o establece la propiedad include cluster resources. Esta propiedad si está habilitada incluirá recursos de ámbito de clúster durante la copia de seguridad.
includedNamespaces	string[]	Obtiene o establece la propiedad include namespaces. Esta propiedad establece los espacios de nombres que se incluirán durante la copia de seguridad.
includedResourceTypes	string[]	Obtiene o establece la propiedad include resource types. Esta propiedad establece los tipos de recursos que se incluirán durante la copia de seguridad.
includedVolumeTypes	AKSVolumeTypes[]	Obtiene o establece la propiedad incluir tipos de volumen. Esta propiedad establece los tipos de volumen que se incluirán durante la copia de seguridad.
labelSelectors	string[]	Obtiene o establece la propiedad LabelSelectors. Esta propiedad establece el recurso con estos selectores de etiquetas que se incluirán durante la copia de seguridad.
objectType	string: KubernetesClusterBackupDatasourceParameters	Tipo del objeto específico: se usa para deserializar
snapshotVolumes	boolean	Obtiene o establece la propiedad de instantánea de volumen. Esta propiedad si está habilitada tomará instantáneas de volumen durante la copia de seguridad.

NamespacedNameResource

Object

Clase para hacer referencia a los recursos que contienen el espacio de nombres y el nombre

Nombre	Tipo	Description
name	string	Nombre del recurso
namespace	string	Espacio de nombres en el que existe el recurso

OperationJobExtendedInfo

Object

Información extendida del trabajo de operación

Nombre	Tipo	Description
jobId	string	Nombre o id. de Arm del trabajo creado para esta operación.
objectType	string: OperationJobExtendedInfo	Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.

PolicyInfo

Object

Información de directiva en backupInstance

Nombre	Tipo	Description
policyId	string
policyParameters	PolicyParameters	Parámetros de directiva para la instancia de copia de seguridad
policyVersion	string

PolicyParameters

Object

Parámetros en la directiva

Nombre	Tipo	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: AdlsBlobBackupDatasourceParameters[] BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Obtiene o establece los parámetros del origen de datos de copia de seguridad.
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Obtiene o establece los parámetros del almacén de datos.

ProtectionStatusDetails

Object

Detalles del estado de protección

Nombre	Tipo	Description
errorDetails	UserFacingError	Especifica el error de estado de protección del recurso.
status	Status	Especifica el estado de protección del recurso.

ResourcePropertiesObjectType

Enumeración

Tipo del objeto específico: se usa para deserializar

Valor	Description
DefaultResourceProperties

SecretStoreBasedAuthCredentials

Object

Credenciales de autenticación basadas en el almacén de secretos.

Nombre	Tipo	Description
objectType	string: SecretStoreBasedAuthCredentials	Tipo del objeto específico: se usa para deserializar
secretStoreResource	SecretStoreResource	Recurso de almacén de secretos

SecretStoreResource

Object

Clase que representa un recurso de almacén de secretos.

Nombre	Tipo	Description
secretStoreType	SecretStoreType	Obtiene o establece el tipo de almacén de secretos.
uri	string	Uri para llegar al recurso
value	string	Obtiene o establece el valor almacenado en el recurso del almacén secreto.

SecretStoreType

Enumeración

Obtiene o establece el tipo de almacén de secretos.

Valor	Description
Invalid
AzureKeyVault

Status

Enumeración

Especifica el estado de protección del recurso.

Valor	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

UserFacingError

Object

Objeto de error usado por capas que tienen acceso al contenido localizado y propagar el objeto al usuario

Nombre	Tipo	Description
code	string	Código único para este error
details	UserFacingError[]	Errores relacionados adicionales
innerError	InnerError	Error interno
isRetryable	boolean	Si la operación se volverá a intentar o no
isUserError	boolean	Si la operación se debe a un error de usuario o a un error de servicio
message	string
properties	object	Cualquier par de valores clave que se pueda insertar dentro del objeto de error
recommendedAction	string[]	RecommendedAction localizado.
target	string	Destino del error.

ValidateForBackupRequest

Object

Validación de la solicitud de copia de seguridad

Nombre	Tipo	Description
backupInstance	BackupInstance	Instancia de copia de seguridad

ValidationType

Enumeración

Especifica el tipo de validación. En el caso de DeepValidation, todas las validaciones de /validateForBackup API se ejecutarán de nuevo.

Valor	Description
ShallowValidation
DeepValidation

Compartir a través de

Backup Instances - Validate For Backup

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

Validate For Backup

Solicitud de ejemplo

Respuesta de muestra

Definiciones

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