Backup Instances - Validate For Backup

Servicio:: Data Protection

Versión de la API:: 2025-07-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-07-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	Nombre del almacén de copia de seguridad.
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	Contiene información adicional, como el identificador de trabajo y la información extendida del trabajo de operación de la operación asincrónica para realizar un seguimiento del estado.
202 Accepted		La operación se completará de forma asincrónica. Encabezados Location: string Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	CloudError	Respuesta de error que describe por qué se produjo un error en la operación.

Nombre

Tipo

Description

200 OK

OperationJobExtendedInfo

Contiene información adicional, como el identificador de trabajo y la información extendida del trabajo de operación de la operación asincrónica para realizar un seguimiento del estado.

202 Accepted

La operación se completará de forma asincrónica.

Encabezados

Location: string
Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

CloudError

Respuesta de error que describe por qué se produjo un error en la operación.

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-07-01

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

Respuesta de muestra

status code:: 202

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

status code:: 200

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

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	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.
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	CloudError
CurrentProtectionState	Especifica el estado de protección actual del recurso.
Datasource	Origen de datos
DatasourceSet	DatasourceSet
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	InnerError
KubernetesClusterBackupDatasourceParameters	Parámetros para el origen de datos de copia de seguridad del clúster de Kubernetes
NamespacedNameResource	NamespacedNameResource
OperationJobExtendedInfo	OperationJobExtendedInfo
PolicyInfo	Información de políticas
PolicyParameters	Parámetros en la directiva
ProtectionStatusDetails	Detalles del Estado de Protección
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	ValidateForBackupRequest
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

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.

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	Origen de datos Obtiene o establece la información del origen de datos.
dataSourceSetInfo	DatasourceSet	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	Información de políticas Obtiene o establece la información de directiva.
protectionErrorDetails	UserFacingError	Especifica el error de protección del recurso.
protectionStatus	ProtectionStatusDetails	Detalles del Estado de Protección 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

CloudError

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
BackupSchedulesSuspended
ConfiguringProtection
ConfiguringProtectionFailed
Invalid
NotProtected
ProtectionConfigured
ProtectionError
ProtectionStopped
RetentionSchedulesSuspended
SoftDeleted
SoftDeleting
UpdatingProtection

Datasource

Object

Origen de datos

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

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
ArchiveStore
OperationalStore
VaultStore

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

InnerError

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

NamespacedNameResource

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

OperationJobExtendedInfo

Object

OperationJobExtendedInfo

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 políticas

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.

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
AzureKeyVault
Invalid

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

ValidateForBackupRequest

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
DeepValidation
ShallowValidation

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

SecretStoreBasedAuthCredentials

SecretStoreResource

SecretStoreType

Status

UserFacingError

ValidateForBackupRequest

ValidationType