Backup Instances - Validate For Backup

Serviço:: Data Protection

Versão da API:: 2025-09-01

Validar se o backup de adesivo será bem-sucedido ou não

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
vaultName	path	True	string	O nome do BackupVaultResource
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
backupInstance	True	BackupInstance	Instância de Backup

Respostas

Nome	Tipo	Description
200 OK	OperationJobExtendedInfo	A operação do Azure foi concluída com êxito.
202 Accepted		Operação de recurso aceita. Cabeçalhos Azure-AsyncOperation: string Location: string
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Nome

Tipo

Description

200 OK

OperationJobExtendedInfo

A operação do Azure foi concluída com êxito.

202 Accepted

Operação de recurso aceita.

Cabeçalhos

Azure-AsyncOperation: string
Location: string

Other Status Codes

CloudError

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Validate For Backup

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 200

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

Código de status:: 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

Definições

Nome	Description
AdlsBlobBackupDatasourceParameters	Parâmetros a serem usados durante a configuração do backup de blobs de conta do Azure Data Lake Storage
AKSVolumeTypes
AzureOperationalStoreParameters	Parâmetros para Operational-Tier DataStore
BackupInstance	Instância de Backup
BlobBackupDatasourceParameters	Parâmetros a serem usados durante a configuração do backup de blobs
CloudError	Uma resposta de erro do Backup do Azure.
CurrentProtectionState	Especifica o estado de proteção atual do recurso
Datasource	Fonte de dados a ser backup
DatasourceSet	Detalhes do Conjunto de Fontes de Dados da fonte de dados a ser feito em backup
DataStoreTypes	tipo de armazenamento de dados; Operacional/Cofre/Arquivo Morto
DefaultResourceProperties	Propriedades de origem padrão
Error	A resposta de erro de gerenciamento de recursos.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
IdentityDetails
InnerError	Erro interno
KubernetesClusterBackupDatasourceParameters	Parâmetros para a fonte de dados de backup do cluster do Kubernetes
NamespacedNameResource	Classe para consultar recursos que contêm namespace e nome
OperationJobExtendedInfo	Informações estendidas do trabalho de operação
PolicyInfo	Informações de política no backupInstance
PolicyParameters	Parâmetros na política
ProtectionStatusDetails	Detalhes do status da proteção
ResourcePropertiesObjectType	Tipo do objeto específico – usado para desserializar
SecretStoreBasedAuthCredentials	Credenciais de autenticação baseadas em repositório secreto.
SecretStoreResource	Classe que representa um recurso do repositório de segredos.
SecretStoreType	Obtém ou define o tipo de repositório secreto
Status	Especifica o status de proteção do recurso
UserFacingError	Objeto de erro usado por camadas que têm acesso ao conteúdo localizado e propagam isso para o usuário
ValidateForBackupRequest	Validar para solicitação de backup
ValidationType	Especifica o tipo de validação. No caso do DeepValidation, todas as validações da API /validateForBackup serão executadas novamente.

AdlsBlobBackupDatasourceParameters

Objeto

Parâmetros a serem usados durante a configuração do backup de blobs de conta do Azure Data Lake Storage

Nome	Tipo	Description
containersList	string[]	Lista de contêineres a serem armazenados em backup durante a configuração do backup de blobs
objectType	string: AdlsBlobBackupDatasourceParameters	Tipo do objeto específico – usado para desserializar

AKSVolumeTypes

Enumeração

Valor	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Objeto

Parâmetros para Operational-Tier DataStore

Nome	Tipo	Description
dataStoreType	DataStoreTypes	tipo de armazenamento de dados; Operacional/Cofre/Arquivo Morto
objectType	string: AzureOperationalStoreParameters	Tipo do objeto específico – usado para desserializar
resourceGroupId	string	Obtém ou define o Uri do Grupo de Recursos de Instantâneo.

BackupInstance

Objeto

Instância de Backup

