Backup Instances - Validate For Backup

Služba:: Data Protection

Verze rozhraní API:: 2025-09-01

Ověřte, jestli bude adhoc zálohování úspěšné nebo ne.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
vaultName	path	True	string	Název zdroje BackupVault
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
backupInstance	True	BackupInstance	Instance zálohování

Odpovědi

Name	Typ	Description
200 OK	OperationJobExtendedInfo	Operace Azure byla úspěšně dokončena.
202 Accepted		Operace prostředku byla přijata. Hlavičky Azure-AsyncOperation: string Location: string
Other Status Codes	CloudError	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

OperationJobExtendedInfo

Operace Azure byla úspěšně dokončena.

202 Accepted

Operace prostředku byla přijata.

Hlavičky

Azure-AsyncOperation: string
Location: string

Other Status Codes

CloudError

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Validate For Backup

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 200

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

Stavový kód:: 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

Definice

Name	Description
AdlsBlobBackupDatasourceParameters	Parametry, které se mají použít při konfiguraci zálohování objektů blob účtu úložiště Azure Data Lake
AKSVolumeTypes
AzureOperationalStoreParameters	Parametry úložiště dat Operational-Tier
BackupInstance	Instance zálohování
BlobBackupDatasourceParameters	Parametry, které se mají použít při konfiguraci zálohování objektů blob
CloudError	Odpověď na chybu ze služby Azure Backup
CurrentProtectionState	Určuje aktuální stav ochrany prostředku.
Datasource	Zdroj dat, který se má zálohovat
DatasourceSet	Podrobnosti sady dat o zdroji dat, které se mají zálohovat
DataStoreTypes	typ úložiště dat; Provozní/ Trezor / Archiv
DefaultResourceProperties	Výchozí vlastnosti zdroje
Error	Odpověď na chybu správy prostředků.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
IdentityDetails
InnerError	Vnitřní chyba
KubernetesClusterBackupDatasourceParameters	Parametry pro zdroj dat zálohování clusteru Kubernetes
NamespacedNameResource	Třída odkazující prostředky, které obsahují obor názvů a název
OperationJobExtendedInfo	Rozšířené informace o úloze operace
PolicyInfo	Informace o zásadách ve službě backupInstance
PolicyParameters	Parametry v zásadách
ProtectionStatusDetails	Podrobnosti o stavu ochrany
ResourcePropertiesObjectType	Typ konkrétního objektu – slouží k deserializaci
SecretStoreBasedAuthCredentials	Přihlašovací údaje pro ověřování založené na úložišti tajných kódů.
SecretStoreResource	Třída představující prostředek úložiště tajných kódů
SecretStoreType	Získá nebo nastaví typ úložiště tajných kódů.
Status	Určuje stav ochrany prostředku.
UserFacingError	Objekt chyby používaný vrstvami, které mají přístup k lokalizovaného obsahu, a rozšířit ho na uživatele
ValidateForBackupRequest	Ověření žádosti o zálohování
ValidationType	Určuje typ ověření. V případě DeepValidation se všechna ověření z rozhraní /validateForBackup API spustí znovu.

AdlsBlobBackupDatasourceParameters

Objekt

Parametry, které se mají použít při konfiguraci zálohování objektů blob účtu úložiště Azure Data Lake

Name	Typ	Description
containersList	string[]	Seznam kontejnerů, které se mají zálohovat během konfigurace zálohování objektů blob
objectType	string: AdlsBlobBackupDatasourceParameters	Typ konkrétního objektu – slouží k deserializaci

AKSVolumeTypes

Výčet

Hodnota	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Objekt

Parametry úložiště dat Operational-Tier

Name	Typ	Description
dataStoreType	DataStoreTypes	typ úložiště dat; Provozní/ Trezor / Archiv
objectType	string: AzureOperationalStoreParameters	Typ konkrétního objektu – slouží k deserializaci
resourceGroupId	string	Získá nebo nastaví identifikátor URI skupiny prostředků snímku.

BackupInstance

Objekt

Instance zálohování

Name	Typ	Description
currentProtectionState	CurrentProtectionState	Určuje aktuální stav ochrany prostředku.
dataSourceInfo	Datasource	Získá nebo nastaví informace o zdroji dat.
dataSourceSetInfo	DatasourceSet	Získá nebo nastaví informace o sadě zdrojů dat.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Přihlašovací údaje, které se mají použít k ověření u poskytovatele zdroje dat.
friendlyName	string	Získá nebo nastaví popisný název instance zálohování.
identityDetails	IdentityDetails	Obsahuje informace opodrobnostch Pokud má hodnotu null, bude výchozí hodnota považována za přiřazenou systémem.
objectType	string
policyInfo	PolicyInfo	Získá nebo nastaví informace o zásadách.
protectionErrorDetails	UserFacingError	Určuje chybu ochrany prostředku.
protectionStatus	ProtectionStatusDetails	Určuje stav ochrany prostředku.
provisioningState	string	Určuje stav zřizování prostředku, tj. zřizování, aktualizace, úspěch nebo selhání.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests, na které se provede kontrola LAC
validationType	ValidationType	Určuje typ ověření. V případě DeepValidation se všechna ověření z rozhraní /validateForBackup API spustí znovu.

