Backup Instances Extension Routing - List

Szolgáltatás:: Data Protection

API-verzió:: 2025-07-01

Lekéri a nyomon követett erőforráshoz társított biztonsági mentési példányok listáját

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceId	path	True	string	A Microsoft.DataProtection használatával védeni kívánt erőforrás ARM-elérési útja
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Válaszok

Name	Típus	Description
200 OK	BackupInstanceResourceList	OKÉ
Other Status Codes	CloudError	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	megszemélyesíti a felhasználói fiókját.

Példák

List BackupInstances associated with an azure resource

Mintakérelem

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

Mintaválasz

Állapotkó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"
    }
  ]
}

Definíciók

Name	Description
AdlsBlobBackupDatasourceParameters	Az Azure Data Lake Storage-fiókblobok biztonsági mentésének konfigurálása során használandó paraméterek
AKSVolumeTypes	Lekéri vagy beállítja a belefoglalási kötettípusok tulajdonságot. Ez a tulajdonság beállítja a biztonsági mentés során figyelembe vehető kötettípusokat.
AzureOperationalStoreParameters	A Operational-Tier DataStore paraméterei
BackupInstance	Biztonsági mentési példány
BackupInstanceResource	BackupInstanceResource
BackupInstanceResourceList	BackupInstanceResourceList
BlobBackupDatasourceParameters	A blobok biztonsági mentésének konfigurálása során használandó paraméterek
CloudError	Felhőhiba
createdByType	Az erőforrást létrehozó identitás típusa.
CurrentProtectionState	Az erőforrás aktuális védelmi állapotát adja meg
Datasource	Adatforrás
DatasourceSet	Adatforrás készlet
DataStoreTypes	az adattár típusa; Operational/Vault/Archive
DefaultResourceProperties	Alapértelmezett forrástulajdonságok
Error	Az erőforrás-kezelési hibaválasz.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
IdentityDetails
InnerError	Belső hiba
KubernetesClusterBackupDatasourceParameters	A Kubernetes-fürt biztonsági mentési adatforrásának paraméterei
NamespacedNameResource	NamespacedNameResource
PolicyInfo	PolicyInfo
PolicyParameters	Paraméterek a Szabályzatban
ProtectionStatusDetails	Védelmi Állapot Részletei
SecretStoreBasedAuthCredentials	Titkos tár alapú hitelesítési hitelesítő adatok.
SecretStoreResource	Titkos tár erőforrását képviselő osztály.
SecretStoreType	Lekéri vagy beállítja a titkos tár típusát
Status	Az erőforrás védelmi állapotát adja meg
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
UserFacingError	A honosított tartalomhoz hozzáféréssel rendelkező rétegek által használt hibaobjektumok propagálása a felhasználó számára
ValidationType	Az ellenőrzés típusát adja meg. DeepValidation esetén a /validateForBackup API összes érvényesítése újra lefut.

AdlsBlobBackupDatasourceParameters

Objektum

Az Azure Data Lake Storage-fiókblobok biztonsági mentésének konfigurálása során használandó paraméterek

Name	Típus	Description
containersList	string[]	A blobok biztonsági mentésének konfigurálása során biztonsági másolatot készítendő tárolók listája
objectType	string: AdlsBlobBackupDatasourceParameters	Az adott objektum típusa – a deszerializáláshoz használatos

AKSVolumeTypes

Enumerálás

Lekéri vagy beállítja a belefoglalási kötettípusok tulajdonságot. Ez a tulajdonság beállítja a biztonsági mentés során figyelembe vehető kötettípusokat.

Érték	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Objektum

A Operational-Tier DataStore paraméterei

Name	Típus	Description
dataStoreType	DataStoreTypes	az adattár típusa; Operational/Vault/Archive
objectType	string: AzureOperationalStoreParameters	Az adott objektum típusa – a deszerializáláshoz használatos
resourceGroupId	string	Lekéri vagy beállítja a pillanatkép-erőforráscsoport URI-ját.

