Backup Protectable Items - List

Service:: Recovery Services - Backup

API Version:: 2025-08-01

Provides a pageable list of protectable objects within your subscription according to the query filter and the pagination parameters.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupProtectableItems?api-version=2025-08-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupProtectableItems?api-version=2025-08-01&$filter={$filter}&$skipToken={$skipToken}

URI Parameters

Name	In	Required	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	The name of the resource group. The name is case insensitive.
subscriptionId	path	True	string minLength: 1	The ID of the target subscription.
vaultName	path	True	string	The name of the recovery services vault.
api-version	query	True	string minLength: 1	The API version to use for this operation.
$filter	query		string	OData filter options.
$skipToken	query		string	skipToken Filter.

Responses

Name	Type	Description
200 OK	WorkloadProtectableItemResourceList	Azure operation completed successfully.
Other Status Codes	ErrorResponse	An unexpected error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

List protectable items with backupManagementType filter as AzureIaasVm

Sample request

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupProtectableItems?api-version=2025-08-01&$filter=backupManagementType eq 'AzureIaasVM'

Sample response

Status code:: 200

{
  "value": [
    {
      "name": "VM;iaasvmcontainer;iaasvm-rg;iaasvm-1",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectableItems",
      "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/protectionContainers/IaasVMContainer;iaasvmcontainer;iaasvm-rg;iaasvm-1/protectableItems/VM;iaasvmcontainer;iaasvm-rg;iaasvm-1",
      "properties": {
        "backupManagementType": "AzureIaasVM",
        "friendlyName": "iaasvm-1",
        "protectableItemType": "Microsoft.ClassicCompute/virtualMachines",
        "protectionState": "NotProtected",
        "virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/providers/Microsoft.ClassicCompute/virtualMachines/iaasvm-1",
        "workloadType": "VM"
      }
    }
  ]
}

Definitions

Name	Description
AzureFileShareProtectableItem	Protectable item for Azure Fileshare workloads.
AzureFileShareType	File Share type XSync or XSMB.
AzureIaaSClassicComputeVMProtectableItem	IaaS VM workload-specific backup item representing the Classic Compute VM.
AzureIaaSComputeVMProtectableItem	IaaS VM workload-specific backup item representing the Azure Resource Manager VM.
AzureVmWorkloadProtectableItem	Azure VM workload-specific protectable item.
AzureVmWorkloadSAPAseDatabaseProtectableItem	Azure VM workload-specific protectable item representing SAP ASE Database.
AzureVmWorkloadSAPAseSystemProtectableItem	Azure VM workload-specific protectable item representing SAP ASE System.
AzureVmWorkloadSAPHanaDatabaseProtectableItem	Azure VM workload-specific protectable item representing SAP HANA Database.
AzureVmWorkloadSAPHanaDBInstance	Azure VM workload-specific protectable item representing SAP HANA Dbinstance.
AzureVmWorkloadSAPHanaHSRProtectableItem	Azure VM workload-specific protectable item representing HANA HSR.
AzureVmWorkloadSAPHanaSystemProtectableItem	Azure VM workload-specific protectable item representing SAP HANA System.
AzureVmWorkloadSQLAvailabilityGroupProtectableItem	Azure VM workload-specific protectable item representing SQL Availability Group.
AzureVmWorkloadSQLDatabaseProtectableItem	Azure VM workload-specific protectable item representing SQL Database.
AzureVmWorkloadSQLInstanceProtectableItem	Azure VM workload-specific protectable item representing SQL Instance.
createdByType	The type of identity that created the resource.
DistributedNodesInfo	This is used to represent the various nodes of the distributed container.
ErrorDetail	Error Detail class which encapsulates Code, Message and Recommendations.
ErrorResponse	Error response
IaaSVMProtectableItem	IaaS VM workload-specific backup item.
InquiryStatus	Status of protectable item, i.e. InProgress,Succeeded,Failed
PreBackupValidation	Pre-backup validation for Azure VM Workload provider.
ProtectionStatus	Specifies whether the container is registered or not
systemData	Metadata pertaining to creation and last modification of the resource.
WorkloadProtectableItemResource	Base class for backup item. Workload-specific backup items are derived from this class.
WorkloadProtectableItemResourceList	List of WorkloadProtectableItem resources

AzureFileShareProtectableItem

Object

Protectable item for Azure Fileshare workloads.