BlobBackupDatasourceParameters

Objekt

Parametry, které se mají použít při konfiguraci zálohování objektů blob

Name	Typ	Description
containersList	string[]	Seznam kontejnerů, které se mají zálohovat během konfigurace zálohování objektů blob
objectType	string: BlobBackupDatasourceParameters	Typ konkrétního objektu – slouží k deserializaci

CloudError

Objekt

Odpověď na chybu ze služby Azure Backup

Name	Typ	Description
error	Error	Odpověď na chybu správy prostředků.

CurrentProtectionState

Výčet

Určuje aktuální stav ochrany prostředku.

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

Datasource

Objekt

Zdroj dat, který se má zálohovat

Name	Typ	Description
datasourceType	string	DatasourceType prostředku.
objectType	string	Typ objektu Datasource, který se používá k inicializaci zděděného typu vpravo
resourceID	string	Úplné ID ARM prostředku U prostředků Azure se jedná o ID ARM. V případě jiných prostředků než Azure to bude ID vytvořené službou backup prostřednictvím prostředků Fabric/Vault.
resourceLocation	string	Umístění zdroje dat
resourceName	string	Jedinečný identifikátor prostředku v kontextu nadřazeného objektu.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Vlastnosti specifické pro zdroj dat
resourceType	string	Typ zdroje dat
resourceUri	string	Identifikátor URI prostředku.

DatasourceSet

Objekt

Podrobnosti sady dat o zdroji dat, které se mají zálohovat

Name	Typ	Description
datasourceType	string	DatasourceType prostředku.
objectType	string	Typ objektu Datasource, který se používá k inicializaci zděděného typu vpravo
resourceID	string	Úplné ID ARM prostředku U prostředků Azure se jedná o ID ARM. V případě jiných prostředků než Azure to bude ID vytvořené službou backup prostřednictvím prostředků Fabric/Vault.
resourceLocation	string	Umístění zdroje dat
resourceName	string	Jedinečný identifikátor prostředku v kontextu nadřazeného objektu.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Vlastnosti specifické pro sadu zdrojů dat
resourceType	string	Typ zdroje dat
resourceUri	string	Identifikátor URI prostředku.

DataStoreTypes

Výčet

typ úložiště dat; Provozní/ Trezor / Archiv

Hodnota	Description
OperationalStore
VaultStore
ArchiveStore

DefaultResourceProperties

Objekt

Výchozí vlastnosti zdroje

Name	Typ	Description
objectType	string: DefaultResourceProperties	Typ konkrétního objektu – slouží k deserializaci

Error

Objekt

