Backup Instances Extension Routing - List

Služba:: Data Protection

Verze rozhraní API:: 2025-07-01

Získá seznam instancí zálohování přidružených ke sledovanému prostředku.

GET https://management.azure.com/{resourceId}/providers/Microsoft.DataProtection/backupInstances?api-version=2025-07-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceId	path	True	string	Cesta ARM prostředku, který se má chránit pomocí Microsoft.DataProtection
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	BackupInstanceResourceList	OK
Other Status Codes	CloudError	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

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

Rozsahy

Name	Description
user_impersonation	zosobnit váš uživatelský účet.

Příklady

List BackupInstances associated with an azure resource

Ukázkový požadavek

HTTP

GET https://management.azure.com/subscriptions/36d32b25-3dc7-41b0-bde1-397500644591/resourceGroups/testRG/providers/Microsoft.Compute/disks/testDisk/providers/Microsoft.DataProtection/backupInstances?api-version=2025-07-01

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "properties": {
        "friendlyName": "testDisk",
        "dataSourceInfo": {
          "resourceID": "/subscriptions/36d32b25-3dc7-41b0-bde1-397500644591/resourceGroups/testRG/providers/Microsoft.Compute/disks/testDisk",
          "resourceUri": "/subscriptions/36d32b25-3dc7-41b0-bde1-397500644591/resourceGroups/testRG/providers/Microsoft.Compute/disks/testDisk",
          "datasourceType": "Microsoft.Compute/disks",
          "resourceName": "testDisk",
          "resourceType": "Microsoft.Compute/disks",
          "resourceLocation": "eastus2euap",
          "objectType": "Datasource"
        },
        "dataSourceSetInfo": {
          "resourceID": "/subscriptions/36d32b25-3dc7-41b0-bde1-397500644591/resourceGroups/testRG/providers/Microsoft.Compute/disks/testDisk",
          "resourceUri": "/subscriptions/36d32b25-3dc7-41b0-bde1-397500644591/resourceGroups/testRG/providers/Microsoft.Compute/disks/testDisk",
          "datasourceType": "Microsoft.Compute/disks",
          "resourceName": "testDisk",
          "resourceType": "Microsoft.Compute/disks",
          "resourceLocation": "eastus2euap",
          "objectType": "DatasourceSet"
        },
        "policyInfo": {
          "policyId": "/subscriptions/36d32b25-3dc7-41b0-bde1-397500644591/resourceGroups/policyRG/providers/Microsoft.DataProtection/backupVaults/jeczrsecy/backupPolicies/disk",
          "policyVersion": "",
          "policyParameters": {
            "dataStoreParametersList": [
              {
                "objectType": "AzureOperationalStoreParameters",
                "dataStoreType": "OperationalStore",
                "resourceGroupId": "/subscriptions/36d32b25-3dc7-41b0-bde1-397500644591/resourceGroups/policyRG"
              }
            ]
          }
        },
        "protectionStatus": {
          "status": "ProtectionConfigured"
        },
        "currentProtectionState": "ProtectionConfigured",
        "provisioningState": "Succeeded",
        "objectType": "BackupInstance"
      },
      "id": "/subscriptions/36d32b25-3dc7-41b0-bde1-397500644591/resourceGroups/testRG/providers/Microsoft.Compute/disks/testDisk/providers/Microsoft.DataProtection/backupInstances/testDiskBI1-testDiskBI1-7664c12f-4d0a-440f-a0dc-b64f708b10e3",
      "name": "testDiskBI1-testDiskBI1-7664c12f-4d0a-440f-a0dc-b64f708b10e3",
      "type": "Microsoft.DataProtection/backupVaults/backupInstances"
    }
  ]
}

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	Získá nebo nastaví zahrnout typ svazku vlastnost. Tato vlastnost nastaví typy svazků, které mají být zahrnuty během zálohování.
AzureOperationalStoreParameters	Parametry úložiště dat Operational-Tier
BackupInstance	Instance zálohování
BackupInstanceResource	Zdroj záložní_instance
BackupInstanceResourceList	Seznam zdrojů zálohovací instance
BlobBackupDatasourceParameters	Parametry, které se mají použít při konfiguraci zálohování objektů blob
CloudError	Chyba mraku
createdByType	Typ identity, která prostředek vytvořila.
CurrentProtectionState	Určuje aktuální stav ochrany prostředku.
Datasource	Zdroj dat
DatasourceSet	Sada zdrojů dat
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	Jmenný prostor Zdroj
PolicyInfo	PolicyInfo
PolicyParameters	Parametry v zásadách
ProtectionStatusDetails	DetailyStavuOchrany
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.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
UserFacingError	Objekt chyby používaný vrstvami, které mají přístup k lokalizovaného obsahu, a rozšířit ho na uživatele
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

Získá nebo nastaví zahrnout typ svazku vlastnost. Tato vlastnost nastaví typy svazků, které mají být zahrnuty během zálohování.

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	Zdroj dat Získá nebo nastaví informace o zdroji dat.
dataSourceSetInfo	DatasourceSet	Sada zdrojů dat 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	PolicyInfo Získá nebo nastaví informace o zásadách.
protectionErrorDetails	UserFacingError	Určuje chybu ochrany prostředku.
protectionStatus	ProtectionStatusDetails	DetailyStavuOchrany 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.

BackupInstanceResource

Objekt

Zdroj záložní_instance

Name	Typ	Description
id	string	ID prostředku proxy představuje úplnou cestu k prostředku.
name	string	Název prostředku proxy serveru přidružený k prostředku
properties	BackupInstance	Vlastnosti BackupInstanceResource
systemData	systemData	Metadata týkající se vytvoření a poslední změny prostředku.
tags	object	Značky prostředků proxy serveru.
type	string	Typ prostředku proxy představuje úplnou cestu k oboru názvů,ResourceType/ResourceType/...

BackupInstanceResourceList

Objekt

Seznam zdrojů zálohovací instance

Name	Typ	Description
nextLink	string	Identifikátor URI, který načte další stránku prostředků. Volání ListNext() načte další stránku prostředků.
value	BackupInstanceResource[]	Seznam prostředků

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

Chyba mraku

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

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
Application
Key
ManagedIdentity
User

CurrentProtectionState

Výčet

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

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

Datasource

Objekt

Zdroj dat

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

Sada zdrojů dat

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

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	Vnitřní chyba 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

Jmenný prostor Zdroj

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

PolicyInfo

Objekt

PolicyInfo

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

DetailyStavuOchrany

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

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

Status

Výčet

Určuje stav ochrany prostředku.

Hodnota	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

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

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

Sdílet prostřednictvím

Backup Instances Extension Routing - List

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

List BackupInstances associated with an azure resource

Ukázkový požadavek

Ukázková odpověď

Definice

AdlsBlobBackupDatasourceParameters

AKSVolumeTypes

AzureOperationalStoreParameters

BackupInstance

BackupInstanceResource

BackupInstanceResourceList

BlobBackupDatasourceParameters

CloudError

createdByType

CurrentProtectionState

Datasource

DatasourceSet

DataStoreTypes

DefaultResourceProperties

Error

ErrorAdditionalInfo

IdentityDetails

InnerError

KubernetesClusterBackupDatasourceParameters

NamespacedNameResource

PolicyInfo

PolicyParameters

ProtectionStatusDetails

SecretStoreBasedAuthCredentials

SecretStoreResource

SecretStoreType

Status

systemData

UserFacingError

ValidationType