Nome	Tipo	Description
currentProtectionState	CurrentProtectionState	Especifica o estado de proteção atual do recurso
dataSourceInfo	Datasource	Obtém ou define as informações da fonte de dados.
dataSourceSetInfo	DatasourceSet	Obtém ou define as informações do conjunto de fontes de dados.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Credenciais a serem usadas para autenticar com o provedor de fonte de dados.
friendlyName	string	Obtém ou define o nome amigável da Instância de Backup.
identityDetails	IdentityDetails	Contém informações dos Detalhes de Identidade para o BI. Se for nulo, o padrão será considerado como Atribuído pelo Sistema.
objectType	string
policyInfo	PolicyInfo	Obtém ou define as informações da política.
protectionErrorDetails	UserFacingError	Especifica o erro de proteção do recurso
protectionStatus	ProtectionStatusDetails	Especifica o status de proteção do recurso
provisioningState	string	Especifica o estado de provisionamento do recurso, ou seja, provisionamento/atualização/êxito/com falha
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests no qual a verificação LAC será executada
validationType	ValidationType	Especifica o tipo de validação. No caso do DeepValidation, todas as validações da API /validateForBackup serão executadas novamente.

BlobBackupDatasourceParameters

Objeto

Parâmetros a serem usados durante a configuração do backup de blobs

Nome	Tipo	Description
containersList	string[]	Lista de contêineres a serem armazenados em backup durante a configuração do backup de blobs
objectType	string: BlobBackupDatasourceParameters	Tipo do objeto específico – usado para desserializar

CloudError

Objeto

Uma resposta de erro do Backup do Azure.

Nome	Tipo	Description
error	Error	A resposta de erro de gerenciamento de recursos.

CurrentProtectionState

Enumeração

Especifica o estado de proteção atual do recurso

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

Datasource

Objeto

Fonte de dados a ser backup

Nome	Tipo	Description
datasourceType	string	DatasourceType do recurso.
objectType	string	Tipo de objeto Datasource, usado para inicializar o tipo herdado correto
resourceID	string	ID completa do ARM do recurso. Para recursos do Azure, essa é a ID do ARM. Para recursos que não são do Azure, essa será a ID criada pelo serviço de backup por meio do Fabric/Vault.
resourceLocation	string	Local da fonte de dados.
resourceName	string	Identificador exclusivo do recurso no contexto do pai.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Propriedades específicas da fonte de dados
resourceType	string	Tipo de recurso de fonte de dados.
resourceUri	string	Uri do recurso.

DatasourceSet

Objeto

Detalhes do Conjunto de Fontes de Dados da fonte de dados a ser feito em backup

Nome	Tipo	Description
datasourceType	string	DatasourceType do recurso.
objectType	string	Tipo de objeto Datasource, usado para inicializar o tipo herdado correto
resourceID	string	ID completa do ARM do recurso. Para recursos do Azure, essa é a ID do ARM. Para recursos que não são do Azure, essa será a ID criada pelo serviço de backup por meio do Fabric/Vault.
resourceLocation	string	Local da fonte de dados.
resourceName	string	Identificador exclusivo do recurso no contexto do pai.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Propriedades específicas do conjunto de fontes de dados
resourceType	string	Tipo de recurso de fonte de dados.
resourceUri	string	Uri do recurso.

DataStoreTypes

Enumeração

tipo de armazenamento de dados; Operacional/Cofre/Arquivo Morto

Valor	Description
OperationalStore
VaultStore
ArchiveStore

DefaultResourceProperties

Objeto

Propriedades de origem padrão

Nome	Tipo	Description
objectType	string: DefaultResourceProperties	Tipo do objeto específico – usado para desserializar

Error

Objeto