Odpověď na chybu správy prostředků.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	Error[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

IdentityDetails

Objekt

Name	Typ	Description
useSystemAssignedIdentity	boolean	Určuje, jestli je BI chráněná identitou systému.
userAssignedIdentityArmUrl	string	Adresa URL ARM pro identitu přiřazenou uživatelem

InnerError

Objekt

Vnitřní chyba

Name	Typ	Description
additionalInfo	object	Všechny páry klíčových hodnot, které lze klientovi poskytnout pro další podrobné informace.
code	string	Jedinečný kód pro tuto chybu
embeddedInnerError	InnerError	Podřízená vnitřní chyba, která umožňuje vnoření.

KubernetesClusterBackupDatasourceParameters

Objekt

Parametry pro zdroj dat zálohování clusteru Kubernetes

Name	Typ	Description
backupHookReferences	NamespacedNameResource[]	Získá nebo nastaví odkazy na zálohovací háky. Tato vlastnost nastaví odkaz na háku, který se má spustit během zálohování.
excludedNamespaces	string[]	Získá nebo nastaví vyloučit obory názvů vlastnost. Tato vlastnost nastaví obory názvů, které mají být vyloučeny během zálohování.
excludedResourceTypes	string[]	Získá nebo nastaví vlastnost vyloučit typy prostředků. Tato vlastnost nastaví typy prostředků, které mají být vyloučeny během zálohování.
includeClusterScopeResources	boolean	Získá nebo nastaví vlastnost zahrnout prostředky clusteru. Pokud je tato vlastnost povolená, bude během zálohování zahrnovat prostředky oboru clusteru.
includedNamespaces	string[]	Získá nebo nastaví include obory názvů vlastnost. Tato vlastnost nastaví obory názvů, které mají být zahrnuty během zálohování.
includedResourceTypes	string[]	Získá nebo nastaví zahrnout typ prostředku vlastnost. Tato vlastnost nastaví typy prostředků, které se mají zahrnout během zálohování.
includedVolumeTypes	AKSVolumeTypes[]	Získá nebo nastaví zahrnout typ svazku vlastnost. Tato vlastnost nastaví typy svazků, které mají být zahrnuty během zálohování.
labelSelectors	string[]	Získá nebo nastaví LabelSelectors vlastnost. Tato vlastnost nastaví prostředek s těmito selektory popisků, které se mají zahrnout během zálohování.
objectType	string: KubernetesClusterBackupDatasourceParameters	Typ konkrétního objektu – slouží k deserializaci
snapshotVolumes	boolean	Získá nebo nastaví vlastnost snímku svazku. Pokud je tato vlastnost povolená, pořídí snímky svazků během zálohování.

NamespacedNameResource

Objekt

Třída odkazující prostředky, které obsahují obor názvů a název

Name	Typ	Description
name	string	Název prostředku
namespace	string	Obor názvů, ve kterém prostředek existuje

OperationJobExtendedInfo

Objekt

Rozšířené informace o úloze operace

Name	Typ	Description
jobId	string	Název nebo ID arm úlohy vytvořené pro tuto operaci
objectType	string: OperationJobExtendedInfo	Tato vlastnost se použije jako diskriminátor pro rozhodování o konkrétních typech v polymorfním řetězci typů.

PolicyInfo

Objekt

Informace o zásadách ve službě backupInstance

Name	Typ	Description
policyId	string
policyParameters	PolicyParameters	Parametry zásad pro instanci zálohování
policyVersion	string

PolicyParameters

Objekt

Parametry v zásadách

Name	Typ	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: AdlsBlobBackupDatasourceParameters[] BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Získá nebo nastaví parametry záložního zdroje dat.
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Získá nebo nastaví parametry úložiště dat.

ProtectionStatusDetails

Objekt

Podrobnosti o stavu ochrany

Name	Typ	Description
errorDetails	UserFacingError	Určuje chybu stavu ochrany prostředku.
status	Status	Určuje stav ochrany prostředku.

ResourcePropertiesObjectType

Výčet

Typ konkrétního objektu – slouží k deserializaci

Hodnota	Description
DefaultResourceProperties

SecretStoreBasedAuthCredentials

Objekt

Přihlašovací údaje pro ověřování založené na úložišti tajných kódů.

Name	Typ	Description
objectType	string: SecretStoreBasedAuthCredentials	Typ konkrétního objektu – slouží k deserializaci
secretStoreResource	SecretStoreResource	Prostředek úložiště tajných kódů

SecretStoreResource

Objekt

Třída představující prostředek úložiště tajných kódů

Name	Typ	Description
secretStoreType	SecretStoreType	Získá nebo nastaví typ úložiště tajných kódů.
uri	string	Identifikátor URI pro přístup k prostředku
value	string	Získá nebo nastaví hodnotu uloženou v prostředku úložiště tajných kódů.

SecretStoreType

Výčet

Získá nebo nastaví typ úložiště tajných kódů.

Hodnota	Description
Invalid
AzureKeyVault

Status

Výčet

Určuje stav ochrany prostředku.

Hodnota	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

UserFacingError

Objekt

Objekt chyby používaný vrstvami, které mají přístup k lokalizovaného obsahu, a rozšířit ho na uživatele

Name	Typ	Description
code	string	Jedinečný kód pro tuto chybu
details	UserFacingError[]	Další související chyby
innerError	InnerError	Vnitřní chyba
isRetryable	boolean	Jestli bude operace opakovatelná, nebo ne
isUserError	boolean	Jestli je operace způsobená chybou uživatele nebo chybou služby
message	string
properties	object	Všechny páry klíč-hodnota, které je možné vloženého do objektu chyby
recommendedAction	string[]	Lokalizovaná doporučená akce.
target	string	Cíl chyby.

ValidateForBackupRequest

Objekt

Ověření žádosti o zálohování

Name	Typ	Description
backupInstance	BackupInstance	Instance zálohování

ValidationType

Výčet

Určuje typ ověření. V případě DeepValidation se všechna ověření z rozhraní /validateForBackup API spustí znovu.

Hodnota	Description
ShallowValidation
DeepValidation

Sdílet prostřednictvím

Backup Instances - Validate For Backup

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Validate For Backup

Ukázkový požadavek

Ukázková odpověď

Definice

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