BackupInstance

Objektum

Biztonsági mentési példány

Name	Típus	Description
currentProtectionState	CurrentProtectionState	Az erőforrás aktuális védelmi állapotát adja meg
dataSourceInfo	Datasource	Adatforrás Lekéri vagy beállítja az adatforrás adatait.
dataSourceSetInfo	DatasourceSet	Adatforrás készlet Lekéri vagy beállítja az adatforráskészlet adatait.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Az adatforrás-szolgáltatóval való hitelesítéshez használandó hitelesítő adatok.
friendlyName	string	Lekéri vagy beállítja a Backup-példány rövid nevét.
identityDetails	IdentityDetails	A BI identitásadatainak adatait tartalmazza. Null érték esetén az alapértelmezett érték a rendszer által hozzárendelt rendszernek minősül.
objectType	string
policyInfo	PolicyInfo	PolicyInfo Lekéri vagy beállítja a szabályzat adatait.
protectionErrorDetails	UserFacingError	Megadja az erőforrás védelmi hibáját
protectionStatus	ProtectionStatusDetails	Védelmi Állapot Részletei Az erőforrás védelmi állapotát adja meg
provisioningState	string	Az erőforrás kiépítési állapotát adja meg, azaz kiépítés/frissítés/Sikeres/Sikertelen
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests, amelyen a LAC-ellenőrzés végrehajtása történik
validationType	ValidationType	Az ellenőrzés típusát adja meg. DeepValidation esetén a /validateForBackup API összes érvényesítése újra lefut.

BackupInstanceResource

Objektum

BackupInstanceResource

Name	Típus	Description
id	string	A proxyerőforrás-azonosító az erőforrás teljes elérési útját jelöli.
name	string	Az erőforráshoz társított proxyerőforrás neve.
properties	BackupInstance	BackupInstanceResource tulajdonságai
systemData	systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
tags	object	Proxyerőforrás-címkék.
type	string	A proxyerőforrás-típus a Névtér/ResourceType/ResourceType/... űrlap teljes elérési útját jelöli.

BackupInstanceResourceList

Objektum

BackupInstanceResourceList

Name	Típus	Description
nextLink	string	Az erőforrások következő oldalának lekérésére használt uri. A Call ListNext() lekéri az erőforrások következő oldalát.
value	BackupInstanceResource[]	Erőforrások listája.

BlobBackupDatasourceParameters

Objektum

A blobok biztonsági mentésének konfigurálása során használandó paraméterek

Name	Típus	Description
containersList	string[]	A blobok biztonsági mentésének konfigurálása során biztonsági másolatot készítendő tárolók listája
objectType	string: BlobBackupDatasourceParameters	Az adott objektum típusa – a deszerializáláshoz használatos

CloudError

Objektum

Felhőhiba

Name	Típus	Description
error	Error	Az erőforrás-kezelési hibaválasz.

createdByType

Enumerálás

Az erőforrást létrehozó identitás típusa.

Érték	Description
Application
Key
ManagedIdentity
User

CurrentProtectionState

Enumerálás

Az erőforrás aktuális védelmi állapotát adja meg

Érték	Description
BackupSchedulesSuspended
ConfiguringProtection
ConfiguringProtectionFailed
Invalid
NotProtected
ProtectionConfigured
ProtectionError
ProtectionStopped
RetentionSchedulesSuspended
SoftDeleted
SoftDeleting
UpdatingProtection

Datasource

Objektum

Adatforrás