Name	Type	Description
azureFileShareType	AzureFileShareType	File Share type XSync or XSMB.
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
parentContainerFabricId	string	Full Fabric ID of container to which this protectable item belongs. For example, ARM ID.
parentContainerFriendlyName	string	Friendly name of container to which this protectable item belongs.
protectableItemType	string: AzureFileShare	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
workloadType	string	Type of workload for the backup management

AzureFileShareType

Enumeration

File Share type XSync or XSMB.

Value	Description
Invalid
XSMB
XSync

AzureIaaSClassicComputeVMProtectableItem

Object

IaaS VM workload-specific backup item representing the Classic Compute VM.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
protectableItemType	string: Microsoft.ClassicCompute/virtualMachines	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
resourceGroup	string	Resource group name of Recovery Services Vault.
virtualMachineId	string	Fully qualified ARM ID of the virtual machine.
virtualMachineVersion	string	Specifies whether the container represents a Classic or an Azure Resource Manager VM.
workloadType	string	Type of workload for the backup management

AzureIaaSComputeVMProtectableItem

Object

IaaS VM workload-specific backup item representing the Azure Resource Manager VM.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
protectableItemType	string: Microsoft.Compute/virtualMachines	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
resourceGroup	string	Resource group name of Recovery Services Vault.
virtualMachineId	string	Fully qualified ARM ID of the virtual machine.
virtualMachineVersion	string	Specifies whether the container represents a Classic or an Azure Resource Manager VM.
workloadType	string	Type of workload for the backup management

AzureVmWorkloadProtectableItem

Object

Azure VM workload-specific protectable item.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: AzureVmWorkloadProtectableItem	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

AzureVmWorkloadSAPAseDatabaseProtectableItem

Object

Azure VM workload-specific protectable item representing SAP ASE Database.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: SAPAseDatabase	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

AzureVmWorkloadSAPAseSystemProtectableItem

Object

Azure VM workload-specific protectable item representing SAP ASE System.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: SAPAseSystem	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

AzureVmWorkloadSAPHanaDatabaseProtectableItem

Object

Azure VM workload-specific protectable item representing SAP HANA Database.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: SAPHanaDatabase	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

AzureVmWorkloadSAPHanaDBInstance

Object

Azure VM workload-specific protectable item representing SAP HANA Dbinstance.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: SAPHanaDBInstance	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

AzureVmWorkloadSAPHanaHSRProtectableItem

Object

Azure VM workload-specific protectable item representing HANA HSR.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: HanaHSRContainer	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

AzureVmWorkloadSAPHanaSystemProtectableItem

Object

Azure VM workload-specific protectable item representing SAP HANA System.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: SAPHanaSystem	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

AzureVmWorkloadSQLAvailabilityGroupProtectableItem

Object

Azure VM workload-specific protectable item representing SQL Availability Group.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
nodesList	DistributedNodesInfo[]	List of the nodes in case of distributed container.
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: SQLAvailabilityGroupContainer	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

AzureVmWorkloadSQLDatabaseProtectableItem

Object

Azure VM workload-specific protectable item representing SQL Database.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: SQLDataBase	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

AzureVmWorkloadSQLInstanceProtectableItem

Object

Azure VM workload-specific protectable item representing SQL Instance.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
isAutoProtectable	boolean	Indicates if protectable item is auto-protectable
isAutoProtected	boolean	Indicates if protectable item is auto-protected
isProtectable	boolean	Indicates if item is protectable
parentName	string	Name for instance or AG
parentUniqueName	string	Parent Unique Name is added to provide the service formatted URI Name of the Parent Only Applicable for data bases where the parent would be either Instance or a SQL AG.
prebackupvalidation	PreBackupValidation	Pre-backup validation for protectable objects
protectableItemType	string: SQLInstance	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
serverName	string	Host/Cluster Name for instance or AG
subinquireditemcount	integer (int32)	For instance or AG, indicates number of DB's present
subprotectableitemcount	integer (int32)	For instance or AG, indicates number of DB's to be protected
workloadType	string	Type of workload for the backup management

createdByType

Enumeration

The type of identity that created the resource.

Value	Description
User
Application
ManagedIdentity
Key

DistributedNodesInfo

Object

This is used to represent the various nodes of the distributed container.

Name	Type	Description
errorDetail	ErrorDetail	Error Details if the Status is non-success.
nodeName	string	Name of the node under a distributed container.
sourceResourceId	string	ARM resource id of the node
status	string	Status of this Node. Failed \| Succeeded

