Share via


Protectable Containers - List

Lists the containers that can be registered to Recovery Services Vault.

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

URI Parameters

Name In Required Type Description
fabricName
path True

string

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.

Responses

Name Type Description
200 OK

ProtectableContainerResourceList

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 AzureStorage

Sample request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRg/providers/Microsoft.RecoveryServices/vaults/testvault/backupFabrics/Azure/protectableContainers?api-version=2025-08-01&$filter=backupManagementType eq 'AzureStorage' and workloadType eq 'AzureFileShare'

Sample response

{
  "value": [
    {
      "name": "StorageContainer;storage;test-rg;testst",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectableContainers",
      "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.RecoveryServices/vaults/testvault/backupFabrics/Azure/protectableContainers/StorageContainer;storage;test-rg;teststorage",
      "properties": {
        "backupManagementType": "AzureStorage",
        "containerId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Storage/storageAccounts/teststorage",
        "friendlyName": "teststorage",
        "healthStatus": "Healthy",
        "protectableContainerType": "StorageContainer"
      }
    },
    {
      "name": "StorageContainer;ClassicStorage;test-rg;teststorage",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectableContainers",
      "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.RecoveryServices/vaults/testvault/backupFabrics/Azure/protectableContainers/StorageContainer;ClassicStorage;test-rg;teststorage",
      "properties": {
        "backupManagementType": "AzureStorage",
        "containerId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.ClassicStorage/storageAccounts/teststorage",
        "friendlyName": "teststorage",
        "healthStatus": "Healthy",
        "protectableContainerType": "StorageContainer"
      }
    }
  ]
}

Definitions

Name Description
AzureStorageProtectableContainer

Azure Storage-specific protectable containers

AzureVMAppContainerProtectableContainer

Azure workload-specific container

BackupManagementType

Backup management type to execute the current job.

createdByType

The type of identity that created the resource.

ErrorDetail

Error Detail class which encapsulates Code, Message and Recommendations.

ErrorResponse

Error response

ProtectableContainerResource

Protectable Container Class.

ProtectableContainerResourceList

List of ProtectableContainer resources

ProtectableContainerType

Type of the container. The value of this property for

  1. Compute Azure VM is Microsoft.Compute/virtualMachines
  2. Classic Compute Azure VM is Microsoft.ClassicCompute/virtualMachines
systemData

Metadata pertaining to creation and last modification of the resource.

AzureStorageProtectableContainer

Azure Storage-specific protectable containers

Name Type Description
backupManagementType

BackupManagementType

Type of backup management for the container.

containerId

string

Fabric Id of the container such as ARM Id.

friendlyName

string

Friendly name of the container.

healthStatus

string

Status of health of the container.

protectableContainerType string:

StorageContainer

Type of the container. The value of this property for

  1. Compute Azure VM is Microsoft.Compute/virtualMachines
  2. Classic Compute Azure VM is Microsoft.ClassicCompute/virtualMachines

AzureVMAppContainerProtectableContainer

Azure workload-specific container

Name Type Description
backupManagementType

BackupManagementType

Type of backup management for the container.

containerId

string

Fabric Id of the container such as ARM Id.

friendlyName

string

Friendly name of the container.

healthStatus

string

Status of health of the container.

protectableContainerType string:

VMAppContainer

Type of the container. The value of this property for

  1. Compute Azure VM is Microsoft.Compute/virtualMachines
  2. Classic Compute Azure VM is Microsoft.ClassicCompute/virtualMachines

BackupManagementType

Backup management type to execute the current job.

Value Description
Invalid
AzureIaasVM
MAB
DPM
AzureBackupServer
AzureSql
AzureStorage
AzureWorkload
DefaultBackup

createdByType

The type of identity that created the resource.

Value Description
User
Application
ManagedIdentity
Key

ErrorDetail

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

Error response

Name Type Description
error

ErrorDetail

The error object.

ProtectableContainerResource

Protectable Container 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 ProtectableContainer:

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

ProtectableContainerResourceList

List of ProtectableContainer 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

ProtectableContainerResource[]

List of resources.

ProtectableContainerType

Type of the container. The value of this property for

  1. Compute Azure VM is Microsoft.Compute/virtualMachines
  2. Classic Compute Azure VM is Microsoft.ClassicCompute/virtualMachines
Value Description
Invalid
Unknown
IaasVMContainer
IaasVMServiceContainer
DPMContainer
AzureBackupServerContainer
MABContainer
Cluster
AzureSqlContainer
Windows
VCenter
VMAppContainer
SQLAGWorkLoadContainer
StorageContainer
GenericContainer
Microsoft.ClassicCompute/virtualMachines
Microsoft.Compute/virtualMachines
AzureWorkloadContainer

systemData

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.