Protected Items - Create Or Update

Service:

Recovery Services - Backup

API Version:

2024-04-01

Enables backup of an item or to modifies the backup policy information of an already backed up item. This is an asynchronous operation. To know the status of the operation, call the GetItemOperationResult API.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2024-04-01

URI Parameters

Name	In	Required	Type	Description
containerName	path	True	string	Container name associated with the backup item.
fabricName	path	True	string	Fabric name associated with the backup item.
protectedItemName	path	True	string	Item name to be backed up.
resourceGroupName	path	True	string	The name of the resource group where the recovery services vault is present.
subscriptionId	path	True	string	The subscription Id.
vaultName	path	True	string	The name of the recovery services vault.
api-version	query	True	string	Client Api Version.

Request Header

Name	Required	Type	Description
x-ms-authorization-auxiliary		string

Request Body

Name	Type	Description
eTag	string	Optional ETag.
location	string	Resource location.
properties	ProtectedItem: AzureFileshareProtectedItem AzureIaaSVMProtectedItem AzureSqlProtectedItem AzureVmWorkloadProtectedItem DPMProtectedItem GenericProtectedItem MabFileFolderProtectedItem AzureVmWorkloadSAPAseDatabaseProtectedItem AzureVmWorkloadSAPHanaDatabaseProtectedItem AzureVmWorkloadSAPHanaDBInstanceProtectedItem AzureVmWorkloadSQLDatabaseProtectedItem AzureIaaSClassicComputeVMProtectedItem AzureIaaSComputeVMProtectedItem	ProtectedItemResource properties
tags	object	Resource tags.

Responses

Name	Type	Description
200 OK	ProtectedItemResource	OK
202 Accepted		Accepted
Other Status Codes	CloudError	Error response describing why the operation failed.

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

Enable Protection on Azure IaasVm

Stop Protection with retain data on Azure IaasVm

Enable Protection on Azure IaasVm

Sample request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1?api-version=2024-04-01

{
  "properties": {
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
    "policyId": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/DefaultPolicy"
  }
}

Java

import com.azure.resourcemanager.recoveryservicesbackup.models.AzureIaaSComputeVMProtectedItem;