ErrorDetail

Object

Error Detail class which encapsulates Code, Message and Recommendations.

Name	Type	Description
code	string	Error code.
message	string	Error Message related to the Code.
recommendations	string[]	List of recommendation strings.

ErrorResponse

Object

Error response

Name	Type	Description
error	ErrorDetail	The error object.

IaaSVMProtectableItem

Object

IaaS VM workload-specific backup item.

Name	Type	Description
backupManagementType	string	Type of backup management to backup an item.
friendlyName	string	Friendly name of the backup item.
protectableItemType	string: IaaSVMProtectableItem	Type of the backup item.
protectionState	ProtectionStatus	State of the back up item.
resourceGroup	string	Resource group name of Recovery Services Vault.
virtualMachineId	string	Fully qualified ARM ID of the virtual machine.
virtualMachineVersion	string	Specifies whether the container represents a Classic or an Azure Resource Manager VM.
workloadType	string	Type of workload for the backup management

InquiryStatus

Enumeration

Status of protectable item, i.e. InProgress,Succeeded,Failed

Value	Description
Invalid
Success
Failed

PreBackupValidation

Object

Pre-backup validation for Azure VM Workload provider.

Name	Type	Description
code	string	Error code of protectable item
message	string	Message corresponding to the error code for the protectable item
status	InquiryStatus	Status of protectable item, i.e. InProgress,Succeeded,Failed

ProtectionStatus

Enumeration

Specifies whether the container is registered or not

Value	Description
Invalid
NotProtected
Protecting
Protected
ProtectionFailed

systemData

Object

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string (date-time)	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string (date-time)	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

WorkloadProtectableItemResource

Object

Base class for backup item. Workload-specific backup items are derived from this class.

Name	Type	Description
eTag	string	Optional ETag.
id	string	Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Resource location.
name	string	The name of the resource
properties	WorkloadProtectableItem: AzureFileShareProtectableItem AzureIaaSClassicComputeVMProtectableItem AzureIaaSComputeVMProtectableItem AzureVmWorkloadProtectableItem AzureVmWorkloadSAPAseDatabaseProtectableItem AzureVmWorkloadSAPAseSystemProtectableItem AzureVmWorkloadSAPHanaDBInstance AzureVmWorkloadSAPHanaDatabaseProtectableItem AzureVmWorkloadSAPHanaHSRProtectableItem AzureVmWorkloadSAPHanaSystemProtectableItem AzureVmWorkloadSQLAvailabilityGroupProtectableItem AzureVmWorkloadSQLDatabaseProtectableItem AzureVmWorkloadSQLInstanceProtectableItem IaaSVMProtectableItem	WorkloadProtectableItemResource properties
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
tags	object	Resource tags.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

WorkloadProtectableItemResourceList

Object

List of WorkloadProtectableItem resources

Name	Type	Description
nextLink	string	The URI to fetch the next page of resources, with each API call returning up to 200 resources per page. Use ListNext() to fetch the next page if the total number of resources exceeds 200.
value	WorkloadProtectableItemResource[]	List of resources.

Share via

Backup Protectable Items - List

URI Parameters

Responses

Security

azure_auth

Scopes

Examples

List protectable items with backupManagementType filter as AzureIaasVm

Sample request

Sample response

Definitions

AzureFileShareProtectableItem

AzureFileShareType

AzureIaaSClassicComputeVMProtectableItem

AzureIaaSComputeVMProtectableItem

AzureVmWorkloadProtectableItem

AzureVmWorkloadSAPAseDatabaseProtectableItem

AzureVmWorkloadSAPAseSystemProtectableItem

AzureVmWorkloadSAPHanaDatabaseProtectableItem

AzureVmWorkloadSAPHanaDBInstance

AzureVmWorkloadSAPHanaHSRProtectableItem

AzureVmWorkloadSAPHanaSystemProtectableItem

AzureVmWorkloadSQLAvailabilityGroupProtectableItem

AzureVmWorkloadSQLDatabaseProtectableItem

AzureVmWorkloadSQLInstanceProtectableItem

createdByType

DistributedNodesInfo

ErrorDetail

ErrorResponse

IaaSVMProtectableItem

InquiryStatus

PreBackupValidation

ProtectionStatus

systemData

WorkloadProtectableItemResource

WorkloadProtectableItemResourceList