A resposta de erro de gerenciamento de recursos.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	Error[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

IdentityDetails

Objeto

Nome	Tipo	Description
useSystemAssignedIdentity	boolean	Especifica se o BI está protegido pela Identidade do Sistema.
userAssignedIdentityArmUrl	string	URL do ARM para identidade atribuída pelo usuário.

InnerError

Objeto

Erro interno

Nome	Tipo	Description
additionalInfo	object	Todos os pares de valor chave que podem ser fornecidos ao cliente para obter informações detalhadas adicionais.
code	string	Código exclusivo para este erro
embeddedInnerError	InnerError	Erro interno filho, para permitir o aninhamento.

KubernetesClusterBackupDatasourceParameters

Objeto

Parâmetros para a fonte de dados de backup do cluster do Kubernetes

Nome	Tipo	Description
backupHookReferences	NamespacedNameResource[]	Obtém ou define as referências de gancho de backup. Essa propriedade define a referência de gancho a ser executada durante o backup.
excludedNamespaces	string[]	Obtém ou define a propriedade excluir namespaces. Essa propriedade define os namespaces a serem excluídos durante o backup.
excludedResourceTypes	string[]	Obtém ou define a propriedade excluir tipos de recurso. Essa propriedade define os tipos de recurso a serem excluídos durante o backup.
includeClusterScopeResources	boolean	Obtém ou define a propriedade incluir recursos de cluster. Essa propriedade, se habilitada, incluirá recursos de escopo de cluster durante o backup.
includedNamespaces	string[]	Obtém ou define a propriedade de namespaces de inclusão. Essa propriedade define os namespaces a serem incluídos durante o backup.
includedResourceTypes	string[]	Obtém ou define a propriedade incluir tipos de recurso. Essa propriedade define os tipos de recurso a serem incluídos durante o backup.
includedVolumeTypes	AKSVolumeTypes[]	Obtém ou define a propriedade incluir tipos de volume. Essa propriedade define os tipos de volume a serem incluídos durante o backup.
labelSelectors	string[]	Obtém ou define a propriedade LabelSelectors. Essa propriedade define o recurso com esses seletores de rótulo a serem incluídos durante o backup.
objectType	string: KubernetesClusterBackupDatasourceParameters	Tipo do objeto específico – usado para desserializar
snapshotVolumes	boolean	Obtém ou define a propriedade de instantâneo de volume. Essa propriedade, se habilitada, tirará instantâneos de volume durante o backup.

NamespacedNameResource

Objeto

Classe para consultar recursos que contêm namespace e nome

Nome	Tipo	Description
name	string	Nome do recurso
namespace	string	Namespace no qual o recurso existe

OperationJobExtendedInfo

Objeto

Informações estendidas do trabalho de operação

Nome	Tipo	Description
jobId	string	Nome ou ID do braço do trabalho criado para esta operação.
objectType	string: OperationJobExtendedInfo	Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.

PolicyInfo

Objeto

Informações de política no backupInstance

Nome	Tipo	Description
policyId	string
policyParameters	PolicyParameters	Parâmetros de política para a instância de backup
policyVersion	string

PolicyParameters

Objeto

Parâmetros na política

Nome	Tipo	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: AdlsBlobBackupDatasourceParameters[] BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Obtém ou define os parâmetros da fonte de dados de backup
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Obtém ou define os parâmetros do DataStore

ProtectionStatusDetails

Objeto

Detalhes do status da proteção

Nome	Tipo	Description
errorDetails	UserFacingError	Especifica o erro de status de proteção do recurso
status	Status	Especifica o status de proteção do recurso

ResourcePropertiesObjectType

Enumeração

Tipo do objeto específico – usado para desserializar

Valor	Description
DefaultResourceProperties

SecretStoreBasedAuthCredentials

Objeto

Credenciais de autenticação baseadas em repositório secreto.

Nome	Tipo	Description
objectType	string: SecretStoreBasedAuthCredentials	Tipo do objeto específico – usado para desserializar
secretStoreResource	SecretStoreResource	Recurso do repositório de segredos

SecretStoreResource

Objeto

Classe que representa um recurso do repositório de segredos.

Nome	Tipo	Description
secretStoreType	SecretStoreType	Obtém ou define o tipo de repositório secreto
uri	string	Uri para acessar o recurso
value	string	Obtém ou define o valor armazenado no recurso do repositório de segredos

SecretStoreType

Enumeração

Obtém ou define o tipo de repositório secreto

Valor	Description
Invalid
AzureKeyVault

Status

Enumeração

Especifica o status de proteção do recurso

Valor	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

UserFacingError

Objeto

Objeto de erro usado por camadas que têm acesso ao conteúdo localizado e propagam isso para o usuário

Nome	Tipo	Description
code	string	Código exclusivo para este erro
details	UserFacingError[]	Erros adicionais relacionados
innerError	InnerError	Erro interno
isRetryable	boolean	Se a operação será repetível ou não
isUserError	boolean	Se a operação é devido a um erro de usuário ou erro de serviço
message	string
properties	object	Todos os pares de valores de chave que podem ser injetados dentro do objeto de erro
recommendedAction	string[]	RecommendedAction localizado.
target	string	Destino do erro.

ValidateForBackupRequest

Objeto

Validar para solicitação de backup

Nome	Tipo	Description
backupInstance	BackupInstance	Instância de Backup

ValidationType

Enumeração

Especifica o tipo de validação. No caso do DeepValidation, todas as validações da API /validateForBackup serão executadas novamente.

Valor	Description
ShallowValidation
DeepValidation

Compartilhar via

Backup Instances - Validate For Backup

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Validate For Backup

Solicitação de exemplo

Resposta de exemplo

Definições

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