/**
 * Samples for ProtectedItems CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2024-04-01/examples/
     * AzureIaasVm/ConfigureProtection.json
     */
    /**
     * Sample code: Enable Protection on Azure IaasVm.
     * 
     * @param manager Entry point to RecoveryServicesBackupManager.
     */
    public static void enableProtectionOnAzureIaasVm(
        com.azure.resourcemanager.recoveryservicesbackup.RecoveryServicesBackupManager manager) {
        manager.protectedItems().define("VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1").withRegion((String) null)
            .withExistingProtectionContainer("NetSDKTestRsVault", "SwaggerTestRg", "Azure",
                "IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1")
            .withProperties(new AzureIaaSComputeVMProtectedItem().withSourceResourceId(
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1")
                .withPolicyId(
                    "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/DefaultPolicy"))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservicesbackup.activestamp import RecoveryServicesBackupClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-recoveryservicesbackup
# USAGE
    python configure_protection.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = RecoveryServicesBackupClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.protected_items.create_or_update(
        vault_name="NetSDKTestRsVault",
        resource_group_name="SwaggerTestRg",
        fabric_name="Azure",
        container_name="IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
        protected_item_name="VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
        parameters={
            "properties": {
                "policyId": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/DefaultPolicy",
                "protectedItemType": "Microsoft.Compute/virtualMachines",
                "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
            }
        },
    )
    print(response)


# x-ms-original-file: specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2024-04-01/examples/AzureIaasVm/ConfigureProtection.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armrecoveryservicesbackup_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/recoveryservices/armrecoveryservicesbackup/v4"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/33c4457b1d13f83965f4fe3367dca4a6df898100/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2024-04-01/examples/AzureIaasVm/ConfigureProtection.json
func ExampleProtectedItemsClient_CreateOrUpdate_enableProtectionOnAzureIaasVm() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armrecoveryservicesbackup.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewProtectedItemsClient().CreateOrUpdate(ctx, "NetSDKTestRsVault", "SwaggerTestRg", "Azure", "IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1", "VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1", armrecoveryservicesbackup.ProtectedItemResource{
		Properties: &armrecoveryservicesbackup.AzureIaaSComputeVMProtectedItem{
			PolicyID:          to.Ptr("/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/DefaultPolicy"),
			ProtectedItemType: to.Ptr("Microsoft.Compute/virtualMachines"),
			SourceResourceID:  to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1"),
		},
	}, &armrecoveryservicesbackup.ProtectedItemsClientCreateOrUpdateOptions{XMSAuthorizationAuxiliary: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ProtectedItemResource = armrecoveryservicesbackup.ProtectedItemResource{
	// 	Name: to.Ptr("VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1"),
	// 	Type: to.Ptr("Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1"),
	// 	Properties: &armrecoveryservicesbackup.AzureIaaSComputeVMProtectedItem{
	// 		BackupManagementType: to.Ptr(armrecoveryservicesbackup.BackupManagementTypeAzureIaasVM),
	// 		ContainerName: to.Ptr("iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1"),
	// 		PolicyID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupPolicies/testPolicy1"),
	// 		ProtectedItemType: to.Ptr("Microsoft.Compute/virtualMachines"),
	// 		SourceResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1"),
	// 		WorkloadType: to.Ptr(armrecoveryservicesbackup.DataSourceTypeVM),
	// 		FriendlyName: to.Ptr("netvmtestv2vm1"),
	// 		HealthStatus: to.Ptr(armrecoveryservicesbackup.HealthStatusPassed),
	// 		LastBackupStatus: to.Ptr("Completed"),
	// 		LastBackupTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-22T12:25:32.048Z"); return t}()),
	// 		ProtectedItemDataID: to.Ptr("636482643132986882"),
	// 		ProtectionState: to.Ptr(armrecoveryservicesbackup.ProtectionStateProtected),
	// 		ProtectionStatus: to.Ptr("Healthy"),
	// 		VirtualMachineID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { RecoveryServicesBackupClient } = require("@azure/arm-recoveryservicesbackup");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Enables backup of an item or to modifies the backup policy information of an already backed up item. This is an
asynchronous operation. To know the status of the operation, call the GetItemOperationResult API.
 *
 * @summary Enables backup of an item or to modifies the backup policy information of an already backed up item. This is an
asynchronous operation. To know the status of the operation, call the GetItemOperationResult API.
 * x-ms-original-file: specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2024-04-01/examples/AzureIaasVm/ConfigureProtection.json
 */
async function enableProtectionOnAzureIaasVM() {
  const subscriptionId =
    process.env["RECOVERYSERVICESBACKUP_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const vaultName = "NetSDKTestRsVault";
  const resourceGroupName = process.env["RECOVERYSERVICESBACKUP_RESOURCE_GROUP"] || "SwaggerTestRg";
  const fabricName = "Azure";
  const containerName = "IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1";
  const protectedItemName = "VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1";
  const parameters = {
    properties: {
      policyId:
        "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/DefaultPolicy",
      protectedItemType: "Microsoft.Compute/virtualMachines",
      sourceResourceId:
        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new RecoveryServicesBackupClient(credential, subscriptionId);
  const result = await client.protectedItems.createOrUpdate(
    vaultName,
    resourceGroupName,
    fabricName,
    containerName,
    protectedItemName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:

202

Location: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/operationResults/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Azure-AsyncOperation: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/operationsStatus/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Retry-After: 60

Status code:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
  "name": "VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
  "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems",
  "properties": {
    "friendlyName": "netvmtestv2vm1",
    "virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
    "protectionStatus": "Healthy",
    "protectionState": "Protected",
    "healthStatus": "Passed",
    "lastBackupStatus": "Completed",
    "lastBackupTime": "2018-01-22T12:25:32.048723Z",
    "protectedItemDataId": "636482643132986882",
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "backupManagementType": "AzureIaasVM",
    "workloadType": "VM",
    "containerName": "iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
    "policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupPolicies/testPolicy1",
    "lastRecoveryPoint": null
  }
}

Stop Protection with retain data on Azure IaasVm

Sample request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1?api-version=2024-04-01

{
  "properties": {
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
    "protectionState": "ProtectionStopped"
  }
}

Java

import com.azure.resourcemanager.recoveryservicesbackup.models.AzureIaaSComputeVMProtectedItem;
import com.azure.resourcemanager.recoveryservicesbackup.models.ProtectionState;

/**
 * Samples for ProtectedItems CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2024-04-01/examples/
     * AzureIaasVm/StopProtection.json
     */
    /**
     * Sample code: Stop Protection with retain data on Azure IaasVm.
     * 
     * @param manager Entry point to RecoveryServicesBackupManager.
     */
    public static void stopProtectionWithRetainDataOnAzureIaasVm(
        com.azure.resourcemanager.recoveryservicesbackup.RecoveryServicesBackupManager manager) {
        manager.protectedItems().define("VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1").withRegion((String) null)
            .withExistingProtectionContainer("NetSDKTestRsVault", "SwaggerTestRg", "Azure",
                "IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1")
            .withProperties(new AzureIaaSComputeVMProtectedItem().withSourceResourceId(
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1")
                .withProtectionState(ProtectionState.PROTECTION_STOPPED))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservicesbackup.activestamp import RecoveryServicesBackupClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-recoveryservicesbackup
# USAGE
    python stop_protection.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = RecoveryServicesBackupClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.protected_items.create_or_update(
        vault_name="NetSDKTestRsVault",
        resource_group_name="SwaggerTestRg",
        fabric_name="Azure",
        container_name="IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
        protected_item_name="VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
        parameters={
            "properties": {
                "protectedItemType": "Microsoft.Compute/virtualMachines",
                "protectionState": "ProtectionStopped",
                "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
            }
        },
    )
    print(response)


# x-ms-original-file: specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2024-04-01/examples/AzureIaasVm/StopProtection.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armrecoveryservicesbackup_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/recoveryservices/armrecoveryservicesbackup/v4"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/33c4457b1d13f83965f4fe3367dca4a6df898100/specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2024-04-01/examples/AzureIaasVm/StopProtection.json
func ExampleProtectedItemsClient_CreateOrUpdate_stopProtectionWithRetainDataOnAzureIaasVm() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armrecoveryservicesbackup.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewProtectedItemsClient().CreateOrUpdate(ctx, "NetSDKTestRsVault", "SwaggerTestRg", "Azure", "IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1", "VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1", armrecoveryservicesbackup.ProtectedItemResource{
		Properties: &armrecoveryservicesbackup.AzureIaaSComputeVMProtectedItem{
			ProtectedItemType: to.Ptr("Microsoft.Compute/virtualMachines"),
			SourceResourceID:  to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1"),
			ProtectionState:   to.Ptr(armrecoveryservicesbackup.ProtectionStateProtectionStopped),
		},
	}, &armrecoveryservicesbackup.ProtectedItemsClientCreateOrUpdateOptions{XMSAuthorizationAuxiliary: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ProtectedItemResource = armrecoveryservicesbackup.ProtectedItemResource{
	// 	Name: to.Ptr("VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1"),
	// 	Type: to.Ptr("Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1"),
	// 	Properties: &armrecoveryservicesbackup.AzureIaaSComputeVMProtectedItem{
	// 		BackupManagementType: to.Ptr(armrecoveryservicesbackup.BackupManagementTypeAzureIaasVM),
	// 		ContainerName: to.Ptr("iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1"),
	// 		PolicyID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupPolicies/testPolicy1"),
	// 		ProtectedItemType: to.Ptr("Microsoft.Compute/virtualMachines"),
	// 		SourceResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1"),
	// 		WorkloadType: to.Ptr(armrecoveryservicesbackup.DataSourceTypeVM),
	// 		FriendlyName: to.Ptr("netvmtestv2vm1"),
	// 		HealthStatus: to.Ptr(armrecoveryservicesbackup.HealthStatusPassed),
	// 		LastBackupStatus: to.Ptr("Completed"),
	// 		LastBackupTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-22T12:25:32.048Z"); return t}()),
	// 		ProtectedItemDataID: to.Ptr("636482643132986882"),
	// 		ProtectionState: to.Ptr(armrecoveryservicesbackup.ProtectionStateProtectionStopped),
	// 		ProtectionStatus: to.Ptr("Healthy"),
	// 		VirtualMachineID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { RecoveryServicesBackupClient } = require("@azure/arm-recoveryservicesbackup");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Enables backup of an item or to modifies the backup policy information of an already backed up item. This is an
asynchronous operation. To know the status of the operation, call the GetItemOperationResult API.
 *
 * @summary Enables backup of an item or to modifies the backup policy information of an already backed up item. This is an
asynchronous operation. To know the status of the operation, call the GetItemOperationResult API.
 * x-ms-original-file: specification/recoveryservicesbackup/resource-manager/Microsoft.RecoveryServices/stable/2024-04-01/examples/AzureIaasVm/StopProtection.json
 */
async function stopProtectionWithRetainDataOnAzureIaasVM() {
  const subscriptionId =
    process.env["RECOVERYSERVICESBACKUP_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const vaultName = "NetSDKTestRsVault";
  const resourceGroupName = process.env["RECOVERYSERVICESBACKUP_RESOURCE_GROUP"] || "SwaggerTestRg";
  const fabricName = "Azure";
  const containerName = "IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1";
  const protectedItemName = "VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1";
  const parameters = {
    properties: {
      protectedItemType: "Microsoft.Compute/virtualMachines",
      protectionState: "ProtectionStopped",
      sourceResourceId:
        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new RecoveryServicesBackupClient(credential, subscriptionId);
  const result = await client.protectedItems.createOrUpdate(
    vaultName,
    resourceGroupName,
    fabricName,
    containerName,
    protectedItemName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:

202

Location: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/operationResults/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Azure-AsyncOperation: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/operationsStatus/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Retry-After: 60

Status code:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1/protectedItems/VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
  "name": "VM;iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
  "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems",
  "properties": {
    "friendlyName": "netvmtestv2vm1",
    "virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
    "protectionStatus": "Healthy",
    "protectionState": "ProtectionStopped",
    "healthStatus": "Passed",
    "lastBackupStatus": "Completed",
    "lastBackupTime": "2018-01-22T12:25:32.048723Z",
    "protectedItemDataId": "636482643132986882",
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "backupManagementType": "AzureIaasVM",
    "workloadType": "VM",
    "containerName": "iaasvmcontainerv2;netsdktestrg;netvmtestv2vm1",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/netsdktestrg/providers/Microsoft.Compute/virtualMachines/netvmtestv2vm1",
    "policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupPolicies/testPolicy1",
    "lastRecoveryPoint": null
  }
}

Definitions

Name	Description
AzureFileshareProtectedItem	Azure File Share workload-specific backup item.
AzureFileshareProtectedItemExtendedInfo	Additional information about Azure File Share backup item.
AzureIaaSClassicComputeVMProtectedItem	IaaS VM workload-specific backup item representing the Classic Compute VM.
AzureIaaSComputeVMProtectedItem	IaaS VM workload-specific backup item representing the Azure Resource Manager VM.
AzureIaaSVMHealthDetails	Azure IaaS VM workload-specific Health Details.
AzureIaaSVMProtectedItem	IaaS VM workload-specific backup item.
AzureIaaSVMProtectedItemExtendedInfo	Additional information on Azure IaaS VM specific backup item.
AzureSqlProtectedItem	Azure SQL workload-specific backup item.
AzureSqlProtectedItemExtendedInfo	Additional information on Azure Sql specific protected item.
AzureVmWorkloadProtectedItem	Azure VM workload-specific protected item.
AzureVmWorkloadProtectedItemExtendedInfo	Additional information on Azure Workload for SQL specific backup item.
AzureVmWorkloadSAPAseDatabaseProtectedItem	Azure VM workload-specific protected item representing SAP ASE Database.
AzureVmWorkloadSAPHanaDatabaseProtectedItem	Azure VM workload-specific protected item representing SAP HANA Database.
AzureVmWorkloadSAPHanaDBInstanceProtectedItem	Azure VM workload-specific protected item representing SAP HANA DBInstance.
AzureVmWorkloadSQLDatabaseProtectedItem	Azure VM workload-specific protected item representing SQL Database.
BackupManagementType	Type of backup management for the backed up item.
CloudError	An error response from the Container Instance service.
CloudErrorBody	An error response from the Container Instance service.
CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
DataSourceType	Type of workload this item represents.
DiskExclusionProperties
DistributedNodesInfo	This is used to represent the various nodes of the distributed container.
DPMProtectedItem	Additional information on Backup engine specific backup item.
DPMProtectedItemExtendedInfo	Additional information of DPM Protected item.
ErrorAdditionalInfo	The resource management error additional info.
ErrorDetail	Error Detail class which encapsulates Code, Message and Recommendations.
ExtendedProperties	Extended Properties for Azure IaasVM Backup.
GenericProtectedItem	Base class for backup items.
HealthStatus	Health status of protected item.
KPIResourceHealthDetails	KPI Resource Health Details
LastBackupStatus	Last backup operation status. Possible values: Healthy, Unhealthy.
MabFileFolderProtectedItem	MAB workload-specific backup item.
MabFileFolderProtectedItemExtendedInfo	Additional information on the backed up item.
ProtectedItemHealthStatus	Health status of the backup item, evaluated based on last heartbeat received
ProtectedItemResource	Base class for backup items.
ProtectedItemState	Backup state of the backed up item.
ProtectionState	Backup state of this backup item.
ResourceHealthDetails	Health Details for backup items.
ResourceHealthStatus	Resource Health Status

AzureFileshareProtectedItem

Azure File Share workload-specific backup item.

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureFileshareProtectedItemExtendedInfo	Additional information with this backup item.
friendlyName	string	Friendly name of the fileshare represented by this backup item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
kpisHealths	<string,  KPIResourceHealthDetails>	Health details of different KPIs
lastBackupStatus	string	Last backup operation status. Possible values: Healthy, Unhealthy.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemType	string: AzureFileShareProtectedItem	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
protectionStatus	string	Backup status of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

AzureFileshareProtectedItemExtendedInfo

Additional information about Azure File Share backup item.

Name	Type	Description
oldestRecoveryPoint	string	The oldest backup copy available for this item in the service.
policyState	string	Indicates consistency of policy object and policy applied to this backup item.
recoveryPointCount	integer	Number of available backup copies associated with this backup item.
resourceState	string	Indicates the state of this resource. Possible values are from enum ResourceState {Invalid, Active, SoftDeleted, Deleted}
resourceStateSyncTime	string	The resource state sync time for this backup item.

AzureIaaSClassicComputeVMProtectedItem

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

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureIaaSVMProtectedItemExtendedInfo	Additional information for this backup item.
extendedProperties	ExtendedProperties	Extended Properties for Azure IaasVM Backup.
friendlyName	string	Friendly name of the VM represented by this backup item.
healthDetails	AzureIaaSVMHealthDetails[]	Health details on this backup item.
healthStatus	HealthStatus	Health status of protected item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
kpisHealths	<string,  KPIResourceHealthDetails>	Health details of different KPIs
lastBackupStatus	string	Last backup operation status.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemDataId	string	Data ID of the protected item.
protectedItemType	string: Microsoft.ClassicCompute/virtualMachines	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
protectionStatus	string	Backup status of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
virtualMachineId	string	Fully qualified ARM ID of the virtual machine represented by this item.
workloadType	DataSourceType	Type of workload this item represents.

AzureIaaSComputeVMProtectedItem

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

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureIaaSVMProtectedItemExtendedInfo	Additional information for this backup item.
extendedProperties	ExtendedProperties	Extended Properties for Azure IaasVM Backup.
friendlyName	string	Friendly name of the VM represented by this backup item.
healthDetails	AzureIaaSVMHealthDetails[]	Health details on this backup item.
healthStatus	HealthStatus	Health status of protected item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
kpisHealths	<string,  KPIResourceHealthDetails>	Health details of different KPIs
lastBackupStatus	string	Last backup operation status.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemDataId	string	Data ID of the protected item.
protectedItemType	string: Microsoft.Compute/virtualMachines	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
protectionStatus	string	Backup status of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
virtualMachineId	string	Fully qualified ARM ID of the virtual machine represented by this item.
workloadType	DataSourceType	Type of workload this item represents.

AzureIaaSVMHealthDetails

Azure IaaS VM workload-specific Health Details.

Name	Type	Description
code	integer	Health Code
message	string	Health Message
recommendations	string[]	Health Recommended Actions
title	string	Health Title

AzureIaaSVMProtectedItem

IaaS VM workload-specific backup item.

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureIaaSVMProtectedItemExtendedInfo	Additional information for this backup item.
extendedProperties	ExtendedProperties	Extended Properties for Azure IaasVM Backup.
friendlyName	string	Friendly name of the VM represented by this backup item.
healthDetails	AzureIaaSVMHealthDetails[]	Health details on this backup item.
healthStatus	HealthStatus	Health status of protected item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
kpisHealths	<string,  KPIResourceHealthDetails>	Health details of different KPIs
lastBackupStatus	string	Last backup operation status.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemDataId	string	Data ID of the protected item.
protectedItemType	string: AzureIaaSVMProtectedItem	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
protectionStatus	string	Backup status of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
virtualMachineId	string	Fully qualified ARM ID of the virtual machine represented by this item.
workloadType	DataSourceType	Type of workload this item represents.

AzureIaaSVMProtectedItemExtendedInfo

Additional information on Azure IaaS VM specific backup item.

Name	Type	Description
newestRecoveryPointInArchive	string	The latest backup copy available for this backup item in archive tier
oldestRecoveryPoint	string	The oldest backup copy available for this backup item across all tiers.
oldestRecoveryPointInArchive	string	The oldest backup copy available for this backup item in archive tier
oldestRecoveryPointInVault	string	The oldest backup copy available for this backup item in vault tier
policyInconsistent	boolean	Specifies if backup policy associated with the backup item is inconsistent.
recoveryPointCount	integer	Number of backup copies available for this backup item.

AzureSqlProtectedItem

Azure SQL workload-specific backup item.

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureSqlProtectedItemExtendedInfo	Additional information for this backup item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemDataId	string	Internal ID of a backup item. Used by Azure SQL Backup engine to contact Recovery Services.
protectedItemType	string: Microsoft.Sql/servers/databases	backup item type.
protectionState	ProtectedItemState	Backup state of the backed up item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

AzureSqlProtectedItemExtendedInfo

Additional information on Azure Sql specific protected item.

Name	Type	Description
oldestRecoveryPoint	string	The oldest backup copy available for this item in the service.
policyState	string	State of the backup policy associated with this backup item.
recoveryPointCount	integer	Number of available backup copies associated with this backup item.

AzureVmWorkloadProtectedItem

Azure VM workload-specific protected item.

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureVmWorkloadProtectedItemExtendedInfo	Additional information for this backup item.
friendlyName	string	Friendly name of the DB represented by this backup item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
kpisHealths	<string,  KPIResourceHealthDetails>	Health details of different KPIs
lastBackupErrorDetail	ErrorDetail	Error details in last backup
lastBackupStatus	LastBackupStatus	Last backup operation status. Possible values: Healthy, Unhealthy.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
nodesList	DistributedNodesInfo[]	List of the nodes in case of distributed container.
parentName	string	Parent name of the DB such as Instance or Availability Group.
parentType	string	Parent type of protected item, example: for a DB, standalone server or distributed
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemDataSourceId	string	Data ID of the protected item.
protectedItemHealthStatus	ProtectedItemHealthStatus	Health status of the backup item, evaluated based on last heartbeat received
protectedItemType	string: AzureVmWorkloadProtectedItem	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
protectionStatus	string	Backup status of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
serverName	string	Host/Cluster Name for instance or AG
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

AzureVmWorkloadProtectedItemExtendedInfo

Additional information on Azure Workload for SQL specific backup item.

Name	Type	Description
newestRecoveryPointInArchive	string	The latest backup copy available for this backup item in archive tier
oldestRecoveryPoint	string	The oldest backup copy available for this backup item across all tiers.
oldestRecoveryPointInArchive	string	The oldest backup copy available for this backup item in archive tier
oldestRecoveryPointInVault	string	The oldest backup copy available for this backup item in vault tier
policyState	string	Indicates consistency of policy object and policy applied to this backup item.
recoveryModel	string	Indicates consistency of policy object and policy applied to this backup item.
recoveryPointCount	integer	Number of backup copies available for this backup item.

AzureVmWorkloadSAPAseDatabaseProtectedItem

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

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureVmWorkloadProtectedItemExtendedInfo	Additional information for this backup item.
friendlyName	string	Friendly name of the DB represented by this backup item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
kpisHealths	<string,  KPIResourceHealthDetails>	Health details of different KPIs
lastBackupErrorDetail	ErrorDetail	Error details in last backup
lastBackupStatus	LastBackupStatus	Last backup operation status. Possible values: Healthy, Unhealthy.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
nodesList	DistributedNodesInfo[]	List of the nodes in case of distributed container.
parentName	string	Parent name of the DB such as Instance or Availability Group.
parentType	string	Parent type of protected item, example: for a DB, standalone server or distributed
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemDataSourceId	string	Data ID of the protected item.
protectedItemHealthStatus	ProtectedItemHealthStatus	Health status of the backup item, evaluated based on last heartbeat received
protectedItemType	string: AzureVmWorkloadSAPAseDatabase	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
protectionStatus	string	Backup status of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
serverName	string	Host/Cluster Name for instance or AG
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

AzureVmWorkloadSAPHanaDatabaseProtectedItem

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

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureVmWorkloadProtectedItemExtendedInfo	Additional information for this backup item.
friendlyName	string	Friendly name of the DB represented by this backup item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
kpisHealths	<string,  KPIResourceHealthDetails>	Health details of different KPIs
lastBackupErrorDetail	ErrorDetail	Error details in last backup
lastBackupStatus	LastBackupStatus	Last backup operation status. Possible values: Healthy, Unhealthy.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
nodesList	DistributedNodesInfo[]	List of the nodes in case of distributed container.
parentName	string	Parent name of the DB such as Instance or Availability Group.
parentType	string	Parent type of protected item, example: for a DB, standalone server or distributed
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemDataSourceId	string	Data ID of the protected item.
protectedItemHealthStatus	ProtectedItemHealthStatus	Health status of the backup item, evaluated based on last heartbeat received
protectedItemType	string: AzureVmWorkloadSAPHanaDatabase	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
protectionStatus	string	Backup status of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
serverName	string	Host/Cluster Name for instance or AG
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

AzureVmWorkloadSAPHanaDBInstanceProtectedItem

Azure VM workload-specific protected item representing SAP HANA DBInstance.

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureVmWorkloadProtectedItemExtendedInfo	Additional information for this backup item.
friendlyName	string	Friendly name of the DB represented by this backup item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
kpisHealths	<string,  KPIResourceHealthDetails>	Health details of different KPIs
lastBackupErrorDetail	ErrorDetail	Error details in last backup
lastBackupStatus	LastBackupStatus	Last backup operation status. Possible values: Healthy, Unhealthy.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
nodesList	DistributedNodesInfo[]	List of the nodes in case of distributed container.
parentName	string	Parent name of the DB such as Instance or Availability Group.
parentType	string	Parent type of protected item, example: for a DB, standalone server or distributed
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemDataSourceId	string	Data ID of the protected item.
protectedItemHealthStatus	ProtectedItemHealthStatus	Health status of the backup item, evaluated based on last heartbeat received
protectedItemType	string: AzureVmWorkloadSAPHanaDBInstance	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
protectionStatus	string	Backup status of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
serverName	string	Host/Cluster Name for instance or AG
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

AzureVmWorkloadSQLDatabaseProtectedItem

Azure VM workload-specific protected item representing SQL Database.

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	AzureVmWorkloadProtectedItemExtendedInfo	Additional information for this backup item.
friendlyName	string	Friendly name of the DB represented by this backup item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
kpisHealths	<string,  KPIResourceHealthDetails>	Health details of different KPIs
lastBackupErrorDetail	ErrorDetail	Error details in last backup
lastBackupStatus	LastBackupStatus	Last backup operation status. Possible values: Healthy, Unhealthy.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
nodesList	DistributedNodesInfo[]	List of the nodes in case of distributed container.
parentName	string	Parent name of the DB such as Instance or Availability Group.
parentType	string	Parent type of protected item, example: for a DB, standalone server or distributed
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemDataSourceId	string	Data ID of the protected item.
protectedItemHealthStatus	ProtectedItemHealthStatus	Health status of the backup item, evaluated based on last heartbeat received
protectedItemType	string: AzureVmWorkloadSQLDatabase	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
protectionStatus	string	Backup status of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
serverName	string	Host/Cluster Name for instance or AG
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

BackupManagementType

Type of backup management for the backed up item.

Name	Type	Description
AzureBackupServer	string
AzureIaasVM	string
AzureSql	string
AzureStorage	string
AzureWorkload	string
DPM	string
DefaultBackup	string
Invalid	string
MAB	string

CloudError

An error response from the Container Instance service.

Name	Type	Description
error	CloudErrorBody	The error object.

CloudErrorBody

An error response from the Container Instance service.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	An identifier for the error. Codes are invariant and are intended to be consumed programmatically.
details	CloudErrorBody[]	A list of additional details about the error.
message	string	A message describing the error, intended to be suitable for display in a user interface.
target	string	The target of the particular error. For example, the name of the property in error.

CreateMode

Create mode to indicate recovery of existing soft deleted data source or creation of new data source.

Name	Type	Description
Default	string
Invalid	string
Recover	string

DataSourceType

Type of workload this item represents.

Name	Type	Description
AzureFileShare	string
AzureSqlDb	string
Client	string
Exchange	string
FileFolder	string
GenericDataSource	string
Invalid	string
SAPAseDatabase	string
SAPHanaDBInstance	string
SAPHanaDatabase	string
SQLDB	string
SQLDataBase	string
Sharepoint	string
SystemState	string
VM	string
VMwareVM	string

DiskExclusionProperties

Name	Type	Description
diskLunList	integer[]	List of Disks' Logical Unit Numbers (LUN) to be used for VM Protection.
isInclusionList	boolean	Flag to indicate whether DiskLunList is to be included/ excluded from backup.

DistributedNodesInfo

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

DPMProtectedItem

Additional information on Backup engine specific backup item.

Name	Type	Description
backupEngineName	string	Backup Management server protecting this backup item
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	DPMProtectedItemExtendedInfo	Extended info of the backup item.
friendlyName	string	Friendly name of the managed item
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemType	string: DPMProtectedItem	backup item type.
protectionState	ProtectedItemState	Protection state of the backup engine
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

DPMProtectedItemExtendedInfo

Additional information of DPM Protected item.

Name	Type	Description
diskStorageUsedInBytes	string	Used Disk storage in bytes.
isCollocated	boolean	To check if backup item is collocated.
isPresentOnCloud	boolean	To check if backup item is cloud protected.
lastBackupStatus	string	Last backup status information on backup item.
lastRefreshedAt	string	Last refresh time on backup item.
oldestRecoveryPoint	string	Oldest cloud recovery point time.
onPremiseLatestRecoveryPoint	string	latest disk recovery point time.
onPremiseOldestRecoveryPoint	string	Oldest disk recovery point time.
onPremiseRecoveryPointCount	integer	disk recovery point count.
protectableObjectLoadPath	object	Attribute to provide information on various DBs.
protected	boolean	To check if backup item is disk protected.
protectionGroupName	string	Protection group name of the backup item.
recoveryPointCount	integer	cloud recovery point count.
totalDiskStorageSizeInBytes	string	total Disk storage in bytes.

ErrorAdditionalInfo

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

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.

ExtendedProperties

Extended Properties for Azure IaasVM Backup.

Name	Type	Description
diskExclusionProperties	DiskExclusionProperties	Extended Properties for Disk Exclusion.
linuxVmApplicationName	string	Linux VM name

GenericProtectedItem

Base class for backup items.

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
fabricName	string	Name of this backup item's fabric.
friendlyName	string	Friendly name of the container.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
policyState	string	Indicates consistency of policy object and policy applied to this backup item.
protectedItemId	integer	Data Plane Service ID of the protected item.
protectedItemType	string: GenericProtectedItem	backup item type.
protectionState	ProtectionState	Backup state of this backup item.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceAssociations	object	Loosely coupled (type, value) associations (example - parent of a protected item)
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

HealthStatus

Health status of protected item.

Name	Type	Description
ActionRequired	string
ActionSuggested	string
Invalid	string
Passed	string

KPIResourceHealthDetails

KPI Resource Health Details

Name	Type	Description
resourceHealthDetails	ResourceHealthDetails[]	Resource Health Status
resourceHealthStatus	ResourceHealthStatus	Resource Health Status

LastBackupStatus

Last backup operation status. Possible values: Healthy, Unhealthy.

Name	Type	Description
Healthy	string
IRPending	string
Invalid	string
Unhealthy	string

MabFileFolderProtectedItem

MAB workload-specific backup item.

Name	Type	Description
backupManagementType	BackupManagementType	Type of backup management for the backed up item.
backupSetName	string	Name of the backup set the backup item belongs to
computerName	string	Name of the computer associated with this backup item.
containerName	string	Unique name of container
createMode	CreateMode	Create mode to indicate recovery of existing soft deleted data source or creation of new data source.
deferredDeleteSyncTimeInUTC	integer	Sync time for deferred deletion in UTC
deferredDeleteTimeInUTC	string	Time for deferred deletion in UTC
deferredDeleteTimeRemaining	string	Time remaining before the DS marked for deferred delete is permanently deleted
extendedInfo	MabFileFolderProtectedItemExtendedInfo	Additional information with this backup item.
friendlyName	string	Friendly name of this backup item.
isArchiveEnabled	boolean	Flag to identify whether datasource is protected in archive
isDeferredDeleteScheduleUpcoming	boolean	Flag to identify whether the deferred deleted DS is to be purged soon
isRehydrate	boolean	Flag to identify that deferred deleted DS is to be moved into Pause state
isScheduledForDeferredDelete	boolean	Flag to identify whether the DS is scheduled for deferred delete
lastBackupStatus	string	Status of last backup operation.
lastBackupTime	string	Timestamp of the last backup operation on this backup item.
lastRecoveryPoint	string	Timestamp when the last (latest) backup copy was created for this backup item.
policyId	string	ID of the backup policy with which this item is backed up.
policyName	string	Name of the policy used for protection
protectedItemType	string: MabFileFolderProtectedItem	backup item type.
protectionState	string	Protected, ProtectionStopped, IRPending or ProtectionError
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests on which LAC check will be performed
softDeleteRetentionPeriodInDays	integer	Soft delete retention period in days
sourceResourceId	string	ARM ID of the resource to be backed up.
vaultId	string	ID of the vault which protects this item
workloadType	DataSourceType	Type of workload this item represents.

MabFileFolderProtectedItemExtendedInfo

Additional information on the backed up item.

Name	Type	Description
lastRefreshedAt	string	Last time when the agent data synced to service.
oldestRecoveryPoint	string	The oldest backup copy available.
recoveryPointCount	integer	Number of backup copies associated with the backup item.

ProtectedItemHealthStatus

Health status of the backup item, evaluated based on last heartbeat received

Name	Type	Description
Healthy	string
IRPending	string
Invalid	string
NotReachable	string
Unhealthy	string

ProtectedItemResource

Base class for backup items.

Name	Type	Description
eTag	string	Optional ETag.
id	string	Resource Id represents the complete path to the resource.
location	string	Resource location.
name	string	Resource name associated with the resource.
properties	ProtectedItem: AzureFileshareProtectedItem AzureIaaSClassicComputeVMProtectedItem AzureIaaSComputeVMProtectedItem AzureIaaSVMProtectedItem AzureSqlProtectedItem AzureVmWorkloadProtectedItem AzureVmWorkloadSAPAseDatabaseProtectedItem AzureVmWorkloadSAPHanaDBInstanceProtectedItem AzureVmWorkloadSAPHanaDatabaseProtectedItem AzureVmWorkloadSQLDatabaseProtectedItem DPMProtectedItem GenericProtectedItem MabFileFolderProtectedItem	ProtectedItemResource properties
tags	object	Resource tags.
type	string	Resource type represents the complete path of the form Namespace/ResourceType/ResourceType/...

ProtectedItemState

Backup state of the backed up item.

Name	Type	Description
BackupsSuspended	string
IRPending	string
Invalid	string
Protected	string
ProtectionError	string
ProtectionPaused	string
ProtectionStopped	string

ProtectionState

Backup state of this backup item.

Name	Type	Description
BackupsSuspended	string
IRPending	string
Invalid	string
Protected	string
ProtectionError	string
ProtectionPaused	string
ProtectionStopped	string

ResourceHealthDetails

Health Details for backup items.

Name	Type	Description
code	integer	Health Code
message	string	Health Message
recommendations	string[]	Health Recommended Actions
title	string	Health Title

ResourceHealthStatus

Resource Health Status

Name	Type	Description
Healthy	string
Invalid	string
PersistentDegraded	string
PersistentUnhealthy	string
TransientDegraded	string
TransientUnhealthy	string