Name	Típus	Description
datasourceType	string	Az erőforrás adatforrástípusa.
objectType	string	A megfelelő öröklődő típus inicializálásához használt adatforrás-objektum típusa
resourceID	string	Az erőforrás teljes ARM-azonosítója. Az Azure-erőforrások esetében ez ARM-azonosító. Nem Azure-erőforrások esetén ez lesz a Biztonsági mentési szolgáltatás által a Fabric/Vaulton keresztül létrehozott azonosító.
resourceLocation	string	Az adatforrás helye.
resourceName	string	Az erőforrás egyedi azonosítója a szülő kontextusában.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Az adatforrásra jellemző tulajdonságok
resourceType	string	Az adatforrás erőforrástípusa.
resourceUri	string	Az erőforrás URI-ja.

DatasourceSet

Objektum

Adatforrás készlet

Name	Típus	Description
datasourceType	string	Az erőforrás adatforrástípusa.
objectType	string	A megfelelő öröklődő típus inicializálásához használt adatforrás-objektum típusa
resourceID	string	Az erőforrás teljes ARM-azonosítója. Az Azure-erőforrások esetében ez ARM-azonosító. Nem Azure-erőforrások esetén ez lesz a Biztonsági mentési szolgáltatás által a Fabric/Vaulton keresztül létrehozott azonosító.
resourceLocation	string	Az adatforrás helye.
resourceName	string	Az erőforrás egyedi azonosítója a szülő kontextusában.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Az adatforráskészletre jellemző tulajdonságok
resourceType	string	Az adatforrás erőforrástípusa.
resourceUri	string	Az erőforrás URI-ja.

DataStoreTypes

Enumerálás

az adattár típusa; Operational/Vault/Archive

Érték	Description
ArchiveStore
OperationalStore
VaultStore

DefaultResourceProperties

Objektum

Alapértelmezett forrástulajdonságok

Name	Típus	Description
objectType	string: DefaultResourceProperties	Az adott objektum típusa – a deszerializáláshoz használatos

Error

Objektum

Az erőforrás-kezelési hibaválasz.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	Error[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

IdentityDetails

Objektum

Name	Típus	Description
useSystemAssignedIdentity	boolean	Megadja, hogy a bi-t rendszeridentitás védi-e.
userAssignedIdentityArmUrl	string	ARM URL-cím a felhasználó által hozzárendelt identitáshoz.

InnerError

Objektum

Belső hiba

Name	Típus	Description
additionalInfo	object	Bármely kulcsértékpár, amely további részletes információkért adható meg az ügyfélnek.
code	string	A hiba egyedi kódja
embeddedInnerError	InnerError	Belső hiba Gyermek belső hibája a beágyazás engedélyezéséhez.

KubernetesClusterBackupDatasourceParameters

Objektum

A Kubernetes-fürt biztonsági mentési adatforrásának paraméterei

Name	Típus	Description
backupHookReferences	NamespacedNameResource[]	Lekéri vagy beállítja a biztonsági mentési horog hivatkozásait. Ez a tulajdonság beállítja a biztonsági mentés során végrehajtandó horoghivatkozást.
excludedNamespaces	string[]	Lekéri vagy beállítja a névterek kizárási tulajdonságát. Ez a tulajdonság beállítja, hogy a névterek ne legyenek kizárva a biztonsági mentés során.
excludedResourceTypes	string[]	Lekéri vagy beállítja a kizárási erőforrástípusok tulajdonságot. Ez a tulajdonság a biztonsági mentés során kizárandó erőforrástípusokat állítja be.
includeClusterScopeResources	boolean	Lekéri vagy beállítja a belefoglalási fürterőforrás-tulajdonságot. Ha engedélyezve van, ez a tulajdonság a fürt hatókörének erőforrásait is tartalmazza a biztonsági mentés során.
includedNamespaces	string[]	Lekéri vagy beállítja a include namespaces tulajdonságot. Ez a tulajdonság beállítja a biztonsági mentés során belefoglalandó névtereket.
includedResourceTypes	string[]	Lekéri vagy beállítja a include resource types tulajdonságot. Ez a tulajdonság beállítja azokat az erőforrástípusokat, amelyek a biztonsági mentés során szerepelni fognak.
includedVolumeTypes	AKSVolumeTypes[]	Lekéri vagy beállítja a belefoglalási kötettípusok tulajdonságot. Ez a tulajdonság beállítja a biztonsági mentés során figyelembe vehető kötettípusokat.
labelSelectors	string[]	Lekéri vagy beállítja a LabelSelectors tulajdonságot. Ez a tulajdonság beállítja az erőforrást olyan címkeválasztókkal, hogy a biztonsági mentés során szerepeljenek.
objectType	string: KubernetesClusterBackupDatasourceParameters	Az adott objektum típusa – a deszerializáláshoz használatos
snapshotVolumes	boolean	Lekéri vagy beállítja a kötet pillanatkép tulajdonságát. Ez a tulajdonság, ha engedélyezve van, a biztonsági mentés során mennyiségi pillanatképeket készít.

NamespacedNameResource

Objektum

NamespacedNameResource

Name	Típus	Description
name	string	Az erőforrás neve
namespace	string	Névtér, amelyben az erőforrás létezik

PolicyInfo

Objektum

PolicyInfo

Name	Típus	Description
policyId	string
policyParameters	PolicyParameters	A biztonsági mentési példány házirendparaméterei
policyVersion	string

PolicyParameters

Objektum

Paraméterek a Szabályzatban

Name	Típus	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: AdlsBlobBackupDatasourceParameters[] BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Lekéri vagy beállítja a biztonsági mentési adatforrás paramétereit
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Lekéri vagy beállítja a DataStore-paramétereket

ProtectionStatusDetails

Objektum

Védelmi Állapot Részletei

Name	Típus	Description
errorDetails	UserFacingError	Megadja az erőforrás védelmi állapotának hibáját
status	Status	Az erőforrás védelmi állapotát adja meg

SecretStoreBasedAuthCredentials

Objektum

Titkos tár alapú hitelesítési hitelesítő adatok.

Name	Típus	Description
objectType	string: SecretStoreBasedAuthCredentials	Az adott objektum típusa – a deszerializáláshoz használatos
secretStoreResource	SecretStoreResource	Titkos tár erőforrása

SecretStoreResource

Objektum

Titkos tár erőforrását képviselő osztály.

Name	Típus	Description
secretStoreType	SecretStoreType	Lekéri vagy beállítja a titkos tár típusát
uri	string	Uri az erőforrás eléréséhez
value	string	Titkos tár erőforrásában tárolt érték lekérése vagy beállítása

SecretStoreType

Enumerálás

Lekéri vagy beállítja a titkos tár típusát

Érték	Description
AzureKeyVault
Invalid

Status

Enumerálás

Az erőforrás védelmi állapotát adja meg

Érték	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

systemData

Objektum

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

UserFacingError

Objektum

A honosított tartalomhoz hozzáféréssel rendelkező rétegek által használt hibaobjektumok propagálása a felhasználó számára

Name	Típus	Description
code	string	A hiba egyedi kódja
details	UserFacingError[]	További kapcsolódó hibák
innerError	InnerError	Belső hiba Belső hiba
isRetryable	boolean	A művelet újrapróbálkozható-e vagy sem
isUserError	boolean	Felhasználói hiba vagy szolgáltatáshiba miatt történt-e a művelet
message	string
properties	object	A hibaobjektumba injektálható kulcsértékpárok
recommendedAction	string[]	AjánlottAction honosított.
target	string	A hiba célja.

ValidationType

Enumerálás

Az ellenőrzés típusát adja meg. DeepValidation esetén a /validateForBackup API összes érvényesítése újra lefut.

Érték	Description
DeepValidation
ShallowValidation

Megosztás a következőn keresztül:

Backup Instances Extension Routing - List

URI-paraméterek

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

List BackupInstances associated with an azure resource

Mintakérelem

Mintaválasz

Definíciók

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